K3sインストール手順

シングルノードで縮小版Kubernetesを構築できるK3sの構築手順について記載します。

手順

下記コマンドでkubectlコマンドなども含めてインストールされます:

# root以外でもkubectlを実行可能にするオプションを付与
curl -sfL https://get.k3s.io | sh -s - server --write-kubeconfig-mode=644

各種設定オプションについては公式ドキュメントに記載されています。

Tips

k8sやkindなどと挙動に差異が出る箇所について記載します。

kubeconfigのパス

cf. https://docs.k3s.io/cluster-access

kubeconfigの設定が記載されているファイルのパスが他と異なります:

root@nob-k3s:~# ls -l /etc/rancher/k3s/k3s.yaml
-rw------- 1 root root 2957 Nov  8 12:09 /etc/rancher/k3s/k3s.yaml

下記のようなエラーが発生した場合、export KUBECONFIG=/etc/rancher/k3s/k3s.yamlすると解決します:

root@nob-k3s:~# argo submit -n argo --watch https://raw.githubusercontent.com/argoproj/argo-workflows/main/examples/hello-world.yaml
Error: invalid configuration: no configuration has been provided, try setting KUBERNETES_MASTER environment variable