Terraform for Launchpad on GCP

A terraform module for preparing a basic GCP compute cluster for Launchpad installation.

[Launchpad]{https://docs.mirantis.com/mke/3.7/launchpad.html} is a Mirantis tool for installation of Mirantis Containers products. The tool can work with any properly prepared accessible cluster, This module can create a basic simple cluster, and provide the appropriate Launchpad configuration for use with Launchpad.

Prerequisites

• An account and credentials for GCP.
• Terraform installed

Authentication

The Terraform google provider uses JSON key file for authentication. Download the JSON key file for a service account and place it in a secure location on your workstation. See here for more information.

Usage

Use the module to create a basic compute cluster with HCL as follows:

module "provision" {
  source = "terraform-mirantis-modules/launchpad-gcp/mirantis"

  gcp_region = "us-central1"

  cluster_name = "my-cluster" 

  master_count = 1
  worker_count = 3
  msr_count    = 1
}

Then use the mke_cluster output for the launchpad yaml:

terraform output -raw mke_cluster > launchpad.yaml
launchpad apply

GCP Configuration

You can also control a few more details that configure GCP interaction:

1. gcp_zone can specify the availability zone
2. gcp_service_credential can specify a specific credential file

Cluster Components

Cluster composition can be managed using simple input controls for swarm managers, workers, MSR replicas. Windows workers also have their own controls matching controls.

manager_count       = 3               // 3 machines will be created
manager_type        = "e2-standard-4" // machine node type
manager_volume_size = 100GB           // machine volume size

Product configuration

While the Terraform module does not run launchpad, it does prepare the Launchpad configuration file for you. Because of this you can provide inputs that will then get included into the Launchpad yaml.

Each product's installation targets can be configured:

mcr_channel  = "stable"
mcr_repo_url = "https://repos.mirantis.com"
mcr_version  = "23.0.3"

mke_image_repo    = "docker.io/mirantis"
mke_install_flags = [ "--nodeport-range=32768-35535" ]
mke_version       = "3.6.3"

msr_image_repo = "docker.io/mirantis"
msr_install_flags = [ "--ucp-insecure-tls" ]
msr_version        = "2.9.11"
msr_replica_config = "sequential"

Specifically, the MKE authentication can be set

admin_password = "mirantisadmin"
admin_username = "admin"

Windows workers

This module supports windows workers. You need only specify the node configuration and also incluse a windows admin password.