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-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

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.1-rc1

1.1.1-rc1

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

1.1.0-rc5

Changelog

(vs 1.1.0-rc4)

• Fix admin UI URLs in "launchpad describe" output
• UCP/DTR product renaming, UCP to MKE, DTR to MSR.
• API version updated to launchpad.mirantis.com/mke/v1.1
• Separate configuration kinds for MKE-only and MKE+MSR installations
• Fix private interface resolving in RHEL and others where /usr/sbin is not in PATH
• Fix MSR sequential replica ID generation potentially creating conflicting IDs
• Changed the replicaConfig: sequential configuration key to replicaIDs: sequential

Configuration syntax changes are migrated automatically when using a launchpad.yaml from an older apiVersion.

Sample configuration with the recent changes:

apiVersion: launchpad.mirantis.com/mke/v1.1 # was "launchpad.mirantis.com/v1"
kind: mke+msr # was "DockerEnterprise"
spec:
  hosts:
    - address: "10.0.0.1"
      role: manager
    - address: "10.0.0.2"
      role: msr # was "dtr"
  mke: # was "ucp:"
    adminUsername: admin
    adminPassword: password
  msr: # was "dtr:"
    version: 2.3.4

1.1.0-rc4

Changelog

(vs 1.1.0-rc3)

• Fix exec --target (#252)
• Add --disable-redact for disabling the hiding of sensitive information
• Add --confirm to prompt for confirmation when running any commands on hosts

1.1.0-rc3

Changelog

(vs 1.1.0-rc2)

• Fix connection retry max period to approx 4 minutes, fail fast on an authentication error

1.1.0-rc2

Changelog

• Error out when the YAML contains unknown keys
• Add back docker auth if registry credential environment variables are set
• Escape and warn about variables when migrating pre v1.1 configs
• Increase the initial connect retry time