Afficher, modifier et supprimer des outils d'orchestration des règles

Console

Pour lister les orchestrateurs de règles, procédez comme suit :

1. Dans la console Trusted Cloud , accédez à la page Règles d'OS.

   Accéder aux règles d'OS

2. Cliquez sur le sélecteur de projet dans la barre d'actions de la console Trusted Cloud , puis sélectionnez le dossier dans lequel vous souhaitez créer l'orchestrateur de règles.

3. Cliquez sur Orchestrateurs globaux.

gcloud

Pour afficher les détails d'un orchestrateur de règles créé dans un dossier, exécutez la commande os-config policy-orchestrators list :

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

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
• FOLDER_NUMBER : ID numérique du dossier dans lequel vous avez créé les orchestrateurs de stratégies.

Exemple

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

REST

Pour afficher tous les orchestrateurs de règles dans un dossier, envoyez une requête GET à la méthode 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"

Remplacez FOLDER_NUMBER par l'ID numérique du dossier dans lequel vous avez créé les orchestrateurs de règles.

Console

Pour afficher un orchestrateur de règles :

1. Dans la console Trusted Cloud , accédez à la page Règles d'OS.

   Accéder aux règles d'OS

2. Cliquez sur le sélecteur de projet dans la barre d'actions de la console Trusted Cloud , puis sélectionnez le projet, le dossier ou l'organisation contenant l'orchestrateur de règles.

3. Cliquez sur Orchestrateurs globaux.

4. Sélectionnez le nom de l'orchestrateur de règles que vous souhaitez afficher. La page Détails de l'orchestrateur s'ouvre.

5. Pour afficher les détails des règles d'OS appliquées aux VM, accédez à la section Règles d'OS attribuées, puis cliquez sur Afficher.

gcloud

Pour afficher les détails d'un orchestrateur de règles créé dans un dossier, exécutez la commande os-config policy-orchestrators describe :

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

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
• ORCHESTRATOR_NAME : nom de l'orchestrateur de règles.
• FOLDER_NUMBER : ID numérique du dossier dans lequel vous avez créé l'orchestrateur de stratégies.

Exemple

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

REST

Pour afficher les détails d'un orchestrateur de règles, envoyez une requête GET à la méthode 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"

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
• FOLDER_NUMBER : ID numérique du dossier dans lequel se trouve l'orchestrateur de règles.
• ORCHESTRATOR_NAME : nom de l'orchestrateur de règles que vous souhaitez supprimer.

Le corps de la requête doit être vide.

Console

Pour modifier les paramètres d'un outil d'orchestration des règles :

1. Dans la console Trusted Cloud , accédez à la page Règles d'OS.

   Accéder aux règles d'OS

2. Cliquez sur le sélecteur de projet dans la barre d'action de la console Trusted Cloud , puis sélectionnez le projet, le dossier ou l'organisation dans lesquels se trouve l'orchestrateur de règles.

3. Cliquez sur Orchestrateurs globaux.

4. Sélectionnez le nom de l'orchestrateur de règles que vous souhaitez modifier. La page Détails de l'orchestrateur s'ouvre.

5. Cliquez sur Modifier.

6. Dans la section Règles d'OS, importez le fichier de règle d'OS.

7. Facultatif : Dans la section État, sélectionnez l'une des options suivantes pour spécifier le comportement de l'orchestrateur de règles :

   • ACTIVE : une fois créé, l'outil d'orchestration des règles prend immédiatement des mesures.
   • STOPPED : un outil d'orchestration des règles créé dans cet état n'effectue aucune action immédiatement. Vous pourrez modifier l'orchestrateur de règles ultérieurement pour changer son état.

8. Dans la section Champ d'application de l'orchestration, spécifiez les dossiers et les projets dans lesquels vous souhaitez déployer les règles d'OS. Vous ne devez saisir que les numéros de projet et de dossier dans ces champs. Par exemple : 123456, 7654321.

9. Facultatif : Sélectionnez les zones contenant les VM auxquelles vous souhaitez appliquer les règles d'OS.

10. Facultatif : Dans la section Instances de VM cibles, spécifiez les VM cibles auxquelles vous souhaitez appliquer les règles d'OS.

    • Sélectionnez les familles de systèmes d'exploitation.

    • Vous pouvez filtrer davantage les VM en spécifiant des étiquettes d'inclusion et d'exclusion.

      Par exemple, vous pouvez sélectionner toutes les VM Ubuntu dans votre environnement de test et exclure celles qui exécutent Google Kubernetes Engine, en spécifiant les éléments suivants :

      • Famille d'OS : ubuntu
      • Inclure : env:test, env:staging
      • Exclure : goog-gke-node

11. Spécifiez un plan de déploiement.

    • Spécifiez la taille de la vague (également appelé budget d'interruption). Exemple : 10%
    • Indiquez le temps d'attente. Par exemple, 15 minutes.

12. Cliquez sur Enregistrer.

gcloud

Pour mettre à jour un orchestrateur de règles, utilisez la commande os-config policy-orchestrators update.

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

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
• ORCHESTRATOR_NAME : nom de l'orchestrateur de règles.

• FOLDER_NUMBER : ID numérique du dossier dans lequel se trouve l'orchestrateur de règles.

  Exemple

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

REST

Pour mettre à jour un orchestrateur de règles dans un dossier, envoyez une requête PATCH à la méthode folders.locations.global.policyOrchestrators.patch.

Dans le corps de la requête, modifiez les spécifications d'attribution des règles de système d'exploitation.

    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
      }

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation
• FOLDER_NUMBER : ID numérique du dossier dans lequel se trouve l'orchestrateur de règles.
• ORCHESTRATOR_NAME : nom de l'orchestrateur de règles que vous souhaitez modifier.
• JSON_OS_POLICY_ORCHESTRATOR : objet de l'outil d'orchestration des règles au format JSON qui définit le champ d'application de l'outil d'orchestration, la ressource orchestrée et l'état de l'orchestration. Pour plus d'informations sur les paramètres et le format, consultez la page Resource: folders.locations.global.policyOrchestrators.

Console

Pour supprimer un outil d'orchestration des règles :

1. Dans la console Trusted Cloud , accédez à la page Règles d'OS.

   Accéder aux règles d'OS

2. Cliquez sur le sélecteur de projet dans la barre d'action de la console Trusted Cloud , puis sélectionnez le projet, le dossier ou l'organisation à partir desquels vous souhaitez supprimer l'orchestrateur de règles.

3. Cliquez sur Orchestrateurs globaux.

4. Sélectionnez le nom de l'orchestrateur de règles que vous souhaitez supprimer. La page Détails de l'orchestrateur s'ouvre.

5. Cliquez sur Supprimer.

gcloud

Pour supprimer un outil d'orchestration des règles d'un dossier, procédez comme suit :

1. Exécutez la commande 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
   

   Remplacez les éléments suivants :

   • QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
   • ORCHESTRATOR_NAME : nom de l'orchestrateur de règles.
   • FOLDER_NUMBER : ID numérique du dossier dans lequel vous avez créé l'orchestrateur de stratégies.
   • POLICY_ID : ID attribué à l'orchestrateur de règles.

   Exemple

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

REST

Pour supprimer un outil d'orchestration des règles dans un dossier, envoyez une requête DELETE à la méthode 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"

Remplacez les éléments suivants :

• QUOTA_PROJECT_ID : ID du projet de quota ou de facturation.
• FOLDER_NUMBER : ID numérique du dossier dans lequel se trouve l'orchestrateur de règles.
• ORCHESTRATOR_NAME : nom de l'orchestrateur de règles que vous souhaitez supprimer.