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

Civo Kubernetesクラスターの作成

すべての新しいCivoアカウントは、Civo KubernetesとのGitLabインテグレーションを開始するために250ドルのクレジットを受け取ります。マーケットプレイスアプリを使用して、Civo KubernetesクラスターにGitLabをインストールすることもできます。

Infrastructure as Code（IaC）を使用してCivo Kubernetesに新しいクラスターを作成する方法をご覧ください。このプロセスでは、CivoおよびKubernetes Terraformプロバイダーを使用して、Civo Kubernetesクラスターを作成します。Kubernetes向けGitLabエージェントを使用して、クラスターをGitLabに接続します。

はじめる前:

ステップ:

  1. サンプルプロジェクトをインポートする。
  2. Kubernetes用エージェントを登録します。
  3. プロジェクトを設定する。
  4. クラスターをプロビジョニングする。

サンプルプロジェクトをインポートする

Infrastructure as Codeを使用してGitLabからクラスターを作成するには、クラスターを管理するためのプロジェクトを作成する必要があります。このチュートリアルでは、サンプルプロジェクトから開始し、必要に応じて変更します。

URLでサンプルプロジェクトをインポートすることから始めましょう。

プロジェクトをインポートするには:

  1. GitLabの左側のサイドバーで、検索または移動先を選択します。
  2. すべてのプロジェクトを表示を選択します。
  3. ページの右側で、新規プロジェクトを選択します。
  4. プロジェクトのインポートを選択します。
  5. リポジトリのURLを選択します。
  6. GitリポジトリのURLには、https://gitlab.com/civocloud/gitlab-terraform-civo.gitを入力してください。
  7. フィールドに入力し、プロジェクトを作成を選択します。

このプロジェクトでは、以下を使用できます:

エージェントを登録する

Kubernetes向けGitLabエージェントを作成するには:

  1. 左側のサイドバーで、操作 > Kubernetesクラスターを選択します。
  2. クラスターに接続を選択します。
  3. Select an agent（エージェントを選択）ドロップダウンリストから、civo-agentを選択し、登録するを選択します。
  4. GitLabは、エージェントのエージェントアクセストークンを生成します。このシークレットトークンは、後で必要になるため、安全に保管してください。
  5. GitLabは、エージェントサーバー（KAS）のアドレスを提供します。これも後で必要になります。

プロジェクトを設定する

CI/CD環境変数を使用して、プロジェクトを設定します。

Required configuration（必要な設定）:

  1. 左側のサイドバーで、設定 > CI/CDを選択します。
  2. 変数を展開します。
  3. CIVO_TOKEN変数をCivoアカウントからのトークンに設定します。
  4. TF_VAR_agent_token変数を、前のタスクで受信したエージェントトークンに設定します。
  5. TF_VAR_kas_address変数を、前のタスクのエージェントサーバーアドレスに設定します。

必要な設定

Optional configuration（オプションの設定）:

ファイルvariables.tfには、必要に応じてオーバーライドできる他の変数が含まれています:

  • TF_VAR_civo_region: クラスターのリージョンを設定します。
  • TF_VAR_cluster_name: クラスターの名前を設定します。
  • TF_VAR_cluster_description: クラスターの説明を設定します。Civoクラスターの詳細ページでGitLabプロジェクトへの参照を作成するには、この値を$CI_PROJECT_URLに設定します。この値は、Civoダッシュボードに表示されるクラスターのプロビジョニングを担当したプロジェクトを特定するのに役立ちます。
  • TF_VAR_target_nodes_size: クラスターに使用するノードのサイズを設定します
  • TF_VAR_num_target_nodes: Kubernetesノードの数を設定します。
  • TF_VAR_agent_version: Kubernetes向けGitLabエージェントのバージョンを設定します。
  • TF_VAR_agent_namespace: Kubernetes向けGitLabエージェントのKubernetesネームスペースを設定します。

その他のリソースオプションについては、Civo TerraformプロバイダーおよびKubernetes Terraformプロバイダーのドキュメントを参照してください。

クラスターをプロビジョニングする

プロジェクトを設定した後、手動でクラスターのプロビジョニングをトリガーします。GitLabで、次の手順を実行します:

  1. 左側のサイドバーで、ビルド > パイプラインを選択します。
  2. パイプラインを新規作成を選択します。
  3. パイプラインの実行を選択し、リストから新しく作成したパイプラインを選択します。
  4. デプロイジョブの横にあるManual action（手動アクション）（ status_manual ）を選択します。

パイプラインが正常に終了すると、新しいクラスターが表示されます:

  • Civoダッシュボード内：Kubernetesタブ。
  • GitLabの場合：プロジェクトのサイドバーから、操作 > Kubernetesクラスターを選択します。

TF_VAR_civo_region変数を設定しなかった場合、クラスターは「lon1」リージョンに作成されます。

クラスターを使用する

クラスターをプロビジョニングすると、GitLabに接続され、デプロイの準備ができます。接続を確認するには:

  1. 左側のサイドバーで、操作 > Kubernetesクラスターを選択します。
  2. リストで、接続ステータス列を表示します。

接続の機能の詳細については、Kubernetes向けGitLabエージェントのドキュメントを参照してください。

クラスターを削除する

クリーンアップジョブは、デフォルトでパイプラインに含まれています。

作成されたすべてのリソースを削除するには:

  1. 左側のサイドバーで、ビルド > パイプラインを選択し、最新のパイプラインを選択します。
  2. destroy-environment（環境を削除）ジョブの横にあるManual action（手動アクション）（ status_manual ）を選択します。

Civoのサポート

このCivoインテグレーションはCivoによってサポートされています。Civoサポートにサポートリクエストを送信してください。