サーバーのアーキテクチャを確認：

uname -m

一般的なアーキテクチャの対応関係：

cri-dockerd 0.3.16 を例として、x86_64 サーバーでは以下を実行します：

cd /tmp
wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.16/cri-dockerd-0.3.16.amd64.tgz
tar -xzf cri-dockerd-0.3.16.amd64.tgz
install -m 0755 cri-dockerd/cri-dockerd /usr/local/bin/cri-dockerd

ARM64 サーバーでは、以下を実行します：

cd /tmp
wget https://github.com/Mirantis/cri-dockerd/releases/download/v0.3.16/cri-dockerd-0.3.16.arm64.tgz
tar -xzf cri-dockerd-0.3.16.arm64.tgz
install -m 0755 cri-dockerd/cri-dockerd /usr/local/bin/cri-dockerd

systemd サービスの作成：

cat > /etc/systemd/system/cri-docker.service << 『EOF』
[Unit]
Description=Dockerアプリケーションコンテナエンジン用CRIインターフェース
Documentation=https://docs.mirantis.com
After=network-online.target docker.service
Wants=network-online.target
Requires=cri-docker.socket

[Service]
Type=notify
ExecStart=/usr/local/bin/cri-dockerd --container-runtime-endpoint fd:// --pod-infra-container-image=registry.aliyuncs.com/google_containers/pause:3.10
ExecReload=/bin/kill -s HUP $MAINPID
TimeoutSec=0
RestartSec=2
Restart=always
LimitNOFILE=infinity
LimitNPROC=infinity
LimitCORE=infinity
TasksMax=infinity
Delegate=yes
KillMode=process

[Install]
WantedBy=multi-user.target
EOF

cat > /etc/systemd/system/cri-docker.socket << 『EOF』
[Unit]
Description=API用CRI Dockerソケット
PartOf=cri-docker.service

[Socket]
ListenStream=/var/run/cri-dockerd.sock
SocketMode=0660
SocketUser=root
SocketGroup=docker

[Install]
WantedBy=sockets.target
EOF

systemctl daemon-reload
systemctl enable --now cri-docker.socket
systemctl enable --now cri-docker.service

cri-dockerdの確認：

systemctl status cri-docker.service --no-pager
cri-dockerd --version

2.3 kubeadm/kubelet/kubectl のインストール

以下の操作は、3台のサーバーすべてで実行します。

kubeadm は単なるクラスタ初期化ツールであり、静的な Pod マニフェストを生成した後、ローカルに常駐するプロセス kubelet に依存してコントロールプレーンコンテナを起動する必要があります。一方、kubectl は、クラスタの操作および管理を行うためのクライアントツールです。

2.3.1 Kubernetesのaptリポジトリを追加する

本記事では Kubernetes v1.32 を使用しています。

mkdir -p /etc/apt/keyrings
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.32/deb/Release. key \\
  | gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg

cat > /etc/apt/sources.list.d/kubernetes.list << 『EOF』
deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.32/deb/ /
EOF

apt-get update

2.3.2 Kubernetes コンポーネントのインストール

apt-get install -y kubelet kubeadm kubectl
apt-mark hold kubelet kubeadm kubectl
systemctl enable kubelet

バージョンの確認：

kubeadm version
kubelet --version
kubectl version --client

この時点では、kubeletがRunning状態になっていない場合がありますが、これは正常です。Masterの初期化が完了するか、Workerがクラスタに参加すると、kubeletは正常に動作します。

2.4 Masterの初期化

以下の操作は、Master ノードでのみ実行してください。

2.4.1 Kubernetesイメージの事前取得

kubeadm config images pull \\
  --kubernetes-version=v1.32.0 \\
  
--image-repository=registry.aliyuncs.com/google_containers \\
  --cri-socket=unix:///var/run/cri-dockerd.sock

2.4.2 クラスタの初期化

172.17.172.87 を、お使いの Master の内部ネットワーク IP に置き換えてください。

kubeadm init \\
  --apiserver-advertise-address=172.17.172.87 \\
  --pod-network-cidr=100.64.0.0/10 \\
  
--kubernetes-version=v1.32.0 \\
  --image-repository=registry.aliyuncs.com/google_containers \\
  --cri-socket=unix:///var/run/cri-dockerd.sock

初期化に成功すると、次のような出力が表示されます：

kubeadm join 172.17.172.87:6443 --token <token> \\
  --discovery-token-ca-cert-hash sha256:<hash>

この kubeadm join コマンドを保存しておいてください。後で Worker ノードをクラスタに追加する際に必要になります。

2.4.3 kubectl の設定

root ユーザーとして以下を実行します：

mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config

確認：

kubectl get nodes

この時点で、Masterが NotReady と表示される場合があります。これは、ネットワークプラグインがまだインストールされていないためです。

2.4.4 Calico ネットワークプラグインのインストール

Calico マニフェストをダウンロード：

curl -O https://raw.githubusercontent.com/projectcalico/calico/v3.29.1/manifests/calico.yaml

本記事ではクラスタの初期化時に Pod のネットワークセグメントとして 100.64.0.0/10 を使用しているため、Calico の CALICO_IPV4POOL_CIDR がこのネットワークセグメントと一致していることを確認する必要があります。

もし calico.yaml に CALICO_IPV4POOL_CIDR が存在する場合、次のように置き換えることができます：

sed -i 『s#192.168.0.0/16#100.64.0.0/10#g』 calico.yaml

Calicoを適用します：

kubectl apply -f calico.yaml

システム Pod のステータスを確認：

kubectl get pods -n kube-system -w

などの calico-node、calico-kube-controllers などのコンポーネントが Running 状態になるのを待ってから、ノードの状態を確認します：

kubectl get nodes -o wide

kubeadm join 172.17.172.87:6443 --token <token> \\
  --discovery-token-ca-cert-hash sha256:<hash> \\
  --cri-socket=unix:///var/run/cri-dockerd.sock

kubeadm token create --print-join-command

--cri-socket=unix:///var/run/cri-dockerd.sock

kubectl get nodes -o wide

kubectl get nodes -o wide

NAME STATUS ROLES AGE VERSION
k8s-master Ready control-plane 10m v1.32.x
k8s-worker1 Ready <none> 5m v1.32.x
k8s-worker2 Ready <none> 5m v1.32.x

kubectl get pods -A

kubectl create deployment nginx --image=nginx:1.25

kubectl expose deployment nginx --port=80 --type=NodePort

kubectl get pod -o wide
kubectl get svc nginx

NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S)
nginx NodePort 10.96.xxx.xxx <none> 80:30xxx/TCP

curl http://172.17.172.87:30xxx
curl http://172.17.172.89:30xxx
curl http://172.17.172.90:30xxx

kubectl delete svc nginx
kubectl delete deployment nginx

kubectl get nodes
kubectl get pods -A
kubectl describe node <node-name>
kubectl describe pod <pod-name> -n <namespace>
journalctl -u kubelet -f
journalctl -u docker -f
journalctl -u cri-docker -f

kubeadm reset -f --cri-socket=unix:///var/run/cri-dockerd.sock
rm -rf /etc/cni/net.d /var/lib/kubelet /var/lib/etcd $HOME/.kube

docker pull swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3

mkdir -p /root/kuboard-data

docker run -d \\
  --restart=unless-stopped \\
  --privileged \\
  --name=kuboard \\
  
-p 38000:80/tcp \\
  -p 38001:10081/tcp \\
  -e KUBOARD_ENDPOINT="http://172.17.172.87:58094" \\
  
-e KUBOARD_AGENT_SERVER_TCP_PORT="58099" \\
  -v /root/kuboard-data:/data \\
  swr.cn-east-2.myhuaweicloud.com/kuboard/kuboard:v3

docker ps --filter name=kuboard
docker logs -f kuboard

http://<マスターのパブリックIP>:38000

kubectl get pods -n kuboard