無料ツール
Docker Compose を Kubernetes に変換
compose.yaml か docker-compose.yml を貼り付けて「変換」を選んでください。各サービスが Deployment に、公開ポートが Service に、環境変数が ConfigMap と Secret に移り、名前付きボリュームには PersistentVolumeClaim が付きます。YAML を確認して kubernetes.yaml としてダウンロードし、結果を Kubernetes の図として確認できます。
出力例
使い方
Compose ファイルを貼り付ける
アンカーや拡張フィールドも含めて、ファイル全体を貼り付けてください。version の行や x- ブロックがあってもかまいません。
「変換」を選び、値の扱いを決める
既定は「名前だけ」で、値は出力に一切入りません。秘密に見えない値をコピーしたいときは「値を残す」に切り替えます。
確認、ダウンロード、または開く
印の付いた値を入力し、kubernetes.yaml をダウンロードするか、図を Archboard で開きます。登録には Google か GitHub のアカウントを使います。
生成される Kubernetes オブジェクト
- Compose のサービスごとに 1 つの Deployment。イメージ、コンテナーのポート、リソース制限、deploy.replicas のレプリカ数を持ちます。ラベルとセレクターには app: とサービス名を使います。
- ポートを公開している Compose のサービスごとに 1 つの Service。port は公開ポート、targetPort はコンテナーのポートです。各ポートには tcp-8080 のような名前が付きます。
- 環境変数は分けて出力します。普通の設定は ConfigMap に、パスワード、トークン、キーに見える名前は Secret に入れます。トップレベルの secrets は、仮の値を持つ Secret オブジェクトになります。
- トップレベルで宣言され、サービスが使っている名前付きボリュームごとに PersistentVolumeClaim を作り、コンテナー内の同じパスにマウントします。
出力は最初の下書きとして扱う
マニフェストは読んで仕上げるためのもので、確認せずに適用するものではありません。Secret の値は REPLACE_ME、空の ConfigMap の値には set value のコメントが付き、ボリューム要求はすべて adjust size のコメント付きで 1Gi を要求します。ヘルスチェックは not converted として印が付くので、プローブ、ストレージクラス、Ingress、名前空間はご自身で設定してください。概要には、まだ入力が必要な値の数が表示されます。
Compose から Kubernetes へのコンバーターが扱わないもの
- Helm チャート、Kustomize のオーバーレイ、テンプレート。出力は、複数のドキュメントを含む普通の YAML ファイル 1 つです。
- ポートを公開していないコンテナーの Service。expose だけを使うサービスや、ポートのないサービスには Service を作りません。ほかのサービスが名前で呼び出している場合は、手動で追加すべきものを警告で示します。
- バインドマウント、tmpfs マウント、匿名ボリューム。警告で数え、hostPath ボリュームは作りません。
- イメージのビルドと depends_on の順序。build セクションしかないサービスには仮のイメージ名を入れ、depends_on は Deployment の上に not converted として印を付けます。
「名前だけ」と「値を残す」
「名前だけ」は変数名だけをコピーし、値、コマンド、エントリーポイントを出力しません。そのため、本物の認証情報を含む Compose ファイルでも出力には入りません。「値を残す」は普通の値を ConfigMap にコピーし、command と entrypoint を args と command に移します。パスワード、トークン、キーに見える名前は、どちらのモードでも REPLACE_ME になります。
Compose から Kubernetes への変換についての質問
各 Deployment のレプリカ数はいくつになりますか?
レプリカ数は Compose ファイルの deploy.replicas から取ります。指定のないサービスは 1 レプリカです。deploy.resources の CPU とメモリーの制限も引き継ぎ、512m のようなメモリーの単位は 512Mi に変換します。
出力にすぐ kubectl apply を実行できますか?
確認してからにしてください。REPLACE_ME をすべて置き換え、空の ConfigMap の値を入力し、ボリュームのサイズを決め、警告に挙がった Service を追加します。ファイルは普通の Kubernetes YAML なので、完成すれば適用することも、分割することも、Helm チャートにすることもできます。
Kubernetes で使えないサービス名はどうなりますか?
名前は小文字にし、Kubernetes の命名規則に合うよう短くします。オブジェクト間の参照には調整後の名前を使います。変更した名前の数は警告で数えるので、適用する前に確認できます。
図を Archboard で開くとどうなりますか?
プレビューは保存されません。「Archboard で開く」を選ぶと、生成したオブジェクトの図が新しい図としてワークスペースに保存され、並べ替え、注釈の追加、共有ができます。kubernetes.yaml 自体は保存されないので、ページを離れる前にコピーするかダウンロードしてください。
Compose から Kubernetes へのコンバーターは無料ですか?
はい。ファイルの変換、マニフェストのコピー、SVG や PNG での図のダウンロードにアカウントは不要です。図を Archboard で開くには無料のアカウントが必要です。