CanineでKubernetesへgit pushデプロイする

KubernetesにPaaSの操作面を置く

READMEはCanineを、KubernetesインフラにPaaS（Herokuのような）の単純さをもたらすセルフホスト型デプロイプラットフォームと説明しています。リポジトリメタデータの一言は'Kubernetesのための開発者に優しいPaaS'です。READMEによると、git pushでアプリケーションをデプロイし、直感的なWebインターフェースでサービスを管理し、YAMLを書かずにKubernetesの能力を活用できます。プロジェクトはRubyで実装されており、これはリポジトリメタデータからわかりますが、README自体はコードベースの内部構造について触れていません。

CanineはHerokuのような単純さを自分のKubernetes基盤へ持ち込むセルフホストPaaSとしてREADMEに説明されています。Web UIからアプリをデプロイ、スケール、管理し、通常の操作で複雑なマニフェストを直接書かずに済ませる方向です。一方、Kubernetesクラスタ、Docker、ドメイン、証明書の運用責任が消えるわけではありません。

Git webhookからイメージを作る

git駆動のデプロイが中心的なワークフローです。READMEはGitHubまたはGitLabリポジトリを接続すると、プッシュのたびにCanineが自動デプロイすると述べています。Dockerイメージをビルドし、デプロイパイプライン全体を処理します。機能表には'GitHub/GitLabからの継続デプロイのためのGit webhook統合'と'Dockerfileまたはbuildpacksを使った自動Dockerイメージビルド'とあります。READMEはまた、Webサービス、バックグラウンドワーカー、スケジュールされたcronジョブの3種類のサービスをデプロイできると説明しています。Webhookの設定手順はREADMEには書かれておらず、ドキュメントサイトはdocs.canine.shとリンクされています。

GitHubまたはGitLabのリポジトリを接続し、pushごとにDockerfileまたはbuildpacksでイメージを作ってデプロイする流れが中心です。READMEはWebhookの詳細な設定手順や失敗時の再試行条件を説明していません。最初はテスト用リポジトリを使い、commit、ビルドログ、生成イメージ、Podの状態を対応付けます。

Web、worker、cronを分ける

デプロイ以外にも、READMEの機能表には以下が挙げられています：CPU、メモリ、GPUのリソース制約。DNS統合と自動SSLを備えたカスタムドメイン管理。環境変数とKubernetes secrets管理。ステートフルアプリケーションのための永続ボリューム管理。アカウントベースのマルチテナンシーで、チームコラボレーションとアクセス制御をサポート。YAMLで書かれたカスタムKubernetes podテンプレート。そしてSAML、OIDC、LDAPをサポートするエンタープライズSSO。READMEはこれらの機能の使用例やスクリーンショットを提供しておらず、リポジトリにはデプロイのスクリーンショットが1枚だけ含まれています。

サービス種別としてWeb service、background worker、scheduled cron jobが機能表にあります。HTTPポートを公開するプロセスと定期処理を同じ設定だと考えず、終了コード、再実行、ログ保持、同時実行数を確認します。READMEにない既定のリソースやタイムアウトは、クラスタの実設定で確かめます。

リソース、Secrets、永続化

インストールには2つの明示された要件があります：Docker v24.0.0以上、Docker Compose v2.0.0以上。クイックパスはcurlコマンド1つです：`curl -sSL https://canine.sh/install.sh | bash`。手動パスはリポジトリをクローンし、生成されたシークレットキーを含む`.env`ファイルを作成してDocker Composeを実行します：`git clone https://github.com/CanineHQ/canine.git`、`cd canine`、`echo "SECRET_KEY_BASE=$(openssl rand -hex 64)" > .env`、そして`docker compose up -d`。その後、ブラウザで`http://localhost:3000`を開きます。READMEはまた、`PORT`環境変数を指定してWeb UIポートを変更する例として`PORT=3456 docker compose up -d`を示しています。install.shスクリプトの内容はREADMEにはありません。

CPU、メモリ、GPUの制約、カスタムドメイン、DNS統合、自動SSL、環境変数、Kubernetes secrets、永続ボリューム、カスタムPodテンプレートが列挙されています。機能表は対応範囲の宣言であり、各クラウドのLBやStorageClassとの互換性を示すものではありません。実クラスタでは一つずつ適用結果を確認します。

Docker Composeで起動する

READMEは、小規模チーム向けに追加機能を提供する有料製品Canine Cloudを説明しています：GitHub統合、ロールベースのアクセス制御によるチームコラボレーション、リアルタイムのメトリクス追跡と監視、そしてメンテナンスの軽減。価格情報についてはランディングページhttps://canine.sh を案内しています。READMEは、これらのクラウド機能のうちどれがセルフホスト版にもあるか（ある場合）、また無料版の制限について述べていません。

要件はDocker 24.0.0以上とDocker Compose 2.0.0以上です。Quick Installはcurl -sSL https://canine.sh/install.sh | bash、手動経路はclone後にSECRET_KEY_BASEを生成してdocker compose up -d、既定UIはhttp://localhost:3000です。PORT=3456 docker compose up -dでUIポートを変える例もあります。

Cloud版とセルフホスト版

CanineはApache 2.0ライセンスでリリースされています。ライセンス本文は、複製、派生作品の作成、公開表示、公開上演、サブライセンス、配布を許可する、永続的、世界的、非独占的、無償、ロイヤリティフリー、取消不能の著作権ライセンスを付与します。また、セクション3の条件に従って特許ライセンスも付与します。READMEは、商用・非商用問わず自由に使用、変更、配布できると述べ、詳細はLICENSEファイルを参照するよう指示しています。ライセンス本文は、保証、サポート、セキュリティ保証については何も述べておらず、それらは付与の範囲外です。

Canine Cloudは小規模チーム向けにGitHub連携、ロールベースの協業、リアルタイムメトリクス、保守負担の軽減を追加するとREADMEにあります。セルフホスト版との機能差、価格、運用データの所在はREADMEだけでは確定しません。Cloudの説明を自前クラスタの保証として扱わないようにします。

最初のデプロイを隔離して測る

この記事の執筆に使ったリポジトリメタデータには、2,911スター、118フォーク、47の未解決issueがあります。デフォルトブランチは`main`、プロジェクトはRubyで書かれ、リポジトリはアーカイブされていません。READMEにはバージョン番号、リリース頻度、変更履歴の記載はありません。ベンチマーク、稼働時間統計、セキュリティ監査結果もありません。これらの数値が必要な場合、READMEとライセンスは根拠を提供しないため、プロジェクトのリリースノートやissueトラッカーから得るしかありません。

導入前はDockerとComposeの版を固定し、手動経路でlocalhost:3000を起動してテスト用アプリを一つ登録します。Git pushからビルド、Pod起動、環境変数、Secrets、永続ボリューム、PORT変更を順に観察し、DNSとSSLを本番ドメインへ向ける前にログと権限を確認します。ライセンスはApache-2.0です。

編集部の結論

CanineでKubernetesへgit pushデプロイするは、READMEに示された構成を自分の環境で検証できる開発者やチームに向きます。文書だけで性能、互換性、運用上の安全性まで保証されたと考える利用者には向きません。導入前に、この記事で挙げた固有のコマンドと入力を小さな隔離環境で実行し、ログ、出力、失敗時の状態を記録してから対象範囲を広げてください。

公式情報源

1. Official documentation
2. Official README
3. Project repository