GKE を Google SecOps と統合する

このドキュメントでは、Google Kubernetes Engine(GKE)を構成して Google Security Operations と統合する方法について説明します。

ユースケース

GKE インテグレーションは、Google SecOps の機能を使用して、次のユースケースをサポートします。

  • クラスタ インベントリ: 指定されたロケーション内のすべての GKE クラスタのリストを自動的に取得します。これにより、セキュリティ チームは Kubernetes インフラストラクチャの最新のインベントリを維持できます。

  • 動的な自動スケーリング: セキュリティ イベントや運用アラートに応じてノードプールのサイズを自動的に調整し、最適なパフォーマンスを確保します。

  • ラベルベースの分離: セキュリティ ポリシーまたはインシデント対応手順に基づいて、GKE クラスタにラベルを自動的に適用します。

  • アドオン構成の調整: セキュリティのベスト プラクティスに基づいて、GKE アドオンを自動的に有効または無効にします。安全でないアドオンを無効にすると、攻撃対象領域を減らすことができます。

  • オペレーション ステータスのモニタリング: セキュリティ ハンドブックまたはインシデント対応ワークフローによってトリガーされる GKE オペレーションのステータスを自動的にモニタリングします。これにより、セキュリティ アナリストは修復の進捗状況をモニタリングし、進行中のオペレーションのステータスを確認できます。

始める前に

Google SecOps で GKE 統合を構成する前に、次の前提条件の手順を完了します。

  1. カスタムの Identity and Access Management ロールを作成して構成する。

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

  3. 次のいずれかの認証方法を選択して構成します。

    • オプション 1: Workload Identity(推奨): この方法では、サービス アカウントの権限借用を介して有効期間の短いトークンを使用します。

    • オプション 2: サービス アカウントの JSON キー: この方法は、静的な、有効期間の長い秘密鍵ファイルに依存します。

IAM ロールを作成して構成する

統合に必要な権限を付与するには、プロジェクトにカスタムロールを作成します。

  1. Google Cloud コンソールで、[ロール] に移動します。

    [ロール] に移動

  2. [ロールを作成] をクリックします。

  3. [タイトル](例: SecOps GKE Analyst)、[説明]、一意の [ID] を指定します。

  4. [ロールのリリース段階] を [一般提供] に設定します。

  5. ロールに次の権限を追加します。

    • container.clusters.list
    • container.clusters.update
    • container.clusters.get
    • container.operations.list
    • container.operations.get
  6. [作成] をクリックします。

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

  1. Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動します。

    [サービス アカウント] に移動

  2. [addサービス アカウントを作成] をクリックします。

  3. 名前と説明を入力し、[作成して続行] をクリックします。

  4. [このサービス アカウントにプロジェクトへのアクセスを許可する] ステップで、作成したカスタム IAM ロールを割り当てます。

  5. [完了] をクリックします。サービス アカウントのメールアドレスをメモします。

Workload Identity 認証情報を構成する

Workload Identity は、サービス アカウントの権限借用を使用して有効期間の短いアクセス トークンを使用するため、推奨されるアプローチです。

一意のインスタンス ID を特定する

接続を確立するには、サービス アカウントの権限を借用する権限を Google SecOps インスタンスに付与する必要があります。

  1. Google SecOps で、[Content Hub] > [Response Integrations] に移動します。

  2. [GKE] 統合を選択し、Workload Identity Email フィールドにサービス アカウントのメールアドレスを入力します。

  3. [保存] > [テスト] をクリックします。テストは失敗することが想定されます。

  4. [テスト] の横にある close_small ボタンをクリックし、gke-init-python@... または soar-python@... で始まる ID メールを見つけます。

  5. この一意のメールアドレスをコピーします。

Google Cloudでインスタンス ID を認可する

  1. Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動します。

    [サービス アカウント] に移動

  2. 対象のサービス アカウントを選択し、[権限] > [アクセスを許可] に移動します。

  3. 一意のメールアドレスを [新しいプリンシパル] フィールドに貼り付け、サービス アカウント トークン作成者ロール(roles/iam.serviceAccountTokenCreator)を割り当てます。

割り当てプロジェクトへのアクセス権を付与する

Workload Identity を使用して認証するには、API の使用状況と課金を追跡するために Quota Project ID が必要です。

  1. Google Cloud コンソールで、割り当てプロジェクトとして使用されるプロジェクトの [IAM] に移動します。

    IAM に移動

  2. サービス アカウントを見つけて、[プリンシパルを編集](編集)をクリックします。

  3. [別のロールを追加] をクリックし、[Service Usage コンシューマー](roles/serviceusage.serviceUsageConsumer)を選択します。

  4. [保存] をクリックします。

JSON キーを構成する

静的で有効期間の長い秘密鍵ファイルは、手動でローテーションする必要があります。この方法は、Workload Identity 認証が使用できない場合にのみ使用してください。

  1. Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動し、サービス アカウントを選択します。

    [サービス アカウント] に移動

  2. [キー] タブに移動し、[キーを追加] > [新しいキーを作成] をクリックします。

  3. [JSON] を選択し、[作成] をクリックします。ブラウザによって JSON ファイルがパソコンにダウンロードされます。

個々のパラメータを手動で構成する

認証情報を手動で入力する場合は、ダウンロードした JSON 鍵ファイルをテキスト エディタで開いたままにして、統合設定に必要な個々の値をコピーします。

統合のパラメータ

Google SecOps と GKE の間に接続を確立するには、次のパラメータを構成する必要があります。この統合では、3 つの異なる認証パスがサポートされています。次のいずれかの方法で認証情報を提供します。

  • Workload Identity: Workload Identity Email と Quota Project ID を使用します。

  • サービス アカウントの JSON ファイル: Service Account Json File Content を使用して、鍵ファイル全体を指定します。

  • 手動の個別パラメータ: JSON キーから手動でコピーされた個別のフィールドを使用します。

パラメータ 説明
API Root

必須。

GKE インスタンスの API ルート。

デフォルト値は https://container.googleapis.com です。

Workload Identity Email

省略可。

サービス アカウントのクライアント メールアドレス。

このパラメータは、Workload Identity を使用して認証する場合にのみ構成します。構成する場合は、Quota Project ID も指定する必要があります。Service Account JSON File Content は無視されます。

Service Account Json File Content

省略可。

サービス アカウント キーの JSON ファイルの内容全体。このパラメータは、JSON キーを使用して認証する場合にのみ構成します。

Project ID

省略可。

GKE でターゲットにするプロジェクト ID。

値が指定されていない場合、統合はサービス アカウントの認証情報から ID を取得します。

Quota Project ID

省略可。

API の使用量と請求額に使用されるプロジェクト ID。

このパラメータは、Workload Identity 認証を使用する場合に必要です。

値が指定されていない場合、統合はサービス アカウントの認証情報から ID を取得します。

Location ID

省略可。

クラスタ オペレーションのスコープ設定に使用される地域 ID。

デフォルト値は europe-central2-a です。

Verify SSL

必須。

選択すると、統合は Google Cloud サーバーに接続するときに SSL 証明書を検証します。

デフォルトで有効になっています。

個々の認証情報パラメータ

JSON ファイルのコンテンツ全体または Workload Identity を使用するのではなく、認証情報を手動で入力する場合にのみ、次のパラメータを構成します。

パラメータ 説明
Account Type

省略可。

JSON キーの type フィールドにある値(通常は service_account)。

Private Key ID

省略可。

JSON キーの private_key_id フィールドにある値。

Private Key

省略可。

JSON キーの private_key フィールドにある値。

Client Email

省略可。

JSON キーの client_email フィールドにある値。

Client ID

省略可。

JSON キーの client_id フィールドにある値。

Auth URI

省略可。

JSON キーの auth_uri フィールドの値。

デフォルトは https://accounts.google.com/o/oauth2/auth です。

Token URI

省略可。

JSON キーの token_uri フィールドにある値。

デフォルトは https://oauth2.googleapis.com/token です。

Auth Provider X509 URL

省略可。

JSON キーの auth_provider_x509_cert_url フィールドにある値。

Client X509 URL

省略可。

JSON キーの client_x509_cert_url フィールドにある値。

Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

オペレーションのステータスを取得する

オペレーション ステータスを取得するアクションを使用して、GKE オペレーションのステータスを取得します。

この操作は非同期です。必要に応じて、アクションの Google SecOps 統合開発環境(IDE)を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Get Operation Status アクションには、次のパラメータが必要です。

パラメータ 説明
Location

必須。

オペレーション ステータスを取得するロケーション(europe-central2-a など)。

Operation Name

必須。

取得するオペレーション。

Wait for the operation to finish

省略可。

選択すると、アクションはオペレーションの結果を待ちます。

デフォルトでは選択されていません。

アクションの出力

Get Operation Status アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、オペレーション ステータスの取得アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
出力メッセージ

オペレーション ステータスの取得アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully fetched operation details.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided operation name OPERATION_NAME was not found.

Error executing action "Set Node Count". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、オペレーション ステータスの取得アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

クラスタの一覧表示

クラスタを一覧表示 アクションを使用して、指定した検索条件に基づいて GKE クラスタを一覧表示します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

List Clusters アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Filter Logic

省略可。

適用するフィルタ ロジック。

フィルタリング ロジックは cluster name フィールドで機能します。

値は次のいずれかになります。

  • Not Specified
  • Equal
  • Contains

デフォルト値は Not Specified です。

Filter Value

省略可。

フィルタに使用する値。

フィルタリング ロジックは cluster name フィールドで機能します。

Filter Logic パラメータを Equal に設定すると、アクションは結果から Filter Value の完全一致を検索します。Filter Logic パラメータを Contains に設定すると、このパラメータで指定した部分文字列を含む結果が検索されます。値を設定しない場合、アクションはフィルタを無視します。

Max Records To Return

省略可。

返されるレコード数。

デフォルト値は 50 です。

アクションの出力

List Clusters アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

List Clusters アクションは、次のテーブルを返すことができます。

テーブル名: Found Clusters

テーブル列:

  • ID
  • 名前
  • 説明
  • クラスタ ネットワーク
  • クラスタ IPv4 CIDR
  • ラベル
  • クラスタ エンドポイント
  • ステータス
  • ロケーション
  • ゾーン
  • 初期クラスタ バージョン
  • 現在のマスター バージョン
  • 現在のノードのバージョン
  • 作成日時
JSON の結果

次の例は、List Clusters アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
           "name": "cluster-test",
           "description": "Requested by user",
           "nodeConfig": {
               "machineType": "e2-micro",
               "diskSizeGb": 15,
               "oauthScopes": [
                   "https://www.googleapis.com/auth/devstorage.read_only",
                   "https://www.googleapis.com/auth/logging.write",
                   "https://www.googleapis.com/auth/monitoring",
                   "https://www.googleapis.com/auth/servicecontrol",
                   "https://www.googleapis.com/auth/service.management.readonly",
                   "https://www.googleapis.com/auth/trace.append"
               ],
               "metadata": {
                   "disable-legacy-endpoints": "true"
               },
               "imageType": "COS",
               "tags": [
                   "pod-net-tag"
               ],
               "serviceAccount": "default",
               "diskType": "pd-standard",
               "shieldedInstanceConfig": {
                   "enableIntegrityMonitoring": true
               }
           },
           "masterAuth": {
               "clusterCaCertificate": "CERTIFICATE"
           }
}
出力メッセージ

List Clusters アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully found clusters for the provided criteria in GKE.

No clusters were found for the provided criteria in GKE.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Clusters". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、クラスタを一覧表示アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ノードプールを一覧表示する

ノードプールを一覧表示するアクションを使用して、指定した検索条件に基づいて GKE クラスタのノードプールを一覧表示します。

フィルタリング ロジックは node pool name フィールドで機能します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

List Node Pools アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

Filter Logic

省略可。

適用するフィルタ ロジック。

フィルタリング ロジックは node pool name フィールドで機能します。

値は次のいずれかになります。

  • Not Specified
  • Equal
  • Contains

デフォルト値は Not Specified です。

Filter Value

省略可。

フィルタに使用する値。

フィルタリング ロジックは node pool name フィールドで機能します。

Filter Logic パラメータを Equal に設定すると、アクションは結果から Filter Value の完全一致を検索します。Filter Logic パラメータを Contains に設定すると、このパラメータで指定した部分文字列を含む結果が検索されます。値を設定しない場合、アクションはフィルタを無視します。

Max Records To Return

省略可。

返されるレコード数。

デフォルト値は 50 です。

アクションの出力

List Node Pools アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

ノードプールを一覧表示するアクションは、次のテーブルを返すことができます。

テーブル名: 検出されたノードプール

  • 名前
  • ステータス
  • バージョン
  • マシンタイプ
  • タグ
  • サービス アカウント
  • 初期ノード数
  • 自動スケーリング
  • 最大 Pod 数の制約
  • ロケーション
JSON の結果

次の例は、ノードプールを一覧表示するアクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "nodePools": [
        {
            "name": "example-pool",
            "config": {
                "machineType": "e2-micro",
                "diskSizeGb": 15,
                "oauthScopes": [
                    "https://www.googleapis.com/auth/devstorage.read_only",
                    "https://www.googleapis.com/auth/logging.write",
                    "https://www.googleapis.com/auth/monitoring",
                    "https://www.googleapis.com/auth/servicecontrol",
                    "https://www.googleapis.com/auth/service.management.readonly",
                    "https://www.googleapis.com/auth/trace.append"
                ],
                "metadata": {
                    "disable-legacy-endpoints": "true"
                },
                "imageType": "COS",
                "tags": [
                    "pod-net-tag"
                ],
                "serviceAccount": "default",
                "diskType": "pd-standard",
                "shieldedInstanceConfig": {
                    "enableIntegrityMonitoring": true
                }
            },
            "initialNodeCount": 3,
            "autoscaling": {},
            "management": {
                "autoUpgrade": true,
                "autoRepair": true
            },
            "maxPodsConstraint": {
                "maxPodsPerNode": "8"
            },
            "podIpv4CidrSize": 28,
            "locations": [
                "europe-central2-a"
            ],
            "networkConfig": {
                "podRange": "gke-cluster-example-pods-ID",
                "podIpv4CidrBlock": "192.0.2.0/24"
            },
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example/nodePools/example-pool",
            "version": "1.18.20-gke.900",
            "instanceGroupUrls": [
                "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/europe-central2-a/instanceGroupManagers/gke-cluster-example-example-pool-ID-grp"
            ],
            "status": "RUNNING",
            "upgradeSettings": {
                "maxSurge": 1
            }
        }
    ]
}
出力メッセージ

List Node Pools アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully found node pools for cluster CLUSTER_NAME for the provided criteria in GKE.

No node pools were found for cluster CLUSTER_NAME for the provided criteria in GKE.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Invalid value was provided for "Max Records to Return": MAX_RECORDS_TO_RETURN. Positive number should be provided.

Error executing action "List Node Pools". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、ノードプールを一覧表示アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

オペレーションの一覧表示

List Operations アクションを使用して、指定した検索条件に基づいてロケーションの GKE オペレーションを一覧表示します。

フィルタリング ロジックは operation name フィールドで機能します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

List Operations アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

オペレーションを検索するロケーション(europe-central2-a など)。

Filter Logic

省略可。

適用するフィルタ ロジック。

フィルタリング ロジックは cluster name フィールドで機能します。

値は次のいずれかになります。

  • Equal
  • Contains

デフォルト値は Equal です。

Filter Value

省略可。

フィルタに使用する値。

フィルタリング ロジックは cluster name フィールドで機能します。

Filter Logic パラメータを Equal に設定すると、アクションは結果から Filter Value の完全一致を検索します。Filter Logic パラメータを Contains に設定すると、このパラメータで指定した部分文字列を含む結果が検索されます。値を設定しない場合、アクションはフィルタを無視します。

Max Records To Return

省略可。

返されるレコード数。

デフォルト値は 50 です。

アクションの出力

List Operations アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用可能
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
ケースウォール テーブル

List Operations アクションは、次のテーブルを返すことができます。

テーブル名: Found Operations

テーブル列:

  • 名前
  • ゾーン
  • オペレーションのタイプ
  • ステータス
  • 開始時間
  • 終了時間
  • ターゲット リンク
  • セルフリンク
JSON の結果

次の例は、List Operations アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "operations": [
        {
            "name": "operation-OPERATION_ID",
            "zone": "europe-central2-a",
            "operationType": "UPGRADE_MASTER",
            "status": "DONE",
            "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
            "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-example",
            "startTime": "2021-08-06T12:33:51.614562051Z",
            "endTime": "2021-08-06T12:38:55.038159801Z"
        },
    ]
}
出力メッセージ

List Operations アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明

Successfully found operations for the provided criteria in GKE.

No operations were found for the provided criteria in GKE.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Error executing action "List Operations". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、List Operations アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

Ping

Ping アクションを使用して、GKE への接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

Ping アクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用不可
出力メッセージ 利用可能
スクリプトの結果 利用可能
出力メッセージ

Ping アクションは、次の出力メッセージを返すことができます。

出力メッセージ メッセージの説明
Successfully connected to the GKE service with the provided connection parameters! アクションが成功しました。
Failed to connect to the GKE service! Error is ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

クラスタ アドオンを設定する

[クラスタ アドオンを設定する] アクションを使用して、GKE クラスタのアドオンを設定します。

ターゲット クラスタがすでに構成変更を行っている場合、現在の構成変更が完了するまで、新しい構成変更を受け入れることはできません。

このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

Set Cluster Addons アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

HTTP Load Balancing

省略可。

HTTP ロード バランシング アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Horizontal Pod Autoscaling

省略可。

水平 Pod 自動スケーリング アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Network Policy Config

省略可。

ネットワーク ポリシー構成アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Cloud Run Config

省略可。

Cloud Run 構成アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled, Load Balancer Type Unspecified
  • Enabled, Load Balancer Type External
  • Enabled, Load Balancer Type Internal

デフォルト値は Not Changed です。

DNS Cache Config

省略可。

DNS キャッシュ構成アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Config Connector Config

省略可。

Config Connector 構成アドオンの値。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Persistent Disk Csi Driver Config

省略可。

Compute Engine 永続ディスク Container Storage Interface(CSI)ドライバ構成アドオンの値を指定します。

値は次のいずれかになります。

  • Not Changed
  • Disabled
  • Enabled

デフォルト値は Not Changed です。

Wait for cluster configuration change operation to finish

省略可。

選択すると、アクションはクラスタ構成変更オペレーションの結果を待機します。

デフォルトで選択されます。

アクションの出力

Set Cluster Addons アクションの出力は次のとおりです。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Set Cluster Addons アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
   "name": "operation-OPERATION_ID",
   "zone": "europe-central2-a",
   "operationType": "UPDATE_CLUSTER",
   "status": "RUNNING",
   "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
   "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
   "startTime": "2021-08-15T11:34:43.051036236Z"
}
出力メッセージ

Set Cluster Addons アクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Successfully created cluster configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Cluster Addons". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Set Cluster Addons アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

クラスタラベルを設定する

[クラスタラベルを設定] アクションを使用して、GKE クラスタのラベルを設定します。このアクションにより、既存のクラスタラベルに新しいラベルが追加されます。

ターゲット クラスタがすでに構成変更を行っている場合、現在の構成変更が完了するまで、新しい構成変更を受け入れることはできません。

このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

クラスタラベルを設定するアクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

Cluster Labels

必須。

クラスタに追加するラベルを含む JSON オブジェクト。このアクションにより、既存のクラスタラベルに新しいラベルが追加されます。

デフォルト値は次のとおりです。

{
      "key1":"value1",
      "key2":"value2"
      }
    
Wait for cluster configuration change operation to finish

省略可。

選択すると、アクションはクラスタ構成変更オペレーションの結果を待機します。

デフォルトでは選択されていません。

アクションの出力

クラスタラベルを設定するアクションは、次の出力を提供します。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、Set Cluster Labels アクションを使用した場合に受信する JSON 結果の出力を示しています。

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
出力メッセージ

クラスタラベルを設定するアクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Successfully created cluster configuration change operation.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Invalid value was provided for the cluster labels: CLUSTER_LABELS.

Error executing action "Set Cluster Labels". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、クラスタラベルを設定アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ノードの自動スケーリングを設定する

[ノードの自動スケーリングを設定] アクションを使用して、GKE クラスタのノードプールの自動スケーリング構成を設定します。このアクションは非同期です。

ターゲット クラスタがすでに構成変更を行っている場合、現在の構成変更が完了するまで、新しい構成変更を受け入れることはできません。

このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

ノードの自動スケーリングを設定するアクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

Node Pool Name

必須。

クラスタのノードプール名。

Autoscaling Mode

省略可。

ノードプールの自動スケーリング モードのステータス。

値は次のいずれかになります。

  • Not Changed
  • Enabled
  • Disabled

デフォルト値は Not Changed です。

Minimum Node Count

省略可。

ノードプール構成のノードの最小数。

Maximum Node Count

省略可。

ノードプール構成のノードの最大数。

Wait for cluster configuration change operation to finish

省略可。

選択すると、アクションはクラスタ構成変更オペレーションの結果を待機します。

デフォルトでは選択されていません。

アクションの出力

ノードの自動スケーリングを設定するアクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、ノードの自動スケーリングを設定するアクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "UPDATE_CLUSTER",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
出力メッセージ

ノードの自動スケーリングを設定するアクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Error executing action "Set Node Autoscaling". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[ノードの自動スケーリングを設定] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ノードプール管理を設定する

[ノードプール管理を設定] アクションを使用して、GKE クラスタのノードプール管理構成を設定します。

このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

ノードプール管理の設定アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

Node Pool Name

必須。

GKE クラスタのノードプール名。

Auto Upgrade

省略可。

自動アップグレード管理機能のステータス。

Auto Repair

省略可。

自動修復管理機能のステータス。

Wait for cluster configuration change operation to finish

省略可。

選択すると、アクションはクラスタ構成変更オペレーションの結果を待機します。

デフォルトでは選択されていません。

アクションの出力

ノードプール管理の設定アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、ノードプールの管理を設定するアクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_MANAGEMENT",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
出力メッセージ

ノードプール管理の設定アクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Error executing action "Set Node Pool Management". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[ノードプールの管理を設定] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

ノード数を設定する

[ノード数を設定] アクションを使用して、GKE クラスタ ノードプールのノード数を設定します。

このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

ノード数を設定アクションには、次のパラメータが必要です。

パラメータ 説明
Cluster Location

必須。

クラスタを検索するロケーション(europe-central2-a など)。

Cluster Name

必須。

検索するクラスタの名前。

Node Pool Name

必須。

GKE クラスタのノードプール名。

Node Count

必須。

GKE クラスタ ノードプールのノード数。

Wait for cluster configuration change operation to finish

省略可。

選択すると、アクションはクラスタ構成変更オペレーションの結果を待機します。

デフォルトでは選択されていません。

アクションの出力

ノード数を設定アクションでは、次の出力が提供されます。

アクションの出力タイプ 対象
ケースウォールのアタッチメント 利用不可
ケースウォールのリンク 利用不可
ケースウォール テーブル 利用不可
拡充テーブル 利用不可
JSON の結果 利用可能
出力メッセージ 利用可能
スクリプトの結果 利用可能
JSON の結果

次の例は、ノード数の設定アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
    "name": "operation-OPERATION_ID",
    "zone": "europe-central2-a",
    "operationType": "SET_NODE_POOL_SIZE",
    "status": "RUNNING",
    "selfLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/operations/operation-OPERATION_ID",
    "targetLink": "https://container.googleapis.com/v1/projects/PROJECT_ID/zones/europe-central2-a/clusters/cluster-test/nodePools/default-pool",
    "startTime": "2021-08-15T11:53:55.904254615Z"
}
出力メッセージ

ノード数を設定アクションは、次の出力メッセージを返すことがあります。

出力メッセージ メッセージの説明

Successfully created cluster node pool configuration change operation.

Failed to execute the action because API returned error, please see action logs LOG_SNIPPET.

Operation OPERATION_NAME is still in progress, current status: STATUS.

Operation OPERATION_NAME successfully finished.

Operation OPERATION_NAME failed to complete with the following status: STATUS.

アクションが成功しました。

Provided cluster location CLUSTER_LOCATION does not exist.

Provided cluster name CLUSTER_NAME was not found.

Provided node pool name NODE_POOL_NAME was not found.

Invalid value was provided for the node count: NODE_COUNT. The value should be a positive number.

Error executing action "Set Node Count". Reason: ERROR_REASON

アクションが失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[ノード数を設定] アクションを使用した場合のスクリプト結果の出力値を示します。

スクリプトの結果名 値
is_success True または False

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。