vSphere with Kubernetes を体験するためのラボ環境構築をしたので、
kubectl で接続して、コンテナ を Kubernetes の Pod（vSphere Pod）として起動してみます。
Supervisor Cluster に作成した名前空間の配下の管理は、基本的には vSphere 専用の kubectl を利用します。
前回はこちら。
vSphere with Kubernetes ラボ環境構築。Part-10: Supervisor Cluster 有効化編
クライアント環境について。
今回は、kubectl を実行するクライアントとして Linux（VMware Photon OS 3.0）を利用しています。
gowatana [ ~ ]$ cat /etc/photon-release
VMware Photon OS 3.0
PHOTON_BUILD_NUMBER=49d932d
Photon OS はデフォルトのパッケージが少ないので、
あらかじめ root ユーザで RPM を追加インストールしておきます。
- photon-checksum-generator： ハッシュ値確認のため（sha256sum コマンド）
- unzip： kubectl の zip ファイル（vsphere-plugin.zip）の解凍のため。
root@vm01 [ ~ ]# tdnf install -y photon-checksum-generator unzip
kubectl のダウンロード ページ。
まず、vSphere 専用の kubectl をダウンロードします。
この環境の Supervisor Cluster には、名前空間「lab-ns-01」、「lab-ns-02」を作成してあります。
ダウンロード サイトには、「名前空間」のサマリページにある「開く」リンクからアクセスできます。
「Kubernetes CLI Tools」ページが開けます。
ちなみに、このサイトのアドレスは、Supervisor Control Plane VM （のアドレスをメンバにしている NSX-T の LB の VIP）のものです。
Web ブラウザのアドレスバーを見ると、今回の IP アドレスは、192.168.70.33 になっています。
このあとの kubectl での接続先も、この IP アドレスです。
ダウンロードサイトでは、Windows / Linux / Mac OS 用の kubectl と、
それぞれの SHA256 ハッシュ値のファイルが提供されます。
OS ごとの kubectl の利用手順も、このページに記載されています。
kubectl のダウンロード ～ ログイン。
「Kubernetes CLI Tools」ページにある「CLI PLUGIN LINUX」と「Checksum CLI plugin Linux」から
右クリック メニューなどでダウンロード URL を取得しておきます。
そして、今回 kubectl を実行する Linux からダウンロードします。
kubectl の zip ファイル（vsphere-plugin.zip）を、curl でダウンロードします。
gowatana [ ~ ]$ curl -k -L -O https://192.168.70.33/wcp/plugin/linux-amd64/vsphere-plugin.zip
あわせて、ハッシュ値のファイル（sha256sum.txt）をダウンロードします。
gowatana [ ~ ]$ curl -k -L -O https://192.168.70.33/wcp/plugin/linux-amd64/sha256sum.txt
2つのファイルをダウンロードしたら、SHA256 のハッシュ値でファイルに問題がなそうか確認しておきます。
- Photon OS 3.0 では、「Kubernetes CLI Tools」ページとは少し手順が異なり、
冒頭での photon-checksum-generator のインストールが必要です。 - とりあえず実行してみるだけであれば、ハッシュ値確認は省略しても大丈夫です。
gowatana [ ~ ]$ ls
sha256sum.txt vsphere-plugin.zip
gowatana [ ~ ]$ tdnf install -y photon-checksum-generator
gowatana [ ~ ]$ sha256sum --check sha256sum.txt < vsphere-plugin.zip
vsphere-plugin.zip: OK
zunzip でファイルを解凍すると、中に kubectl が入っています。
gowatana [ ~ ]$ unzip vsphere-plugin.zip
Archive: vsphere-plugin.zip
creating: bin/
inflating: bin/kubectl-vsphere
inflating: bin/kubectl
kubectl に PATH を通しておきます。
gowatana [ ~ ]$ export PATH=$(pwd)/bin:$PATH
gowatana [ ~ ]$ which kubectl
/home/gowatana/bin/kubectl
今回の kubectl のバージョンです。
gowatana [ ~ ]$ kubectl version --client
Client Version: version.Info{Major:"1", Minor:"17+", GitVersion:"v1.17.4-2+a00aae1e6a4a69", GitCommit:"a00aae1e6a4a698595445ec86aab1502a495c1ce", GitTreeState:"clean", BuildDate:"2020-04-22T11:35:29Z", GoVersion:"go1.13.8", Compiler:"gc", Platform:"linux/amd64"}
kubectl で Bash の Tab キー補完を利用するためのコマンドラインを実行しておきます。
gowatana [ ~ ]$ source <(kubectl completion bash)
ちなみに、Photon OS ではなく RHEL / CentOS などを利用する場合、
この Bash 補完機能を利用するためには、bash-completion のインストールと再ログインが必要だったりします。
[root@centos7 ~]# yum install -y bash-completion
ダウンロードした kubectl には、一般的な kubectl にはない「kubectl vsphere ～」といったコマンドがあります。
gowatana [ ~ ]$ kubectl vsphere --help
vSphere Plugin for kubectl.
Usage:
kubectl-vsphere [command]
Available Commands:
help Help about any command
login Authenticate user with vCenter Namespaces
logout Destroys current sessions with all vCenter Namespaces clusters.
version Prints the version of the plugin.
Flags:
-h, --help help for kubectl-vsphere
--request-timeout string Request timeout for HTTP client.
-v, --verbose int Print verbose logging information.
Use "kubectl-vsphere [command] --help" for more information about a command.
「kubectl vsphere login」で、Supervisor Control VM のアドレス宛にログインします。
gowatana [ ~ ]$ kubectl vsphere login --help
Authenticate user with vCenter Namespaces:
To access Kubernetes, you must first authenticate against vCenter Namespaces.
You must pass the address of the vCenter Namspaces server and the username of
the user to authenticate, and will be prompted to provide further credentials.
Usage:
kubectl-vsphere login [flags]
Examples:
kubectl vsphere login --vsphere-username user@domain --server=https://10.0.1.10
https://10.0.1.10/Flags:
-h, --help help for login
--insecure-skip-tls-verify Skip certificate verification (this is insecure).
--server string Address of the server to authenticate against.
--tanzu-kubernetes-cluster-name string Name of the Tanzu Kubernetes cluster to login to.
--tanzu-kubernetes-cluster-namespace string Namespace in which the Tanzu Kubernetes cluster resides.
-u, --vsphere-username string Username to authenticate.
Global Flags:
--request-timeout string Request timeout for HTTP client.
-v, --verbose int Print verbose logging information.
今回は、vCenter の名前空間で特にアクセス権限を付与していないので、
デフォルトでアクセス可能になっている administrator@vsphere.local ユーザでログインします。
接続先は、vCenter ではなく、Supervisor Control VM にアクセスできる VIP アドレス「192.168.70.33」です。さきほどの 「Kubernetes CLI Tools」ページと同じアドレスになるはずです。
証明書エラーを回避するため、「--insecure-skip-tls-verify」を指定しています。
gowatana [ ~ ]$ kubectl vsphere login --insecure-skip-tls-verify --server=192.168.70.33
Username: administrator@vsphere.local
Password: ★パスワード入力
Logged in successfully.
You have access to the following contexts:
192.168.70.33
lab-ns-01
lab-ns-02
If the context you wish to use is not in this list, you may need to try
logging in again later, or contact your cluster administrator.
To change context, use `kubectl config use-context <workload name>`
利用可能な Context が表示されるので、
名前空間「lab-ns-01」にアクセスできる、同名のコンテキストに切り替えます。
gowatana [ ~ ]$ kubectl config use-context lab-ns-01
Switched to context "lab-ns-01".
Pod の起動確認。（kubectl run）
まずは、kubectl コマンドで CentOS 7 のコンテナを Kubernetes の Pod として起動してみます。
下記のようなオプション指定で、まずは コンテナが起動できることだけ確認します。
- コンテナ イメージは centos:7 を Docker Hubからダウンロードしています。
- 「-it」 オプションで起動したコンテナにそのまま接続しています。
- 「--rm」オプションで、コンテナから抜けた（exit した）際に、Pod を削除します。
コンテナを起動し、そのまま接続して、CentOS であることを確認してみました。
gowatana [ ~ ]$ kubectl run -it --image=centos:7 --generator=run-pod/v1 --rm centos
If you don't see a command prompt, try pressing enter.
[root@centos /]# ★ここからコンテナの中。
[root@centos /]#
[root@centos /]# cat /etc/centos-release
CentOS Linux release 7.8.2003 (Core)
この状態で vSphere Client から名前空間「lab-ns-01」を確認すると、
「centos」という名前のコンテナを含む Pod が作成、起動されています。
exit で抜けると、「--rm」オプションにより自動的にコンテナは削除されます。
[root@centos /]# exit
exit
Session ended, resume using 'kubectl attach centos -c centos -i -t' command when the pod is running
pod "centos" deleted
gowatana [ ~ ]$
vSphere Client でも、Pod が削除される様子が確認できます。
ちなみに、タスク名が「仮想マシンの削除」なのは、vSphere Pod では Pod が仮想マシンとして起動されているためです。
Pod の起動確認。（kubectl apply）
Kubernetes へのコンテナの展開は、実際には YAML ファイルを利用するのが一般的です。
そこで、YAML ファイルを用意して Pod を起動してみます。
下記のような nginx-pod.yml ファイルを用意します。
nginx イメージによる nginx-container コンテナ 1つを含む、nginx-pod という Pod を作成します。
---
kind: Pod
apiVersion: v1
metadata:
name: nginx-pod
labels:
app: wcp-demo
spec:
containers:
- image: nginx
name: nginx-container
nginx-pod.yml ファイルは、たとえば vi などのテキスト エディタで作成・・・
gowatana [ ~ ]$ vi nginx-pod.yml
もしくは下記のように ファイルを作成します。
gowatana [ ~ ]$ cat << EOF > nginx-pod.yml
> ---
> kind: Pod
> apiVersion: v1
> metadata:
> name: nginx-pod
> labels:
> app: wcp-demo
> spec:
> containers:
> - image: nginx
> name: nginx-container
> EOF
gowatana [ ~ ]$ cat ./nginx-pod.yml
---
kind: Pod
apiVersion: v1
metadata:
name: nginx-pod
labels:
app: wcp-demo
spec:
containers:
- image: nginx
name: nginx-container
kubectl apply コマンドで YAML ファイルを指定して、Pod を起動してみます。
gowatana [ ~ ]$ kubectl apply -f nginx-pod.yml
pod/nginx-pod created
Pod の起動が、kubectl で確認できます。
gowatana [ ~ ]$ kubectl get pods
NAME READY STATUS RESTARTS AGE
nginx-pod 1/1 Running 0 40s
vSphere Client でも、Pod が起動された様子が確認できます。
ちなみに、今回はただ Pod を起動しただけなので、Nginx に Web アクセスするには別途手順が必要です。
vSphere with Kubernetes の機能は NSX-T を前提としており、kubectl での操作に合わせて、
NSX によるネットワークが自動的に設定変更されます。（これについては別途・・・）
kubectl delete コマンドで Pod を削除すると、
vSphere Client でも Pod が削除された様子がわかるはずです。
gowatana [ ~ ]$ kubectl delete pod -f nginx-pod.yml
pod "nginx-pod" deleted
このように、vSphere with Kubernetes のでの Kubernetes ワークロードの操作については、
vSphere Client ではなく、基本的に kubectl を利用します。
以上、Supervisor Cluster に kubectl でアクセスして Pod を起動してみる話でした。
次は・・・
vSphere with Kubernetes ラボ環境構築。Part-12: Supervisor Namespace での Tanzu Kubernetes Cluster 準備編
