Gestione dei criteri guest (legacy)

Dopo aver creato una policy guest, puoi utilizzare le seguenti procedure per esaminare e gestire le tue policy:

Poiché l'agente OS Config viene eseguito ogni 10-15 minuti, quando configuri un aggiornamento o un'eliminazione di una policy, saranno necessari circa 10-15 minuti per l'applicazione.

Puoi gestire le policy guest utilizzando Google Cloud CLI o REST.

Prima di iniziare

  • Esamina le quote di OS Config.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e 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:

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

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

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

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

Aggiornamento dei criteri guest

Per aggiornare una policy guest, completa i seguenti passaggi:

  1. Aggiorna il file YAML o JSON.
  2. Esegui un comando di aggiornamento o patch. La procedura di aggiornamento è simile a quella di creazione, con l'aggiunta del supporto per gli etag che consentono il controllo della concorrenza e della coerenza.

gcloud

Utilizza il comando os-config guest-policies update per aggiornare una policy guest.

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

Sostituisci quanto segue:

  • POLICY_ID: il nome della policy guest che vuoi aggiornare.
  • FILE: il file JSON o YAML contenente le specifiche aggiornate della policy guest.

REST

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

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

{
  For more information, see Guest policy JSON
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • POLICY_ID: il nome della policy guest.

Descrizione di una policy guest

gcloud

Per visualizzare i dettagli di una policy guest, utilizza il comando os-config guest-policies describe. Sostituisci POLICY_ID con il nome della norma guest che vuoi descrivere.

gcloud beta compute os-config guest-policies describe POLICY_ID

REST

Nell'API, crea una richiesta GET al metodo projects.guestPolicies.get.

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

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • POLICY_ID: il nome della policy guest.

Elenca le policy guest

gcloud

Per visualizzare un elenco delle policy guest nel tuo progetto, utilizza il comando os-config guest-policies list.

gcloud beta compute os-config guest-policies list

REST

Nell'API, crea una richiesta GET al metodo projects.guestPolicies.list. Sostituisci PROJECT_ID con l'ID progetto.

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

Eliminazione dei criteri guest

Quando l'agente OS Config rileva che è stata attivata l'eliminazione di una policy guest, lo stato attuale del sistema viene mantenuto, ma non viene eseguita alcuna ulteriore manutenzione della configurazione. Ad esempio, supponiamo che tu abbia configurato una policy guest package-update-zone2b che installa un pacchetto my-package su tutte le VM nella zona us-west2-b e mantiene il pacchetto UPDATED.

Se elimini le norme package-update-zone2b, si verificano le seguenti modifiche:

  • Tutte le VM in us-west2-b su cui è installato my-package mantengono my-package installato. Non è previsto il ripristino dello stato attuale del sistema.

  • In tutte le esecuzioni future dell'agente OS Config, dopo l'eliminazione della policy, si verifica quanto segue:

    • Se viene aggiunta una nuova VM a us-west2-b,my-package non è installato su questa nuova VM.
    • Per le istanze con my-package installato, il pacchetto non viene aggiornato.

gcloud

Per eliminare una policy guest, utilizza il comando os-config guest-policies delete. Sostituisci POLICY_ID con il nome della policy guest che vuoi eliminare.

gcloud beta compute os-config guest-policies delete POLICY_ID

REST

Nell'API, crea una richiesta DELETE al metodo projects.guestPolicies.delete.

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

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • POLICY_ID: il nome della policy guest.

Visualizza le configurazioni di un'istanza VM

gcloud

Per visualizzare le policy applicate a una singola istanza VM, utilizza il comando os-config guest-policies lookup.

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

Sostituisci quanto segue:

  • VM_NAME: il nome dell'istanza VM.
  • ZONE: la zona per l'istanza VM.

REST

Per visualizzare le policy applicate a una singola istanza VM, utilizza la seguente richiesta POST.

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

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • ZONE: la zona per l'istanza VM.
  • VM_NAME: il nome dell'istanza VM.

Risoluzione dei problemi

Esaminare le policy guest

Puoi utilizzare la console Google Cloud o Google Cloud CLI per esaminare le policy guest associate al tuo progetto.

Console

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

    Vai alla pagina Policy relative a ospiti del sistema operativo

  2. Seleziona il criterio ospite che vuoi esaminare, quindi fai clic su VISUALIZZA DETTAGLI.

gcloud

  1. Utilizza il comando os-config guest-policies list per elencare tutte le tue policy guest.

    gcloud beta compute os-config guest-policies list

  2. Dall'elenco dei criteri guest, copia gli ID dei criteri guest che vuoi esaminare, quindi esegui il comando per esaminare ciascuno dei criteri guest. Sostituisci POLICY_ID con l'ID criterio che vuoi esaminare.

    gcloud beta compute os-config guest-policies describe POLICY_ID

Esaminare le policy guest per una VM specifica

Puoi eseguire il comando lookup per una determinata VM per vedere quali configurazioni si applicano a quella VM.

Nei casi in cui una VM non sembra applicare i requisiti della policy guest prevista, è utile esaminare l'elenco delle policy guest le cui assegnazioni includono quella specifica istanza VM. Ciò consente di determinare se il campo Assignment nella policy guest corrisponde a questa VM specifica.

Utilizza il comando os-config guest-policies lookup per elencare le policy guest che potrebbero avere come target una VM specifica. Sostituisci VM_NAME con il nome della VM da esaminare.

gcloud beta compute os-config guest-policies lookup VM_NAME

Per saperne di più, consulta Visualizzare le configurazioni per un'istanza VM.

L'output del comando potrebbe rivelare che la VM non è effettivamente inclusa nelle proprietà di assegnazione della VM della policy guest. Ad esempio, potrebbe non essere elencato nell'elenco di Labels o nell'elenco dei prefissi dei nomi VM.

Recupero in caso di errore

L'installazione non riuscita di una ricetta software non viene riprovata. Questo perché il sistema non conosce lo stato in cui si trova il software dopo l'errore.

Quando esegui il debug delle ricette software non riuscite, ti consigliamo di seguire questi passaggi:

  1. Rinomina la formula software.
  2. Elimina e ricrea la policy guest utilizzando la formula software rinominata.

Per ulteriori passaggi per la risoluzione dei problemi, consulta la sezione Risoluzione dei problemi di VM Manager.

Passaggi successivi