Neste documento, apresentamos uma visão geral das políticas globais de extensão de VM no Gerenciador de Extensões de VM. Com as políticas de extensão global, é possível implantar e gerenciar extensões em todas as zonas e regiões de um projeto, pasta ou organização para manter configurações de frota consistentes sem gerenciar políticas por zona.
Para mais informações sobre os níveis de hierarquia das políticas de extensão, consulte Escopos da hierarquia de recursos.
O diagrama a seguir ilustra como as políticas de extensão global aplicam extensões a VMs em zonas e regiões nos níveis de organização, pasta e projeto:
Como mostrado no diagrama anterior, é possível definir políticas de extensão globais no nível da organização, da pasta ou do projeto. O Gerenciador de extensões de VM aplica cada política às VMs correspondentes em todas as zonas dentro desse escopo de hierarquia.
Planos de lançamento para políticas globais
As políticas globais usam planos de lançamento para implantar extensões em zonas e regiões. Com um plano de lançamento, você define a ordem e o momento das atualizações para garantir um lançamento gradual e controlado e minimizar o risco de problemas generalizados.
Ao criar ou atualizar uma política global, é possível especificar um dos seguintes planos de lançamento:
- Lançamento lento. Implanta extensões gradualmente em zonas durante um período padrão de cinco dias. Use esse plano de lançamento para identificar e resolver problemas nas primeiras ondas de implantação antes que eles afetem toda a frota.
- Lançamento rápido. Implanta extensões em todas as VMs de destino em todas as zonas e regiões imediatamente. Use esse plano de lançamento quando precisar implantar rapidamente uma extensão ou um patch em ambientes que não sejam de produção.
Também é possível definir planos de lançamento personalizados para especificar as ondas de implantação por zona ou região e o tempo de espera entre as ondas. Para mais informações, consulte o
método
rolloutPlans.insert.
Comportamento em caso de conflito no lançamento
Ao criar ou atualizar uma política de extensão global, pode ocorrer um conflito com uma política zonal existente nas seguintes situações:
- Ao criar uma política global. Se já houver uma política zonal com o mesmo nome em uma zona, ocorrerá um conflito de nomes.
- Quando você atualiza uma política global. Se você modificar uma política zonal atual de maneira independente, por exemplo, usando uma chamada de API zonal, e um lançamento de política global subsequente tentar atualizar essa política zonal, ocorrerá um conflito de conteúdo.
Para resolver conflitos de lançamento, especifique um comportamento de conflito para o lançamento. Essa configuração determina se a política global substitui as políticas zonais conflitantes durante um lançamento. É possível especificar um dos seguintes comportamentos:
- Não substituir (padrão). Se você não especificar um comportamento de conflito, o lançamento da política global não vai substituir as políticas zonais conflitantes. A configuração da política zonal tem precedência nessa zona.
- Substituir. Se você definir o comportamento de conflito como
overwrite, a política global vai substituir as políticas zonais conflitantes, e o Gerenciador de Extensões de VM vai aplicar a configuração da política global nessa zona.
Os conflitos de lançamento e a prioridade da política são recursos distintos que funcionam de maneira independente. Para mais informações sobre a prioridade de políticas, consulte Prioridade de políticas e resolução de conflitos.
Para mais informações sobre as configurações de conflito de lançamento, consulte o parâmetro conflictBehavior
no método
globalVmExtensionPolicies.insert.
Tentar um lançamento novamente
Quando você atualiza ou exclui uma política de extensão global, o Gerenciador de Extensões de VM inicia um novo lançamento para aplicar as mudanças de acordo com o plano de lançamento. Se um lançamento falhar ou novas zonas ficarem disponíveis, será possível repetir a operação iniciando um novo lançamento para a mesma política.
Ao repetir uma atualização ou excluir um lançamento, é necessário fornecer um identificador exclusivo universalmente (UUID) no formato hexadecimal de 32 caracteres (por exemplo, a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8) para identificar a solicitação de nova tentativa. É possível usar qualquer gerador de UUID padrão para criar esse valor.
Tentar novamente o lançamento de uma política de atualização
A lista a seguir descreve cenários em que pode ser necessário repetir o lançamento de uma política de atualização:
- Novas zonas adicionadas. Se novas zonas do Cloud de Confiance ficarem disponíveis depois que você lançar uma política global, o Gerenciador de extensões de VM não aplicará automaticamente as políticas atuais às VMs nas novas zonas. É possível tentar novamente o lançamento da atualização para aplicar a política de extensão às VMs nessas zonas.
- Reverta as mudanças na política zonal. Se você modificar uma política zonal de forma independente, por exemplo, usando uma chamada de API zonal, será possível repetir um lançamento de atualização com
conflictBehaviordefinido comooverwrite. Essa configuração reaplica a configuração da política global e substitui as alterações da política zonal. - Lançamento interrompido. Se um lançamento anterior falhar antes de ser concluído, você poderá iniciar um novo lançamento para tentar a atualização novamente.
- Acelerar um lançamento. Se um lançamento em andamento estiver muito lento, inicie um novo usando um plano
FAST_ROLLOUTou um plano de lançamento personalizado para acelerar o processo de atualização.
Para mais informações, consulte o parâmetro retryUuid no
método globalVmExtensionPolicies.update.
Tentar novamente o lançamento de uma política de exclusão
A lista a seguir descreve cenários em que pode ser necessário repetir o lançamento de uma política de exclusão:
- Lançamento interrompido. Se um lançamento de exclusão anterior falhar antes de ser concluído, você poderá iniciar um novo lançamento para tentar novamente.
- Acelerar um lançamento. Se um lançamento de exclusão em andamento progredir muito
lentamente, será possível iniciar um novo lançamento usando um plano
FAST_ROLLOUTou um plano de lançamento personalizado para acelerar o processo de exclusão.
Para mais informações, consulte o parâmetro retryUuid no
método globalVmExtensionPolicies.delete.
A seguir
- Para implantar agentes compatíveis na sua frota no nível da organização, da pasta ou do projeto, consulte Instalar extensões de VM criando políticas de extensão.
- Para modificar as definições de configuração, alterar as versões fixadas ou remover os agentes implantados, consulte Gerenciar extensões de VM usando políticas de extensão.
- Para inspecionar o progresso do lançamento e o status de integridade da extensão, consulte Ver detalhes e status da extensão de VM.
- Para criar painéis do Cloud Monitoring e configurar alertas de integridade do agente, uso da CPU e uso da memória, consulte Monitorar extensões de VM.