Accessing your IBM® Cloud Private cluster by using the kubectl CLI

To access your cluster by using the command line interface (CLI), you must install and configure kubectl, the Kubernetes command line tool.

  1. Install the Kubernetes command line interface kubectl version 1.7.3. You can obtain the kubectl binary file from the IBM® Cloud Private installer or download a new installation file.

    • To use the binary file from the IBM® Cloud Private installer for Linux™ 64-bit, run this command:

      • Standard edition:

          docker run -e LICENSE=accept --net=host -v /usr/local/bin:/data ibmcom/kubernetes:v1.7.3-ee cp /kubectl /data
        
      • Community edition:

          docker run -e LICENSE=accept --net=host -v /usr/local/bin:/data ibmcom/kubernetes:v1.7.3 cp /kubectl /data
        
    • To use the binary file from the IBM® Cloud Private installer for Linux™ on Power® 64-bit LE, run this command:

      • Standard edition:

          docker run -e LICENSE=accept --net=host -v /usr/local/bin:/data ibmcom/kubernetes-ppc64le:v1.7.3-ee cp /kubectl /data
        
      • Community edition:

        docker run -e LICENSE=accept --net=host -v /usr/local/bin:/data ibmcom/kubernetes-ppc64le:v1.7.3 cp /kubectl /data
        
    • To download and install a new binary file, see Install and Set Up kubectl External link icon.

  2. Log in to your cluster management console. See Accessing your IBM® Cloud Private cluster by using the management console.
  3. Select User Name > Configure client, which is in the upper right of the window. The cluster configuration details display, resembles the following code:

    kubectl config set-cluster {cluster_name} --server=https://master_ip:8001 --insecure-skip-tls-verify=true
    kubectl config set-context {cluster_name}-context --cluster={cluster_name}
    kubectl config set-credentials {cluster_name}-user --token={token}
    kubectl config set-context {cluster_name}-context --user={cluster_name}-user --namespace=default
    kubectl config use-context {cluster_name}-context
    

    In these details, master_ip is the IP address of the master node for your IBM® Cloud Private cluster.

  4. Copy and paste the configuration information to your command line, and press Enter.

    Note: This configuration expires in 12 hours. To continue to use the CLI, you must log in and reconfigure kubectl every 12 hours. To avoid this limitation, you can configure your CLI by using service accounts. See https://www.ibm.com/developerworks/community/blogs/fe25b4ef-ea6a-4d86-a629-6f87ccf4649e/entry/Configuring_the_Kubernetes_CLI_by_using_service_account_tokens1 External link icon.