ウェブサイト検索

Minikubeを使ってローカルKubernetesクラスターを開始する方法


Minikubeは、ローカル開発用に設計された最小限のKubernetesディストリビューションです。Kubernetesプロジェクトの一部として開発されており、主要なクラスタ機能のすべての実装が含まれています。

MinikubeはLinux、Mac、Windowsのホストで動作します。クラスターとそのワークロードを実行するために、コンテナまたは仮想マシン環境を使用できます。以下はすべてのサポートされているランタイムです:

  • ドッカー
  • ポッドマン
  • KVM
  • ハイパーV
  • ハイパーキット
  • パラレルズ
  • VirtualBox
  • VMware

このガイドを続ける前に、これらの技術がインストールされていることを確認してください。Minikubeのセットアッププロセスは、利用可能なランタイムを自動的に検出し、適切な構成を適用します。デプロイメントを完了し、Minikubeの使用を開始する方法をお見せします。

Minikubeのインストール

このガイドでは、x86 Linux システムに焦点を当てています。Windows、Mac、または他の CPU プラットフォームを使用している場合は、最も詳細なセットアップ情報を得るために Minikube のドキュメントを参照してください。初回のインストール手順の後、Minikube の基本的な使用法はすべてのサポートされているシステムで同じです。

Linuxユーザーは、直接バイナリダウンロードまたはDebian/RPMパッケージの間で選択できます。この例ではバイナリダウンロードを使用します。

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

sudo install minikube-linux-amd64 /usr/local/bin/minikube

Minikubeがインストールされ、使用準備が整いました。

Kubernetesクラスターの開始

次のコマンドminikube startを使ってMinikubeクラスタを起動します:

minikube start

minikube v1.25.2 on Ubuntu 20.04

Automatically selected the docker driver. Other choices: kvm2, ssh

Starting control plane node minikube in cluster minikube

Pulling base image ...

Downloading Kubernetes v1.23.3 preload ...

Minikubeは自動的に最新のKubernetesリリースをダウンロードし、開始します。このプロセスは完了するまで数分かかる場合があります。コマンドの出力は進行状況を示し、Minikubeが行っているアクションを表示します。上の例では、Dockerドライバーがクラスタをホストするために選択されていることがわかります。コンテナプラットフォームや仮想化スタックが自動的に検出されない場合は、Minikubeのドライバーのドキュメントを参照してください。

Kubectlを使用してクラスタを操作する

Minikubeはあなたの環境を変更して、既存のKubectlインストールを使ってクラスタに接続できるようにします。Minikubeクラスタを対象とするminikubeコンテキストをKUBECONFIGファイルに追加します。

Minikubeには、minikube kubectlコマンドを使ってアクセスできるバンドル版のKubectlも含まれています。これは、すでにKubectlがインストールされていない場合や、既存のバイナリがMinikubeクラスタのバージョンと異なる場合に便利です。

Uses the Kubectl version that's bundled with Minikube

minikube kubectl get pods

このガイドの残りの部分では、シンプルなkubectlコマンドを示し、それがあなたのMinikubeクラスターを対象にしていると仮定します。毎回minikubeを接頭辞として使用する必要がないように、MinikubeにバンドルされたKubectlを使用するためのシェルエイリアスを設定できます。

alias kubectl="minikube kubectl"

Minikubeが稼働し、Kubectlが利用可能になったので、Kubernetesクラスターにアプリケーションを追加できるようになりました:

kubectl create deployment nginx --image=nginx:latest

deployment.apps/nginx created

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

service/nginx exposed

この minikube service コマンドは、サービスの公開URLを提供します:

minikube service nginx --url

http://192.168.49.2:31599

ウェブブラウザにURLを貼り付けるか、--urlフラグなしでコマンドを実行してサービスを表示します。

Kubernetesダッシュボードにアクセスする

MinikubeはKubernetesダッシュボードをオプションの統合機能として提供しています。minikube dashboardコマンドを実行してダッシュボードコンポーネントをダウンロードし、新しいブラウザタブでインターフェースを起動します。

ダッシュボードを使用して、リソースを管理し、その活動を可視化することができます。ダッシュボードに対話している間は、ターミナルでminikube dashboardコマンドを実行し続けてください。作業が終了したら、Ctrl+Cキーのシーケンスでコマンドを終了します。

イメージレジストリの有効化

Minikubeにはオプションのアドオンとしてイメージレジストリが含まれています。これにより、コンテナイメージをMinikube内に保存でき、クラスター内でのデプロイメントに利用可能になります。

まず、レジストリアドオンを有効にしてください。

minikube addons enable registry

次に、画像にタグを付けてMinikubeレジストリを参照するようにします。レジストリは、minikube ipコマンドによって提供されるIPアドレスのポート5000で待機しています。

docker tag my-image:latest $(minikube ip):5000/my-image:latest

プッシュする前に、Dockerを設定してURLを不正なレジストリとして受け入れる必要があります。それを、あなたの/etc/docker/daemon.jsonファイル内のinsecure-registriesフィールドに追加してください。これにより、DockerはHTTPアクセスを許可します。

{

"insecure-registries": ["192.168.49.2:5000"]

}

自分のminikube ipコマンドで表示されたIPアドレスに置き換えてください。systemctl restart dockerコマンドでDockerを再起動します。

今、あなたは自分のイメージをMinikubeレジストリにプッシュできます:

docker push $(minikube ip):5000/my-image:latest

クラスター内のポッドがこのイメージを使用する前に、最終的なステップが必要です。Minikubeのコンテナランタイムもレジストリへの非安全なアクセスを許可するように構成する必要があります。これを有効にするには、minikube startを実行する際に--insecure-registryフラグを含めてください。IPアドレスは、MinikubeインストールのデフォルトのクラスターIPを指す必要があります。これは、kubectl get servicesを実行して、kubernetesサービスのCLUSTER-IPを確認することで取得できます。その後、Minikubeを停止し、追加のフラグを付けて再起動してください。

kubectl get service

NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE

kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 63m

minikube stop

minikube start --insecure-registry 10.96.0.1/24

Kubernetesのバージョンを変更する

Minikubeはデフォルトで最新のKubernetesリリースを使用します。特定のバージョンに切り替えるには、クラスターを起動するときに--kubernetes-versionフラグを含めてください:

minikube start --kubernetes-version=v1.23.0

複数の異なるKubernetesバージョンを持つクラスターを同時に実行することができ、いくつかの異なるプロファイルを作成することで実現できます。--profileフラグは、特定のコマンドのターゲットとなるプロファイルを選択します。

minikube start --profile v1.22 --kubernetes-version=v1.22.0

minikube start --profile v1.23 --kubernetes-version=v1.23.0

minikube --profile v1.22 kubectl get pods

複数のノードを使用する

Minikubeは複数の仮想ノードをサポートしています。これにより、新しい物理ハードウェアをデプロイすることなく、アプリケーションが利用可能なノード全体でスケールする方法をテストできます。

この例では、3つのノードを持つクラスタを作成します。

minikube start --nodes 3

複数のノードが利用可能であることを、Kubectlでリストすることで確認できます。

kubectl get nodes

NAME STATUS ROLES AGE VERSION

minikube Ready control-plane,master 71m v1.23.3

minikube-m02 Ready <none> 71m v1.23.3

minikube-m03 Ready <none> 71m v1.23.3

リモートアクセスの有効化

Minikubeはデフォルトでの受信トラフィックを受け付けません。これはローカル用途向けに設計されており、外部リクエストに応じるための保護が施されていません。それでも、コントロールプレーンのリッスンアドレスを変更することで、クラスター内のワークロードへのリモートアクセスを有効にすることができます。リスクを十分に評価した後にのみこれを行ってください - あなたのネットワークは外部世界にさらされることになります。

minikube start --listen-address=0.0.0.0

ポートフォワーディングは、特定のサービスへのアクセスを開く必要があるときに、より安全なソリューションです。Kubectlのport-forwardコマンドを使用して、ホストポートからサービスのいずれかへのルートを作成します:

kubectl port-forward service/nginx 8080:80

今、localhost:8080にアクセスして、このガイドで以前に作成したNGINXサービスに訪問できます。ホストのポート8080はサービスのポート80にバインドされています。

Minikubeを削除する

Minikubeの利点の一つは、その削除の簡単さです。もしMinikubeがあなたに合わないと判断した場合は、deleteコマンドを実行して、システムに追加されたすべてのものを削除してください:

minikube delete

より破壊的でないオプションは minikube stop で、これによりクラスタが停止しますが、すべてのリソースはそのまま残ります。 minikube start コマンドを使用してクラスタを再起動できます。

結論

Minikubeは、コンテナまたは仮想化を使用してローカルマシン上でクラスターを実行する自己完結型のKubernetesディストリビューションです。これは、上流のKubernetesプロジェクトによってサポートされています。Minikubeは、Kubernetesダッシュボード、ネットワーキングサポート、永続ストレージ、および交換可能なコンテナランタイムをバンドルした、機能が完全なKubernetesの実装です。

Minikubeについては公式ドキュメントで詳しく学ぶことができます。また、慣れ親しんだKubectlコマンドを使用してクラスターを管理し、新しいワークロードを展開することもできます。これで、アプリケーションを構築およびテストするための完全に機能するローカルKubernetes環境が整いました。

関連記事: