minikubeの設定・起動

ホストディレクトリのmount

MacOSなどのホストディレクトリにコンテナからアクセスするには、起動時の--mountオプションが手軽です。

$ minikube start --mount --mount-string /path/to/localDir:/minikube_dir

minikubeのアーキテクチャは、ホストPC / minikube VM / コンテナOSの3層構造になっており、コンテナ起動時のvolumes.hostPath設定ではminikubeVMのPathを参照します。

複数のPathを参照する場合、--mount-stringには最上位のディレクトリを1つ指定するため、ディレクトリ構成を工夫することが事実上必要になりそうです。

ホストディレクトリの参照を確認したい場合には、minikube sshコマンドでminikube VMのレイヤにログインできるため、この環境でlsすると良いでしょう。

ただし、 Directories provisioned by hostPath provisioner are only writeable by root が現状オープンであるとおり、minikubeのhostPathはパーミッション設定に難があります。
マウントしたディレクトリ内のファイルオーナーのUID, GIDがホストの番号になっているため、コンテナ上のUIDと一致しないのです。

コンテナ上のプロセスがrootであればファイルパーミッションを超越して読み書き可能ですが、DBMSなど一般ユーザーによる書き込みの必要なvolumeの利用ケースでホストOS上にファイルを置きたい場合、まだ適切なサポートがない状況のようです。

※ minikube VM上にファイルを置く構成であればコンテナ起動時にsecurityContext.privileged: trueを指定すると動作します。minikube VM上のファイルオーナーがコンテナ上のUIDになります。

minikubeのVM設定

minikubeの起動時デフォルト設定は、minikube configで設定可能で、~/.minikube/config/config.jsonに記録されています。

config.jsonに記録された設定はminikube config viewで確認でき、minikube startのオプション指定を省略可能です。

$ minikube config set memory 8192
$ minikube config set cpus 2
These changes will take effect upon a minikube delete and then a minikube start

minikube v0.26.0以前では、vm-driverオプションがhyperkitをサポートしておらず、setするとエラーになりますが、~/.minikube/config/config.jsonに直接記載すると機能します。

プロファイル切り替え

minikubeはprofile機能を通じて、独立した環境を提供しています。
minikube start -p profile_nameでプロファイルを切り替え可能です。オプション無指定時のデフォルトプロファイル名はminikubeです。
プロファイル別の設定は、~/.minikube/profiles/にあります。

ただし、minikube v0.26.0で確認した範囲では、プロファイルを指定すると一度も起動しない、という事象に遭遇しています。

クラッシュ後に起動しなくなった際のリセット方法

特定のプロファイルがクラッシュした後に起動しなくなった場合、ホスト仮想マシンのイメージが破損していることがあります。

プロファイル別の仮想マシンイメージは~/.minikube/machinesディレクトリにプロファイル別にあります。
不調なイメージのディレクトリをリネーム(完全に不要ならminikube deleteで削除)すると、次回そのプロファイルでminikube startした際にイメージ新規作成から開始します。

インストール

MacOSでもVMより透過的でレスポンスの速い環境を利用できます。

minikube起動に必要なコンポーネントは以下のとおりです。

  • dockerランタイム: Docker for Mac
  • kubectl: Google Cloud SDK由来、またはhomebrewでインストール
  • minikube: minikubeをインストール
  • Linux仮想環境ドライバー: hyperkit-driverをインストール

minikubeのインストールは、 公式チュートリアル に掲載されているとおり、コマンドをcurlでネットワーク取得して配置するだけです。

必要なファイルが揃ったら、minikube startでクラスタを起動できます。
初回起動の際に、150MB程度のISOイメージとkube-systemのコンテナイメージを自動ダウンロードして立ち上がります。

$ minikube start --vm-driver=hyperkit --cpus 2 --memory 8192
Starting local Kubernetes v1.10.0 cluster...
Starting VM...
Downloading Minikube ISO
 150.53 MB / 150.53 MB [============================================] 100.00% 0s
Getting VM IP address...
Moving files into cluster...
Downloading kubeadm v1.10.0
Downloading kubelet v1.10.0
Finished Downloading kubelet v1.10.0
Finished Downloading kubeadm v1.10.0
Setting up certs...
Connecting to cluster...
Setting up kubeconfig...
Starting cluster components...
Kubectl is now configured to use the cluster.
Loading cached images from config file.

この時点でkubectlのコンテキストがminikubeを指しているので、nodeを確認するとminikubeがnodeとして起動していることが分かります。

$ kubectl get nodes
NAME       STATUS    ROLES     AGE       VERSION
minikube   Ready     master    43s       v1.10.0

ここまで来たら、あとは一般的なkubernetesの運用と変わりません。

まとめ

すでにdockerを利用している環境であれば、クラスタ構築といっても管理コマンドとドライバを計2ファイルコピーするだけで立ち上がるため、セットアップは驚異的に手軽と言えます。

これまで、コンテナベースでWebサービスの環境を用意するとなると、productionは kubernetes、dev環境は Docker Compose という不揃いな環境になりがちでした。
minikubeを活用すると、コンテナ操作をkubectlに統一し定義ファイルもkubernetesベースに統一できるため管理コストが下がります。

逆にdockerにも、kubernetesを操作するメタコマンドが導入されたのですが、dockerの基礎的なコマンドではなくDocker Swarmベースであるため「Swarmで環境を統一する」と決めたプロジェクト以外では利用しづらい面があります。

kubernetesとdockerを比較すると、Google Kubernetes EngineやAmazon EKSなど、productionの選択肢でkubernetesが圧勝したため、Appサーバ+RDBMSといった複数コンテナのネットワーク構成では、kubernetesを採用する方が合理的な情勢と言えるでしょう。

⁋ 2018/04/20↻ 2026/10/08