Debian 12サーバーにRancherをインストールする方法

Rancherは、Kubernetesクラスターのデプロイ、管理、ガバナンスを容易にするために設計されたオープンソースのコンテナ管理プラットフォームです。Kubernetes自体を置き換えるKubernetesディストリビューションとは異なり、Rancherは1つまたは複数のKubernetesクラスターの上に位置する管理ソリューションとして機能し、管理者が全体のコンテナインフラストラクチャを監視できる集中型プラットフォームを提供します。

このチュートリアルでは、Debian 12サーバーにRancherをインストールする方法を学びます。Dockerを介して単一ノードとしてRancherをインストールし、その上にKubernetesの単一ノードもデプロイします。

前提条件

このガイドを始める前に、以下の要件を満たしていることを確認してください：

• 最低4GBのRAMまたはメモリを持つDebian 12サーバー
• 管理者権限を持つ非ルートユーザー

Dockerのインストール

Rancherをインストールする前に、システムにDockerがインストールされていることを確認する必要があります。このセクションでは、公式のDockerリポジトリを介してDebianシステムにDocker Engineをインストールします。

まず、以下のコマンドを実行してパッケージインデックスを更新し、’ca-certificates’や’curl’などのパッケージをインストールします。

sudo apt update && sudo apt install ca-certificates curl -y

次に、以下のコマンドを実行してDockerリポジトリのGPGキーを追加します。

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

次に、以下のコマンドを実行してDockerリポジトリをDebianシステムに追加します。これにより、Debianのバージョンが自動的に検出されます。

echo \  
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \  
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

DockerリポジトリとGPGキーを追加したので、以下のコマンドを実行してパッケージインデックスを更新し、システムにDocker Engineをインストールします。この例では、Docker ComposeやDocker Buildxプラグインなどの追加パッケージと共にDocker Engineをインストールします。

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

インストールを続行するには’Y’を入力します。

インストールが完了したら、以下の’systemctl’コマンドを使用してDockerサービスの状態を確認します。Dockerが実行中で、Debianマシンで有効になっていることがわかります。

sudo systemctl is-enabled docker  
sudo systemctl status docker

最後に、以下の’docker’コマンドを実行して’hello-word’コンテナを実行できます。

sudo docker run hello-world

成功すると、Dockerから以下の’ Hello World ‘メッセージが表示されます。

Rancherのインストール

Dockerがインストールされたので、Rancherをインストールする準備が整いました。このセクションでは、Rancherイメージをダウンロードし、Dockerを介してRancherコンテナを実行します。この例では、Rancherコンテナによって自動的に生成される自己署名証明書を使用します。また、Rancherイメージの最新バージョンを使用します。

以下の’docker pull’コマンドを使用してRancherイメージをダウンロードします。この例では、Rancherの最新バージョンを使用します。

sudo docker pull rancher/rancher:latest

Rancherイメージのダウンロードが完了したら、’docker run’コマンドを実行してRancherを実行します。これにより、Rancherコンテナがバックグラウンドで実行され、ホストDebianサーバーでポート80と443がエクスポートされます。

sudo docker run -d --restart=unless-stopped \  
-p 80:80 -p 443:443 \  
--privileged \  
rancher/rancher:latest

以下のコマンドを使用してコンテナの状態を確認します。

sudo docker ps

以下の出力では、Rancherがポート443で実行されていることがわかります。また、コンテナIDとコンテナの名前も表示されます。

さらに、エラーが発生した場合は、以下の’docker’コマンドを使用してRancherのログを確認できます。

docker ps -a  
docker log container-name or container id

‘ps -a’オプションは、実行中および終了したコンテナを表示し、’docker log’コマンドはコンテナのログを確認するために使用されます。

Rancherの設定

この時点で、RancherはコンテナとしてDebianシステムで実行されています。次のステップでは、Rancherダッシュボードにログインして、Rancherインストールの上に実行されているKubernetesの単一ノードを確認します。

ウェブブラウザを開き、DebianサーバーのIPアドレスにポート8080を追加してアクセスします。例えば、https://192.168.10.41:8080/です。インストールが成功していれば、以下のRancherログインページが表示されます。

ターミナルに戻り、以下のコマンドを実行してRancherパスワードを取得します。インストールに合わせてコンテナIDを変更し、パスワードをコピーしてください。

sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"

パスワードを入力し、ローカルユーザーでログインをクリックします。

次に、生成されたRancherのパスワードをコピーし、利用規約とライセンスに同意してください。

次に、以下のRancherダッシュボードが表示されます。以下の例では、K3sで作成された単一ノードのKubernetesクラスターが表示されています。

ローカルKubernetesクラスターをクリックすると、Kubernetesクラスターに関する詳細情報が表示されます。

kubectlを使用してKubernetesクラスターにアクセスする

まず、KubeConfigをローカルコンピュータにダウンロードします。Rancherダッシュボードから、以下のファイルメニューをクリックします。

以下のコマンドを使用してシステムに’kubectl’をインストールします。Debian 12では、APTを介して’ kubernetes-client ‘パッケージをインストールできます。

sudo apt install kubernetes-client -y

デフォルトのKUBECONFIGをファイルに設定します。この例では、KubeConfigファイルは’kubeconfig.yaml’です。

export KUBECONFIG=~/kubeconfig.yaml

最後に、以下の’kubectl’コマンドを実行して、すべてのKubernetesネームスペースのポッドのリストを取得します。

kubectl get pods --all-namespaces

Rancherの下で各ポッドが実行されていることがわかります。

結論

おめでとうございます！Debian 12サーバーにDockerでRancherのインストールを完了しました。Rancherをセットアップし、その上にKubernetesクラスターを作成する方法を学びました。最後に、Kubernetesクラスターと対話する方法も学びました。さらに、’kubectl’を介してKubernetesクラスターにコンテナ化されたアプリケーションをデプロイできます。