1.2.0-beta7

Changelog

(vs 1.2.0-beta6)

• Support for Ubuntu 20.04
• Mount docker socket when listing MKE images
• APIVersion 1.3

There is a rather large refactoring done between beta6 and this version, all of the host communication code has been moved to a library shared between k0sctl and Launchpad.

Configuration API changes

Address is now in the level of protocol configuration:

Before:

spec:
  hosts:
    - role: manager
      address: 10.0.0.1
      ssh:
        port: 22

Now:

spec:
  hosts:
    - role: manager
      ssh:
        address: 10.0.0.1
        port: 22

The "localhost" connection is no longer a direct boolean:

Before:

spec:
  hosts:
    - localhost: true

Now:

spec:
  hosts:
    - localhost:
        enabled: true

Any old style configuration will be migrated.

1.2.0-beta6

Changelog

(vs 1.2.0-beta4)

• Add ProgressPreference=SilentlyContinue to powershell commands
• Fix nil panic in Install MSR phase

1.2.0-beta4

Changelog

(vs 1.2.0-beta3)

• Restored "sudo ping" which was lost in beta3
• Use -NoProfile in powershell commands to avoid "Preparing modules for first use" in STDERR.

1.2.0-beta3

Changelog

(vs 1.2.0-beta2)

• Add MKE and MSR upgradeFlags
• Rename "engine" to Mirantis Container Runtime
• APIVersion 1.2
• Upgrade default versions: MKE: 3.3.5, MSR: 2.8.5, MCR: 19.03.14

Example:

apiVersion: launchpad.mirantis.com/mke/v1.2
kind: mke
spec:
  hosts:
    - address: 10.0.0.1
      role: manager
      mcrConfig: # <-- was 'engineConfig'
        debug: true
  mke:
    installFlags:
      - --default-node-orchestrator=kubernetes
    upgradeFlags: # <-- new, also in MKE
      - --force-recent-backup
      - --force-minimums
  mcr: # <-- was 'engine'
    version: 19.03.13

1.2.0-beta2

Changelog

(vs 1.2.0-beta1)

• Preliminary SLES support
• Don't pull images that already exist (lost in refactoring)

1.2.0-beta10

Changelog

(vs 1.2.0-beta9)

• Don't disable cleanup in MKE/MSR image listing when using --disable-cleanup
• TP corrected version sorting when comparing MKE/MSR versions (1.0.0-rc1 is newer than1.0.0-tp3 so standard semver sorting does not work)
• Fix WinRM file uploads
• Fix WinRM default port when using HTTPS

1.2.0-beta1

Changelog

• Initial support for Oracle Linux 7
• Update default versions: MKE 3.3.4, MSR 2.8.4, Engine 19.03.13
• Fix enabling selinux engine setting on RHEL

Notes

Some variants of Oracle Linux found on providers like AWS seem to come with very strict iptables rules, for testing, you may want to add a preinstall hooks like:

spec:
  hosts:
    - address: 10.0.0.1
      hooks:
        apply:
          before:
            - sudo iptables -F
            - sudo iptables -P INPUT ACCEPT

(This will clear all iptables rules and make the default input rule to be accept all.)

1.2.0-beta.11

Changelog

(vs 1.2.0-beta10)

• Add spec.mke.swarmInstallFlags

1.1.1

Changelog

• Update daemon.json also when not installing/upgrading engine
• Fix docker login on windows
• Upgrade engines on MSR hosts individually to avoid downtime
• Clean up empty hooks from config output
• Ignore MSR configuration when no MSR hosts present

1.1.0

Version 1.1.0 Highlights

Renamed Products

• UCP (Universal Control Plane) is now Mirants Kubernetes Engine
• DTR (Docker Trusted Registry) is now Mirantis Secure Registry

This is also reflected in the configuration syntax.

launchpad exec

Run commands or interactive remote terminals on a remote hosts:

$ launchpad exec --role manager --interactive
root@manager0 # ls -al

launchpad describe

The describe subcommand can be used to show a simple report of the current status of the cluster:

$ launchpad describe mke

Environment Variable Substitution in launchpad.yaml

You can now use variables in the configuration. The values will be read from the local environment variables.

Example:

spec:
  mke:
    adminPassword: $MKE_ADMIN_PASSWORD

Read Configuration From STDIN

Instead of redirecting to a file, you can now do this:

$ terraform output mke_cluster | launchpad apply --config -

Configuration Syntax Changes

The latest API version is launchpad.mirantis.com/mke/v1.1.

Changes in a nutshell:

• kind: DockerEnterprise is now kind: mke
• ucp: is now mke:
• dtr: is now msr:
• role: dtr is now role: msr
• replicaConfig is now replicaIDs
• The administrator credentials can be set via spec.mke.adminUsername and .adminPassword instead of having to use the --admin-username/-password install flags.

A configuration for any previous launchpad apiVersion can still be used without changes and it will be migrated on the fly while loading. To output a migrated version of your launchpad.yaml, you can use:

$ launchpad describe config

Breaking Changes

• NOTE: The Terraform examples have been updated to reflect the renamed products. If you use the new ones for updating any existing clusters deployed using the old ones, some new objects such as security groups, load balancers, etc may be created.
• The launchpad download-bundle subcommand is now launchpad client-config. The subcommand no longer accepts --username and --password, you must specify those in the configuration YAML.
• The --prune flag has been removed from launchpad apply, to enable pruning, set configuration spec.cluster.prune: true
• Due to it's destructive nature, on an interactive terminal, launchpad reset will now ask for confirmation. When running non-interactively, you must supply the --force flag.

Changelog

• Validate "localhost" resolves to an address on the host
• Detect host's privateInterface automatically
• Add launchpad download-launchpad subcommand to download the latest launchpad version
• Make launchpad reset require --force or confirmation
• Populate UCP SANs with manager addresses unless given
• Add launchpad describe subcommand to show cluster status
• Add bash, zsh and fish auto-completions
• Validate MSR hosts can access the MKE cluster through the --ucp-url
• Don't re-pull images that already exist
• Make commands on windows hosts consider any output to STDERR to be a sign of failure
• Use a more robust way to upload large files to hosts
• Validate the resolved internal IP address is an IP address and not for example an error message
• Setting UseNTLM: true now actually enables NTLM on WinRM
• Improve how self upgrade check resolves the latest version
• The self upgrade check can now be disabled using --disable-upgrade-check/-u/DISABLE_UPGRADE_CHECK
• Perform self upgrade check in the background during normal command execution to reduce delay
• The launchpad apply --prune option has been removed and can now be set via config spec.cluster.prune: true
• Fix pulling and running MKE/MSR images from custom repositories
• Add launchpad exec that can be used to run commands or interactive terminals on hosts
• Reboot (mostly windows) hosts after engine installation has completed if necessary
• Detect and adapt to windows private interface name change after engine install (Ethernet 2 => vEthernet (Ethernet 2))
• The MKE administrator credentials can now be supplied via spec.mke.adminUsername and adminPassword
• Perform environment variable substitution when parsing launchpad.yaml
• Add spec.host.imageDir for uploading .tar/.tar.gz images from docker save to hosts
• Removed the timestamp from log output and added a host role identifier and connection port (INFO M 127.0.0.1:22)
• Removed unnecessary extra image pulls to worker hosts when installing MSR
• Use the automatically generated MKE administrator password when installing MSR when none given
• Renamed the launchpad download-bundle to launchpad client-config and removed the --username/--password options in favor of config spec.mke.adminUsername/adminPassword.
• Read launchpad.yaml from STDIN when using --config -
• Fix panic when running apply without any MKE configuration
• Use admin as the default MKE administrator username when not given
• Update the configuration API version to launchpad.mirantis.com/mke/v1.1
• Error out when the YAML contains unknown keys
• Increase the initial connect retry time to 4 minutes to allow deployed hosts time to spin up
• Add --disable-redact for disabling the hiding of sensitive information
• Add --confirm to prompt for confirmation when running any commands on hosts
• UCP/DTR product renaming, UCP to MKE, DTR to MSR.
• Fix private interface resolving in RHEL and others where ip is in /usr/sbin but it is not in PATH
• Fix MSR sequential replica ID generation potentially creating conflicting IDs
• Changed the replicaConfig: sequential configuration key to replicaIDs: sequential

Documentation

The updated documentation can be browsed in the Launchpad GitHub repo