Gerenciar atribuições de políticas do SO usando o orquestrador de políticas

Console

Para criar um orquestrador de políticas e aplicar atribuições de políticas de SO em um projeto, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console do Cloud de Confiance e selecione o projeto em que você quer criar o orquestrador de políticas.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Para mais informações sobre convenções de nomenclatura, consulte Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
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: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. É possível editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione a ação UPSERT.
9. Na seção Escopo da orquestração, especifique as pastas e projetos em que você quer lançar as políticas do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs às quais você quer aplicar as políticas do SO. Ou clique em Selecionar tudo para aplicar as mudanças da política do SO a recursos em todas as zonas.
11. 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 o nome e a versão do SO. Para mais informações, consulte Atribuições de políticas do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um arquivo de atribuição de política do SO no formato JSON ou YAML. Para mais informações sobre esse arquivo e exemplos de atribuições de política, consulte Atribuições de política do SO.

2. Use o comando os-config policy-orchestrators create para criar e implantar a atribuição de política do SO no escopo especificado.

     gcloud compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
       --policy-type=os_policy_assignment_v1 \
       --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
       --policy-id=POLICY_ID
   

   Substitua:

   • ORCHESTRATOR_NAME: nome do orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos.
   • OS_POLICY_ASSIGNMENT_FILE: o caminho absoluto para o arquivo de atribuição de política do SO que você criou na etapa anterior.
   • POLICY_ID: um ID exclusivo para o orquestrador de políticas. Se você não especificar um valor, o orquestrador de políticas vai atribuir um ID exclusivo ao recurso.

   Exemplo

     gcloud compute os-config policy-orchestrators create my-os-policy-orchestrator \
         --policy-type=os_policy_assignment_v1 \
         --policy-file=/downloads/assignment-config.yaml \
         --policy-id=policy-123
   

REST

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um arquivo de atribuição de política do SO. Ele precisa ser um arquivo JSON. Para mais informações sobre como criar atribuições de política do SO ou ver amostras de atribuições de política do SO, consulte Atribuição de política do SO.

2. Dependendo do escopo em que você está criando o orquestrador de políticas, use um dos seguintes métodos:

   Envie uma solicitação POST para o método projects.locations.global.policyOrchestrators.create.

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

   POST https://osconfig.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/policyOrchestrators
   
     {
         JSON_OS_POLICY_ORCHESTRATOR
     }
   

   Substitua:

   • PROJECT_NUMBER: o ID numérico do projeto em que você quer criar o orquestrador de políticas.
   • JSON_OS_POLICY_ORCHESTRATOR: o objeto do orquestrador de políticas no formato JSON que define o escopo do orquestrador, o recurso orquestrado e o estado da orquestração. Para mais informações sobre os parâmetros e o formato, consulte Resource: folders.locations.global.policyOrchestrators.

   Exemplo

   Por exemplo, para criar uma atribuição de política de SO que instale um arquivo MSI do Windows transferido por download de um bucket do Cloud Storage usando o exemplo de atribuição de política de SO, conclua as seguintes etapas:

   1. Converta a amostra em um arquivo JSON.

   2. Faça a seguinte solicitação:

      POST https://osconfig.googleapis.com/v2/projects/123456/locations/global/policyOrchestrators
      
      {
      "action": "UPSERT",
      "orchestratedResource": {
        "osPolicyAssignmentV1Payload": {
          "instanceFilter": {
            "inventories": [
              {
                "osShortName": "windows"
              }
            ]
          },
          "osPolicies": [
          {
            "id": "install-msi-policy",
            "mode": "ENFORCEMENT",
            "resourceGroups": [
              {
                "resources": [
                  {
                    "id": "install-msi",
                    "pkg": {
                      "desiredState": "INSTALLED",
                      "msi": {
                        "source": {
                          "gcs": {
                            "bucket": "my-bucket",
                            "generation": "1619136883923956",
                            "object": "my-app.msi"
                          }
                        }
                      }
                    }
                  }
                ]
              }
            ]
          }
          ],
          "rollout": {
            "disruptionBudget": {
              "fixed": 10
            },
            "minWaitDuration": "300s"
          }
        }
      },
      "orchestrationScope": {
      "selectors": [
        {
           "resourceHierarchySelector": {
              "includedProjects": [
              "projects/87654321",
              "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
      }
      

Console

Para criar um orquestrador de políticas e aplicar atribuições de políticas de SO em uma pasta, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console do Cloud de Confiance e selecione a pasta em que você quer criar o orquestrador de políticas.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Para mais informações sobre convenções de nomenclatura, consulte Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
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: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. É possível editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione a ação UPSERT.
9. Na seção Escopo da orquestração, especifique as pastas e projetos em que você quer lançar as políticas do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs às quais você quer aplicar as políticas do SO. Ou clique em Selecionar tudo para aplicar as mudanças da política do SO a recursos em todas as zonas.
11. 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 o nome e a versão do SO. Para mais informações, consulte Atribuições de políticas do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um arquivo de atribuição de política do SO no formato JSON ou YAML. Para mais informações sobre esse arquivo e exemplos de atribuições de política, consulte Atribuições de política do SO.

2. Use o comando os-config policy-orchestrators create para criar e implantar a atribuição de política do SO no escopo especificado.

     gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
       --folder=FOLDER_NUMBER \
       --policy-type=os_policy_assignment_v1 \
       --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
       --policy-id=POLICY_ID \
       --include-projects=PROJECT_NUMBERS
   

   Substitua:

   • QUOTA_PROJECT_ID: o ID do projeto do projeto de cota ou o projeto de faturamento.
   • ORCHESTRATOR_NAME: nome do orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos.
   • FOLDER_NUMBER: o número da pasta em que você quer criar o orquestrador de políticas.
   • OS_POLICY_ASSIGNMENT_FILE: o caminho absoluto para o arquivo de atribuição de política do SO que você criou na etapa anterior.
   • POLICY_ID: um ID exclusivo para o orquestrador de políticas. Se você não especificar um valor, o orquestrador de políticas vai atribuir um ID exclusivo ao recurso.
   • PROJECT_NUMBERS: uma lista de projetos em que você quer aplicar as atribuições de política do SO. É necessário especificar os números do projeto, o ID numérico exclusivo dos projetos.

   Exemplo

     gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
         --folder=123456 \
         --policy-type=os_policy_assignment_v1 \
         --policy-file=/downloads/assignment-config.yaml \
         --policy-id=policy-123 \
         --include-projects=87654321,4567890
   

REST

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um arquivo de atribuição de política do SO. Ele precisa estar no formato JSON. Para mais informações sobre como criar atribuições de política do SO ou ver amostras de atribuições de política do SO, consulte Atribuição de política do SO.

2. Dependendo do escopo em que você está criando o orquestrador de políticas, use um dos seguintes métodos:

   Envie uma solicitação POST para o método folders.locations.global.policyOrchestrators.create.

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

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

   Substitua:

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

   Exemplo

   Por exemplo, para criar uma atribuição de política de SO que instale um arquivo MSI do Windows transferido por download de um bucket do Cloud Storage usando o exemplo de atribuição de política de SO, conclua as seguintes etapas:

   1. Converter a amostra em JSON

   2. Faça a seguinte solicitação:

      POST https://osconfig.googleapis.com/v2/folders/123456/locations/global/policyOrchestrators \
      -H "x-goog-user-project: my-quota-project
      
      {
      "action": "UPSERT",
      "orchestratedResource": {
        "osPolicyAssignmentV1Payload": {
          "instanceFilter": {
            "inventories": [
              {
                "osShortName": "windows"
              }
            ]
          },
          "osPolicies": [
          {
            "id": "install-msi-policy",
            "mode": "ENFORCEMENT",
            "resourceGroups": [
              {
                "resources": [
                  {
                    "id": "install-msi",
                    "pkg": {
                      "desiredState": "INSTALLED",
                      "msi": {
                        "source": {
                          "gcs": {
                            "bucket": "my-bucket",
                            "generation": "1619136883923956",
                            "object": "my-app.msi"
                          }
                        }
                      }
                    }
                  }
                ]
              }
            ]
          }
          ],
          "rollout": {
            "disruptionBudget": {
              "fixed": 10
            },
            "minWaitDuration": "300s"
          }
        }
      },
      "orchestrationScope": {
      "selectors": [
        {
           "resourceHierarchySelector": {
              "includedProjects": [
              "projects/87654321",
              "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
      }
      

Console

Para criar um orquestrador de políticas e aplicar atribuições de políticas de SO em uma organização, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console Cloud de Confiance e selecione a organização em que você quer criar o orquestrador de políticas.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Para mais informações sobre convenções de nomenclatura, consulte Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
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: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. É possível editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione a ação UPSERT.
9. Na seção Escopo da orquestração, especifique as pastas e projetos em que você quer lançar as políticas do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs às quais você quer aplicar as políticas do SO. Ou clique em Selecionar tudo para aplicar as mudanças da política do SO a recursos em todas as zonas.
11. 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 o nome e a versão do SO. Para mais informações, consulte Atribuições de políticas do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um recurso de atribuição de política do SO no formato JSON ou YAML. Para mais informações sobre esse arquivo e exemplos de atribuições de política, consulte Atribuições de política do SO.

2. Use o comando os-config policy-orchestrators create para criar e implantar a atribuição de política do SO no escopo especificado.

     gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
       --organization=ORGANIZATION_NUMBER \
       --policy-type=os_policy_assignment_v1 \
       --policy-file=OS_POLICY_ASSIGNMENT_YAML_FILE \
       --policy-id=POLICY_ID \
       --include-projects=PROJECT_NUMBERS
   

   Substitua:

   • QUOTA_PROJECT_ID: o ID do projeto do projeto de cota ou o projeto de faturamento.
   • ORCHESTRATOR_NAME: nome do orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos.
   • FOLDER_NUMBER: o número da pasta em que você quer criar o orquestrador de políticas.
   • OS_POLICY_ASSIGNMENT_FILE: o caminho absoluto para o arquivo de atribuição de política do SO que você criou na etapa anterior.
   • POLICY_ID: um ID exclusivo para o orquestrador de políticas. Se você não especificar um valor, o orquestrador de políticas vai atribuir um ID exclusivo ao recurso.
   • PROJECT_NUMBERS: uma lista de projetos em que você quer aplicar as atribuições de política do SO. É necessário especificar os números do projeto, o ID numérico exclusivo dos projetos.

   Exemplo

     gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
         --organization=123456 \
         --policy-type=os_policy_assignment_v1 \
         --policy-file=/downloads/assignment-config.yaml \
         --policy-id=policy-123 \
         --include-projects=87654321,4567890
   

REST

Para criar um orquestrador de políticas, siga estas etapas:

1. Crie ou faça o download de um arquivo de atribuição de política do SO. Ele precisa ser um arquivo JSON. Para mais informações sobre como criar atribuições de política do SO ou ver amostras de atribuições de política do SO, consulte Atribuição da política do SO.

2. Dependendo do escopo em que você está criando o orquestrador de políticas, use um dos seguintes métodos:

   Envie uma solicitação POST para o método organizations.locations.global.policyOrchestrators.create.

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

   POST https://osconfig.googleapis.com/v2/organizations/ORGANIZATION_NUMBER/locations/global/policyOrchestrators \
   -H "x-goog-user-project: QUOTA_PROJECT_ID"
   
     {
         JSON_OS_POLICY_ORCHESTRATOR
     }
   

   Substitua:

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

   Exemplo

   Por exemplo, para criar uma atribuição de política de SO que instale um arquivo MSI do Windows transferido por download de um bucket do Cloud Storage usando o exemplo de atribuição de política de SO, conclua as seguintes etapas:

   1. Converter a amostra em JSON

   2. Faça a seguinte solicitação:

      POST https://osconfig.googleapis.com/v2/organizations/567890/locations/global/policyOrchestrators \
      -H "x-goog-user-project: my-quota-project
      {
      "action": "UPSERT",
      "orchestratedResource": {
        "osPolicyAssignmentV1Payload": {
          "instanceFilter": {
            "inventories": [
              {
                "osShortName": "windows"
              }
            ]
          },
          "osPolicies": [
          {
            "id": "install-msi-policy",
            "mode": "ENFORCEMENT",
            "resourceGroups": [
              {
                "resources": [
                  {
                    "id": "install-msi",
                    "pkg": {
                      "desiredState": "INSTALLED",
                      "msi": {
                        "source": {
                          "gcs": {
                            "bucket": "my-bucket",
                            "generation": "1619136883923956",
                            "object": "my-app.msi"
                          }
                        }
                      }
                    }
                  }
                ]
              }
            ]
          }
          ],
          "rollout": {
            "disruptionBudget": {
              "fixed": 10
            },
            "minWaitDuration": "300s"
          }
        }
      },
      "orchestrationScope": {
      "selectors": [
        {
           "resourceHierarchySelector": {
              "includedProjects": [
              "projects/87654321",
              "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
      }
      

Console

Para excluir atribuições de política de SO em um projeto, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console Cloud de Confiance e selecione o projeto de que você quer excluir as atribuições de política do SO.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
6. Na seção Políticas do SO, selecione e faça upload do arquivo da política do SO que você quer excluir.
7. Opcional: na seção Estado, selecione uma das seguintes opções para especificar o comportamento do orquestrador de políticas:
   • ACTIVE: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. Você pode editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione EXCLUIR.
9. Na seção Escopo da orquestração, especifique as pastas e os projetos de que você quer excluir as atribuições de política do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs de que você quer excluir as atribuições de política do SO.
11. Opcional: na seção Instâncias de VM de destino, especifique as VMs de destino de que você quer excluir as atribuições de política do SO.
    • Selecione as famílias do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para excluir a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para excluir políticas do SO de vários projetos usando um orquestrador de políticas, use o comando os-config policy-orchestrators create e especifique a ação como delete para o policy-id associado à atribuição de política do SO.

    gcloud compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
      --policy-type=os_policy_assignment_v1 \
      --policy-file=OS_POLICY_ASSIGNMENT_FILE \
      --policy-id=POLICY_ID \
      --action=delete

Substitua:

• ORCHESTRATOR_NAME: nome do orquestrador de políticas.
• OS_POLICY_ASSIGNMENT_FILE: o caminho absoluto para o arquivo de atribuição de política do SO.
• POLICY_ID: o ID da política para o recurso do orquestrador de políticas do SO.

Exemplo

   gcloud compute os-config policy-orchestrators create my-os-policy-orchestrator \
     --policy-type=os_policy_assignment_v1
     --policy-id=my-policy \
     --action=delete

REST

Para criar um orquestrador de políticas que exclua políticas do SO de vários projetos, use um dos seguintes métodos e especifique a ação como DELETE:

Envie uma solicitação POST para o método projects.locations.global.policyOrchestrators.create.

No corpo da solicitação, especifique o ID da política associada à atribuição de política do SO.

  POST https://osconfig.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/policyOrchestrators

    {
        JSON_OS_POLICY_ORCHESTRATOR
    }
  

Substitua:

• PROJECT_NUMBER: o ID numérico do projeto em que você quer criar o orquestrador de políticas.

• JSON_OS_POLICY_ORCHESTRATOR: o objeto do orquestrador de políticas no formato JSON que define o escopo do orquestrador, o recurso orquestrado e o estado da orquestração. Para mais informações sobre os parâmetros e o formato, consulte Resource: folders.locations.global.policyOrchestrators.

  Exemplo

  POST https://osconfig.googleapis.com/v2/projects/567890/locations/global/policyOrchestrators
  
  {
    "action": "DELETE",
    "orchestratedResource": {
      "id": "my-policy",
      "osPolicyAssignmentV1Payload": {}
    },
    "orchestrationScope": {
      "selectors": [
        {
          "resourceHierarchySelector": {
            "includedProjects": [
              "projects/87654321",
              "projects/4567890"
            ]
          }
        }
      ]
    },
    "state": "ACTIVE"
  }
  

Console

Para excluir atribuições de política de SO em uma pasta, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console Cloud de Confiance e selecione a pasta de onde você quer excluir as atribuições de política do SO.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
6. Na seção Políticas do SO, selecione e faça upload do arquivo da política do SO que você quer excluir.
7. Opcional: na seção Estado, selecione uma das seguintes opções para especificar o comportamento do orquestrador de políticas:
   • ACTIVE: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. Você pode editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione EXCLUIR.
9. Na seção Escopo da orquestração, especifique as pastas e os projetos de que você quer excluir as atribuições de política do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs de que você quer excluir as atribuições de política do SO.
11. Opcional: na seção Instâncias de VM de destino, especifique as VMs de destino de que você quer excluir as atribuições de política do SO.
    • Selecione as famílias do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para excluir a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para excluir políticas do SO de vários projetos usando um orquestrador de políticas, use o comando os-config policy-orchestrators create e especifique a ação como delete para o policy-id associado à atribuição de política do SO.

    gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
      --policy-type=os_policy_assignment_v1 \
      --policy-id=POLICY_ID \
      --action=delete

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto de cota ou faturamento.
• ORCHESTRATOR_NAME: nome do orquestrador de políticas.
• FOLDER_NUMBER: o ID numérico da pasta de onde você quer excluir os recursos da política do SO.
• POLICY_ID: o ID da política para o recurso do orquestrador de políticas do SO.

Exemplo

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

REST

Para criar um orquestrador de políticas que exclua políticas do SO de vários projetos, use um dos seguintes métodos e especifique a ação como DELETE:

Envie uma solicitação POST para o método folders.locations.global.policyOrchestrators.create.

No corpo da solicitação, especifique o ID da política associada à atribuição de política do SO.

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

 {
    JSON_OS_POLICY_ORCHESTRATOR
 }

Substitua:

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

Exemplo

Por exemplo, para excluir recursos de política de SO de vários projetos, faça a seguinte solicitação:

   POST https://osconfig.googleapis.com/v2/folders/567890/locations/global/policyOrchestrators
   -H "x-goog-user-project: my-quota-project


{
      "action": "DELETE",
      "orchestratedResource": {
        "id": "my-policy",
        "osPolicyAssignmentV1Payload": {}
      },
      "orchestrationScope": {
        "selectors": [
          {
            "resourceHierarchySelector": {
              "includedProjects": [
                "projects/87654321",
                "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
    }
 

Console

Para excluir atribuições de políticas de SO em uma organização, faça o seguinte:

1. No cliente local, crie ou faça o download de um arquivo de política do SO. Ele precisa ser um arquivo JSON ou YAML. Para mais informações sobre como criar políticas do SO ou ver amostras de políticas do SO, consulte Políticas do SO.
2. No console do Cloud de Confiance , acesse a página Políticas do SO.

   Acessar as políticas do SO

3. Clique no Seletor de projetos na barra de ações do console Cloud de Confiance e selecione a organização de que você quer excluir as atribuições de política do SO.
4. Clique em Criar global.
5. Especifique um nome e uma descrição para o orquestrador de políticas. Consulte a Convenção de nomenclatura de recursos. O VM Manager atribui um ID exclusivo ao orquestrador de políticas. É possível editar esse ID, se necessário.
6. Na seção Políticas do SO, selecione e faça upload do arquivo da política do SO que você quer excluir.
7. Opcional: na seção Estado, selecione uma das seguintes opções para especificar o comportamento do orquestrador de políticas:
   • ACTIVE: nesse estado, o orquestrador de políticas pode realizar ações assim que é criado.
   • STOPPED: um orquestrador de políticas criado nesse estado não realiza nenhuma ação imediatamente. Você pode editar o orquestrador de políticas depois para mudar o estado dele.
8. No campo Ação, selecione EXCLUIR.
9. Na seção Escopo da orquestração, especifique as pastas e os projetos de que você quer excluir as atribuições de política do SO. Insira apenas os números do projeto e da pasta nesses campos, por exemplo, 123456,7654321.
10. Selecione as zonas que contêm as VMs de que você quer excluir as atribuições de política do SO.
11. Opcional: na seção Instâncias de VM de destino, especifique as VMs de destino de que você quer excluir as atribuições de política do SO.
    • Selecione as famílias do SO.
    • É possível filtrar ainda mais as VMs especificando inclusões e exclusões.

      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:

      • Nome curto do SO: ubuntu
      • Incluir: env:test, env:staging
      • Excluir: goog-gke-node
12. Especifique um plano de lançamento para excluir a atribuição de política do SO.
    • 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.
13. Clique em Criar.

gcloud

Para excluir políticas do SO de vários projetos usando um orquestrador de políticas, use o comando os-config policy-orchestrators create e especifique a ação como delete para o policy-id associado à atribuição de política do SO.

  gcloud --billing-project=QUOTA_PROJECT_ID compute os-config policy-orchestrators create ORCHESTRATOR_NAME \
    --organization=ORGANIZATION_NUMBER \
    --policy-type=os_policy_assignment_v1 \
    --policy-id=POLICY_ID \
    --action=delete

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto de cota ou faturamento.
• ORCHESTRATOR_NAME: nome do orquestrador de políticas.
• ORGANIZATION_NUMBER: o ID numérico da organização de que você quer excluir os recursos da política do SO.
• POLICY_ID: o ID da política para o recurso do orquestrador de políticas do SO.

Exemplo

  gcloud --billing-project=my-quota-project compute os-config policy-orchestrators create my-os-policy-orchestrator \
    --organization=987654321
    --policy-type=os_policy_assignment_v1
    --policy-id=my-policy \
    --action=delete

REST

Para criar um orquestrador de políticas que exclua políticas do SO de vários projetos, use um dos seguintes métodos e especifique a ação como DELETE:

Envie uma solicitação POST para o método organizations.locations.global.policyOrchestrators.create.

No corpo da solicitação, especifique o ID da política associada à atribuição de política do SO.

 POST https://osconfig.googleapis.com/v2/organizations/ORGANIZATION_NUMBER/locations/global/policyOrchestrators
-H "x-goog-user-project: QUOTA_PROJECT_ID"

{
    JSON_OS_POLICY_ORCHESTRATOR
}

Substitua:

• QUOTA_PROJECT_ID: o ID do projeto de cota ou faturamento.
• ORGANIZATION_NUMBER: o ID numérico da organização de que você quer excluir os recursos da política do SO.
• JSON_OS_POLICY_ORCHESTRATOR: o objeto do orquestrador de políticas no formato JSON que define o ID da política, o escopo do orquestrador, o recurso orquestrado e o estado da orquestração. Para mais informações sobre os parâmetros e o formato, consulte Resource: organizations.locations.global.policyOrchestrators.

Exemplo

Por exemplo, para excluir recursos de política do SO de vários projetos, envie a seguinte solicitação:

  POST https://osconfig.googleapis.com/v2/organizations/567890/locations/global/policyOrchestrators
  -H "x-goog-user-project: my-quota-project


{
      "action": "DELETE",
      "orchestratedResource": {
        "id": "my-policy",
        "osPolicyAssignmentV1Payload": {}
      },
      "orchestrationScope": {
        "selectors": [
          {
            "resourceHierarchySelector": {
              "includedProjects": [
                "projects/87654321",
                "projects/4567890"
              ]
            }
          }
        ]
      },
      "state": "ACTIVE"
    }