Veja, edite e elimine orquestradores de políticas

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

Antes de começar

  • Reveja a política do SO e a atribuição da política do SO.
  • Reveja as quotas de configuração do SO.
  • Certifique-se de que cumpre os pré-requisitos para usar o orquestrador de políticas.
  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

Apresentar orquestradores de políticas do SO

Para ver todos os orquestradores de políticas num projeto, numa pasta ou numa organização, conclua os seguintes passos:

Consola

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

  1. Na Google Cloud consola, aceda à página Políticas de SO.

    Aceda às políticas de SO

  2. Clique no seletor de projetos na barra de ações da Google Cloud consola e selecione a pasta na qual quer criar o orquestrador de políticas.

  3. Clique em Orquestradores globais.

gcloud

Para ver os detalhes de um orquestrador de políticas criado numa pasta, execute o comando os-config policy-orchestrators list:

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

Substitua o seguinte:

Exemplo

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

REST

Para ver todos os orquestradores de políticas numa pasta, envie um pedido GET para o método folders.locations.global.policyOrchestrators.list:

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

Substitua FOLDER_NUMBER pelo ID numérico da pasta na qual criou os orquestradores de políticas.

Veja detalhes de um orquestrador de políticas

Para ver os detalhes de um orquestrador de políticas numa pasta, conclua os seguintes passos:

Consola

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

  1. Na Google Cloud consola, aceda à página Políticas de SO.

    Aceda às políticas de SO

  2. Clique no seletor de projetos na barra de ações da Google Cloud consola e, de seguida, selecione o projeto, a pasta ou a organização que contém o orquestrador de políticas.

  3. Clique em Orquestradores globais.

  4. Selecione o nome do orquestrador de políticas que quer ver. É apresentada a página Detalhes do organizador.

  5. Para ver os detalhes das políticas de SO aplicadas às VMs, aceda à secção Políticas de SO atribuídas e, de seguida, clique em Ver.

gcloud

Para ver os detalhes de um orquestrador de políticas criado numa pasta, execute o comando os-config policy-orchestrators describe:

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

Substitua o seguinte:

  • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação.
  • ORCHESTRATOR_NAME: nome do orquestrador de políticas.
  • FOLDER_NUMBER: o ID numérico da pasta na qual criou o orquestrador de políticas.

Exemplo

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

REST

Para ver os detalhes de um orquestrador de políticas, envie um pedido GET para o método folders.locations.global.policyOrchestrators.get,

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

Substitua o seguinte:

  • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação.
  • FOLDER_NUMBER: o ID numérico da pasta na qual o orquestrador de políticas existe.
  • ORCHESTRATOR_NAME: o nome do orquestrador de políticas que quer eliminar.

O corpo do pedido tem de estar vazio.

Edite os orquestradores de políticas de SO

Pode modificar os orquestradores de políticas para adicionar ou atualizar as atribuições de políticas do SO, o âmbito e os recursos do orquestrador.

Consola

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

  1. Na Google Cloud consola, aceda à página Políticas de SO.

    Aceda às políticas de SO

  2. Clique no seletor de projetos na barra de ações da Google Cloud consola e selecione o projeto, a pasta ou a organização em que o orquestrador de políticas existe.

  3. Clique em Orquestradores globais.

  4. Selecione o nome do orquestrador de políticas que quer editar. É apresentada a página Detalhes do organizador.

  5. Clique em Edit.

  6. Na secção Políticas de SO, carregue o ficheiro de políticas de SO.

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

    • ACTIVE: depois de criada, o orquestrador de políticas toma medidas imediatamente.
    • STOPPED: um orquestrador de políticas criado neste estado não toma medidas imediatamente. Pode editar o orquestrador de políticas mais tarde para alterar o respetivo estado.

  8. Na secção Âmbito da orquestração, especifique as pastas e os projetos nos quais quer implementar as políticas de SO. Tem de introduzir apenas os números dos projetos e os números das pastas nestes campos. Por exemplo, 123456, 7654321.

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

  10. Opcional: na secção Segmentar instâncias de VMs, especifique as VMs de destino às quais quer aplicar as políticas de SO.

    • Selecione as famílias de SO.

    • Pode filtrar ainda mais as VMs especificando etiquetas de inclusão e exclusão.

      Por exemplo, pode selecionar todas as VMs Ubuntu no seu ambiente de teste e excluir as que estão a executar o Google Kubernetes Engine, especificando o seguinte:

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

  11. Especifique um plano de implementação.

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

  12. Clique em Guardar.

gcloud

Para atualizar um orquestrador de políticas, use o comando os-config policy-orchestrators update.

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

Substitua o seguinte:

  • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação.
  • ORCHESTRATOR_NAME: nome do orquestrador de políticas.

  • FOLDER_NUMBER: o ID numérico da pasta na qual o orquestrador de políticas existe.

    Exemplo

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

REST

Para atualizar um orquestrador de políticas numa pasta, envie um pedido PATCH para o método folders.locations.global.policyOrchestrators.patch.

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

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

      {
        JSON_OS_POLICY_ORCHESTRATOR
      }

Substitua o seguinte:

  • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação
  • FOLDER_NUMBER: o ID numérico da pasta na qual o orquestrador de políticas existe.
  • ORCHESTRATOR_NAME: o nome do orquestrador de políticas que quer editar.
  • JSON_OS_POLICY_ORCHESTRATOR: o objeto do orquestrador de políticas no formato JSON que define o âmbito do orquestrador, 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.

Elimine um orquestrador de políticas

Para eliminar um orquestrador de políticas e cancelar todas as implementações em curso, conclua os seguintes passos:

Consola

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

  1. Na Google Cloud consola, aceda à página Políticas de SO.

    Aceda às políticas de SO

  2. Clique no seletor de projetos na barra de ações da Google Cloud consola e selecione o projeto, a pasta ou a organização a partir da qual quer eliminar o orquestrador de políticas.

  3. Clique em Orquestradores globais.

  4. Selecione o nome do orquestrador de políticas que quer eliminar. É apresentada a página Detalhes do organizador.

  5. Clique em Eliminar.

gcloud

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

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

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

    Substitua o seguinte:

    • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação.
    • ORCHESTRATOR_NAME: nome do orquestrador de políticas.
    • FOLDER_NUMBER: o ID numérico da pasta na qual criou o orquestrador de políticas.
    • POLICY_ID: o ID atribuído ao orquestrador de políticas.

    Exemplo

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

REST

Para eliminar um orquestrador de políticas numa pasta, envie um pedido DELETE para o método folders.locations.global.policyOrchestrators.delete:

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

Substitua o seguinte:

  • QUOTA_PROJECT_ID: o ID do projeto da quota ou do projeto de faturação.
  • FOLDER_NUMBER: o ID numérico da pasta na qual o orquestrador de políticas existe.
  • ORCHESTRATOR_NAME: o nome do orquestrador de políticas que quer eliminar.

O que se segue?