Installing the IBM Multicloud Manager Klusterlet on a Google Kubernetes Engine

Follow the procedure to install IBM Multicloud Manager Klusterlet in a Google Kubernetes Engine (Kubernetes Engine) environment. For more information about Kubernetes Engine, see Google Kubernetes Engine .

Optional: View the license file for IBM Multicloud Manager with the following command:

docker run -e LICENSE=view ibmcom/mcm-inception-amd64:3.1.2-ce

1. Extract the cluster directory from the inception container with the following command:

    docker run -v $(pwd):/data -e LICENSE=accept \
    ibmcom/mcm-inception-amd64:3.1.2-ce \
    cp -r /installer/cluster.gke /data/cluster
   

2. Change to the cluster folder in your installation directory with the following command:

    cd cluster
   

3. Obtain your cluster access information.

   To run the inception installer on a Kubernetes Engine cluster, you need a Google Cloud service account and key. For information about creating a Google Cloud Platform service accounts, see Authenticating to Cloud Platform with Service Accounts . If you need to create a key manually, see Creating and Managing Service Account Keys.

   To obtain your credentials, you need the key for the service account that is assigned the Kubernetes Engine Admin role. You can find that service account in the IAM & admin section of the console.

   If you do not have your key, complete the following procedure to create a key:

   1. Log in to your Google Cloud Platform console.
   2. Navigate to the IAM & admin > Service accounts and find the account that is assigned the Kubernetes Engine Admin role.
   3. From the Actions menu, click Create key and select JSON to download the key to your directory.
   4. Copy the .json file and rename the key to gke-sa-key.json. Copy the file to the cluster directory, which overrides the previous file.
   5. Add the key to your cluster directory. Note: You must overwrite the current file with your gke-sa-key.json file.

4. Configure the Kubernetes service provider information in your config.yaml file. Configure the following gcloud parameters:

   • cluster-name: Name of the target cluster from the Google Cloud Platform console
   • zone: Location of the cluster. Click Kubernetes Engine > Cluster in the console
   • project: The project ID for the project where the target cluster was created. You can find this in the Dashboard.

5. Configure the Klusterlet parameters in the config.yaml file in the cluster directory:

   • cluster-name: The name of the target cluster resource on the hub-cluster
   • cluster-namespace: The namespace where the target cluster is contained on the hub-cluster
   • cluster-tags: Tags that are used to describe the target cluster
   • hub-k8s-endpoint: The Kubernetes API endpoint of the IBM Multicloud Manager hub-cluster
   • hub-k8s-token: The authentication token for the Kubernetes API endpoint of the IBM Multicloud Manager hub-cluster

6. Run the inception container with the following command:

    docker run --net=host -t -e LICENSE=accept \
    -v "$(pwd)":/installer/cluster \
    ibmcom/mcm-inception-amd64:3.1.2-ce \
    install-mcm-klusterlet -v
   

   See the IBM Multicloud Manager installation overview for more installation topics.