Gestire le assegnazioni delle policy del sistema operativo

Dopo aver creato un'assegnazione di policy del sistema operativo, esamina e gestisci le assegnazioni utilizzando le seguenti procedure:

• Aggiorna assegnazioni delle policy del sistema operativo: modifica le configurazioni per l'assegnazione delle policy del sistema operativo
• Descrivi assegnazioni policy del sistema operativo: visualizza i dettagli di un'assegnazione policy del sistema operativo specifica
• Elenca le assegnazioni delle policy del sistema operativo: visualizza un elenco delle assegnazioni delle policy del sistema operativo in una zona specifica
• Elenca revisioni dell'assegnazione di policy del sistema operativo: visualizza un elenco delle revisioni disponibili per una specifica assegnazione di policy del sistema operativo
• Elimina un'assegnazione policy del sistema operativo: elimina un'assegnazione policy del sistema operativo specifica
• Esegui il debug di un'assegnazione dei criteri del sistema operativo: risolvi i problemi relativi a un'assegnazione dei criteri del sistema operativo

Puoi gestire le assegnazioni di policy del sistema operativo utilizzando la Google Cloud console, Google Cloud CLIo l'API OS Config.

Prima di iniziare

• Esamina le quote di OS Config.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Autorizzazioni

I proprietari di un progetto hanno accesso completo per gestire le assegnazioni delle policy del sistema operativo. Per tutti gli altri utenti, devi concedere le autorizzazioni. Per gestire le assegnazioni delle policy del sistema operativo, puoi concedere uno dei seguenti ruoli granulari:

• Amministratore OSPolicyAssignment (roles/osconfig.osPolicyAssignmentAdmin). Contiene le autorizzazioni per creare, eliminare, aggiornare, ottenere ed elencare le assegnazioni delle policy del sistema operativo.
• Editor OSPolicyAssignment (roles/osconfig.osPolicyAssignmentEditor). Contiene le autorizzazioni per aggiornare, recuperare ed elencare le assegnazioni delle policy del sistema operativo.
• Visualizzatore assegnazioni policy del sistema operativo (roles/osconfig.osPolicyAssignmentViewer). Contiene le autorizzazioni per l'accesso di sola lettura per recuperare ed elencare le assegnazioni delle policy del sistema operativo.

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member user:USER_ID@gmail.com \
        --role roles/osconfig.osPolicyAssignmentAdmin

Aggiorna le assegnazioni delle policy del sistema operativo

Per aggiornare l'assegnazione di una policy del sistema operativo, completa i seguenti passaggi:

1. Aggiorna il file YAML o JSON che contiene l'assegnazione delle policy del sistema operativo.

   La richiesta di aggiornamento supporta le maschere dei campi. Potresti dover aggiornare solo determinati campi nell'assegnazione delle policy del sistema operativo, lasciando invariati gli altri campi. Il comando di aggiornamento o patch utilizza le maschere di campo per comunicare all'API quali campi sono stati modificati. La richiesta di aggiornamento o patch ignora tutti i campi non specificati nella maschera del campo, lasciandoli con i valori attuali. Per ulteriori informazioni sulle maschere di campo, vedi FieldMask.

2. Aggiorna l'assegnazione dei criteri del sistema operativo utilizzando la Google Cloud console, Google Cloud CLI o l'API OS Config.

   Quando aggiorni un'assegnazione dei criteri del sistema operativo, viene creata un'implementazione. Puoi visualizzare l'avanzamento dell'aggiornamento monitorando l'implementazione. Per ulteriori informazioni, vedi Visualizzare i dettagli di un lancio.

   Console

   1. Nella console Google Cloud , vai alla pagina Policy del sistema operativo > Assegnazioni.

      Vai alla console Google Cloud

   2. Per l'assegnazione del criterio del sistema operativo che vuoi modificare, fai clic su Azione (more_vert) > Modifica assegnazione.

   3. Apporta gli aggiornamenti necessari. Ad esempio, puoi caricare il file delle norme del sistema operativo aggiornato.

   4. Fai clic su Avvia implementazione.

   gcloud

   Utilizza il comando os-config os-policy-assignments update per aggiornare un'assegnazione di policy del sistema operativo.

   gcloud compute os-config os-policy-assignments update OS_POLICY_ASSIGNMENT_ID \
       --location=ZONE \
       --file=FILE
   

   Sostituisci quanto segue:

   • OS_POLICY_ASSIGNMENT_ID: il nome dell'assegnazione della norma del sistema operativo che vuoi aggiornare
   • ZONE: la zona in cui si trova l'assegnazione policy sistema operativo

   • FILE: il percorso assoluto del file JSON o YAML che contiene le specifiche aggiornate dell'assegnazione delle policy del sistema operativo

     Se l'assegnazione dei criteri del sistema operativo non esiste e se specifichi il flag --allow-missing, VM Manager crea l'assegnazione dei criteri del sistema operativo con l'ID e le specifiche specificati.

   REST

   Nell'API, crea una richiesta PATCH al metodo projects.locations.osPolicyAssignments.patch.

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID
   
   {
    JSON_OS_POLICY
   }
   

   Sostituisci quanto segue:

   • PROJECT_ID: il tuo ID progetto
   • OS_POLICY_ASSIGNMENT_ID: il nome dell'assegnazione delle policy del sistema operativo che vuoi aggiornare
   • JSON_OS_POLICY: le specifiche di assegnazione delle policy del sistema operativo create nel passaggio precedente. Deve essere in formato JSON. Per ulteriori informazioni sui parametri e sul formato, vedi Resource: OSPolicyAssignment.
   • ZONE: la zona in cui si trova l'assegnazione policy sistema operativo

Elenca le assegnazioni delle policy del sistema operativo

 gcloud compute os-config os-policy-assignments list \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments

Descrivi un'assegnazione di policy del sistema operativo

gcloud compute os-config os-policy-assignments describe OS_POLICY_ASSIGNMENT_ID \
     --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

Elenca le revisioni dell'assegnazione delle policy del sistema operativo

gcloud compute os-config os-policy-assignments list-revisions OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID:listRevisions

Elimina assegnazioni delle policy del sistema operativo

Quando elimini un'assegnazione di policy del sistema operativo, viene creata un'implementazione. Puoi visualizzare l'avanzamento dell'eliminazione monitorando l'implementazione. Per ulteriori informazioni, vedi Visualizzare i dettagli di un lancio.

gcloud compute os-config os-policy-assignments delete OS_POLICY_ASSIGNMENT_ID \
    --location=ZONE

DELETE https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/osPolicyAssignments/OS_POLICY_ASSIGNMENT_ID

Risoluzione dei problemi

Per risolvere i problemi relativi a un'assegnazione di criteri del sistema operativo, consulta la sezione Risoluzione dei problemi di VM Manager.

Passaggi successivi

• Scopri di più sulle policy del sistema operativo.
• Crea un'assegnazione delle policy del sistema operativo.