Utilizza uno script di avvio nelle VM Windows

Uno script di avvio esegue attività durante il processo di avvio di una macchina virtuale (VM). Questa pagina fornisce i passaggi da seguire per utilizzare gli script di avvio sulle istanze VM.

Prima di iniziare

Per utilizzare i comandi dell'interfaccia a riga di comando (CLI) gdcloud, assicurati di aver scaricato, installato, e configurato la gdcloud CLI. Tutti i comandi per l'appliance GDC con air gap utilizzano la CLI gdcloud o kubectl e richiedono un ambiente del sistema operativo (OS).

Recupera il percorso del file kubeconfig

Per eseguire comandi sul server API di gestione, assicurati di disporre delle seguenti risorse:

  1. Individua il nome del server API di gestione o chiedi all'amministratore della piattaforma (PA) qual è il nome del server.

  2. Accedi e genera il file kubeconfig per il server API di gestione se non ne hai uno.

  3. Utilizza il percorso per sostituire MANAGEMENT_API_SERVER{"</var>"}} in queste istruzioni.

Richiedi ruoli IAM

Per utilizzare gli script di avvio per una VM, contatta l'amministratore IAM del progetto per richiedere i seguenti ruoli nel progetto:

  • Project VirtualMachine Admin (project-vm-admin): crea, modifica, elenca ed elimina le VM nello spazio dei nomi del progetto.

  • Secret Admin (secret-admin): recupera, elenca, crea, aggiorna, elimina, applica patch e monitora i secret Kubernetes nello spazio dei nomi del progetto. Utilizza questo ruolo per specificare i secret degli script di avvio. Non hai bisogno di questo ruolo per specificare gli script di avvio in testo normale.

Tutti i ruoli VM devono essere associati allo spazio dei nomi del progetto in cui risiede la VM. Segui i passaggi per verificare l'accesso.

Formattare i nomi degli script di avvio di Windows

Gli script di avvio per le VM Windows devono seguire un formato di denominazione specifico con il nome dello script e l'estensione del file aggiunti, separati da trattini. Ad esempio, create-directory-ps1, con create-directory come nome dello script e ps1 come estensione del file. I formati errati includono l'utilizzo di punti al posto dei trattini e l'omissione dell'estensione del file, ad esempio create-directory.ps1 e create-directory.

Di seguito sono riportate le estensioni di file da utilizzare per gli script di avvio di Windows:

  • ps1: contiene comandi PowerShell.
  • cmd: contiene comandi batch per l'interprete del prompt dei comandi.
  • bat: contiene comandi batch.

Eseguire gli script di avvio di Windows in ordine

Puoi utilizzare più script di avvio. Il tipo di file contenente lo script influisce sull'ordine di esecuzione di ogni script. La tabella seguente mostra l'ordine di esecuzione degli script di avvio di Windows:

Script Windows Ordine di esecuzione
Script di PowerShell Primo all'avvio.
Script batch Secondo all'avvio.
Script di comando Terzo all'avvio.

Se due script di avvio hanno la stessa estensione di file, gli script vengono eseguiti in base all'estensione e al nome del file in ordine alfabetico. Ad esempio, se i nomi degli script di avvio sono alpha-script-ps1 e beta-script-ps1, alpha-script-ps1 viene eseguito prima di beta-script-ps1.

La seguente specifica della VM di esempio mostra l'ordine e la struttura degli script di avvio di Windows nel campo startupScripts:

...
  startupScripts:
  - name: create-directory-ps1
    script: |-
      New-Item -ItemType Directory -Path C:\ -Name NewDir
      Get-ChildItem -Path C:\
  - name: hello-world-bat
    script: |-
      ECHO "Hello World!"
  - name: list-directories-cmd
    script: |-
      dir C:\Windows  > files.txt
...

Passare uno script di avvio

L'appliance GDC con air gap esegue gli script di avvio in ordine alfabetico, in base al nome di ogni script di avvio.

La tabella seguente mostra il formato dello script da utilizzare in base alle dimensioni dello script:

Dimensioni dello script Formato dello script
Script fino a 2048 byte Dati in chiaro
Script maggiori di 2048 byte Secret Kubernetes

Definire uno script di avvio

Per utilizzare uno script di avvio, devi aggiungere il campo startupScripts al campo spec della VM. In questo campo puoi specificare più script di avvio come testo normale o come secret Kubernetes.

L'esempio seguente specifica gli script di avvio come dati in chiaro e un secret Kubernetes:

apiVersion: virtualmachine.gdc.goog/v1
kind: VirtualMachine
metadata:
  name: "vm-test"
spec:
  ...
  startupScripts:
  - name: create-directory-ps1
    script: |-
      New-Item -ItemType Directory -Path C:\ -Name NewDir
      Get-ChildItem -Path C:\
  - name: list-directories-cmd
    scriptSecretRef:
      name: list-directories
---

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: list-directories
data: 
  script:
    ZGlyIEM6XFdpbmRvd3MgID4gZmlsZXMudHh0Cg==

Esamina le seguenti considerazioni:

  • Lo script di avvio viene eseguito a ogni avvio.
  • Lo script di avvio ha privilegi di root predefiniti.
  • Nel secret Kubernetes, il nome di scriptSecretRef nella spec della VM deve corrispondere al campo metadata.name.
  • Nel secret Kubernetes, specifica il contenuto dello script di avvio aggiungendo una chiave script al campo data.

Creare una nuova VM con uno script di avvio di Windows

Per creare una VM con uno script di avvio di Windows, segui i passaggi descritti in Creare una nuova VM con uno script di avvio.