Conferir, editar e excluir orquestradores de políticas

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Esta página descreve como visualizar e excluir orquestradores de políticas nas suas pastas ou organização.

Antes de começar

• Analise a política do SO e a atribuição da política do SO.
• Revise as cotas de configuração do SO.
• Verifique se você atende aos pré-requisitos para usar o orquestrador de políticas.
• Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Listar todos os orquestradores de políticas em uma pasta

Para conferir todos os orquestradores de políticas em uma pasta, siga estas etapas:

Console

Para listar os orquestradores de políticas em uma pasta, faça o seguinte:

1. No console do Google Cloud, acesse a página Políticas do SO.

   Acessar as políticas do SO

2. Clique no Seletor de projetos na barra de ação do console do Google Cloud e selecione a pasta em que você quer criar o orquestrador de políticas.

3. Clique em Orquestradores de políticas.

gcloud

Para conferir os detalhes de um orquestrador de políticas criado em uma pasta, execute o comando beta os-config policy-orchestrators list:

  gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators list \
    --folder=FOLDER_NUMBER \

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
• FOLDER_NUMBER: o ID numérico da pasta em que você criou os orquestradores de políticas.

Exemplo

  gcloud beta compute os-config policy-orchestrators list \
    --folder=123456 \

REST

Para conferir todos os orquestradores de políticas em uma pasta, envie uma solicitação GET para o método folders.locations.global.policyOrchestrators.list:

GET https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Substitua FOLDER_NUMBER pelo ID numérico da pasta em que você criou os orquestradores de políticas.

Conferir detalhes de um orquestrador de políticas

Para conferir os detalhes de um orquestrador de políticas em uma pasta, siga estas etapas:

Console

Para conferir um orquestrador de políticas, faça o seguinte:

1. No console do Google Cloud, acesse a página Políticas do SO.

   Acessar as políticas do SO

2. Clique no Seletor de projetos na barra de ação do console do Google Cloud e selecione a pasta em que você quer criar o orquestrador de políticas.

3. Clique em Orquestradores de políticas.

4. Selecione o nome do orquestrador de políticas que você quer acessar. A página Detalhes do orquestrador é aberta.

5. Para conferir os detalhes das políticas do SO aplicadas às VMs, clique em Modelo de política do SO.

gcloud

Para conferir os detalhes de um orquestrador de políticas criado em uma pasta, execute o comando beta os-config policy-orchestrators describe:

gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators describe ORCHESTRATOR_NAME \
  --folder=FOLDER_NUMBER \

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
• ORCHESTRATOR_NAME: nome do orquestrador de políticas.
• FOLDER_NUMBER: o ID numérico da pasta em que você criou o orquestrador de políticas.

Exemplo

  gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators describe my-os-policy-orchestrator \
      --folder=123456 \

REST

Para conferir detalhes de um orquestrador de políticas, envie uma solicitação GET ao método folders.locations.global.policyOrchestrators.get.

GET https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
• FOLDER_NUMBER: o ID numérico da pasta em que o orquestrador de políticas existe.
• ORCHESTRATOR_NAME: o nome do orquestrador de políticas que você quer excluir.

O corpo da solicitação precisa estar vazio.

Editar um orquestrador de políticas

É possível modificar os orquestradores de políticas para adicionar ou atualizar as atribuições de políticas do SO, escopo do orquestrador e recursos.

Console

Para mudar as configurações de um orquestrador de políticas, faça o seguinte:

1. No console do Google Cloud, acesse a página Políticas do SO.

   Acessar as políticas do SO

2. Clique no Seletor de projetos na barra de ação do console do Google Cloud e selecione a pasta em que você quer criar o orquestrador de políticas.

3. Clique em Orquestradores de políticas.

4. Selecione o nome do orquestrador de políticas que você quer editar. A página Detalhes do orquestrador é aberta.

5. Clique em Editar.

6. Na seção Políticas do SO, faça upload do arquivo da política do SO.

7. Opcional: na seção Estado, selecione uma das seguintes opções para especificar o comportamento do orquestrador de políticas:

   • ACTIVE: depois de criado, o orquestrador de políticas realiza ações imediatamente.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. Você pode editar o orquestrador de políticas mais tarde para mudar o estado dele.

8. Na seção Escopo da orquestração, especifique as pastas e os projetos em que você quer implementar as políticas do SO. Insira apenas os números de projeto e de pastas nesses campos. Por exemplo, 123456 ou 7654321.

9. Opcional: selecione as zonas que contêm as VMs às quais você quer aplicar as políticas do SO.

10. Opcional: na seção Instâncias de VM de destino, especifique as VMs de destino a que você quer aplicar as políticas do SO.

    • Selecione as famílias do SO.

    • É possível filtrar ainda mais as VMs especificando rótulos de inclusão e exclusão.

      Por exemplo, é possível selecionar todas as VMs do Ubuntu no ambiente de teste e excluir aquelas que executam o Google Kubernetes Engine. Basta especificar o seguinte:

      • Família do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node

11. Especifique um plano de lançamento.

    • Especifica o tamanho da onda (também conhecido como orçamento de interrupção). Por exemplo, 10%.
    • Especifique o tempo de espera. Por exemplo, 15 minutes.

12. Clique em Salvar.

gcloud

Para atualizar um orquestrador de políticas em uma pasta, siga estas etapas:

1. Use o comando beta os-config policy-orchestrators update para editar o orquestrador de políticas em uma pasta especificada.

     gcloud --billing-project=QUOTA_PROJECT_ID beta compute os-config policy-orchestrators update ORCHESTRATOR_NAME \
       --folder=FOLDER_NUMBER \
       --state=stopped
   

   Substitua:

   • QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
   • ORCHESTRATOR_NAME: nome do orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos.
   • FOLDER_NUMBER: o ID numérico da pasta em que o orquestrador de políticas existe.

   Exemplo

     gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators update my-os-policy-orchestrator \
       --folder=123456 \
       --include-projects=5432134,4567890
   

REST

Para atualizar um orquestrador de políticas em uma pasta, conclua as etapas a seguir e envie uma solicitação PATCH para o método folders.locations.global.policyOrchestrators.patch.

No corpo da solicitação, edite as especificações de atribuição da política do SO.

    PATCH https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
    -H "x-goog-user-project: QUOTA_PROJECT_ID"

      {
        JSON_OS_POLICY_ORCHESTRATOR
      }

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento
• FOLDER_NUMBER: o ID numérico da pasta em que o orquestrador de políticas existe.
• ORCHESTRATOR_NAME: o nome do orquestrador de políticas que você quer editar.
• JSON_OS_POLICY_ORCHESTRATOR: o objeto orquestrador de políticas em formato JSON que define o escopo, o recurso orquestrado e o estado de orquestração. Para mais informações sobre os parâmetros e o formato, consulte Resource: folders.locations.global.policyOrchestrators.

Excluir um orquestrador de políticas

Observação: a exclusão de um orquestrador de políticas exclui apenas o recurso do orquestrador de políticas do escopo especificado, não as atribuições de política do SO aplicadas aos recursos zonais. Se você quiser excluir as atribuições de política do SO criadas por um orquestrador de políticas, edite o orquestrador e mude o action para delete. Depois que o orquestrador exclui as atribuições de políticas do SO, exclua o orquestrador.

Para excluir um orquestrador de políticas e cancelar todas as implantações em andamento, siga estas etapas:

Console

Para excluir um orquestrador de políticas, faça o seguinte:

1. No console do Google Cloud, acesse a página Políticas do SO.

   Acessar as políticas do SO

2. Clique no Seletor de projetos na barra de ação do console do Google Cloud e selecione a pasta em que você quer criar o orquestrador de políticas.

3. Clique em Orquestradores de políticas.

4. Selecione o nome do orquestrador de políticas que você quer excluir. A página Detalhes do orquestrador é aberta.

5. Clique em Excluir.

gcloud

Para excluir um orquestrador de políticas de uma pasta, faça o seguinte:

1. Use o comando beta os-config policy-orchestrators delete:

     gcloud --billing-project=QUOTA_PROJECT_IDbeta compute os-config policy-orchestrators delete ORCHESTRATOR_NAME \
       --folder=FOLDER_NUMBER \
       --policy-id=POLICY_ID
   

   Substitua:

   • QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
   • ORCHESTRATOR_NAME: nome do orquestrador de políticas.
   • FOLDER_NUMBER: o ID numérico da pasta em que você criou o orquestrador de políticas.
   • POLICY_ID: o ID atribuído ao orquestrador de políticas.

   Exemplo

     gcloud --billing-project=my-quota-project beta compute os-config policy-orchestrators create my-os-policy-orchestrator \
       --folder=123456 \
       --policy-id=my-policy
   

REST

Para excluir um orquestrador de políticas em uma pasta, envie uma solicitação DELETE para o método folders.locations.global.policyOrchestrators.delete:

DELETE https://osconfig.googleapis.com/v2beta/folders/FOLDER_NUMBER/locations/global/policyOrchestrators/ORCHESTRATOR_NAME
-H "x-goog-user-project: QUOTA_PROJECT_ID"

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto da cota ou do projeto de faturamento.
• FOLDER_NUMBER: o ID numérico da pasta em que o orquestrador de políticas existe.
• ORCHESTRATOR_NAME: o nome do orquestrador de políticas que você quer excluir.

A seguir

• Saiba como gerenciar atribuições de políticas do SO usando o Policy Orchestrator.