クイックスタート: リポジトリから構成ファイルを同期する

このチュートリアルでは、Google Kubernetes Engine（GKE）Enterprise エディションのクラスタを作成し、Config Sync を使用してマルチリポジトリ サンプル リポジトリの構成ファイルを同期します。

たとえば、コンプライアンス チームは、組織内の全員が内部ルールに従うようにすることが任務であるとします。その内部ルールを適用するために、コンプライアンス チームでは、構成ファイルを作成して、サンプル リポジトリに追加しました。組織内の各クラスタは、そのリポジトリと同期する必要があり、お客様がクラスタの作成と同期を担当しているとします。

始める前に

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. Make sure that you have the following role or roles on the project: GKE Hub Admin

    Check for the roles

    1. In the Google Cloud console, go to the IAM page.

      Go to IAM
    2. Select the project.

    3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

    4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

    Grant the roles

    1. In the Google Cloud console, go to the IAM page.

      IAM に移動
    2. プロジェクトを選択します。
    3. [ アクセスを許可] をクリックします。

    4. [新しいプリンシパル] フィールドに、ユーザー ID を入力します。 これは通常、Google アカウントのメールアドレスです。

    5. [ロールを選択] リストでロールを選択します。
    6. 追加のロールを付与するには、 [別のロールを追加] をクリックして各ロールを追加します。
    7. [保存] をクリックします。

      8. クラスタを作成する

      このセクションでは、このチュートリアルで使用できるクラスタを作成します。実際には、複数のクラスタを管理することをおすすめしますが、このチュートリアルでは、クラスタを 1 つだけ作成して管理します。

      クラスタを作成するには、次の手順を完了します。

      1. Google Kubernetes Engine（GKE）Enterprise エディション API を有効にします。これは Config Sync に不可欠です。

        Google Kubernetes Engine（GKE）Enterprise エディションに移動

      2. Google Cloud コンソールで、[Kubernetes Engine] ページに移動します。

        Google Kubernetes Engine に移動

      3. [ 作成] をクリックします。

      4. [Autopilot] セクションで、[構成] を選択します。

      5. [クラスタの基本] セクションで、[名前] フィールドに「cs-cluster」と入力します。

      6. [クラスタの階層] セクションで、[エンタープライズ階層] を選択します。他のフィールドは、すべて推奨されたデフォルトのままにしておきます。

      7. [作成] をクリックします。[Kubernetes クラスタ] ページが表示されます。クラスタの作成には数分かかります。クラスタの横にある [ステータス] 列に緑色のチェックマークが表示されたら、準備完了です。

      クラスタを構成する

      クラスタが作成されたため、サンプル リポジトリの config-sync-quickstart ディレクトリの構成ファイルと同期するように Config Sync を構成できます。

      Google Cloud コンソールで Config Sync を構成するには、次の手順を完了します。

      1. Google Cloud コンソールで、[機能] セクションの [構成] ページに移動します。

        [構成] に移動

      2. [ Config Sync のインストール] をクリックします。
      3. [自動アップグレード] を選択して、Config Sync がバージョンを自動的にアップグレードできるようにします。
      4. [インストール オプション] で、[個別のクラスタに Config Sync をインストールする] を選択します。
      5. [使用可能なクラスタ] テーブルで、cs-cluster を選択し、[Config Sync をインストールする] をクリックします。数分後に、[設定] タブで cs-cluster のステータスが [有効] として表示されます。
      6. Config Sync ダッシュボードで、[クラスタ パッケージをデプロイ] をクリックします。
      7. [パッケージ デプロイのクラスタの選択] テーブルで、cs-cluster を選択し、[続行] をクリックします。
      8. [Git でホストされているパッケージ] を選択したままにして、[続行] をクリックします。
      9. [パッケージ名] フィールドに「sample-repository」と入力します。
      10. [リポジトリの URL] フィールドに「https://github.com/GoogleCloudPlatform/anthos-config-management-samples」と入力します。
      11. [パス] フィールドに「config-sync-quickstart/multirepo/root」と入力します。
      12. 他のフィールドはデフォルト値のままにしておきます。

      13. [パッケージをデプロイ] をクリックします。

        数分後、cs-cluster の [同期ステータス] 列に「同期済み」と表示されます。

      以上で Config Sync がリポジトリと同期し、常にクラスタの状態をリポジトリの構成ファイルに一致させるようになります。

      パッケージの詳細を表示する

      Config Sync で管理されているすべてのオブジェクトを表示するには、[パッケージ] タブで cs-cluster をクリックして、パッケージの詳細ページを表示します。このページでは、パッケージごとに同期されたすべてのリソースの概要と、リソースのタイプや同期先 Namespace などの詳細を確認できます。

      これらの Namespace が作成される元となった構成ファイルは、GitHub のリポジトリの /config-sync-quickstart/multirepo/ フォルダに移動して確認できます。config-sync-quickstart ディレクトリには、ClusterRole、CustomResourceDefinition、Rolebinding、Namespace、RepoSync の構成が含まれます。また、モニタリング用の Prometheus Operator の構成も含まれています。

      クリーンアップ

      1. Google Cloud コンソールの GKE メニューに移動します。

        GKE に移動

      2. cs-cluster の横にある [操作]（） をクリックし、[削除]（）をクリックします。

      3. 確認するメッセージが表示されたら、もう一度 [削除] をクリックします。

      次のステップ