Como gerenciar políticas de convidado (legado)

Depois de criar uma política de convidado, será possível usar os procedimentos a seguir para revisar e gerenciar as políticas:

• Atualizar políticas de convidado: modifique as configurações de política de convidado.
• Descrever as políticas de convidado: consulte detalhes sobre uma política de convidado específica.
• Listar políticas de convidado: consulte uma lista de políticas de convidado em um projeto.
• Excluir um convidado: exclua uma política de convidado específica.
• Visualizar configurações de uma instância de VM: consulte as configurações aplicadas a uma instância de VM.
• Depurar uma política de convidado: solucione problemas de uma política de convidado.

Como o agente de configuração do SO é executado a cada 10-15 minutos, quando você configura uma atualização ou exclusão de uma política, ela leva cerca de 10 a 15 minutos para entrar em vigor.

É possível gerenciar suas políticas de convidado usando a CLI do Google Cloud ou a REST.

Antes de começar

• Revise as cotas de configuração do SO.
• 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 Trusted Cloud by S3NS . 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:

  gcloud

  1. Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

     gcloud init

  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 a CLI gcloud.

  Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

  gcloud init

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

Como atualizar políticas de convidado

Para atualizar uma política de convidado, siga estas etapas:

1. Atualize o arquivo YAML ou JSON.
2. Execute um comando update ou patch. O processo de atualização é semelhante ao processo de criação, com a adição de suporte para ETags que permitem controle de simultaneidade e consistência.

gcloud beta compute os-config guest-policies update POLICY_ID \
     --file=FILE

PATCH https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

{
  For more information, see Guest policy JSON
}

Como descrever uma política de convidado

gcloud beta compute os-config guest-policies describe POLICY_ID

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Listar políticas de convidado

gcloud beta compute os-config guest-policies list

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies

Como excluir políticas de convidado

Quando o agente de Configuração do SO detecta que a exclusão de uma política de convidado é acionada, o estado atual do sistema é mantido, mas nenhuma outra manutenção é feita. Por exemplo, digamos que você tenha uma política de convidado package-update-zone2b configurada que instale um pacote my-package em todas as VMs na zona us-west2-b e mantenha o pacote UPDATED.

Se você excluir a política package-update-zone2b, ocorrerão as seguintes alterações:

• Todas as VMs em us-west2-b com my-package instalado manterão o my-package instalado. Não há reversão do estado atual do sistema.

• Em todas as execuções futuras do agente de Configuração do SO, após a exclusão da política, ocorrerá o seguinte:

  • Se uma nova VM for adicionada a us-west2-b, my-package não será instalado nesta nova VM.
  • Para instâncias com my-package instalado, o pacote não é atualizado.

gcloud beta compute os-config guest-policies delete POLICY_ID

DELETE https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Conferir as configurações de uma instância de VM

gcloud beta compute os-config guest-policies lookup VM_NAME \
    --zone=ZONE

POST https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME:lookupEffectiveGuestPolicy

Solução de problemas

Inspecionar políticas de convidado

Use o console Trusted Cloud ou a Google Cloud CLI para inspecionar as políticas de convidado associadas ao projeto.

Inspecionar políticas de convidado para uma VM específica

É possível executar o comando lookup para uma determinada VM para conferir quais configurações se aplicam a ela.

Nos casos em que uma instância de VM não estiver aplicando os requisitos da política de convidado conforme esperado, inspecione a lista de políticas de convidado que tenham atribuições que incluam essa instância de VM específica. Isso ajuda a determinar se o campo Assignment na política de convidado corresponde a essa VM específica.

Use o comando os-config guest-policies lookup para listar as políticas de convidado que podem estar segmentando uma determinada VM. Substitua VM_NAME pelo nome da VM a ser inspecionada.

gcloud beta compute os-config guest-policies lookup VM_NAME

Para mais informações, consulte Como visualizar configurações de uma instância de VM.

A saída do comando pode revelar que a VM não está realmente segmentada nas propriedades de atribuição de VM da política de convidado. Por exemplo, talvez ela não esteja listada na lista de Labels ou na lista de prefixos de nome de VM.

Como se recuperar de falhas

Uma instalação de receita de software com falha não é repetida. Isso ocorre porque o sistema não sabe em que estado ficou o roteiro do software com falha.

Ao depurar roteiros de software com falha, recomendamos as seguintes etapas:

1. Renomeie a receita de software.
2. Exclua e recrie a política de convidado usando a receita de software renomeada.

Para mais etapas de solução de problemas, consulte Solução de problemas do VM Manager.

A seguir

• Saiba mais sobre as políticas de convidado do SO (legadas).
• Configure uma política de convidado.