Integrar o GKE ao Google SecOps

Neste documento, explicamos como configurar e integrar o Google Kubernetes Engine (GKE) com o Google Security Operations.

Casos de uso

A integração do GKE usa os recursos do Google SecOps para oferecer suporte aos seguintes casos de uso:

  • Inventário de clusters: recupere automaticamente uma lista de todos os clusters do GKE em um local especificado. Isso ajuda as equipes de segurança a manter um inventário atualizado da infraestrutura do Kubernetes.

  • Escalonamento automático dinâmico: ajuste automaticamente o tamanho dos pools de nós em resposta a eventos de segurança ou alertas operacionais, garantindo o desempenho ideal.

  • Isolamento com base em rótulos: aplique rótulos automaticamente aos clusters do GKE com base em políticas de segurança ou procedimentos de resposta a incidentes.

  • Ajuste de configuração de complementos: ative ou desative automaticamente os complementos do GKE com base nas práticas recomendadas de segurança. Desativar complementos não seguros pode reduzir a superfície de ataque.

  • Monitoramento do status de funcionamento da operação: monitore automaticamente o status de funcionamento das operações do GKE acionadas por playbooks de segurança ou fluxos de trabalho de resposta a incidentes. Isso permite que os analistas de segurança monitorem o progresso da correção e verifiquem o status das operações em andamento.

Antes de começar

Antes de configurar a integração do GKE no Google SecOps, conclua as seguintes etapas de pré-requisito:

  1. Criar e configurar um papel personalizado do Identity and Access Management.

  2. Crie uma conta de serviço.

  3. Escolha e configure um dos seguintes métodos de autenticação:

Criar e configurar um papel do IAM

Para fornecer à integração as permissões necessárias, crie um papel personalizado no projeto:

  1. No console do Google Cloud , acesse Papéis.

    Acessar "Papéis"

  2. Clique em Criar papel.

  3. Forneça um Título (por exemplo, SecOps GKE Analyst), uma Descrição e um ID exclusivo.

  4. Defina o Estágio de lançamento do papel como Disponibilidade geral.

  5. Adicione as seguintes permissões ao papel:

    • container.clusters.list
    • container.clusters.update
    • container.clusters.get
    • container.operations.list
    • container.operations.get
  6. Clique em Criar.

Criar uma conta de serviço

  1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço.

    Acessar a página "Contas de serviço"

  2. Clique em addCriar conta de serviço.

  3. Insira um nome e uma descrição e clique em Criar e continuar.

  4. Na etapa Conceder a essa conta de serviço acesso ao projeto, atribua o papel personalizado do IAM que você criou.

  5. Clique em Concluído. Anote o endereço de e-mail da conta de serviço.

Configurar credenciais da Identidade da carga de trabalho

A Identidade da carga de trabalho é a abordagem recomendada, porque usa tokens de acesso de curta duração com a identidade temporária de conta de serviço.

Identificar a identidade exclusiva da instância

Para estabelecer uma conexão, é necessário conceder à instância do Google SecOps permissão para personificar sua conta de serviço.

  1. No Google SecOps, acesse Hub de conteúdo > Integrações de resposta.

  2. Selecione a integração do GKE e insira o e-mail da sua conta de serviço no campo Workload Identity Email.

  3. Clique em Salvar > Testar. O teste deve falhar.

  4. Clique no botão close_small ao lado de Teste e localize o e-mail de identidade que começa com gke-init-python@... ou soar-python@....

  5. Copie esse endereço de e-mail exclusivo.

Autorize a identidade da instância em Google Cloud.

  1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço.

    Acessar a página "Contas de serviço"

  2. Selecione a conta de serviço de destino e acesse Permissões > Conceder acesso.

  3. Cole o endereço de e-mail exclusivo no campo Novos principais e atribua o papel Criador de token da conta de serviço (roles/iam.serviceAccountTokenCreator).

Conceder acesso ao projeto de cota

A autenticação com a Identidade da carga de trabalho requer um Quota Project ID para rastrear o uso e o faturamento da API.

  1. No console do Google Cloud , acesse o IAM do projeto usado como projeto de cota.

    Acessar IAM

  2. Localize sua conta de serviço e clique em Editar principal (editar).

  3. Clique em Adicionar outro papel e selecione Consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer).

  4. Clique em Salvar.

Configurar uma chave JSON

Os arquivos de chave secreta estáticos e de longa duração exigem rotação manual. Use esse método apenas se a autenticação da Identidade da carga de trabalho não estiver disponível.

  1. No console do Google Cloud , acesse IAM e administrador > Contas de serviço e selecione sua conta de serviço.

    Acessar a página "Contas de serviço"

  2. Acesse a guia Chaves e clique em Adicionar chave > Criar nova chave.

  3. Selecione JSON e clique em Criar. O navegador faz o download do arquivo JSON para seu computador.

Configurar parâmetros individuais manuais

Se você optar por inserir as credenciais manualmente, mantenha o arquivo de chave JSON salvo aberto em um editor de texto para copiar os valores individuais necessários nas configurações de integração.

Parâmetros de integração

Para estabelecer uma conexão entre o Google SecOps e o GKE, configure os parâmetros a seguir. A integração é compatível com três caminhos de autenticação distintos. Escolha um dos seguintes métodos para fornecer credenciais:

  • Identidade da carga de trabalho: usa Workload Identity Email e Quota Project ID.

  • Arquivo JSON da conta de serviço: usa Service Account Json File Content para fornecer todo o arquivo de chave.

  • Parâmetros individuais manuais: usa campos separados copiados manualmente de uma chave JSON.

Parâmetro Descrição
API Root

Obrigatório.

A raiz da API da instância do GKE.

O valor padrão é https://container.googleapis.com.

Workload Identity Email

Opcional.

O endereço de e-mail do cliente da sua conta de serviço.

Configure esse parâmetro apenas se você estiver autenticando usando uma Identidade da carga de trabalho. Se configurado, você também precisa fornecer um Quota Project ID, e Service Account JSON File Content é ignorado.

Service Account Json File Content

Opcional.

O conteúdo completo do arquivo JSON da chave da conta de serviço. Configure esse parâmetro apenas se estiver autenticando com uma chave JSON.

Project ID

Opcional.

O ID do projeto a ser segmentado no GKE.

Se nenhum valor for fornecido, a integração vai recuperar o ID das credenciais da conta de serviço.

Quota Project ID

Opcional.

O ID do projeto usado para uso e faturamento da API.

Esse parâmetro é obrigatório ao usar a autenticação da Identidade da carga de trabalho.

Se nenhum valor for fornecido, a integração vai recuperar o ID das credenciais da conta de serviço.

Location ID

Opcional.

O ID do local usado para definir o escopo das operações do cluster.

O valor padrão é europe-central2-a.

Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor do Google Cloud .

Ativado por padrão.

Parâmetros de credenciais individuais

Configure os parâmetros a seguir somente se você estiver inserindo credenciais manualmente, em vez de usar o conteúdo completo do arquivo JSON ou uma Identidade da carga de trabalho.

Parâmetro Descrição
Account Type

Opcional.

O valor encontrado no campo type da chave JSON (normalmente service_account).

Private Key ID

Opcional.

O valor encontrado no campo private_key_id da chave JSON.

Private Key

Opcional.

O valor encontrado no campo private_key da chave JSON.

Client Email

Opcional.

O valor encontrado no campo client_email da chave JSON.

Client ID

Opcional.

O valor encontrado no campo client_id da chave JSON.

Auth URI

Opcional.

O valor encontrado no campo auth_uri da sua chave JSON.

O padrão é https://accounts.google.com/o/oauth2/auth.

Token URI

Opcional.

O valor encontrado no campo token_uri da chave JSON.

O padrão é https://oauth2.googleapis.com/token.

Auth Provider X509 URL

Opcional.

O valor encontrado no campo auth_provider_x509_cert_url da chave JSON.

Client X509 URL

Opcional.

O valor encontrado no campo client_x509_cert_url da chave JSON.

Para instruções sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Se necessário, você pode fazer mudanças depois. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na sua mesa de trabalho e Executar uma ação manual no seu caso.

Verificar o status de funcionamento

Use a ação Get Operation Status para recuperar o status da operação do GKE.

Essa ação é assíncrona. Ajuste o ambiente de desenvolvimento integrado (IDE) do Google SecOps para a ação, conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Receber status da operação requer os seguintes parâmetros:

Parâmetro Descrição
Location

Obrigatório.

Um local para recuperar os status de funcionamento, como europe-central2-a.

Operation Name

Obrigatório.

Uma operação a ser recuperada.

Wait for the operation to finish

Opcional.

Se selecionada, a ação aguarda os resultados da operação.

Não selecionada por padrão.

Saídas da ação

A ação Receber status da operação fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Get Operation Status:

{
    "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"
}
Mensagens de saída

A ação Get Operation Status pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Get Operation Status:

Nome do resultado do script Valor
is_success True ou False

Listar clusters

Use a ação Listar clusters para listar clusters do GKE com base nos critérios de pesquisa especificados.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Listar clusters requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

O local para pesquisar clusters, como europe-central2-a.

Filter Logic

Opcional.

A lógica de filtro que será aplicada.

A lógica de filtragem funciona com o campo cluster name.

Os valores possíveis são os seguintes:

  • Not Specified
  • Equal
  • Contains

O valor padrão é Not Specified.

Filter Value

Opcional.

O valor a ser usado no filtro.

A lógica de filtragem funciona com o campo cluster name.

Se você definir o parâmetro Filter Logic como Equal, a ação vai procurar a correspondência exata de Filter Value entre os resultados. Se você definir o parâmetro Filter Logic como Contains, a ação vai pesquisar resultados que contenham a substring especificada nesse parâmetro. Se você não definir um valor, a ação vai ignorar o filtro.

Max Records To Return

Opcional.

O número de registros que serão retornados.

O valor padrão é 50.

Saídas da ação

A ação Listar clusters fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Disponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela do painel de casos

A ação Listar clusters pode retornar a seguinte tabela:

Nome da tabela: Clusters encontrados

Colunas da tabela:

  • ID
  • Nome
  • Descrição
  • Rede do cluster
  • CIDR IPv4 do cluster
  • Marcadores
  • Endpoint do cluster
  • Status
  • Local
  • Zona
  • Versão inicial do cluster
  • Versão mestre atual
  • Versão atual do nó
  • Horário de criação
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Listar clusters:

{
           "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"
           }
}
Mensagens de saída

A ação Listar clusters pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully found clusters for the provided criteria in GKE.

No clusters were found for the provided criteria in GKE.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Listar clusters:

Nome do resultado do script Valor
is_success True ou False

Listar pools de nós

Use a ação Listar pools de nós para listar os pools de nós do cluster do GKE com base nos critérios de pesquisa especificados.

A lógica de filtragem funciona com o campo node pool name.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Listar pools de nós requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

Filter Logic

Opcional.

A lógica de filtro que será aplicada.

A lógica de filtragem funciona com o campo node pool name.

Os valores possíveis são os seguintes:

  • Not Specified
  • Equal
  • Contains

O valor padrão é Not Specified.

Filter Value

Opcional.

O valor a ser usado no filtro.

A lógica de filtragem funciona com o campo node pool name.

Se você definir o parâmetro Filter Logic como Equal, a ação vai procurar a correspondência exata de Filter Value entre os resultados. Se você definir o parâmetro Filter Logic como Contains, a ação vai pesquisar resultados que contenham a substring especificada nesse parâmetro. Se você não definir um valor, a ação vai ignorar o filtro.

Max Records To Return

Opcional.

O número de registros que serão retornados.

O valor padrão é 50.

Saídas da ação

A ação Listar pools de nós fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Disponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela do painel de casos

A ação Listar pools de nós pode retornar a seguinte tabela:

Nome da tabela: Pools de nós encontrados

  • Nome
  • Status
  • Versão
  • Tipo de máquina
  • Tags
  • Conta de serviço
  • Contagem inicial de nós
  • Escalonamento automático
  • Restrição de pods máximos
  • Locais
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Listar pools de nós:

{
    "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
            }
        }
    ]
}
Mensagens de saída

A ação Listar pools de nós pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Listar pools de nós:

Nome do resultado do script Valor
is_success True ou False

Listar operações

Use a ação Listar operações para listar as operações do GKE em um local com base nos critérios de pesquisa especificados.

A lógica de filtragem funciona com o campo operation name.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Listar operações requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

O local para pesquisar operações, como europe-central2-a.

Filter Logic

Opcional.

A lógica de filtro que será aplicada.

A lógica de filtragem funciona com o campo cluster name.

Os valores possíveis são os seguintes:

  • Equal
  • Contains

O valor padrão é Equal.

Filter Value

Opcional.

O valor a ser usado no filtro.

A lógica de filtragem funciona com o campo cluster name.

Se você definir o parâmetro Filter Logic como Equal, a ação vai procurar a correspondência exata de Filter Value entre os resultados. Se você definir o parâmetro Filter Logic como Contains, a ação vai pesquisar resultados que contenham a substring especificada nesse parâmetro. Se você não definir um valor, a ação vai ignorar o filtro.

Max Records To Return

Opcional.

O número de registros que serão retornados.

O valor padrão é 50.

Saídas da ação

A ação Listar operações fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Disponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela do painel de casos

A ação Listar operações pode retornar a seguinte tabela:

Nome da tabela: Operações encontradas

Colunas da tabela:

  • Nome
  • Zona
  • Tipo de operação
  • Status
  • Horário de início
  • Horário de término
  • Link de destino
  • Self link
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Listar operações:

{
    "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"
        },
    ]
}
Mensagens de saída

A ação Listar operações pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

Successfully found operations for the provided criteria in GKE.

No operations were found for the provided criteria in GKE.

A ação foi concluída.

Provided cluster location CLUSTER_LOCATION does not exist.

Error executing action "List Operations". Reason: ERROR_REASON

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Listar operações:

Nome do resultado do script Valor
is_success True ou False

Ping

Use a ação Ping para testar a conectividade com o GKE.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Indisponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ping pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully connected to the GKE service with the provided connection parameters! A ação foi concluída.
Failed to connect to the GKE service! Error is ERROR_REASON

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:

Nome do resultado do script Valor
is_success True ou False

Definir complementos de cluster

Use a ação Definir complementos do cluster para definir complementos para o cluster do GKE.

Se o cluster de destino já estiver passando por uma mudança de configuração, ele não poderá aceitar novas mudanças até que a atual seja concluída.

Essa ação é executada de forma assíncrona. Ajuste as configurações do ambiente de desenvolvimento integrado do Google SecOps conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir complementos do cluster requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

HTTP Load Balancing

Opcional.

O valor do complemento de balanceamento de carga HTTP.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Horizontal Pod Autoscaling

Opcional.

O valor do complemento de escalonamento automático horizontal de pods.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Network Policy Config

Opcional.

O valor do complemento de configuração da política de rede.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Cloud Run Config

Opcional.

O valor do complemento de configuração do Cloud Run.

Os valores possíveis são os seguintes:

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

O valor padrão é Not Changed.

DNS Cache Config

Opcional.

O valor do complemento de configuração do cache de DNS.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Config Connector Config

Opcional.

O valor do complemento de configuração do Config Connector.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Persistent Disk Csi Driver Config

Opcional.

Especifique o valor do complemento de configuração do driver da Interface de Armazenamento de Contêiner (CSI, na sigla em inglês) do disco permanente do Compute Engine.

Os valores possíveis são os seguintes:

  • Not Changed
  • Disabled
  • Enabled

O valor padrão é Not Changed.

Wait for cluster configuration change operation to finish

Opcional.

Se selecionada, a ação aguarda os resultados da operação de alteração da configuração do cluster.

Essa configuração é selecionada por padrão.

Saídas da ação

A ação Definir complementos do cluster fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Definir complementos do 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"
}
Mensagens de saída

A ação Definir complementos do cluster pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir complementos do cluster:

Nome do resultado do script Valor
is_success True ou False

Definir rótulos de cluster

Use a ação Definir rótulos de cluster para definir rótulos para o cluster do GKE. A ação anexa novos rótulos aos rótulos de cluster atuais.

Se o cluster de destino já estiver passando por uma mudança de configuração, ele não poderá aceitar novas mudanças até que a atual seja concluída.

Essa ação é executada de forma assíncrona. Ajuste as configurações do ambiente de desenvolvimento integrado do Google SecOps conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir rótulos de cluster requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

Cluster Labels

Obrigatório.

Um objeto JSON que contém rótulos para adicionar ao cluster. A ação anexa novos rótulos aos rótulos de cluster atuais.

O valor padrão é o seguinte:

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

Opcional.

Se selecionada, a ação aguarda os resultados da operação de alteração da configuração do cluster.

Não selecionada por padrão.

Saídas da ação

A ação Definir rótulos de cluster fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Definir rótulos de 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"
}
Mensagens de saída

A ação Definir rótulos de cluster pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir rótulos de cluster:

Nome do resultado do script Valor
is_success True ou False

Definir o escalonamento automático de nós

Use a ação Definir escalonamento automático de nós para definir a configuração de escalonamento automático do pool de nós para o cluster do GKE. A ação é assíncrona.

Se o cluster de destino já estiver passando por uma mudança de configuração, ele não poderá aceitar novas mudanças até que a atual seja concluída.

Essa ação é executada de forma assíncrona. Ajuste as configurações do ambiente de desenvolvimento integrado do Google SecOps conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir escalonamento automático de nós requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

Node Pool Name

Obrigatório.

O nome do pool de nós do cluster.

Autoscaling Mode

Opcional.

O status do modo de escalonamento automático do pool de nós.

Os valores possíveis são os seguintes:

  • Not Changed
  • Enabled
  • Disabled

O valor padrão é Not Changed.

Minimum Node Count

Opcional.

O número mínimo de nós para a configuração do pool de nós.

Maximum Node Count

Opcional.

O número máximo de nós para a configuração do pool de nós.

Wait for cluster configuration change operation to finish

Opcional.

Se selecionada, a ação aguarda os resultados da operação de alteração da configuração do cluster.

Não selecionada por padrão.

Saídas da ação

A ação Definir escalonamento automático de nós fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Definir escalonamento automático de nós:

{
    "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"
}
Mensagens de saída

A ação Definir escalonamento automático de nós pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir escalonamento automático de nós:

Nome do resultado do script Valor
is_success True ou False

Definir o gerenciamento do pool de nós

Use a ação Definir gerenciamento de pool de nós para definir a configuração de gerenciamento de pool de nós para o cluster do GKE.

Essa ação é executada de forma assíncrona. Ajuste as configurações do ambiente de desenvolvimento integrado do Google SecOps conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir gerenciamento do pool de nós requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

Node Pool Name

Obrigatório.

O nome do pool de nós do cluster do GKE.

Auto Upgrade

Opcional.

O status do recurso de gerenciamento de upgrade automático.

Auto Repair

Opcional.

O status do recurso de gerenciamento de reparo automático.

Wait for cluster configuration change operation to finish

Opcional.

Se selecionada, a ação aguarda os resultados da operação de alteração da configuração do cluster.

Não selecionada por padrão.

Saídas da ação

A ação Definir gerenciamento do pool de nós fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Definir gerenciamento de pool de nós:

{
    "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"
}
Mensagens de saída

A ação Definir gerenciamento do pool de nós pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir gerenciamento do pool de nós:

Nome do resultado do script Valor
is_success True ou False

Definir a quantidade de nós

Use a ação Definir contagem de nós para definir a contagem de nós do pool de nós do cluster do GKE.

Essa ação é executada de forma assíncrona. Ajuste as configurações do ambiente de desenvolvimento integrado do Google SecOps conforme necessário.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Definir contagem de nós requer os seguintes parâmetros:

Parâmetro Descrição
Cluster Location

Obrigatório.

Um local para pesquisar clusters, como europe-central2-a.

Cluster Name

Obrigatório.

O nome do cluster a ser pesquisado.

Node Pool Name

Obrigatório.

O nome do pool de nós do cluster do GKE.

Node Count

Obrigatório.

O número de nós do pool de nós do cluster do GKE.

Wait for cluster configuration change operation to finish

Opcional.

Se selecionada, a ação aguarda os resultados da operação de alteração da configuração do cluster.

Não selecionada por padrão.

Saídas da ação

A ação Definir contagem de nós fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Definir contagem de nós:

{
    "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"
}
Mensagens de saída

A ação Definir contagem de nós pode retornar as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem

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.

A ação foi concluída.

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

Falha na ação.

Verifique a conexão com o servidor, os parâmetros de entrada ou as credenciais.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Definir contagem de nós:

Nome do resultado do script Valor
is_success True ou False

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.