正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

クラウドSeed

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

クラウドSeedは、GitLabがGoogle Cloudと連携して主導するオープンソースプログラムです。

クラウドSeedは、Herokuのような使いやすさと、ハイパークラウドの柔軟性を兼ね備えています。これは、OAuth 2を使用して、TerraformとInfrastructure as Codeを基盤とするハイパークラウド上にサービスをプロビジョニングし、2日目の運用を可能にすることで実現しています。

目的

GitLabから主要なクラウドプロバイダーにWebアプリケーション(およびその他のワークロード)をデプロイすることは簡単であるべきだと考えています。

この取り組みをサポートするために、クラウドSeedを使用すると、GitLabで適切なGoogle Cloudサービスを簡単かつ直感的に利用できます。

Google Cloudを選ぶ理由

または、AWSやAzureを使用しないのはなぜですか?

クラウドSeedは、誰でも拡張できるオープンソースプログラムであり、主要なクラウドプロバイダーと協力したいと考えています。Google Cloudのチームはアクセスしやすく、協力的であり、この取り組みに協力的なため、Google Cloudと協力することを選択しました。

オープンソースプロジェクトとして、誰でもコントリビュートして、私たちの方向性を形作ることができます。

Cloud Runへのデプロイ

GitLabプロジェクトにWebアプリケーションがある場合は、次の手順に従って、クラウドSeedを使用してGitLabからGoogle Cloudにアプリケーションをデプロイします:

  1. デプロイメント認証情報を設定する
  2. (オプション)優先GCPリージョンを構成する
  3. Cloud Runデプロイメントパイプラインを構成する

デプロイメント認証情報を設定する

クラウドSeedは、GitLabプロジェクトからGoogle Cloud Platform(GCP)サービスアカウントを作成するためのインターフェースを提供します。関連付けられたGCPプロジェクトは、サービスアカウントの作成ワークフロー中に選択する必要があります。このプロセスにより、サービスアカウント、キー、およびデプロイメント権限が生成されます。

サービスアカウントを作成するには:

  1. Project :: Infrastructure :: Google Cloudページに移動します。
  2. Create Service Account(サービスアカウントの作成)を選択します。
  3. Google OAuth 2のワークフローに従い、GitLabを承認します。
  4. GCPプロジェクトを選択します。
  5. 選択したGCPプロジェクトのGit参照(ブランチやタグなど)を関連付けます。
  6. フォームを送信して、サービスアカウントを作成します。

生成されたサービスアカウント、サービスアカウントキー、および関連付けられたGCPプロジェクトIDは、GitLabにプロジェクトCI変数として保存されます。これらは、Project :: Settings :: CIページで確認および管理できます。

生成されたサービスアカウントには、次のロールがあります:

  • roles/iam.serviceAccountUser
  • roles/artifactregistry.admin
  • roles/cloudbuild.builds.builder
  • roles/run.admin
  • roles/storage.admin
  • roles/cloudsql.client
  • roles/browser

CI変数をシークレットマネージャーに保存することで、セキュリティを強化できます。詳細については、GitLabでのシークレットの管理を参照してください。

優先GCPリージョンを構成する

デプロイメント用にGCPリージョンを構成すると、提供されるリージョンのリストは、利用可能なすべてのGCPリージョンのサブセットになります。

リージョンを構成するには:

  1. Project :: Infrastructure :: Google Cloudページに移動します。
  2. Configure GCP Region(GCPリージョンの構成) を選択します。
  3. 優先GCPリージョンを選択します。
  4. 選択したGCPリージョンのGit参照(ブランチやタグなど)を関連付けます。
  5. フォームを送信して、GCPリージョンを構成します。

構成されたGCPリージョンは、GitLabにプロジェクトCI変数として保存されます。これらは、Project :: Settings :: CIページで確認および管理できます。

Cloud Runデプロイメントパイプラインを構成する

パイプラインでGoogle Cloud Runデプロイメントジョブを構成できます。このようなパイプラインの一般的なユースケースは、Webアプリケーションの継続的デプロイです。

プロジェクトパイプライン自体は、ビルド、テスト、セキュアなど、いくつかのステージングにまたがる、より広範な目的を持つ可能性があります。したがって、Cloud Runデプロイメントの提供は、はるかに大きなパイプラインに適合する1つのジョブとしてパッケージ化されています。

Cloud Runデプロイメントパイプラインを構成するには:

  1. Project :: Infrastructure :: Google Cloudページに移動します。
  2. Deploymentsタブに移動します。
  3. Cloud Runで、マージリクエスト経由で設定を選択します。
  4. 変更を確認して送信し、マージリクエストを作成します。

これにより、Cloud Runデプロイメントパイプライン(または既存のパイプラインに挿入)を持つ新しいブランチが作成され、変更とデプロイメントパイプラインの実行を確認してメインブランチにマージできる、関連付けられたマージリクエストが作成されます。

Cloud SQLデータベースをプロビジョニングする

Project :: Infrastructure :: Google Cloudページから、リレーショナルデータベースインスタンスをプロビジョニングできます。Cloud SQLは、データベースインスタンスをプロビジョニングするために使用される基盤となるGoogle Cloudサービスです。

次のデータベースとバージョンがサポートされています:

  • PostgreSQL: 14、13、12、11、10、および9.6
  • MySQL: 8.0、5.7、および5.6
  • SQL Server
    • 2019: Standard、Enterprise、Express、Web
    • 2017: Standard、Enterprise、Express、Web

Google Cloudの料金が適用されます。Cloud SQLの料金ページを参照してください。

  1. データベースインスタンスを作成する
  2. バックグラウンドワーカーによるデータベース設定
  3. データベースに接続する
  4. データベースインスタンスを管理する

データベースインスタンスを作成する

Project :: Infrastructure :: Google Cloudページで、Database(データベース) タブを選択します。ここでは、Postgres、MySQL、およびSQL Serverデータベースインスタンスを作成するための3つのボタンがあります。

データベースインスタンスの作成フォームには、GCPプロジェクト、Git参照(ブランチまたはタグ)、データベースバージョン、およびマシンタイプのフィールドがあります。送信すると、データベースインスタンスが作成され、データベースのセットアップがバックグラウンドジョブとしてキューに入れられます。

バックグラウンドワーカーによるデータベース設定

データベースインスタンスの作成が成功すると、バックグラウンドワーカーがトリガーされ、次のタスクが実行されます:

  • データベースユーザーを作成する
  • データベーススキーマを作成する
  • プロジェクトのCI/CD変数にデータベースの詳細を保存する

データベースに接続する

データベースインスタンスのセットアップが完了すると、データベース接続の詳細がプロジェクト変数として使用可能になります。これらは、Project :: Settings :: CIページから管理でき、適切な環境で実行されるパイプラインで使用できるようになります。

データベースインスタンスを管理する

Project :: Infrastructure :: Google Cloud :: Databasesのインスタンスのリストは、Google Cloudコンソールにリンクで戻ります。インスタンスを選択して、詳細を表示し、インスタンスを管理します。

クラウドSeedにコントリビュートする

クラウドSeedにコントリビュートできる方法はいくつかあります:

  • クラウドSeedを使用し、フィードバックを共有します。
  • Ruby on RailsまたはVue.jsに精通している場合は、デベロッパーとしてGitLabにコントリビュートすることを検討してください。
    • クラウドSeedの多くは、GitLabコードベースの内部モジュールです。
  • GitLabパイプラインに精通している場合は、クラウドSeedライブラリプロジェクトにコントリビュートすることを検討してください。