kubectlで複数のクラスターを切り替える方法

Kubernetesの新しいクラスターを追加したので、kubectlコマンドで切り替えられるように設定しました。

一度設定してしまうといじることはなく、このままだとやり方忘れてしまうので、自分用に設定方法をメモしておきます。

仕組み

Kubernetesを操作するにはkubectlコマンドを使うのですが、kubectlはKubernetesを構築したプラットフォームに非依存で、 Kubernetesをオンプレで作ろうが、GCPで作ろうが、AWSで作ろうが、１つのkubectlコマンドで全てのKubernetesにアクセスできます。

kubectlからクラスターにアクセスするには、アクセス先の「クラスター」とその「ユーザー」の情報が必要です。

kubectlでは、その「クラスター」と「ユーザー」（と「ネームスペース」）を、１つの「コンテキスト」というものでまとめています。

そして、kubectlでコマンドを実行する際、「コンテキスト」からアクセス先の情報を得て、目的のKubernetesにアクセスできるようになります。

さらに、「コンテキスト」は複数作成することができ、「コンテキスト」を切り替えることにより、１つのkubectlで様々なKubernetesクラスターにアクセスできるようになります。

ちなみに、「ネームスペース」は必須ではなく、省略した場合「default」ネームスペースにアクセスします。「ネームスペース」を設定すると、同じクラスターでも「ネームスペース」を分けた「コンテキスト」を作成することができます。

クラスター・ユーザー情報設定

新しいKukbernetesにアクセスする場合、クラスター・ユーザー情報をkubectlのコンテキストに設定する必要があるのですが、設定方法はクラスターを構築したプラットフォーム依存です。

例えばGoogle Cloud Platformの場合、下記のようなコマンドで設定します。

gcloud container clusters get-credentials \
    [クラスター名] \
    --project [GCPプロジェクト名] \
    --zone [GCPゾーン名]

コンテキスト一覧を取得するコマンドkubectl config get-contextsを実行してみます。

CURRENT NAME    CLUSTER    AHTHINFO    NAMESPACE
*[context_name]    [cluster_name]    [user_name]

と、新しい「コンテキスト」が作成され、それに「クラスター」と「ユーザー」も自動で設定されています。

クラスター接続テストは下記で行います。

kubectl cluster-info

kubectlコンテキスト関連コマンド

クラスターへのアクセスに必要な設定がコンテキストにされたので、後は使いやすいようにコンテキストを編集していきます。

コンテキスト関連でよく使うコマンドを記載します。

コンテキスト一覧を表示

kubectl config get-contexts

現在のコンテキストを表示

kubectl config current-context

指定したコンテキストをアクティブにする

kubectl config set-context [コンテキスト名]

ネームスペース設定を設定する

設定したいコンテキストをアクティブにしてから下記を実行

kubectl config set-context --current --namespace=[ネームスペース名]

コンテキスト設定ファイルを直接編集する

コンテキストの設定は~/.kube/configファイルに記載されています。

apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: 
  name: [クラスター１]
- cluster:
    certificate-authority-data:
  name: [クラスター２]
contexts:
- context:
    cluster: [クラスター１]
    user: [ユーザー１]
  name:  [コンテキスト１]
- context:
    cluster: [クラスター２]
    namespace: [ネームスペース１]
    user: [ユーザー２]
  name:  [コンテキスト２]
current-context: [コンテキスト１]
kind: Config
preferences: {}
users:
- name: [ユーザー１]
  user:
    auth-provider:
- name: [ユーザー２]
  user:
    auth-provider: