Configura le routine di avvio delle VM

Version 1.13 

• Ultimi
• Versione 1.16
• Versioni precedenti (non supportate)

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Quando utilizzi Anthos clusters on bare metal versione 1.13.0 e successive, puoi specificare le routine di avvio per personalizzare l'inizializzazione della VM all'avvio. Puoi configurare la tua VM per creare chiavi SSH, aggiungere utenti e password, installare pacchetti, scrivere file, configurare le impostazioni di rete e altro ancora.

Queste attività di avvio sono configurate con l'API cloud-init o con l'API Script di avvio (non entrambe). Queste istruzioni di avvio sono specificate nel file manifest YAML VirtualMachine e vengono eseguite automaticamente a ogni avvio della VM.

Prerequisiti

Per configurare una VM con istruzioni di avvio, devi soddisfare i seguenti prerequisiti:

• Abilita il runtime VM di Anthos.

• Utilizza un sistema operativo Linux verificato e imposta osType su Linux nel manifest della VM. I sistemi operativi Windows non sono supportati per questa funzionalità, poiché non supportano cloud-init.

• Assicurati che sul sistema operativo guest sia installato cloud-init. I sistemi operativi Linux più recenti includono cloud-init.

Le sezioni seguenti descrivono come specificare le routine di avvio nel manifest della VM con l'API cloud-init o gli script di avvio.

Usa l'API cloud-init per inizializzare le VM

Cloud-init è comunemente utilizzato per l'inizializzazione delle istanze cloud e per personalizzare le VM durante l'avvio. In genere, l'inizializzazione delle VM prevede attività come l'installazione dei pacchetti, la configurazione dei repository, la creazione di chiavi SSH, la scrittura di dati nei file e la configurazione di altri aspetti della VM. Incorpori YAML di configurazione cloud-in nella risorsa personalizzata VirtualMachine con il campo spec.cloudInit. All'avvio dell'istanza VM, cloud-init legge i dati forniti e inizializza la VM di conseguenza.

Prendi nota dei seguenti dettagli della nostra implementazione di cloud-init:

• Puoi specificare i dati cloud-init nel manifest YAML VirtualMachine quando crei o aggiorni una VM. Per istruzioni su come creare una VM applicando un manifest, consulta il tutorial: crea e gestisci una VM Linux nel runtime VM di Anthos.

• Utilizziamo l'origine dati NoCloud, spec.cloudInit.noCloud nelle specifiche della nostra VM.

• Devi specificare i dati utente e i dati di rete in sezioni separate nel manifest VirtualMachine. La denominazione delle sezioni e la struttura dipendono dal formato dei dati che decidi di utilizzare.

• Puoi specificare le informazioni di configurazione di cloud-init nei seguenti formati dati:

  • Cancella testo
  • Stringa codificata in Base64
  • Secret Kubernetes

Nota: non è possibile specificare entrambe le istruzioni API cloud-init (spec.cloudInit) e gli script di avvio (spec.startupScripts) nello stesso manifestVirtualMachine.

Per aiutarti a iniziare, abbiamo fornito alcuni esempi di configurazione per le attività comuni di inizializzazione delle VM.

Dati utente Cloud-init

Anthos VM Runtime supporta i dati utente cloud-init nella sintassi cloud-config, quindi inizia i dati utente con #cloud-config. Puoi formattare i dati utente come testo in chiaro, una stringa codificata in base64 o un secret di Kubernetes.

Nota: quando si utilizza testo chiaro o una stringa codificata in base64, la dimensione massima consentita è 2048 byte. Se la dimensione dei dati utente è pari o superiore a 2048 byte, specificala come secret di Kubernetes.

Per ulteriori informazioni sulla sintassi dei dati utente e sul riferimento del modulo, consulta la documentazione relativa a cloud-init.

Dati utente Cloud-in come testo in chiaro

Il file manifest di esempio riportato di seguito mostra come specificare i dati utente come testo in chiaro. In questo caso, cloud-init esegue un comando all'avvio della VM:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        runcmd:
          - echo hello

Dati utente Cloud-init come stringa codificata in base64

L'esempio seguente mostra come specificare i dati utente in formato con codifica base64. In questo esempio, i dati utente sono costituiti dallo stesso comando echo hello dell'esempio di testo in chiaro:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userDataBase64: I2Nsb3VkLWNvbmZpZwpydW5jbWQ6CiAgLSBlY2hvIGhlbGxvCg==

Dati utente Cloud-init come secret di Kubernetes

L'esempio seguente mostra un manifest YAML sia per VirtualMachine che per Secret. La sezione spec.cloudInit.noCloud.secretRef nella configurazione VirtualMachine indica che i dati utente di cloud-init si trovano in un secret di Kubernetes denominato my-sec. La configurazione Secret corrispondente specifica i dati utente come coppia chiave-valore. Il valore codificato in base64 in questo caso sono i dati utente cloud-init nella sintassi cloud-config.

Nel Secret di riferimento, utilizza la chiave dei dati userData (mostrata) o userdata per specificare i dati utente cloud-init.

In questo esempio, i dati utente sono costituiti dallo stesso comando echo hello dell'esempio di testo in chiaro:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      secretRef:
        name: my-sec
---
apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: my-sec
data:
  userData: I2Nsb3VkLWNvbmZpZwpydW5jbWQ6CiAgLSBlY2hvIGhlbGxvCg==

Se il secret specificato non è stato trovato o la chiave dati userData o userdata non esiste nel secret, tieni presente il seguente comportamento di avvio delle VM:

• Per la creazione della VM, la VM viene messa in stato ErrorConfiguration con un motivo e un messaggio dettagliati.

• In altri casi, la VM continua a utilizzare i vecchi dati utente cloud-init finché la VM non è configurata correttamente. Di conseguenza, l'abilitazione o la disabilitazione degli aggiornamenti agli agenti non ha effetto finché la VM non è configurata correttamente.

Per recuperare le informazioni sulle VM, inclusi i dati utente cloud-init utilizzati, utilizza il comando seguente:

kubectl get vm VM_NAME -o yaml --kubeconfig KUBECONFIG_PATH

Sostituisci quanto segue:

• VM_NAME: il nome della tua VM.

• KUBECONFIG_PATH: il percorso del file kubeconfig per il cluster contenente la tua VM.

Per recuperare l'evento di avviso di Kubernetes correlato, utilizza kubectl get event o kubectl describe gvm.

Dati di rete Cloud-init

Analogamente ai dati utente, puoi formattare i dati di rete come testo in chiaro, una stringa codificata in base64 o un secret di Kubernetes. A differenza dei dati utente, i dati di rete non utilizzano la sintassi di cloud-config.

Quando utilizzi testo in chiaro o una stringa codificata in base64, la dimensione massima consentita è 2048 byte. Se la dimensione dei dati utente è pari o superiore a 2048 byte, specificala come secret di Kubernetes.

Per ulteriori informazioni sulla sintassi dei dati di rete e sui dettagli correlati, consulta la sezione Networking Config versione 2 nella documentazione relativa a cloud-init.

Suggerimento: le sezioni seguenti illustrano come specificare i dati di rete cloud-init nella configurazione di VirtualMachine in diversi formati. I dati di rete di esempio attivano il protocollo DHCP per tutti i dispositivi Ethernet i cui nomi iniziano con una "e". Questa specifica istruzione cloud-init per abilitare il DHCP viene incorporata automaticamente nella VM, in modo da non doverla specificare manualmente.

Dati di rete cloud-init come testo in chiaro

Il file manifest di esempio riportato di seguito mostra come specificare i dati di rete come testo in chiaro. In questo caso, cloud-init abilita il protocollo DHCP per tutti i dispositivi Ethernet i cui nomi iniziano con una "e" (e*):

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        runcmd:
          - echo hello
      networkData: |
        version: 2
        ethernets:
          alleths:
            match:
              name: e*
            dhcp4: true

Dati di rete cloud-init come stringa codificata in base64

L'esempio seguente mostra come specificare i dati di rete in formato con codifica base64. In questo esempio, i dati di rete sono costituiti dalla stessa configurazione DHCP specificata nell'esempio di testo chiaro:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      networkDataBase64: dmVyc2lvbjogMgpldGhlcm5ldHM6CiAgYWxsZXRoczoKICAgIG1hdGNoOgogICAgICBuYW1lOiBlKgogICAgZGhjcDQ6IHRydWUK

Dati di rete cloud-in come secret di Kubernetes

L'esempio seguente mostra un manifest YAML sia per VirtualMachine che per Secret. La sezione spec.cloudInit.noCloud.networkDataSecretRef nella configurazione VirtualMachine indica che i dati di rete cloud-init si trovano in un secret Kubernetes denominato my-sec. La configurazione Secret corrispondente specifica i dati di rete come coppia chiave-valore. Il valore codificato in base64 in questo caso sono i dati di rete cloud-init.

Nel secret di riferimento, utilizza la chiave dati networkData (visualizzata) o networkdata per specificare i dati di rete cloud-init.

In questo esempio, i dati di rete sono costituiti dalla stessa configurazione DHCP specificata nell'esempio di testo chiaro:

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      networkDataSecretRef:
        name: my-sec
---
apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: my-sec
data:
  networkData: dmVyc2lvbjogMgpldGhlcm5ldHM6CiAgYWxsZXRoczoKICAgIG1hdGNoOgogICAgICBuYW1lOiBlKgogICAgZGhjcDQ6IHRydWUK

Esempi di cloud-init

Le seguenti sezioni contengono alcuni esempi di testo chiaro di alcuni casi d'uso comuni per l'inizializzazione delle VM con cloud-init:

• Configurare le chiavi SSH autorizzate
• Aggiungere un nuovo utente
• Esegui i comandi al primo avvio
• Scrivi file

Configura chiavi SSH autorizzate

Il seguente esempio di dati utente assegna la chiave SSH autorizzata ssh-rsa AAAAB3NzaK8L93bWxnyp all'utente predefinito.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        ssh_authorized_keys:
          - ssh-rsa AAAAB3NzaK8L93bWxnyp

Aggiungere un nuovo utente

L'esempio di dati utente riportato di seguito crea un utente test e concede a test l'accesso completo sudo. In questo esempio all'utente viene assegnata una password di pwd senza scadenza.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        users:
        - default
        - name: test
          sudo: ALL=(ALL) NOPASSWD:ALL
        chpasswd:
          list: |
            test:pwd
          expire: False

Esegui comandi al primo avvio

Il seguente esempio di dati utente esegue un comando echo e un comando ls. Puoi utilizzare i comandi per installare pacchetti e altro all'avvio della VM.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        runcmd:
          - [ echo, hello ]
          - [ ls, -l, / ]

Scrittura di file

L'esempio di dati utente seguente scrive uno script bash nel file test nella directory /var/lib/google della VM. Le istruzioni cloud-init impostano le autorizzazioni del file per la lettura, la scrittura e l'esecuzione (0744) per il proprietario del file.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  cloudInit:
    noCloud:
      userData: |
        #cloud-config
        write_files:
        - path: /var/lib/google/test
          permissions: 0744
          content: |
            #!/bin/bash
            echo hello

Risoluzione dei problemi di cloud-init

Se riscontri problemi con l'inizializzazione della VM e utilizzi cloud-init, verifica i seguenti log cloud-init nella VM:

• /var/log/cloud-init.log: per impostazione predefinita, in questo log cloud-init scrive tutti gli eventi con un livello pari o superiore a DEBUG.

• /var/log/cloud-init-output.log: per impostazione predefinita, cloud-init indirizza sia stdout sia stderr da tutte le fasi di cloud-init a questo log.

Usa gli script di avvio per inizializzare le VM

Gli script di avvio eseguono le attività durante il processo di avvio di un'istanza di macchina virtuale (VM). Puoi specificare uno o più script nella sezione spec.startupScripts delle specifiche VirtualMachine. Gli script di avvio possono essere utilizzati per inizializzare la VM. In genere, l'inizializzazione delle VM prevede attività come l'installazione dei pacchetti, la configurazione dei repository, la creazione di chiavi SSH, la scrittura di dati nei file e la configurazione di altri aspetti della VM.

Tieni presente i seguenti dettagli per gli script di avvio:

• Specifica gli script di avvio nel manifest YAML di VirtualMachine quando crei o aggiorni una VM. Per istruzioni su come creare una VM applicando un manifest, consulta il tutorial: crea e gestisci una VM Linux nel runtime VM di Anthos.

• Gli script specificati vengono eseguiti a ogni avvio della VM.

• Includi #!/bin/... nella parte superiore dello script per indicare l'interprete dello script. Ad esempio, includi #!/bin/bash per eseguire lo script con la shell Bash.

• Non puoi specificare entrambe le istruzioni API cloud-init (spec.cloudInit) e gli script di avvio (spec.startupScripts) nello stesso manifest VirtualMachine.

Nota: se utilizzi Anthos clusters on bare metal versione 1.13.0, devi avviare la VM due volte affinché gli script di avvio abbiano effetto in circostanze specifiche. Questo comportamento di avvio della VM si applica solo quando aggiorni una VM esistente che non ha script di avvio per includere gli script di avvio. Questo problema è stato risolto in Anthos clusters on bare metal release 1.13.1 e versioni successive.

Formati script

Puoi specificare gli script di avvio nei seguenti formati di dati:

• Cancella testo
• Stringa codificata in Base64
• Secret Kubernetes

Tieni presente le seguenti regole per lavorare con diversi formati di script:

• Quando utilizzi testo chiaro o una stringa codificata in base64, la dimensione massima consentita per i contenuti dello script è 2048 byte. Se le dimensioni dei contenuti dello script sono superiori o superiori a 2048 byte, specifica gli script come secret di Kubernetes.

• Quando utilizzi un secret di Kubernetes, usa la chiave dati script nel secret di riferimento per specificare i contenuti dello script.

• Se non è stato trovato un Secret di riferimento o se la chiave dati script non esiste nel Secret di riferimento, la VM continua a eseguire lo script. ma non scrive o aggiorna i contenuti degli script. In questo caso, puoi trovare l'evento di avviso di Kubernetes con kubectl get event o kubectl describe gvm.

Il seguente manifest YAML VirtualMachine di esempio contiene tre script, uno in ciascuno dei formati supportati. In questo caso, ogni script esegue il comando echo hello mostrato in myscript1, l'esempio di testo in chiaro.

apiVersion: vm.cluster.gke.io/v1
kind: VirtualMachine
metadata:
  name: "my-vm"
spec:
  ...
  startupScripts:
  - name: myscript1
    script: |
      #!/bin/bash
      echo hello
  - name: myscript2
    scriptBase64: IyEvYmluL2Jhc2gKICAgICAgZWNobyBoZWxsbwo=
  - name: myscript3
    scriptSecretRef:
      name: my-sec
---
apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: my-sec
data:
  script: IyEvYmluL2Jhc2gKICAgICAgZWNobyBoZWxsbwo=

Risoluzione dei problemi relativi agli script

Per controllare i risultati o i log degli script, esegui il comando seguente:

journalctl -u cloud-final

Le voci di log degli script di avvio iniziano con il seguente testo:

started to run the command /var/lib/google/startup-scripts/SCRIPT_NAME ...

La voce di log include SCRIPT_NAME, il nome dello script di avvio.