Integra GKE con Google SecOps

Questo documento spiega come configurare e integrare Google Kubernetes Engine (GKE) con Google Security Operations.

Casi d'uso

L'integrazione di GKE utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Inventario dei cluster: recupera automaticamente un elenco di tutti i cluster GKE in una località specificata. In questo modo, i team di sicurezza possono mantenere un inventario aggiornato della propria infrastruttura Kubernetes.

  • Scalabilità automatica dinamica: regola automaticamente le dimensioni dei pool di nodi in risposta a eventi di sicurezza o avvisi operativi, garantendo prestazioni ottimali.

  • Isolamento basato su etichette: applica automaticamente le etichette ai cluster GKE in base alle policy di sicurezza o alle procedure di risposta agli incidenti.

  • Modifica della configurazione dei componenti aggiuntivi: abilita o disabilita automaticamente i componenti aggiuntivi di GKE in base alle best practice di sicurezza. La disattivazione dei componenti aggiuntivi non sicuri può ridurre la superficie di attacco.

  • Monitoraggio dello stato di attività delle operazioni: monitora automaticamente lo stato di attività delle operazioni GKE attivate dai playbook di sicurezza o dai workflow di risposta agli incidenti. In questo modo, gli analisti della sicurezza possono monitorare l'avanzamento della correzione e controllare lo stato delle operazioni in corso.

Prima di iniziare

Prima di configurare l'integrazione di GKE in Google SecOps, completa i seguenti passaggi preliminari:

  1. Crea e configura un ruolo personalizzato di Identity and Access Management.

  2. Crea un account di servizio.

  3. Scegli e configura uno dei seguenti metodi di autenticazione:

    • Opzione 1: Workload Identity (consigliata): questo metodo utilizza token di breve durata tramite la simulazione dell'identità dei account di servizio.

    • Opzione 2: chiave JSON del service account. Questo metodo si basa su un file di chiave segreta statico e di lunga durata.

Crea e configura un ruolo IAM

Per fornire all'integrazione le autorizzazioni necessarie, crea un ruolo personalizzato nel tuo progetto:

  1. Nella console Google Cloud , vai a Ruoli.

    Vai a Ruoli.

  2. Fai clic su Crea ruolo.

  3. Fornisci un Titolo (ad esempio SecOps GKE Analyst), una Descrizione e un ID univoco.

  4. Imposta Fase di lancio del ruolo su Disponibilità generale.

  5. Aggiungi le seguenti autorizzazioni al ruolo:

    • container.clusters.list
    • container.clusters.update
    • container.clusters.get
    • container.operations.list
    • container.operations.get

  6. Fai clic su Crea.

Crea un account di servizio

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio.

    Vai a Service account

  2. Fai clic su addCrea service account.

  3. Fornisci un nome e una descrizione, quindi fai clic su Crea e continua.

  4. Nel passaggio Concedi a questo account di servizio l'accesso al progetto, assegna il ruolo IAM personalizzato che hai creato.

  5. Fai clic su Fine. Prendi nota dell'indirizzo email del account di servizio.

Configura le credenziali di Workload Identity

Workload Identity è l'approccio consigliato perché utilizza token di accesso di breve durata tramite la simulazione dell'identità dei account di servizio.

Identifica l'identità univoca dell'istanza

Per stabilire una connessione, devi concedere alla tua istanza Google SecOps l'autorizzazione per simulare l'identità del tuo account di servizio.

  1. In Google SecOps, vai a Content Hub > Integrazioni di risposta.

  2. Seleziona l'integrazione GKE e inserisci l'indirizzo email del tuo account di servizio nel campo Workload Identity Email.

  3. Fai clic su Salva > Verifica. Il test dovrebbe non riuscire.

  4. Fai clic sul pulsante close_small accanto a Test e individua l'email di identità che inizia con gke-init-python@... o soar-python@....

  5. Copia questo indirizzo email univoco.

Autorizza l'identità dell'istanza in Google Cloud

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio.

    Vai a Service account

  2. Seleziona il account di servizio di destinazione e vai a Autorizzazioni > Concedi l'accesso.

  3. Incolla l'indirizzo email univoco nel campo Nuove entità e assegna il ruolo Creatore token account di servizio (roles/iam.serviceAccountTokenCreator).

Concedi l'accesso al progetto di quota

L'autenticazione con Workload Identity richiede un Quota Project ID per monitorare l'utilizzo e la fatturazione delle API.

  1. Nella console Google Cloud , vai a IAM per il progetto utilizzato come progetto di quota.

    Vai a IAM

  2. Individua il tuo account di servizio e fai clic su Modifica entità (edit).

  3. Fai clic su Aggiungi un altro ruolo e seleziona Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

  4. Fai clic su Salva.

Configura una chiave JSON

I file delle chiavi secret statici e di lunga durata richiedono la rotazione manuale. Utilizza questo metodo solo se l'autenticazione di Workload Identity non è disponibile.

  1. Nella console Google Cloud , vai a IAM e amministrazione > Account di servizio e seleziona il tuo service account.

    Vai a Service account

  2. Vai alla scheda Chiavi e fai clic su Aggiungi chiave > Crea nuova chiave.

  3. Seleziona JSON e fai clic su Crea. Il browser scarica il file JSON sul tuo computer.

Configura i singoli parametri manuali

Se scegli di inserire le credenziali manualmente, tieni aperto il file della chiave JSON scaricato in un editor di testo per copiare i singoli valori richiesti nelle impostazioni di integrazione.

Parametri di integrazione

Per stabilire una connessione tra Google SecOps e GKE, devi configurare i seguenti parametri. L'integrazione supporta tre percorsi di autenticazione distinti. Scegli uno dei seguenti metodi per fornire le credenziali:

  • Workload Identity: utilizza Workload Identity Email e Quota Project ID.

  • File JSON del service account: utilizza Service Account Json File Content per fornire l'intero file della chiave.

  • Parametri individuali manuali: utilizza campi separati copiati manualmente da una chiave JSON.

Parametro Descrizione
API Root

Obbligatorio.

La radice dell'API dell'istanza GKE.

Il valore predefinito è https://container.googleapis.com.
Workload Identity Email

Facoltativo.

L'indirizzo email client del tuo account di servizio.

Configura questo parametro solo se l'autenticazione avviene utilizzando Workload Identity. Se configurato, devi anche fornire un Quota Project ID e Service Account JSON File Content viene ignorato.
Service Account Json File Content

Facoltativo.

Il contenuto completo del file JSON della chiave del account di servizio. Configura questo parametro solo se l'autenticazione viene eseguita utilizzando una chiave JSON.
Project ID

Facoltativo.

L'ID progetto da scegliere come target in GKE.

Se non viene fornito alcun valore, l'integrazione recupera l'ID dalle credenziali dell'account di servizio.
Quota Project ID

Facoltativo.

L'ID progetto utilizzato per l'utilizzo e la fatturazione dell'API.

Questo parametro è obbligatorio quando si utilizza l'autenticazione Workload Identity.

Se non viene fornito alcun valore, l'integrazione recupera l'ID dalle credenziali dell'account di servizio.
Location ID

Facoltativo.

L'ID località utilizzato per definire l'ambito delle operazioni del cluster.

Il valore predefinito è europe-central2-a.
Verify SSL

Obbligatorio.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Google Cloud .

Abilitato per impostazione predefinita.

Parametri delle credenziali individuali

Configura i seguenti parametri solo se inserisci manualmente le credenziali anziché utilizzare i contenuti completi del file JSON o un Workload Identity.

Parametro Descrizione
Account Type

Facoltativo.

Il valore trovato nel campo type della chiave JSON (in genere service_account).
Private Key ID

Facoltativo.

Il valore trovato nel campo private_key_id della chiave JSON.
Private Key

Facoltativo.

Il valore trovato nel campo private_key della chiave JSON.
Client Email

Facoltativo.

Il valore trovato nel campo client_email della chiave JSON.
Client ID

Facoltativo.

Il valore trovato nel campo client_id della chiave JSON.
Auth URI

Facoltativo.

Il valore trovato nel campo auth_uri della chiave JSON.

Il valore predefinito è https://accounts.google.com/o/oauth2/auth.
Token URI

Facoltativo.

Il valore trovato nel campo token_uri della chiave JSON.

Il valore predefinito è https://oauth2.googleapis.com/token.
Auth Provider X509 URL

Facoltativo.

Il valore trovato nel campo auth_provider_x509_cert_url della chiave JSON.
Client X509 URL

Facoltativo.

Il valore trovato nel campo client_x509_cert_url della chiave JSON.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Ottieni lo stato di attività

Utilizza l'azione Recupera stato operazione per recuperare lo stato dell'operazione GKE.

Questa azione è asincrona. Modifica l'ambiente di sviluppo integrato (IDE) di Google SecOps per l'azione in base alle esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Operation Status richiede i seguenti parametri:

Parametro Descrizione
Location

Obbligatorio.

Una località da cui recuperare gli stati di attività, ad esempio europe-central2-a.
Operation Name

Obbligatorio.

Un'operazione da recuperare.
Wait for the operation to finish

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione.

Non selezionato per impostazione predefinita.

Output azione

L'azione Get Operation Status fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera stato operazione:

{
    "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"
}
Messaggi di output

L'azione Get Operation Status può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Get Operation Status:

Nome del risultato dello script Valore
is_success True o False

Elenco dei cluster

Utilizza l'azione Elenca cluster per elencare i cluster GKE in base ai criteri di ricerca specificati.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca cluster richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

La località in cui cercare i cluster, ad esempio europe-central2-a.
Filter Logic

Facoltativo.

La logica di filtro da applicare.

La logica di filtro funziona con il campo cluster name.

I valori possibili sono:

  • Not Specified
  • Equal
  • Contains

Il valore predefinito è Not Specified.
Filter Value

Facoltativo.

Il valore da utilizzare per il filtro.

La logica di filtro funziona con il campo cluster name.

Se imposti il parametro Filter Logic su Equal, l'azione cerca la corrispondenza esatta di Filter Value tra i risultati. Se imposti il parametro Filter Logic su Contains, l'azione cerca i risultati che contengono la sottostringa specificata in questo parametro. Se non imposti un valore, l'azione ignora il filtro.
Max Records To Return

Facoltativo.

Il numero di record da restituire.

Il valore predefinito è 50.

Output azione

L'azione Elenca cluster fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

L'azione Elenca cluster può restituire la seguente tabella:

Nome della tabella: Cluster trovati

Colonne della tabella:

  • ID
  • Nome
  • Descrizione
  • Rete cluster
  • CIDR IPv4 del cluster
  • Etichette
  • Endpoint del cluster
  • Stato
  • Località
  • Zona
  • Versione iniziale del cluster
  • Versione master corrente
  • Versione attuale del nodo
  • Data/ora di creazione
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca cluster:

{
           "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"
           }
}
Messaggi di output

L'azione Elenca cluster può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully found clusters for the provided criteria in GKE.

No clusters were found for the provided criteria in GKE.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca cluster:

Nome del risultato dello script Valore
is_success True o False

Elenco dei node pool

Utilizza l'azione Elenca pool di nodi per elencare i pool di nodi per il cluster GKE in base ai criteri di ricerca specificati.

La logica di filtro funziona con il campo node pool name.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca pool di nodi richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
Filter Logic

Facoltativo.

La logica di filtro da applicare.

La logica di filtro funziona con il campo node pool name.

I valori possibili sono:

  • Not Specified
  • Equal
  • Contains

Il valore predefinito è Not Specified.
Filter Value

Facoltativo.

Il valore da utilizzare per il filtro.

La logica di filtro funziona con il campo node pool name.

Se imposti il parametro Filter Logic su Equal, l'azione cerca la corrispondenza esatta di Filter Value tra i risultati. Se imposti il parametro Filter Logic su Contains, l'azione cerca i risultati che contengono la sottostringa specificata in questo parametro. Se non imposti un valore, l'azione ignora il filtro.
Max Records To Return

Facoltativo.

Il numero di record da restituire.

Il valore predefinito è 50.

Output azione

L'azione Elenca i node pool fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

L'azione Elenca i node pool può restituire la seguente tabella:

Nome della tabella: Node pool trovati

  • Nome
  • Stato
  • Versione
  • Tipo di macchina
  • Tag
  • Account di servizio
  • Conteggio nodi iniziale
  • Scalabilità automatica
  • Vincolo del numero massimo di pod
  • Località
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca pool di nodi:

{
    "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
            }
        }
    ]
}
Messaggi di output

L'azione Elenca i node pool può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca i node pool:

Nome del risultato dello script Valore
is_success True o False

Elenco operazioni

Utilizza l'azione Elenca operazioni per elencare le operazioni GKE per una località in base ai criteri di ricerca specificati.

La logica di filtro funziona con il campo operation name.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca operazioni richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

La località in cui cercare le operazioni, ad esempio europe-central2-a.
Filter Logic

Facoltativo.

La logica di filtro da applicare.

La logica di filtro funziona con il campo cluster name.

I valori possibili sono:

  • Equal
  • Contains

Il valore predefinito è Equal.
Filter Value

Facoltativo.

Il valore da utilizzare per il filtro.

La logica di filtro funziona con il campo cluster name.

Se imposti il parametro Filter Logic su Equal, l'azione cerca la corrispondenza esatta di Filter Value tra i risultati. Se imposti il parametro Filter Logic su Contains, l'azione cerca i risultati che contengono la sottostringa specificata in questo parametro. Se non imposti un valore, l'azione ignora il filtro.
Max Records To Return

Facoltativo.

Il numero di record da restituire.

Il valore predefinito è 50.

Output azione

L'azione Elenca operazioni fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

L'azione Elenca operazioni può restituire la seguente tabella:

Nome tabella: Found Operations

Colonne della tabella:

  • Nome
  • Zona
  • Tipo di operazione
  • Stato
  • Ora di inizio
  • Ora di fine
  • Link di destinazione
  • Link alla pagina corrente
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca operazioni:

{
    "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"
        },
    ]
}
Messaggi di output

L'azione Elenca operazioni può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully found operations for the provided criteria in GKE.

No operations were found for the provided criteria in GKE.

L'azione è riuscita.

Provided cluster location CLUSTER_LOCATION does not exist.

Error executing action "List Operations". Reason: ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca operazioni:

Nome del risultato dello script Valore
is_success True o False

Dindin

Utilizza l'azione Ping per testare la connettività a GKE.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Messaggi di output

L'azione Ping può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully connected to the GKE service with the provided connection parameters! L'azione è riuscita.
Failed to connect to the GKE service! Error is ERROR_REASON

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
is_success True o False

Imposta componenti aggiuntivi del cluster

Utilizza l'azione Imposta componenti aggiuntivi del cluster per impostare i componenti aggiuntivi per il cluster GKE.

Se il cluster di destinazione è già in fase di modifica della configurazione, non può accettare nuove modifiche alla configurazione finché non viene completata la modifica della configurazione corrente.

Questa azione viene eseguita in modo asincrono. Modifica le impostazioni dell'IDE di Google SecOps in base alle tue esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta componenti aggiuntivi del cluster richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
HTTP Load Balancing

Facoltativo.

Il valore del componente aggiuntivo di bilanciamento del carico HTTP.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Horizontal Pod Autoscaling

Facoltativo.

Il valore del componente aggiuntivo per la scalabilità automatica orizzontale dei pod.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Network Policy Config

Facoltativo.

Il valore del componente aggiuntivo di configurazione della policy di rete.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Cloud Run Config

Facoltativo.

Il valore del componente aggiuntivo di configurazione di Cloud Run.

I valori possibili sono:

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

Il valore predefinito è Not Changed.
DNS Cache Config

Facoltativo.

Il valore del componente aggiuntivo di configurazione della cache DNS.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Config Connector Config

Facoltativo.

Il valore del componente aggiuntivo di configurazione di Config Connector.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Persistent Disk Csi Driver Config

Facoltativo.

Specifica il valore per il componente aggiuntivo di configurazione del driver CSI (Container Storage Interface) per il disco permanente di Compute Engine.

I valori possibili sono:

  • Not Changed
  • Disabled
  • Enabled

Il valore predefinito è Not Changed.
Wait for cluster configuration change operation to finish

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione di modifica della configurazione del cluster.

Questo tipo di annuncio sarà selezionato per impostazione predefinita.

Output azione

L'azione Imposta componenti aggiuntivi del cluster fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta componenti aggiuntivi del cluster:

{
   "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"
}
Messaggi di output

L'azione Imposta componenti aggiuntivi del cluster può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta componenti aggiuntivi del cluster:

Nome del risultato dello script Valore
is_success True o False

Imposta etichette cluster

Utilizza l'azione Imposta etichette cluster per impostare le etichette per il cluster GKE. L'azione aggiunge nuove etichette a quelle esistenti del cluster.

Se il cluster di destinazione è già in fase di modifica della configurazione, non può accettare nuove modifiche alla configurazione finché non viene completata la modifica della configurazione corrente.

Questa azione viene eseguita in modo asincrono. Modifica le impostazioni dell'IDE di Google SecOps in base alle tue esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta etichette cluster richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
Cluster Labels

Obbligatorio.

Un oggetto JSON contenente le etichette da aggiungere al cluster. L'azione aggiunge nuove etichette a quelle esistenti del cluster.

Il valore predefinito è il seguente:

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

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione di modifica della configurazione del cluster.

Non selezionato per impostazione predefinita.

Output azione

L'azione Imposta etichette cluster fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta etichette cluster:

{
    "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"
}
Messaggi di output

L'azione Imposta etichette cluster può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta etichette cluster:

Nome del risultato dello script Valore
is_success True o False

Imposta la scalabilità automatica dei nodi

Utilizza l'azione Imposta scalabilità automatica dei nodi per impostare la configurazione della scalabilità automatica pool di nodi per il cluster GKE. L'azione è asincrona.

Se il cluster di destinazione è già in fase di modifica della configurazione, non può accettare nuove modifiche alla configurazione finché non viene completata la modifica della configurazione corrente.

Questa azione viene eseguita in modo asincrono. Modifica le impostazioni dell'IDE di Google SecOps in base alle tue esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta scalabilità automatica dei nodi richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
Node Pool Name

Obbligatorio.

Il nome pool di nodi per il cluster.
Autoscaling Mode

Facoltativo.

Lo stato della modalità di scalabilità automatica per il pool di nodi.

I valori possibili sono:

  • Not Changed
  • Enabled
  • Disabled

Il valore predefinito è Not Changed.
Minimum Node Count

Facoltativo.

Il numero minimo di nodi per la configurazione del pool di nodi.
Maximum Node Count

Facoltativo.

Il numero massimo di nodi per la configurazione del pool di nodi.
Wait for cluster configuration change operation to finish

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione di modifica della configurazione del cluster.

Non selezionato per impostazione predefinita.

Output azione

L'azione Imposta scalabilità automatica dei nodi fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta scalabilità automatica dei nodi:

{
    "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"
}
Messaggi di output

L'azione Imposta scalabilità automatica dei nodi può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta scalabilità automatica dei nodi:

Nome del risultato dello script Valore
is_success True o False

Imposta la gestione del node pool

Utilizza l'azione Imposta gestione pool di nodi per impostare la configurazione della gestione del pool di nodi per il cluster GKE.

Questa azione viene eseguita in modo asincrono. Modifica le impostazioni dell'IDE di Google SecOps in base alle tue esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta gestione del node pool richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
Node Pool Name

Obbligatorio.

Il nome pool di nodi per il cluster GKE.
Auto Upgrade

Facoltativo.

Lo stato della funzionalità di gestione dell'upgrade automatico.
Auto Repair

Facoltativo.

Lo stato della funzionalità di gestione della riparazione automatica.
Wait for cluster configuration change operation to finish

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione di modifica della configurazione del cluster.

Non selezionato per impostazione predefinita.

Output azione

L'azione Imposta la gestione del node pool fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta gestione del node pool:

{
    "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"
}
Messaggi di output

L'azione Imposta gestione del node pool può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta gestione dei node pool:

Nome del risultato dello script Valore
is_success True o False

Imposta il numero di nodi

Utilizza l'azione Imposta numero di nodi per impostare il numero di nodi per il pool di nodi del cluster GKE.

Questa azione viene eseguita in modo asincrono. Modifica le impostazioni dell'IDE di Google SecOps in base alle tue esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Imposta conteggio nodi richiede i seguenti parametri:

Parametro Descrizione
Cluster Location

Obbligatorio.

Una località in cui cercare i cluster, ad esempio europe-central2-a.
Cluster Name

Obbligatorio.

Il nome del cluster da cercare.
Node Pool Name

Obbligatorio.

Il nome pool di nodi per il cluster GKE.
Node Count

Obbligatorio.

Il numero di nodi per il pool di nodi del cluster GKE.
Wait for cluster configuration change operation to finish

Facoltativo.

Se selezionata, l'azione attende i risultati dell'operazione di modifica della configurazione del cluster.

Non selezionato per impostazione predefinita.

Output azione

L'azione Imposta conteggio nodi fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Imposta conteggio nodi:

{
    "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"
}
Messaggi di output

L'azione Imposta conteggio nodi può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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.

 L'azione è riuscita.

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

L'azione non è riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Imposta conteggio nodi:

Nome del risultato dello script Valore
is_success True o False

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.