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:
Criar e configurar um papel personalizado do Identity and Access Management.
Escolha e configure um dos seguintes métodos de autenticação:
Opção 1: Identidade da carga de trabalho (recomendado): esse método usa tokens de curta duração por meio da identidade temporária de conta de serviço.
Opção 2: chave JSON da conta de serviço: esse método depende de um arquivo de chave secreta estático e de longa duração.
Criar e configurar um papel do IAM
Para fornecer à integração as permissões necessárias, crie um papel personalizado no projeto:
No console do Google Cloud , acesse Papéis.
Clique em Criar papel.
Forneça um Título (por exemplo,
SecOps GKE Analyst), uma Descrição e um ID exclusivo.Defina o Estágio de lançamento do papel como Disponibilidade geral.
Adicione as seguintes permissões ao papel:
container.clusters.listcontainer.clusters.updatecontainer.clusters.getcontainer.operations.listcontainer.operations.get
Clique em Criar.
Criar uma conta de serviço
No console do Google Cloud , acesse IAM e administrador > Contas de serviço.
Clique em addCriar conta de serviço.
Insira um nome e uma descrição e clique em Criar e continuar.
Na etapa Conceder a essa conta de serviço acesso ao projeto, atribua o papel personalizado do IAM que você criou.
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.
No Google SecOps, acesse Hub de conteúdo > Integrações de resposta.
Selecione a integração do GKE e insira o e-mail da sua conta de serviço no campo
Workload Identity Email.Clique em Salvar > Testar. O teste deve falhar.
Clique no botão close_small ao lado de Teste e localize o e-mail de identidade que começa com
gke-init-python@...ousoar-python@....Copie esse endereço de e-mail exclusivo.
Autorize a identidade da instância em Google Cloud.
No console do Google Cloud , acesse IAM e administrador > Contas de serviço.
Selecione a conta de serviço de destino e acesse Permissões > Conceder acesso.
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.
No console do Google Cloud , acesse o IAM do projeto usado como projeto de cota.
Localize sua conta de serviço e clique em Editar principal (editar).
Clique em Adicionar outro papel e selecione Consumidor do Service Usage (
roles/serviceusage.serviceUsageConsumer).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.
No console do Google Cloud , acesse IAM e administrador > Contas de serviço e selecione sua conta de serviço.
Acesse a guia Chaves e clique em Adicionar chave > Criar nova chave.
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 EmaileQuota Project ID.Arquivo JSON da conta de serviço: usa
Service Account Json File Contentpara 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 é |
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
|
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 é |
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 |
Private Key ID |
Opcional. O valor encontrado no campo |
Private Key |
Opcional. O valor encontrado no campo |
Client Email |
Opcional. O valor encontrado no campo |
Client ID |
Opcional. O valor encontrado no campo |
Auth URI |
Opcional. O valor encontrado no campo O padrão é |
Token URI |
Opcional. O valor encontrado no campo O padrão é |
Auth Provider X509 URL |
Opcional. O valor encontrado no campo |
Client X509 URL |
Opcional. O valor encontrado no campo |
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
|
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 |
|---|---|
|
A ação foi concluída. |
|
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
|
Filter Logic |
Opcional. A lógica de filtro que será aplicada. A lógica de filtragem
funciona com o campo Os valores possíveis são os seguintes:
O valor padrão é |
Filter Value |
Opcional. O valor a ser usado no filtro. A lógica de filtragem
funciona com o campo Se você definir o
parâmetro |
Max Records To Return |
Opcional. O número de registros que serão retornados. O valor padrão é |
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
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 Os valores possíveis são os seguintes:
O valor padrão é |
Filter Value |
Opcional. O valor a ser usado no filtro. A lógica de filtragem
funciona com o campo Se você definir o
parâmetro |
Max Records To Return |
Opcional. O número de registros que serão retornados. O valor padrão é |
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
Filter Logic |
Opcional. A lógica de filtro que será aplicada. A lógica de filtragem
funciona com o campo Os valores possíveis são os seguintes:
O valor padrão é |
Filter Value |
Opcional. O valor a ser usado no filtro. A lógica de filtragem
funciona com o campo Se você definir o
parâmetro |
Max Records To Return |
Opcional. O número de registros que serão retornados. O valor padrão é |
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
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:
O valor padrão é |
Horizontal Pod Autoscaling |
Opcional. O valor do complemento de escalonamento automático horizontal de pods. Os valores possíveis são os seguintes:
O valor padrão é |
Network Policy Config |
Opcional. O valor do complemento de configuração da política de rede. Os valores possíveis são os seguintes:
O valor padrão é |
Cloud Run Config |
Opcional. O valor do complemento de configuração do Cloud Run. Os valores possíveis são os seguintes:
O valor padrão é |
DNS Cache Config |
Opcional. O valor do complemento de configuração do cache de DNS. Os valores possíveis são os seguintes:
O valor padrão é |
Config Connector Config |
Opcional. O valor do complemento de configuração do Config Connector. Os valores possíveis são os seguintes:
O valor padrão é |
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:
O valor padrão é |
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
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 |
|---|---|
|
A ação foi concluída. |
|
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
|
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:
O valor padrão é |
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
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 |
|---|---|
|
A ação foi concluída. |
|
|
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
|
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 |
|---|---|
|
A ação foi concluída. |
|
|
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.