Google Distributed Cloud の Binary Authorization を使用すると、Binary Authorization のデプロイ時の適用をオンプレミスのユーザー クラスタに拡張して、コンテナ ワークロードを保護できます。 Google Cloud プロジェクトで構成したポリシーの適用ルールを、バージョン 1.28 以降のユーザー クラスタに適用できます。ポリシーとルールの詳細については、Binary Authorization の概要をご覧ください。
Google Distributed Cloud の Binary Authorization のプレビュー リリースを有効にしている場合は、バージョン 1.28 以降のクラスタで GA 機能を有効にする前に、これを無効にしてリソースをクリーンアップしてください。
前提条件
ユーザー クラスタで Binary Authorization ポリシーの適用を有効にする前に、以下の前提条件を満たしていることを確認してください。
クラスタをフリートに登録する:
gkectlで作成したクラスタの場合、クラスタは、クラスタ構成ファイルのgkeConnect.projectIDフィールドで指定した Google Cloud プロジェクトに登録されます。このプロジェクトはフリート ホスト プロジェクトと呼ばれます。ユースケース、ベスト プラクティス、例などのフリートの詳細については、フリート管理のドキュメントをご覧ください。Google Cloud プロジェクトで Binary Authorization API を有効にする: フリートホスト プロジェクトで Binary Authorization サービスを有効にします。
Binary Authorization ポリシー評価者ロールをフリート ホスト プロジェクトに追加する: Binary Authorization ポリシー エバリュエータ ロール(
roles/binaryauthorization.policyEvaluator)をフリート ホスト プロジェクトの Kubernetes サービス アカウントに付与するには、次のコマンドを実行します。gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_ID.[binauthz-system/binauthz-agent]" \ --role="roles/binaryauthorization.policyEvaluator"クラスタがプロキシ サーバーの背後で実行されている場合は、プロキシ サーバーが Binary Authorization API(
binaryauthorization.googleapis.com)への接続を許可していることを確認してください。この API は、クラスタにデプロイされたイメージの、ポリシーベースのデプロイ検証と制御を提供します。詳細については、プロキシとファイアウォール ルールをご覧ください。
前提条件を満たすと、新しいクラスタを作成ときや既存のクラスタを更新するときに Binary Authorization ポリシーを有効化(または無効化)できます。
クラスタの作成時に Binary Authorization ポリシーを有効にする
Binary Authorization ポリシーの適用は、gkectl または gcloud CLI を使用して有効にできます。
gkectl
gkectl を使用してクラスタを作成するときに Binary Authorization を有効にするには:
クラスタを作成する前に、次の例に示すように、ユーザー クラスタ構成ファイルに
binaryAuthorization.evaluationModeを追加します。... binaryAuthorization: evaluationMode: "project_singleton_policy_enforce" ...evaluationModeに指定できる値は以下のとおりです。project_singleton_policy_enforce: Binary Authorization ポリシーで指定されたルール(プロジェクトのシングルトン ポリシーとも呼ばれます)を Google Cloud プロジェクトに適用してクラスタ上のコンテナ イメージのデプロイを管理します。disabled: クラスタで Binary Authorization の使用を無効にします。これはデフォルト値です。binaryAuthorizationを省略すると、この機能は無効になります。
クラスタ構成ファイルに必要な他の変更を行い、
gkectl create clusterコマンドを実行します。
クラスタの作成の詳細については、Google Distributed Cloud のインストールの概要をご覧ください。
既存のクラスタの Binary Authorization ポリシーを有効または無効にする
既存のバージョン 1.28 以降のクラスタを使用している場合は、gkectl または gcloud CLI を使用して、Binary Authorization をいつでも有効または無効にできます。
gkectl
有効にする手順は次のとおりです。
クラスタ構成ファイルを編集して、
binaryAuthorizationフィールドを追加します。... binaryAuthorization: evaluationMode: "project_singleton_policy_enforce"クラスタを更新します。
gkectl update cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIG_FILE \ --force
次のように置き換えます。
ADMIN_CLUSTER_KUBECONFIG: 管理クラスタの kubeconfig ファイルのパスUSER_CLUSTER_CONFIG_FILE: ユーザー クラスタの構成ファイルのパス
binauthz-systemNamespace のbinauthz-module-deploymentという名前の Deployment の準備が整うまで待ちます。デプロイの準備が整うと、Binary Authorization は Binary Authorization ポリシー(プロジェクト シングルトン ポリシーとも呼ばれる)で指定されたルールを適用します。このポリシーは、Google Cloud プロジェクトに関連付けられ、コンテナ イメージのデプロイを管理するルールを指定します。
gkectlを使用したクラスタの更新について詳しくは、クラスタを更新するをご覧ください。Binary Authorization ポリシーとルールについては、Binary Authorization の概要をご覧ください。
無効にするには:
クラスタ構成ファイルを編集し、
binaryAuthorizationセクションを削除するか、evaluationModeをdisabledに設定します。... binaryAuthorization: evaluationMode: "disabled"クラスタを更新します。
gkectl update cluster \ --kubeconfig ADMIN_CLUSTER_KUBECONFIG \ --config USER_CLUSTER_CONFIG_FILE \ --force
この変更を行ったら、
binauthz-systemNamespace のbinauthz-module-deploymentという名前の Deployment が削除されるまで数分待ちます。
トラブルシューティング
前提条件をすべて完了していない場合、Binary Authorization の構成に問題があることを示す次のようなメッセージが表示されることがあります。
failed to validate Binary Authorization policy (1) Ensure the Binary Authorization API is enabled for your Google Cloud project: gcloud services enable binaryauthorization.googleapis.com --project=PROJECT_ID (2) Ensure an IAM policy binding is in place granting binaryauthorization.policyEvaluator role to the binauthz-system/binauthz-agent Kubernetes service account: gcloud projects add-iam-policy-binding PROJECT_ID \ --member="serviceAccount:PROJECT_ID.[binauthz-system/binauthz-agent]" \ --role=roles/binaryauthorization.policyEvaluator