Gérer les règles relatives aux invités (anciennes)

Après avoir créé une stratégie relative aux invités, vous pouvez utiliser les procédures suivantes pour examiner et gérer vos stratégies :

• Mettre à jour les stratégies d'invités : modifiez la configuration des stratégies d'invités.
• Décrire les stratégies d'invités : obtenez des informations sur une stratégie d'invités spécifique.
• Répertorier les stratégies d'invités : affichez la liste des stratégies d'invités d'un projet.
• Supprimer un invité : permet de supprimer une stratégie d'invités spécifique.
• Afficher les configurations d'une instance de VM : affichez les configurations appliquées à une instance de VM.
• Déboguer une stratégie d'invités : dépannez une stratégie d'invités.

Étant donné que l'agent OS Config s'exécute toutes les 10 à 15 minutes, la mise à jour ou la suppression d'une stratégie prend environ 10 à 15 minutes.

Vous pouvez gérer vos stratégies relatives aux invités en utilisant Google Cloud CLI ou REST.

Avant de commencer

• Consultez les quotas d'OS Config.
• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :
  

  Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

  gcloud

  1. Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

     gcloud init

  2. Définissez une région et une zone par défaut.

  REST

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

  Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :

  gcloud init

Mettre à jour les stratégies relatives aux invités

Pour mettre à jour une stratégie relative aux invités, procédez comme suit :

1. Mettez à jour le fichier YAML ou JSON.
2. Exécutez une commande de mise à jour ou de correctif. Le processus de mise à jour est similaire au processus de création, avec la compatibilité avec les etags qui permettent un contrôle de simultanéité et de cohérence.

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
}

Décrire une stratégie relative aux invités

gcloud beta compute os-config guest-policies describe POLICY_ID

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

Répertorier les stratégies relatives aux invités

gcloud beta compute os-config guest-policies list

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

Supprimer des stratégies relatives aux invités

Lorsque l'agent OS Config détecte la suppression d'une stratégie relative aux invités, l'état actuel du système est conservé, mais la configuration n'est pas maintenue. Par exemple, supposons que vous ayez défini une stratégie d'invités package-update-zone2b qui installe un package my-package sur toutes les VM de la zone us-west2-b et conserve le package UPDATED.

Si vous supprimez la stratégie package-update-zone2b, les modifications suivantes ont lieu :

• Toutes les VM de us-west2-b sur lesquelles my-package est installé, conservent my-package. Il n'y a pas d'annulation de l'état actuel du système.

• Lors de toutes les exécutions futures de l'agent OS Config, après la suppression de la stratégie, les opérations suivantes ont lieu :

  • Si une nouvelle VM est ajoutée à us-west2-b, my-package n'est pas installé sur cette nouvelle VM.
  • Pour les instances sur lesquelles my-package est installé, le package n'est pas mis à jour.

gcloud beta compute os-config guest-policies delete POLICY_ID

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

Afficher les configurations d'une instance 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

Dépannage

Inspecter les stratégies d'invités

Vous pouvez utiliser la console Google Cloud ou Google Cloud CLI pour inspecter les stratégies relatives aux invités associées à votre projet.

Inspecter les stratégies d'invités pour une VM spécifique

Vous pouvez exécuter la commande lookup pour une VM donnée pour voir quelles configurations s'appliquent à cette VM.

Dans les cas où une VM ne semble pas appliquer les exigences de la stratégie d'invités attendue, il est utile d'inspecter la liste des stratégies d'invités dont les attributions incluent cette instance de VM spécifique. Cela permet de déterminer si le champ Assignment de la stratégie relative aux invités correspond à cette VM particulière.

Utilisez la commande os-config guest-policies lookup pour répertorier les stratégies d'invités qui pourraient cibler une VM particulière. Remplacez VM_NAME par le nom de la VM à inspecter.

gcloud beta compute os-config guest-policies lookup VM_NAME

Pour en savoir plus, consultez la section Afficher les configurations d'une instance de VM.

Le résultat de la commande peut révéler que la VM n'est pas réellement ciblée dans les propriétés d'attribution de VM de la stratégie relative aux invités. Par exemple, il peut ne pas être répertorié dans la liste Labels ou dans la liste des préfixes de noms de VM.

Récupération après échec

Une installation de recette logicielle ayant échoué n'est pas relancée. En effet, le système ne connaît pas l'état dans lequel la recette logicielle ayant échoué a laissé des choses.

Lors du débogage des recettes logicielles ayant échoué, nous vous recommandons de procéder comme suit :

1. Renommez la recette logicielle.
2. Supprimez et recréez la stratégie d'invités à l'aide de la recette logicielle renommée.

Pour connaître la procédure de dépannage, consultez la section Dépannage de VM Manager.

Étape suivante

• Obtenez plus d'informations sur les stratégies relatives aux invités pour les systèmes d'exploitation (ancien).
• Configurer une stratégie relative aux invités.