GKE を Google SecOps と統合する
このドキュメントでは、Google Kubernetes Engine(GKE)を構成して Google Security Operations と統合する方法について説明します。
ユースケース
GKE インテグレーションは、Google SecOps の機能を使用して、次のユースケースをサポートします。
クラスタ インベントリ: 指定されたロケーション内のすべての GKE クラスタのリストを自動的に取得します。これにより、セキュリティ チームは Kubernetes インフラストラクチャの最新のインベントリを維持できます。
動的な自動スケーリング: セキュリティ イベントや運用アラートに応じてノードプールのサイズを自動的に調整し、最適なパフォーマンスを確保します。
ラベルベースの分離: セキュリティ ポリシーまたはインシデント対応手順に基づいて、GKE クラスタにラベルを自動的に適用します。
アドオン構成の調整: セキュリティのベスト プラクティスに基づいて、GKE アドオンを自動的に有効または無効にします。安全でないアドオンを無効にすると、攻撃対象領域を減らすことができます。
オペレーション ステータスのモニタリング: セキュリティ ハンドブックまたはインシデント対応ワークフローによってトリガーされる GKE オペレーションのステータスを自動的にモニタリングします。これにより、セキュリティ アナリストは修復の進捗状況をモニタリングし、進行中のオペレーションのステータスを確認できます。
始める前に
Google SecOps で GKE 統合を構成する前に、次の前提条件の手順を完了します。
次のいずれかの認証方法を選択して構成します。
オプション 1: Workload Identity(推奨): この方法では、サービス アカウントの権限借用を介して有効期間の短いトークンを使用します。
オプション 2: サービス アカウントの JSON キー: この方法は、静的な、有効期間の長い秘密鍵ファイルに依存します。
IAM ロールを作成して構成する
統合に必要な権限を付与するには、プロジェクトにカスタムロールを作成します。
Google Cloud コンソールで、[ロール] に移動します。
[ロールを作成] をクリックします。
[タイトル](例:
SecOps GKE Analyst)、[説明]、一意の [ID] を指定します。[ロールのリリース段階] を [一般提供] に設定します。
ロールに次の権限を追加します。
container.clusters.listcontainer.clusters.updatecontainer.clusters.getcontainer.operations.listcontainer.operations.get
[作成] をクリックします。
サービス アカウントを作成する
Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動します。
[addサービス アカウントを作成] をクリックします。
名前と説明を入力し、[作成して続行] をクリックします。
[このサービス アカウントにプロジェクトへのアクセスを許可する] ステップで、作成したカスタム IAM ロールを割り当てます。
[完了] をクリックします。サービス アカウントのメールアドレスをメモします。
Workload Identity 認証情報を構成する
Workload Identity は、サービス アカウントの権限借用を使用して有効期間の短いアクセス トークンを使用するため、推奨されるアプローチです。
一意のインスタンス ID を特定する
接続を確立するには、サービス アカウントの権限を借用する権限を Google SecOps インスタンスに付与する必要があります。
Google SecOps で、[Content Hub] > [Response Integrations] に移動します。
[GKE] 統合を選択し、
Workload Identity Emailフィールドにサービス アカウントのメールアドレスを入力します。[保存] > [テスト] をクリックします。テストは失敗することが想定されます。
[テスト] の横にある close_small ボタンをクリックし、
gke-init-python@...またはsoar-python@...で始まる ID メールを見つけます。この一意のメールアドレスをコピーします。
Google Cloudでインスタンス ID を認可する
Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動します。
対象のサービス アカウントを選択し、[権限] > [アクセスを許可] に移動します。
一意のメールアドレスを [新しいプリンシパル] フィールドに貼り付け、サービス アカウント トークン作成者ロール(
roles/iam.serviceAccountTokenCreator)を割り当てます。
割り当てプロジェクトへのアクセス権を付与する
Workload Identity を使用して認証するには、API の使用状況と課金を追跡するために Quota Project ID が必要です。
Google Cloud コンソールで、割り当てプロジェクトとして使用されるプロジェクトの [IAM] に移動します。
サービス アカウントを見つけて、[プリンシパルを編集](編集)をクリックします。
[別のロールを追加] をクリックし、[Service Usage コンシューマー](
roles/serviceusage.serviceUsageConsumer)を選択します。[保存] をクリックします。
JSON キーを構成する
静的で有効期間の長い秘密鍵ファイルは、手動でローテーションする必要があります。この方法は、Workload Identity 認証が使用できない場合にのみ使用してください。
Google Cloud コンソールで、[IAM と管理] > [サービス アカウント] に移動し、サービス アカウントを選択します。
[キー] タブに移動し、[キーを追加] > [新しいキーを作成] をクリックします。
[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 ルート。 デフォルト値は |
Workload Identity Email |
省略可。 サービス アカウントのクライアント メールアドレス。 このパラメータは、Workload Identity を使用して認証する場合にのみ構成します。構成する場合は、 |
Service Account Json File Content |
省略可。 サービス アカウント キーの JSON ファイルの内容全体。このパラメータは、JSON キーを使用して認証する場合にのみ構成します。 |
Project ID |
省略可。 GKE でターゲットにするプロジェクト ID。 値が指定されていない場合、統合はサービス アカウントの認証情報から ID を取得します。 |
Quota Project ID |
省略可。 API の使用量と請求額に使用されるプロジェクト ID。 このパラメータは、Workload Identity 認証を使用する場合に必要です。 値が指定されていない場合、統合はサービス アカウントの認証情報から ID を取得します。 |
Location ID |
省略可。 クラスタ オペレーションのスコープ設定に使用される地域 ID。 デフォルト値は |
Verify SSL |
必須。 選択すると、統合は Google Cloud サーバーに接続するときに SSL 証明書を検証します。 デフォルトで有効になっています。 |
個々の認証情報パラメータ
JSON ファイルのコンテンツ全体または Workload Identity を使用するのではなく、認証情報を手動で入力する場合にのみ、次のパラメータを構成します。
| パラメータ | 説明 |
|---|---|
Account Type |
省略可。 JSON キーの |
Private Key ID |
省略可。 JSON キーの |
Private Key |
省略可。 JSON キーの |
Client Email |
省略可。 JSON キーの |
Client ID |
省略可。 JSON キーの |
Auth URI |
省略可。 JSON キーの デフォルトは |
Token URI |
省略可。 JSON キーの デフォルトは |
Auth Provider X509 URL |
省略可。 JSON キーの |
Client X509 URL |
省略可。 JSON キーの |
Google SecOps で統合を構成する方法については、統合を構成するをご覧ください。
必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法については、複数のインスタンスのサポートをご覧ください。
操作
アクションの詳細については、デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。
オペレーションのステータスを取得する
オペレーション ステータスを取得するアクションを使用して、GKE オペレーションのステータスを取得します。
この操作は非同期です。必要に応じて、アクションの Google SecOps 統合開発環境(IDE)を調整します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
Get Operation Status アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Location |
必須。 オペレーション ステータスを取得するロケーション( |
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"
}
出力メッセージ
オペレーション ステータスの取得アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、オペレーション ステータスの取得アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
クラスタの一覧表示
クラスタを一覧表示 アクションを使用して、指定した検索条件に基づいて GKE クラスタを一覧表示します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Clusters アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
Filter Logic |
省略可。 適用するフィルタ ロジック。 フィルタリング ロジックは 値は次のいずれかになります。
デフォルト値は |
Filter Value |
省略可。 フィルタに使用する値。 フィルタリング ロジックは
|
Max Records To Return |
省略可。 返されるレコード数。 デフォルト値は |
アクションの出力
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 アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、クラスタを一覧表示アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ノードプールを一覧表示する
ノードプールを一覧表示するアクションを使用して、指定した検索条件に基づいて GKE クラスタのノードプールを一覧表示します。
フィルタリング ロジックは node pool name フィールドで機能します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Node Pools アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
Cluster Name |
必須。 検索するクラスタの名前。 |
Filter Logic |
省略可。 適用するフィルタ ロジック。 フィルタリング ロジックは 値は次のいずれかになります。
デフォルト値は |
Filter Value |
省略可。 フィルタに使用する値。 フィルタリング ロジックは
|
Max Records To Return |
省略可。 返されるレコード数。 デフォルト値は |
アクションの出力
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 アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、ノードプールを一覧表示アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
オペレーションの一覧表示
List Operations アクションを使用して、指定した検索条件に基づいてロケーションの GKE オペレーションを一覧表示します。
フィルタリング ロジックは operation name フィールドで機能します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
List Operations アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 オペレーションを検索するロケーション( |
Filter Logic |
省略可。 適用するフィルタ ロジック。 フィルタリング ロジックは 値は次のいずれかになります。
デフォルト値は |
Filter Value |
省略可。 フィルタに使用する値。 フィルタリング ロジックは
|
Max Records To Return |
省略可。 返されるレコード数。 デフォルト値は |
アクションの出力
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 アクションは、次の出力メッセージを返すことができます。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、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 |
必須。 クラスタを検索するロケーション( |
Cluster Name |
必須。 検索するクラスタの名前。 |
HTTP Load Balancing |
省略可。 HTTP ロード バランシング アドオンの値。 値は次のいずれかになります。
デフォルト値は |
Horizontal Pod Autoscaling |
省略可。 水平 Pod 自動スケーリング アドオンの値。 値は次のいずれかになります。
デフォルト値は |
Network Policy Config |
省略可。 ネットワーク ポリシー構成アドオンの値。 値は次のいずれかになります。
デフォルト値は |
Cloud Run Config |
省略可。 Cloud Run 構成アドオンの値。 値は次のいずれかになります。
デフォルト値は |
DNS Cache Config |
省略可。 DNS キャッシュ構成アドオンの値。 値は次のいずれかになります。
デフォルト値は |
Config Connector Config |
省略可。 Config Connector 構成アドオンの値。 値は次のいずれかになります。
デフォルト値は |
Persistent Disk Csi Driver Config |
省略可。 Compute Engine 永続ディスク Container Storage Interface(CSI)ドライバ構成アドオンの値を指定します。 値は次のいずれかになります。
デフォルト値は |
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 アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、Set Cluster Addons アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
クラスタラベルを設定する
[クラスタラベルを設定] アクションを使用して、GKE クラスタのラベルを設定します。このアクションにより、既存のクラスタラベルに新しいラベルが追加されます。
ターゲット クラスタがすでに構成変更を行っている場合、現在の構成変更が完了するまで、新しい構成変更を受け入れることはできません。
このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
クラスタラベルを設定するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
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"
}
出力メッセージ
クラスタラベルを設定するアクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、クラスタラベルを設定アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ノードの自動スケーリングを設定する
[ノードの自動スケーリングを設定] アクションを使用して、GKE クラスタのノードプールの自動スケーリング構成を設定します。このアクションは非同期です。
ターゲット クラスタがすでに構成変更を行っている場合、現在の構成変更が完了するまで、新しい構成変更を受け入れることはできません。
このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ノードの自動スケーリングを設定するアクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
Cluster Name |
必須。 検索するクラスタの名前。 |
Node Pool Name |
必須。 クラスタのノードプール名。 |
Autoscaling Mode |
省略可。 ノードプールの自動スケーリング モードのステータス。 値は次のいずれかになります。
デフォルト値は |
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"
}
出力メッセージ
ノードの自動スケーリングを設定するアクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[ノードの自動スケーリングを設定] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ノードプール管理を設定する
[ノードプール管理を設定] アクションを使用して、GKE クラスタのノードプール管理構成を設定します。
このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ノードプール管理の設定アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
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"
}
出力メッセージ
ノードプール管理の設定アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[ノードプールの管理を設定] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
ノード数を設定する
[ノード数を設定] アクションを使用して、GKE クラスタ ノードプールのノード数を設定します。
このアクションは非同期で実行されます。必要に応じて、Google SecOps IDE の設定を調整します。
このアクションは Google SecOps エンティティに対しては実行されません。
アクションへの入力
ノード数を設定アクションには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Cluster Location |
必須。 クラスタを検索するロケーション( |
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"
}
出力メッセージ
ノード数を設定アクションは、次の出力メッセージを返すことがあります。
| 出力メッセージ | メッセージの説明 |
|---|---|
|
アクションが成功しました。 |
|
|
アクションが失敗しました。 サーバーへの接続、入力パラメータ、または認証情報を確認してください。 |
スクリプトの結果
次の表に、[ノード数を設定] アクションを使用した場合のスクリプト結果の出力値を示します。
| スクリプトの結果名 | 値 |
|---|---|
is_success |
True または False |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。