前回の記事では、AKS を使用する上での環境構築をしました。今回はそのうえで、Azure CLI から AKS を色々いじってみようと思います。

#Azure CLI からのコマンド操作
kubectl を使います。基本的には以下の様な構文を書きます。

kubectl [コマンド] [タイプ] [名前] [フラグ]

コマンドでは、PowerShell や Command と同じように、create apply get delete がよく使用されるみたいです。また、ここでいうタイプは短縮形が可能だそうです。

$kubectl get pod
$kubectl get po (短縮名)
$kubectl get deployment
$kubectl get deploy (短縮名)
$kubectl get horizontalprodautoscalers
$kubectl get hpa (短縮名)

#よく使うコマンド一覧
ここではよく使うコマンドを記録として残しておこうともいます。その前に、実際Azure CLI で操作をする場合には変数の定義が再度必要になります。以下フォーマットで最初に実行しておくことで、あとあと便利です。たとえば今回は前回記事で作成した AKS に一発で使用できる状態にするコマンドを記載します。

$ACR_NAME=komiyasavalacr
$ACR_RES_GROUP=$ACR_NAME
$ACR_ID=$(az acr show --name $ACR_NAME --query id --output tsv)
$SP_NAME=sample-acr-service-principal
$SP_PASSWD=$(az ad sp create-for-rbac --name $SP_NAME --role Reader --scopes $ACR_ID --query password --output tsv)
$APP_ID=$(az ad sp show --id http://$SP_NAME --query appId --output tsv)
$AKS_CLUSTER_NAME=AKSCuster
$AKS_RES_GROUP=$AKS_CLUSTER_NAME

##クラスターの情報を表示する
$kubectl cluster-info
このコマンドではクラスターの情報が確認することができます。動いている API やアドオン機能の状態が確認できます。

miyasaka@Azure:~/Understanding-K8s/chap02$ kubectl cluster-info
Kubernetes master is running at https://akscuster-akscuster-XXXXXXXXXXXXXXXXXXX:443
CoreDNS is running at https://akscuster-akscuster-XXXXXXXXXXXXXXXXXXXXXXXXX:443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
kubernetes-dashboard is running at https://akscuster-akscuster-XXXXXXXXXXXXXXXXXXXXXX:443/api/v1/namespaces/kube-system/services/kubernetes-dashboard/proxy
Metrics-server is running at https://akscuster-akscuster-XXXXXXXXXXXXXXXXXXXXX:443/api/v1/namespaces/kube-system/services/https:metrics-server:/proxy

To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

##クラスター上の Node の確認
$kubectl get node
このコードでは、クラスター上で実行されている Node 一覧を取得することが出来ます。

miyasaka@Azure:~/Understanding-K8s/chap02$ kubectl get node
NAME                               STATUS   ROLES   AGE     VERSION
aks-nodepool1-XXXXXXXXXXXXXXXXXX   Ready    agent   3h17m   v1.13.12
aks-nodepool1-XXXXXXXXXXXXXXXXXX   Ready    agent   3h17m   v1.13.12
aks-nodepool1-XXXXXXXXXXXXXXXXXX   Ready    agent   3h17m   v1.13.12

$kubectl get node -o=wide
上記のコードにオプションとして Wide を付けた形になります。

miyasaka@Azure:~/Understanding-K8s/chap02$ kubectl get node -o=wide
NAME                                STATUS   ROLES   AGE     VERSION    INTERNAL-IP   EXTERNAL-IP   OS-IMAGE             KERNEL-VERSION      CONTAINER-RUNTIME
aks-nodepool1-XXXXXXXX-vmss000000   Ready    agent   3h19m   v1.13.12   XX.XXX.X.X    <none>        Ubuntu 16.04.6 LTS   4.15.0-1060-azure   docker://3.0.7
aks-nodepool1-XXXXXXXX-vmss000001   Ready    agent   3h19m   v1.13.12   XX.XXX.X.X    <none>        Ubuntu 16.04.6 LTS   4.15.0-1060-azure   docker://3.0.7
aks-nodepool1-XXXXXXXX-vmss000002   Ready    agent   3h19m   v1.13.12   XX.XXX.X.X    <none>        Ubuntu 16.04.6 LTS   4.15.0-1060-azure   docker://3.0.7

##Node の詳細情報表示
$kubectl describe node aks-nodepool1-XXXXXXXX-vmss000000
指定した Node の詳細情報を表示します。

miyasaka@Azure:~/Understanding-K8s/chap02$ kubectl describe node aks-nodepool1-XXXXXXXX-vmss000000
Name:               aks-nodepool1-XXXXXXXX-vmss000000
Roles:              agent
Labels:             agentpool=nodepool1
                    beta.kubernetes.io/arch=amd64
                    beta.kubernetes.io/instance-type=Standard_DS1_v2
                    beta.kubernetes.io/os=linux
                    failure-domain.beta.kubernetes.io/region=japaneast
                    failure-domain.beta.kubernetes.io/zone=0
                    kubernetes.azure.com/cluster=MC_AKSCuster_AKSCuster_japaneast
                    kubernetes.azure.com/role=agent
                    kubernetes.io/hostname=aks-nodepool1-XXXXXXXX-vmss000000
                    kubernetes.io/role=agent
                    node-role.kubernetes.io/agent=
                    storageprofile=managed
                    storagetier=Premium_LRS
Annotations:        node.alpha.kubernetes.io/ttl: 0
                    volumes.kubernetes.io/controller-managed-attach-detach: true
CreationTimestamp:  Fri, 08 Nov 2019 06:44:42 +0000
Taints:             <none>
Unschedulable:      false
Conditions:
  Type                 Status  LastHeartbeatTime                 LastTransitionTime                Reason                       Message
  ----                 ------  -----------------                 ------------------                ------                       -------
  NetworkUnavailable   False   Fri, 08 Nov 2019 06:47:03 +0000   Fri, 08 Nov 2019 06:47:03 +0000   RouteCreated                 RouteController created a route
  MemoryPressure       False   Fri, 08 Nov 2019 10:07:38 +0000   Fri, 08 Nov 2019 06:44:42 +0000   KubeletHasSufficientMemory   kubelet has sufficient memory available
  DiskPressure         False   Fri, 08 Nov 2019 10:07:38 +0000   Fri, 08 Nov 2019 06:44:42 +0000   KubeletHasNoDiskPressure     kubelet has no disk pressure
  PIDPressure          False   Fri, 08 Nov 2019 10:07:38 +0000   Fri, 08 Nov 2019 06:44:42 +0000   KubeletHasSufficientPID      kubelet has sufficient PID available
  Ready                True    Fri, 08 Nov 2019 10:07:38 +0000   Fri, 08 Nov 2019 06:44:43 +0000   KubeletReady                 kubelet is posting ready status. AppArmor enabled
~ 中略 ~
  (Total limits may be over 100 percent, i.e., overcommitted.)
  Resource                       Requests    Limits
  --------                       --------    ------
  cpu                            200m (21%)  0 (0%)
  memory                         70Mi (3%)   170Mi (9%)
  ephemeral-storage              0 (0%)      0 (0%)
  attachable-volumes-azure-disk  0           0
Events:                          <none>

##ヘルプを参照
$kubectl help
ヘルプの一覧を参照することが出来ます。

miyasaka@Azure:~/Understanding-K8s/chap02$ kubectl help
kubectl controls the Kubernetes cluster manager.

 Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/

Basic Commands (Beginner):
  create         Create a resource from a file or from stdin.
  expose         Take a replication controller, service, deployment or pod and expose it as a new Kubernetes Service
  run            Run a particular image on the cluster
  set            Set specific features on objects

Basic Commands (Intermediate):
  explain        Documentation of resources
  get            Display one or many resources
  edit           Edit a resource on the server
  delete         Delete resources by filenames, stdin, resources and names, or by resources and label selector

Deploy Commands:
  rollout        Manage the rollout of a resource
  scale          Set a new size for a Deployment, ReplicaSet, Replication Controller, or Job
  autoscale      Auto-scale a Deployment, ReplicaSet, or ReplicationController

Cluster Management Commands:
  certificate    Modify certificate resources.
  cluster-info   Display cluster info
  top            Display Resource (CPU/Memory/Storage) usage.
  cordon         Mark node as unschedulable
  uncordon       Mark node as schedulable
  drain          Drain node in preparation for maintenance
  taint          Update the taints on one or more nodes

Troubleshooting and Debugging Commands:
  describe       Show details of a specific resource or group of resources
  logs           Print the logs for a container in a pod
  attach         Attach to a running container
  exec           Execute a command in a container
  port-forward   Forward one or more local ports to a pod
  proxy          Run a proxy to the Kubernetes API server
  cp             Copy files and directories to and from containers.
  auth           Inspect authorization

Advanced Commands:
  diff           Diff live version against would-be applied version
  apply          Apply a configuration to a resource by filename or stdin
  patch          Update field(s) of a resource using strategic merge patch
  replace        Replace a resource by filename or stdin
  wait           Experimental: Wait for a specific condition on one or many resources.
  convert        Convert config files between different API versions
  kustomize      Build a kustomization target from a directory or a remote url.

Settings Commands:
  label          Update the labels on a resource
  annotate       Update the annotations on a resource
  completion     Output shell completion code for the specified shell (bash or zsh)

Other Commands:
  api-resources  Print the supported API resources on the server
  api-versions   Print the supported API versions on the server, in the form of "group/version"
  config         Modify kubeconfig files
  plugin         Provides utilities for interacting with plugins.
  version        Print the client and server version information

Usage:
  kubectl [flags] [options]

Use "kubectl <command> --help" for more information about a given command.
Use "kubectl options" for a list of global command-line options (applies to all commands).

#リソースの削除
テストで構築しても、クラスターが稼働している間や ACR レジストリにコンテナーイメージデータを置いている間は課金が発生するので、作成したものは使用しない場合は削除しておきましょう。以下コマンドで今回作成したものの削除が可能です。

$az group delete -name $AKS_RES_GROUP
$az group delete -name $AKS_RESOURCE_GROUP
$az ad sp delete --id=$(az ad ap show --id http://$SP_NAME --query appId --output tsv)

#参考
kubectl Commands

Azure Kubernetes Service (AKS)

しくみがわかるKubernetes Azureで動かしながら学ぶコンセプトと実践知識