Questa pagina è stata tradotta dall'API Cloud Translation.

Utilizzo degli script di avvio nelle VM Linux

Linux

Uno script di avvio è un file che esegue delle attività durante il processo di avvio di un di macchina virtuale (VM). Gli script di avvio possono essere applicati a tutte le VM in un progetto o a una singola VM. Script di avvio specificati dall'override dei metadati a livello di VM solo script di avvio specificati da metadati a livello di progetto e script di avvio quando è disponibile una rete. Questo documento descrive come utilizzare l'avvio su istanze VM Linux. Per informazioni su come aggiungere uno script di avvio a livello di progetto, consulta gcloud compute project-info add-metadata.

Per gli script di avvio di Linux, puoi utilizzare un file bash o non-bash. Per usare una funzione designa l'interprete aggiungendo #! all'inizio del file. Per esempio, per utilizzare uno script di avvio Python 3, aggiungi #! /usr/bin/python3 all'inizio del file.

Se specifichi uno script di avvio utilizzando una delle procedure in questo documento, Compute Engine fa quanto segue:

Copia lo script di avvio nella VM
Imposta le autorizzazioni di esecuzione sullo script di avvio
Esegue lo script di avvio come utente root all'avvio della VM

Per informazioni sulle varie attività relative agli script di avvio e su quando eseguire ciascuna, consulta la Panoramica.

Prima di iniziare

Leggi la panoramica degli script di avvio.
Scopri di più sul server di metadati.
Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi 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:
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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Chiavi dei metadati per gli script di avvio di Linux

Uno script di avvio viene passato a una VM da una posizione specificata da una chiave di metadati. Una chiave di metadati specifica se lo script di avvio è archiviato in locale, archiviati in Cloud Storage o passati direttamente alla VM. La chiave dei metadati utilizzata potrebbe dipendere anche dalle dimensioni dello script di avvio.

La tabella seguente mostra le chiavi dei metadati che puoi utilizzare per l'avvio di Linux script e fornisce informazioni sulla chiave da utilizzare in base al tipo posizione e dimensione dello script di avvio.

Chiave dei metadati	Utilizzo per
`startup-script`	Passare uno script di avvio bash o non bash archiviato localmente o aggiunto direttamente e di dimensioni massime pari a 256 KB
`startup-script-url`	Passare uno script di avvio bash o non bash archiviato in Cloud Storage e di dimensioni superiori a 256 KB. La stringa che inserisci qui viene utilizzata così com'è per eseguire `gcloud storage`. Se `startup-script-url` contiene caratteri di spazio, non sostituire gli spazi con `%20` o aggiungere virgolette doppie (`""`) alla stringa `startup-script-url`.

Ordine di esecuzione degli script di avvio di Linux

Puoi utilizzare più script di avvio. Script di avvio archiviati localmente o aggiunti da eseguire direttamente prima degli script di avvio archiviati di archiviazione ideale in Cloud Storage. La tabella seguente mostra, in base alla chiave dei metadati, l'ordine di esecuzione degli script di avvio di Linux.

Chiave dei metadati	Ordine di esecuzione
`startup-script`	Prima di tutto, dopo ogni avvio
`startup-script-url`	Secondo durante ogni avvio dopo l'avvio iniziale

Il passaggio diretto di uno script di avvio Linux

Puoi aggiungere i contenuti di uno script di avvio direttamente a una VM quando la crei. Le procedure riportate di seguito mostrano come creare una VM con uno script di avvio che installa Apache e crea una pagina web di base.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

Tutte le autorizzazioni necessarie per creare una nuova VM.
compute.instances.setMetadata sulla VM.

Console

Passaggio di uno script di avvio Linux direttamente a una nuova VM

Nella console Google Cloud, vai alla pagina Crea un'istanza.

Vai a Crea un'istanza
In Disco di avvio, seleziona Cambia e scegli un sistema operativo Linux di un sistema operativo completo.

Espandi la sezione Opzioni avanzate e segui questi passaggi:

Espandi la sezione Gestione.

Nella sezione Automazione, aggiungi il seguente script di avvio:

 #! /bin/bash
 apt update
 apt -y install apache2
 cat <<EOF > /var/www/html/index.html
 <html><body><p>Linux startup script added directly.</p></body></html>
 EOF

Fai clic su Crea.

Passaggio di uno script di avvio Linux direttamente a una VM esistente

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sul nome della VM.
Fai clic su Modifica.
In Automazione, aggiungi i contenuti dello script di avvio.

Verifica dello script di avvio

Dopo l'avvio della VM, visualizza l'IP esterno in un browser web per verificare che lo script di avvio ha creato il sito web. Potresti dover attendere circa 1 minuto per il completamento dello script di avvio di esempio.

gcloud

Passare uno script di avvio Linux direttamente a una nuova VM

Passa i contenuti di uno script di avvio direttamente a una VM durante la creazione utilizzando il seguente comando gcloud compute instances create.

gcloud compute instances create VM_NAME \
  --image-project=debian-cloud \
  --image-family=debian-10 \
  --metadata=startup-script='#! /bin/bash
  apt update
  apt -y install apache2
  cat <<EOF > /var/www/html/index.html
  <html><body><p>Linux startup script added directly.</p></body></html>
  EOF'

Sostituisci VM_NAME con il nome della VM.

Passare uno script di avvio Linux direttamente a una VM esistente

Aggiungi lo script di avvio direttamente a una VM esistente utilizzando il seguente gcloud compute instances add-metadata comando:

gcloud compute instances add-metadata VM_NAME \
    --zone=ZONE \
    --metadata=startup-script='#! /bin/bash
    apt update
    apt -y install apache2
    cat <<EOF > /var/www/html/index.html
    <html><body><p>Linux startup script added directly.</p></body></html>
    EOF'

Sostituisci quanto segue:

VM_NAME: il nome della VM
ZONE: la zona della VM

Verificare lo script di avvio

Una volta avviata la VM, visualizza l'IP esterno in un browser web per verificare che lo script di avvio abbia creato il sito web. Potresti dover attendere circa 1 minuti per il completamento dello script di avvio di esempio.

REST

Passaggio di uno script di avvio Linux direttamente a una nuova VM

Passa i contenuti di uno script di avvio direttamente a una VM durante la creazione utilizzando il seguente instances.insert metodo.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  ...
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "type": "ONE_TO_ONE_NAT"
        }
      ]
    }
  ],
  "metadata": {
    "items": [
      {
        "key": "startup-script",
        "value": "#! /bin/bash\napt update\napt -y install apache2\ncat <<EOF > /var/www/html/index.html\n<html><body><p>Linux startup script added directly.</p></body></html>\nEOF"
      }
    ]
  },
  ...
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto
ZONE: la zona in cui creare la VM

Passaggio di uno script di avvio Linux direttamente a una VM esistente

Ottieni il valore tags.fingerprint della VM utilizzando il metodo instances.get.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto
- ZONE: la zona della VM
- VM_NAME: la zona della VM

Passa lo script di avvio utilizzando il valore fingerprint, insieme alla chiave e al valore dei metadati per lo script di avvio, in una chiamata al metodo instances.setMetadata:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata

{
  "fingerprint": FINGERPRINT,
  "items": [
    {
      "key": "startup-script",
      "value": "#! /bin/bash\napt update\napt -y install apache2\ncat <<EOF > /var/www/html/index.html\n<html><body><p>Linux startup script added directly.</p></body></html>\nEOF"
    }
  ],
  ...
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto
ZONE: la zona della VM
VM_NAME: la zona della VM
FINGERPRINT: il valore di tags.fingerprint ottenuta mediante l'uso di instances.get metodo

Verifica dello script di avvio

Trasmissione di uno script di avvio di Linux da un file locale

Puoi archiviare uno script di avvio in un file locale sulla tua workstation e passare il file locale come metadati a una VM quando la crei. Non puoi utilizzare i file archiviati sulle VM come script di avvio.

Prima di passare uno script di avvio Linux da un file locale a una VM, segui questi passaggi: seguenti:

Crea un file locale per archiviare lo script di avvio.
Prendi nota del percorso relativo dall'interfaccia a riga di comando gcloud allo script di avvio.

Aggiungi il seguente script di avvio al file:

#! /bin/bash
apt update
apt -y install apache2
cat <<EOF > /var/www/html/index.html
<html><body><p>Linux startup script from a local file.</p></body></html>
EOF

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

Tutte le autorizzazioni necessarie per creare una nuova VM.
compute.instances.setMetadata sulla VM.

gcloud

Passare uno script di avvio Linux da un file locale a una nuova VM

Crea una VM e passa i contenuti di un file locale da utilizzare come script di avvio utilizzando il comando gcloud compute instances create con il flag --metadata-from-file.

gcloud compute instances create VM_NAME \
  --image-project=debian-cloud \
  --image-family=debian-10 \
  --metadata-from-file=startup-script=FILE_PATH

Sostituisci quanto segue:

VM_NAME: il nome della VM
FILE_PATH: il percorso relativo al file script di avvio

Passare uno script di avvio Linux da un file locale a una VM esistente

Passa uno script di avvio a una VM esistente da un file locale utilizzando il seguente gcloud compute instances add-metadata comando:

gcloud compute instances add-metadata VM_NAME \
  --zone=ZONE \
  --metadata-from-file startup-script=FILE_PATH

Sostituisci quanto segue:

VM_NAME: il nome della VM
ZONE: la zona della VM
FILE_PATH: il percorso relativo alla startup file di script

Verificare lo script di avvio

Visualizza l'IP esterno in un browser web per verificare che lo script di avvio abbia creato il sito web. Potresti dover attendere circa 1 minuto prima che venga avviato l'esempio per completare lo script.

Trasmissione di uno script di avvio Linux da Cloud Storage

Puoi archiviare uno script di avvio in Cloud Storage e passarlo a una VM al momento della creazione. Dopo aver aggiunto uno script di avvio a Cloud Storage, disponi di un URL da utilizzare per fare riferimento allo script di avvio quando crei una VM.

Prima di aggiungere uno script di avvio da un bucket Cloud Storage, esegui la seguenti:

Crea un file per archiviare lo script di avvio. Questo esempio utilizza un file bash (.sh).

Aggiungi quanto segue al file bash, che installa Apache e crea una semplice pagina web:

#! /bin/bash
apt update
apt -y install apache2
cat <<EOF > /var/www/html/index.html
<html><body><p>Linux startup script from Cloud Storage.</p></body></html>
EOF

Crea un bucket Cloud Storage.
Aggiungi il file al bucket Cloud Storage.

Implicazioni per la sicurezza

Per impostazione predefinita, i proprietari e gli editor dei progetti possono accedere ai file di Cloud Storage nello stesso progetto, a meno che non siano presenti controlli di accesso espliciti che lo impediscano.
Se il bucket o l'oggetto Cloud Storage è meno sicuro dei metadati, esiste il rischio di escalation dei privilegi se lo script di avvio viene modificato e la VM si riavvia. Questo accade perché, dopo il riavvio della VM, lo script di avvio viene eseguito come root e può quindi utilizzare le autorizzazioni dell'account di servizio associato per accedere ad altre risorse.

Limitazioni

Container-Optimized OS ha un supporto limitato o nullo per alcune funzionalità.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

Tutte le autorizzazioni necessarie per creare una nuova VM.
compute.instances.setMetadata sulla VM.
Autorizzazione ad accedere al bucket e al file di script in Cloud Storage. Controlla le impostazioni di controllo dell'accesso sul bucket e sul file per assicurarti di disporre dell'autorizzazione.

Console

Passaggio di uno script di avvio archiviato in Cloud Storage su una nuova VM

Nella console Google Cloud, vai alla pagina Crea un'istanza.

Vai a Crea un'istanza
Specifica i dettagli della VM.
In Disco di avvio, seleziona Cambia e scegli un sistema operativo Linux.
Nella sezione Identità e accesso API, seleziona un account di servizio che abbia il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer).
Espandi la sezione Opzioni avanzate e segui questi passaggi:
1. Espandi la sezione Gestione.
2. Nella sezione Metadati, aggiungi i valori per quanto segue:
  - Chiave: la chiave dei metadati. Imposta su startup-script-url per aggiungere un script di avvio da Cloud Storage.
  - Valore: il valore dei metadati. Imposta la posizione del file dello script di avvio in Cloud Storage utilizzando uno dei seguenti formati:
    - URL autenticato: https://storage.googleapis.com/BUCKET/FILE
    - URI gcloud storage: gs://BUCKET/FILE
    Sostituisci quanto segue:
    - BUCKET: il nome del bucket che contiene il file dello script di avvio
    - FILE: il nome del file dello script di avvio
Per creare la VM, fai clic su Crea.

Passaggio di uno script di avvio archiviato in Cloud Storage a una VM esistente

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sul nome della VM.
Fai clic su Modifica.
In Metadati, aggiungi i seguenti valori:
- Chiave: startup-script-url
- Valore: il percorso Cloud Storage dello script di avvio utilizzando uno dei seguenti formati:
  - URL autenticato: https://storage.googleapis.com/BUCKET/FILE
  - URI gcloud storage: gs://BUCKET/FILE

Verificare lo script di avvio

Visualizza l'IP esterno in un browser web per verificare che lo script di avvio abbia creato il sito web. Potresti dover attendere circa 1 minuto prima che venga visualizzato script di avvio.

gcloud

Passare uno script di avvio archiviato in Cloud Storage a una nuova VM

Passa a una VM uno script di avvio archiviato in Cloud Storage quando per crearlo usando questo gcloud compute instances create un comando kubectl. Per il valore di il flag --scope, utilizza storage-ro per consentire alla VM di accedere di archiviazione ideale in Cloud Storage.

gcloud compute instances create VM_NAME \
  --image-project=debian-cloud \
  --image-family=debian-10 \
  --scopes=storage-ro \
  --metadata=startup-script-url=CLOUD_STORAGE_URL

Sostituisci quanto segue:

VM_NAME: il nome della VM.
CLOUD_STORAGE_URL: il valore dei metadati. Imposta su il percorso Cloud Storage del file di script di avvio utilizzando uno dei seguenti formati:
- URL autenticato: https://storage.googleapis.com/BUCKET/FILE
- URI gcloud storage: gs://BUCKET/FILE

Passaggio di uno script di avvio archiviato in Cloud Storage a una VM esistente

Passa uno script di avvio archiviato in Cloud Storage a una VM esistente utilizzando il seguente gcloud compute instances add-metadata comando:

gcloud compute instances add-metadata VM_NAME \
    --zone=ZONE \
    --metadata startup-script-url=CLOUD_STORAGE_URL

Sostituisci quanto segue:

VM_NAME: il nome della VM.
ZONE: la zona della VM.
CLOUD_STORAGE_URL: il valore dei metadati. Impostato sulla posizione del file dello script di avvio in Cloud Storage utilizzando uno dei seguenti formati:
- URL autenticato: https://storage.googleapis.com/BUCKET/FILE
- URI gcloud storage: gs://BUCKET/FILE

Verificare lo script di avvio

Visualizza l'IP esterno in un browser web per verificare che lo script di avvio abbia creato il sito web. Potresti dover attendere circa 1 minuto prima che venga visualizzato script di avvio.

REST

Passare uno script di avvio archiviato in Cloud Storage a una nuova VM

Passa uno script di avvio archiviato in Cloud Storage a una VM quando la crei utilizzando il seguente metodo instances.insert. Alle scopes aggiungi https://www.googleapis.com/auth/devstorage.read_only in modo che la VM possono accedere a Cloud Storage.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  ...
  "networkInterfaces": [
    {
      "accessConfigs": [
        {
          "type": "ONE_TO_ONE_NAT"
        }
      ]
    }
  ],
  "serviceAccounts": [
    {
      "email": "default",
      "scopes": [
        "https://www.googleapis.com/auth/devstorage.read_only"
      ]
    }
  ],
  "metadata": {
    "items": [
      {
        "key": "startup-script-url",
        "value": "CLOUD_STORAGE_URL"
      }
    ]
  },
  ...
}

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto.
ZONE: la zona in cui creare la nuova VM.
CLOUD_STORAGE_URL: il valore dei metadati. Impostato sulla posizione del file dello script di avvio in Cloud Storage utilizzando uno dei seguenti formati:
- URL autenticato: https://storage.googleapis.com/BUCKET/FILE
- URI gcloud storage: gs://BUCKET/FILE

Passaggio di uno script di avvio archiviato in Cloud Storage a una VM esistente

Ottieni il valore tags.fingerprint della VM utilizzando il metodo instances.get.
```
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto
- ZONE: la zona della VM
- VM_NAME: la zona della VM
Passa lo script di avvio utilizzando il valore fingerprint, insieme al comando la chiave e il valore dei metadati per lo script di avvio, in una chiamata al instances.setMetadata :
```
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setMetadata

{
  "fingerprint": FINGERPRINT,
  "items": [
    {
        "key": "startup-script-url",
        "value": "CLOUD_STORAGE_URL"
    }
  ],
  ...
}
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto.
- ZONE: la zona della VM.
- VM_NAME: la zona della VM.
- FINGERPRINT: il valore di tags.fingerprint ottenuta mediante l'uso di instances.get di controllo.
- CLOUD_STORAGE_URL: il valore dei metadati. Imposta su il percorso Cloud Storage del file di script di avvio utilizzando uno dei seguenti formati:
  - URL autenticato: https://storage.googleapis.com/BUCKET/FILE
  - URI gcloud storage: gs://BUCKET/FILE

Verificare lo script di avvio

Visualizza l'IP esterno in un browser web per verificare che lo script di avvio abbia creato il sito web. Potresti dover attendere circa 1 minuto prima che venga visualizzato script di avvio.

Accesso ai metadati da uno script di avvio di Linux

In uno script di avvio puoi accedere ai valori dei metadati. Ad esempio, puoi utilizzare lo stesso script per più VM e parametrizzare ogni script singolarmente passando valori dei metadati diversi a ogni VM.

Per accedere a un valore dei metadati personalizzato da uno script di avvio:

Crea uno script di avvio che esegue una query sul valore di una chiave dei metadati. Ad esempio, il seguente script di avvio del file bash (.sh) esegue una query sul valore della chiave dei metadati foo.

#! /bin/bash
METADATA_VALUE=$(curl http://metadata.google.internal/computeMetadata/v1/instance/attributes/foo -H "Metadata-Flavor: Google")
apt update
apt -y install apache2
cat <<EOF > /var/www/html/index.html
<html><body><p>Accessing metadata value of foo: $METADATA_VALUE</p></body></html>
EOF

Imposta il valore della chiave di metadati foo quando crei una VM usando il metodo persone che segui gcloud compute instances create comando. Per questo esempio, lo script di avvio viene passato alla VM da un file locale.
gcloud
```
gcloud compute instances create VM_NAME \
  --image-project=debian-cloud \
  --image-family=debian-10 \
  --metadata-from-file=startup-script=FILE_PATH \
  --metadata=foo=bar
```
Sostituisci quanto segue:
- VM_NAME: il nome della VM
- FILE_PATH: il percorso relativo alla startup file di script
Per saperne di più su come specificare una coppia chiave/valore dei metadati, consulta Impostare i metadati personalizzati.
Dalla tua workstation locale, visualizza l'IP esterno in un browser web per verificare che lo script di avvio restituisca il valore foo. Potresti dover attendere circa 1 minuto per il completamento dello script di avvio di esempio.

Riavviare uno script di avvio di Linux

Esegui di nuovo uno script di avvio procedendo nel seguente modo:

Connessione alla VM.

Esegui il seguente comando:

sudo google_metadata_script_runner startup

Visualizzazione dell'output di uno script di avvio Linux

Puoi visualizzare l'output di uno script di avvio Linux eseguendo una delle seguenti operazioni:

Connessione all'istanza ed eseguendo questo comando:

sudo journalctl -u google-startup-scripts.service

Visualizza l'output tramite la porta seriale 1 nella console Google Cloud e controlla la presenza di eventigoogle_metadata_script_runner.

Passaggi successivi

Scopri come utilizzare gli script di avvio nelle VM Windows.
Scopri come risolvere i problemi relativi agli script di avvio.
Scopri come aggiungere uno script di arresto.
Scopri di più sull'archiviazione e il recupero dei metadati.