Setup Kubernetes CLI for EKS

Owned by Kevin He
Last updated: May 19, 2023 by Alex Xie
1 min read

Prerequisites

  1. Install Kubernetes CLI tool - kubectl. Instructions can be found here: https://kubernetes.io/docs/tasks/tools/install-kubectl/

  2. Install the AWS CLI. https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html

Create AWS SSO profile

  1. Run command and apply settings as below: aws configure sso

    SSO session name (Recommended): cloudservice SSO start URL [None]: https://iqx.awsapps.com/start# SSO region [None]: ap-southeast-2 SSO registration scopes [None]: sso:account:access

  2. The CLI will open a page in browser for authentication. Follow the page and Allow CLI access your account.

  3. Select the account “cloudservice@iqxbusiness.com” from account list.

  4. Select a role according to your need.

  5. Apply following for the rest of configurations.

    CLI default client Region [None]: ap-southeast-2 CLI default output format [None]: json

Connect kubectl to EKS cluster

  1. Create EKS context. Run the command below. You don’t need to run this command again once the context is created.

    aws eks update-kubeconfig --region ap-southeast-2 --name <your cluster name> --profile cloudservice

  2. Get all kubectl contexts available.

  3. Select the context for the cluster that you want to work on.

  4. Test the connection.

Refresh token