Gestione dei criteri relativi agli ospiti (legacy)

Dopo crea un criterio guest, puoi utilizzare le seguenti procedure per rivedere e gestire i tuoi criteri:

Poiché l'agente OS Config viene eseguito ogni 10-15 minuti, l'aggiornamento o l'eliminazione di un criterio richiede circa 10-15 minuti perché abbia effetto.

Puoi gestire i criteri relativi agli ospiti utilizzando Google Cloud CLI oppure REST.

Prima di iniziare

  • Esamina le quote di OS Config.
  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

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

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Aggiornamento dei criteri relativi agli ospiti

Per aggiornare un criterio relativo agli ospiti, segui questi passaggi:

  1. Aggiorna il file YAML o JSON.
  2. Esegui un comando di aggiornamento o patch. La procedura di aggiornamento è simile alla di creazione di contenuti con l'aggiunta del supporto etag che consentono un controllo della contemporaneità e della coerenza.

gcloud

Utilizza la os-config guest-policies update per aggiornare un criterio guest.

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

Sostituisci quanto segue:

  • POLICY_ID: il nome del criterio guest che vuoi aggiornare.
  • FILE: il file JSON o YAML che contiene specifiche aggiornate dei criteri relativi agli ospiti.

REST

Nell'API, crea una richiesta PATCH alla 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 del criterio relativo agli ospiti.

Descrizione di un criterio relativo agli ospiti

gcloud

Per visualizzare i dettagli di un criterio ospite, utilizza la os-config guest-policies describe . Sostituisci POLICY_ID con il nome del che vuoi descrivere per gli ospiti.

gcloud beta compute os-config guest-policies describe POLICY_ID

REST

Nell'API, crea una richiesta GET alla 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 del criterio relativo agli ospiti.

Elenca i criteri relativi agli ospiti

gcloud

Per visualizzare un elenco di criteri guest nel tuo progetto, utilizza os-config guest-policies list .

gcloud beta compute os-config guest-policies list

REST

Nell'API, crea una richiesta GET alla projects.guestPolicies.list . Sostituisci PROJECT_ID con il tuo ID progetto.

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

Eliminazione dei criteri relativi agli ospiti in corso...

Quando l'agente OS Config rileva che è stata attivata un'eliminazione di un criterio guest, viene mantenuto lo stato attuale del sistema, ma non viene effettuata ulteriore manutenzione la configurazione iniziale. Ad esempio, supponi di avere un criterio relativo agli ospiti package-update-zone2b configurazione che installa un pacchetto my-package su tutte le VM nella zona us-west2-b e conserva il pacco UPDATED.

Se elimini il criterio package-update-zone2b, vengono apportate le seguenti modifiche:

  • Tutte le VM in us-west2-b con my-package installato mantengono my-package installato. Non è possibile ripristinare lo stato attuale del sistema.

  • In tutte le esecuzioni future dell'agente OS Config, dopo l'eliminazione del criterio, 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 in cui è installato my-package, il pacchetto non viene aggiornato.

gcloud

Per eliminare un criterio guest, utilizza os-config guest-policies delete . Sostituisci POLICY_ID con il nome del il criterio guest che vuoi eliminare.

gcloud beta compute os-config guest-policies delete POLICY_ID

REST

Nell'API, crea una richiesta DELETE alla 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 del criterio relativo agli ospiti.

Visualizza le configurazioni per un'istanza VM

gcloud

Per vedere i criteri applicati a una singola istanza VM, utilizza 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 il di un'istanza VM.

REST

Per vedere i criteri applicati a una singola istanza VM, usa la seguente richiesta di 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 il di un'istanza VM.
  • VM_NAME: il nome della tua istanza VM.

Risoluzione dei problemi

Esaminare i criteri relativi agli ospiti

Puoi utilizzare la console Google Cloud o Google Cloud CLI per esaminare i criteri guest associati al progetto.

Console

  1. Nella console Google Cloud, vai alla pagina Criteri relativi agli ospiti del sistema operativo.

    Vai alla pagina Criteri relativi agli ospiti del sistema operativo

  2. Seleziona il criterio relativo agli ospiti che vuoi esaminare, quindi fai clic su VISUALIZZA DETTAGLI.

gcloud

  1. Utilizza la os-config guest-policies list per elencare tutti i criteri guest.

    gcloud beta compute os-config guest-policies list

  2. Dall'elenco dei criteri guest, copia gli ID dei criteri guest che vuoi esaminare ed esegui il comando per esaminarli dei criteri guest. Sostituisci POLICY_ID con l'ID norma che vuoi esaminare.

    gcloud beta compute os-config guest-policies describe POLICY_ID

Ispeziona i criteri guest per una VM specifica

Puoi eseguire il comando lookup per una determinata VM per vedere quale configurazioni si applicano alla VM.

Nei casi in cui una VM non sembra applicare i requisiti il criterio guest previsto, è utile esaminare l'elenco le cui assegnazioni includono quella specifica istanza VM. Ciò aiuta a determinare se il campo Assignment nel criterio guest corrisponde a questa VM specifica.

Usa il comando os-config guest-policies lookup per elencare i criteri guest che potrebbero scegliere come target una determinata VM. Sostituisci VM_NAME con il nome della VM da ispezionare.

gcloud beta compute os-config guest-policies lookup VM_NAME

Per ulteriori informazioni, consulta la sezione Visualizzazione delle configurazioni per un'istanza VM.

L'output del comando potrebbe indicare che la VM non è effettivamente scelta come target le proprietà di assegnazione VM del criterio guest. Ad esempio, potrebbe non essere nell'elenco di Labels o nell'elenco di prefissi di nomi VM.

Recupero da un errore

Non verrà effettuato un nuovo tentativo di installazione di una formula software con esito negativo. Questo perché il sistema non conosce lo stato in cui la formula software con errore ha lasciato elementi.

Per eseguire il debug di formule software non riuscite, ti consigliamo di seguire questi passaggi:

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

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

Passaggi successivi