フリート全体にリソースをデプロイする

1. ウェブブラウザで GitHub を開きます。

2. 必要に応じて GitHub アカウントにログインします。GitHub で他の組織またはチームにアクセスできる場合は、個人アカウントでリポジトリを作成していることを確認してください。

3. ツールバーから、[Create new...]（新規作成...）add ボタンを選択し、 [New repository]（新しいリポジトリ）をクリックします。

4. リポジトリの名前として「fleet-package-tutorial」と入力します。

5. リポジトリの公開設定として [公開] を選択したままにします。

6. [リポジトリを作成] を選択します。

リポジトリを Cloud Build に接続する

Config Sync のフリート パッケージ サービスは、Cloud Build を使用して Git リポジトリから Kubernetes リソースを同期して取得します。

GitHub リポジトリを Cloud Build に接続するには、次の手順を行います。

1. Cloud de Confiance コンソールで Cloud Build ページを開き、[リポジトリ] を選択します。

   [リポジトリ] ページを開く

2. 第 2 世代の [リポジトリ] ページに移動します。必要に応じて、[リポジトリ（第 2 世代）を表示] を選択します。

3. [ホスト接続を作成] をクリックします。

4. [リージョン] メニューで、リージョンとして [us-central1（アイオワ）] を選択します。

5. [名前] フィールドに、接続の名前として「fleet-package-quickstart-connection」を入力します。

6. [接続] をクリックします。

7. Cloud Build を GitHub アカウントに初めて接続する場合は、次の操作を行います。

   1. GitHub OAuth トークンのリクエストを承認します。トークンは、Cloud Build GitHub 接続で使用するために Secret Manager に保存されます。[続行] をクリックします。
   2. GitHub リポジトリに Cloud Build をインストールします。[新しいアカウントでインストール] を選択します。
   3. 新しい GitHub ウィンドウが開きます。ここで、先ほど Cymbal Bank のフォークを作成した GitHub アカウントを選択します。本番環境では、アクセス権を委任された他のアカウントまたはリポジトリを選択できます。
   4. 認証プロンプトに従って、GitHub で本人確認を行います。
   5. Cloud Build リポジトリ アクセスの GitHub ウィンドウで、[Only select repositories] を選択します。
   6. リポジトリが一覧表示されたプルダウン メニューから、fleet-package-tutorial リポジトリを選択します。
   7. [保存] をクリックします。

8. Cloud de Confiance コンソールの Cloud Build ページで、[リポジトリをリンク] をクリックして、新しい Git リポジトリを Cloud Build に接続します。

9. [接続] メニューで、[fleet-package-quickstart-connection] を選択します。

10. [リポジトリ] メニューで、fleet-package-tutorial リポジトリを選択します。

11. [リンク] をクリックします。

フリートを設定する

このセクションでは、クラスタを作成してフリートに登録し、Config Sync をフリート パッケージとしてインストールすることで、フリートを設定します。

クラスタを作成する

このチュートリアルでは、フリート パッケージを使用して複数のクラスタにリソースをデプロイする方法を示すために、2 つのクラスタを作成する方法について説明します。

2 つのクラスタを作成してプロジェクトのフリートに登録するには:

1. GKE クラスタを作成します。

   gcloud container clusters create-auto cluster1 \
     --project=PROJECT_ID \
     --region=REGION \
     --fleet-project=PROJECT_ID \
     --release-channel=rapid
   

   次のように置き換えます。

   • PROJECT_ID: プロジェクト ID。
   • REGION は、クラスタを作成するリージョン（us-central1 など）に置き換えます。

2. 2 番目の GKE クラスタを作成します。

   gcloud container clusters create-auto cluster2 \
     --project=PROJECT_ID \
     --region=REGION \
     --fleet-project=PROJECT_ID \
     --release-channel=rapid
   

Config Sync をフリートのデフォルトとしてインストールする

フリート パッケージ サービスを使用するには、両方のクラスタに Config Sync がインストールされている必要があります。次の手順を行うと、Config Sync を複数のクラスタに一度にインストールできます。また、今後フリートに登録されるクラスタにもインストールできます。

1. Cloud de Confiance コンソールで、[機能マネージャー] ページに移動します。

   機能マネージャーに移動

2. [Config Sync] ペインで、[構成] をクリックします。

3. [フリートの設定をカスタマイズ] をクリックします。表示されるダイアログで、インストールする Config Sync のバージョンを選択します。

4. [構成] をクリックします。

5. [フリートの設定を構成] 確認ダイアログで、[確認] をクリックします。以前に Config Sync を有効にしていない場合は、[確認] をクリックして anthosconfigmanagement.googleapis.com API を有効にします。

6. [フリート内のクラスタ] テーブルで、両方のクラスタを選択し、[フリートの設定に同期] をクリックします。これにより、構成した設定で両方のクラスタに Config Sync がインストールされます。

   クラスタの同期には数分かかることがあります。Config Sync が [インストール済み] と表示されたら、次の手順に進みます。

Cloud Build のサービス アカウントを設定する

サービス アカウントを作成して Cloud Build に必要な権限を付与する手順は次のとおりです。

1. サービス アカウントを作成します。

   gcloud iam service-accounts create "quickstart-service-account"
   

2. リソース バンドル パブリッシャー ロールの IAM ポリシー バインディングを追加して、Git リポジトリからリソースを取得する権限をサービス アカウントに付与します。

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com" \
      --role='roles/configdelivery.resourceBundlePublisher'
   

   メッセージが表示されたら、ポリシーの条件として None を選択します。

3. ログ書き込みロールの IAM ポリシー バインディングを追加して、サービス アカウントにログの書き込み権限を付与します。

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com" \
      --role='roles/logging.logWriter'
   

   メッセージが表示されたら、ポリシーの条件として None を選択します。

4. Artifact Registry 書き込みロールの IAM ポリシー バインディングを追加します。

   gcloud projects add-iam-policy-binding PROJECT_ID \
      --member="serviceAccount:quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com" \
      --role='roles/artifactregistry.writer'
   

   メッセージが表示されたら、ポリシーの条件として None を選択します。

フリート全体にリソースをデプロイする

このチュートリアルでは、nginx デプロイを含む Kubernetes マニフェストを Git リポジトリに追加し、リリースを公開してから、nginx アプリケーションをデプロイするフリート パッケージを作成します。

Kubernetes マニフェストをリポジトリに commit する

リソースを GitHub に追加してリリースを公開する手順は次のとおりです。

1. GitHub リポジトリのウェブブラウザ ウィンドウで、[Add file]、[Create new file] の順にクリックします。

2. ファイルに deployment.yaml という名前を付け、次のコンテンツを貼り付けます。

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
   spec:
     replicas: 3
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - image: nginx:1.14.2
           name: nginx
           ports:
           - containerPort: 80
   

3. [Commit changes...] をクリックします。

4. 確認ダイアログで、[Commit directly to the main branch] を選択したままにして、[Commit changes] をクリックします。

5. リポジトリのメインページで、サイドバーから [Releases] を選択します。

6. ページの上部で [Draft a new release] を選択します。

7. [Choose a tag] メニューを選択し、タグとして「v1.0.0」と入力します。[Create new tag] をクリックします。

8. [Publish release] をクリックします。

フリート パッケージを使用してリソースをクラスタにデプロイする

新しいリソースをデプロイするには、新しいフリート パッケージを作成します。

1. このフリート パッケージは、クラスタ セレクタ（target.fleet セクション）を定義していないため、フリート内のすべてのクラスタをターゲットにします。デプロイ バリアント（deployment.yaml ファイルから派生）をこれらのすべてのクラスタにデプロイするように構成されています。

   Cloud Shell で、次の内容を含むファイルを fleet-package.yaml という名前で作成します。

   resourceBundleSelector:
     cloudBuildRepository:
       name: projects/PROJECT_ID/locations/us-central1/connections/fleet-package-quickstart-connection/repositories/REPOSITORY_NAME
       tag: v1.0.0
       serviceAccount: projects/PROJECT_ID/serviceAccounts/quickstart-service-account@PROJECT_ID.s3ns.iam.gserviceaccount.com
       path:
       # Match all files (including deployment.yaml) to generate variants
       variantsPattern: "*.yaml"
   target:
     fleet:
       project: projects/PROJECT_ID
   rolloutStrategy:
     rolling:
       maxConcurrent: 1
   variantSelector:
     # Explicitly match the variant generated from "deployment.yaml"
     variantNameTemplate: "deployment"
   

   REPOSITORY_NAME は、Cloud Build のリポジトリ名に置き換えます。通常は USERNAME-REPOSITORY_NAME 形式です。

2. フリート パッケージを作成して、ロールアウトを開始します。

   gcloud container fleet packages create fp-nginx \
      --source=fleet-package.yaml \
      --project=PROJECT_ID
   

3. フリート パッケージが作成されたことを確認します。

   gcloud container fleet packages list
   

   表示されたリンクをクリックすると、Cloud Build ジョブのストリーミング ログを表示できます。

   フリート パッケージが、フリート全体で Kubernetes リソースのロールアウトを開始します。

4. Cloud de Confiance コンソールの [Google Kubernetes Engine] ページで、[ワークロード] ページに移動すると、すべての GKE クラスタにデプロイされているワークロードの集約ビューが表示されます。

   [ワークロード] ページを開く

   ワークロードが使用可能になるまでに数分かかることがあります。Autopilot が新しいデプロイのリソース リクエストを調整しているときに、可用性エラーが発生することもあります。

   フリート パッケージ定義で maxConcurrent: が 1 に設定されているため、フリート パッケージ API は、1 つのクラスタに nginx-deployment が完全にデプロイされるまで待機してから、2 番目のクラスタへのデプロイを開始します。ロールアウト戦略を maxConcurrent: 2 以上に変更した場合、リソースは両方のクラスタに同時にデプロイされます。

   数分後、両方のクラスタの nginx-deployment に 2 つの新しいワークロードが表示されます。ページの更新が必要になる場合があります。

フリート パッケージを使用した別のデプロイ戦略も考えてみましょう。たとえば、フリートに新しいクラスタを追加して、ワークロードがその新しいクラスタに自動的にデプロイされることを確認できます。デプロイ戦略とバリエーションの詳細については、フリート パッケージをデプロイするをご覧ください。