Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurare le impostazioni di EC2Launch v2 per le istanze Windows

Questa sezione contiene informazioni su come configurare le impostazioni per EC2Launch v2.

Modifica delle impostazioni utilizzando la finestra di dialogo delle impostazioni di EC2Launch v2

Di seguito è riportato un esempio di file YAML di configurazione creato dalle impostazioni immesse nella finestra di dialogo EC2Launch.

version: 1.0
config:
  - stage: boot
	tasks:
      - task: extendRootPartition
  - stage: preReady
    tasks:
      - task: activateWindows
        inputs:
          activation:
            type: amazon
      - task: setDnsSuffix
        inputs:
          suffixes:
            - $REGION.ec2-utilities.amazonaws.com
      - task: setAdminAccount
        inputs:
          password:
            type: random
      - task: setWallpaper
        inputs:
          path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
          attributes:
            - hostName
            - instanceId
            - privateIpAddress
            - publicIpAddress
            - instanceSize
            - availabilityZone
            - architecture
            - memory
            - network
  - stage: postReady
    tasks:
      - task: startSsm

Configurare EC2Launch v2 tramite la CLI

Puoi utilizzare l'interfaccia a riga di comando (CLI) per configurare le impostazioni di EC2Launch e gestire il servizio. La sezione seguente contiene le descrizioni e le informazioni sull'utilizzo dei comandi CLI che puoi usare per gestire EC2Launch v2.

collect-logs

Raccoglie i file di log per EC2launch, comprime i file e li inserisce in una directory specificata.

Esempio

ec2launch collect-logs -o C:\Mylogs.zip

Usage

ec2launch collect-logs [flags]

Flag

-h, --help

aiuto per collect-logs

-o, --output string

percorso dei file di log di output compressi

get-agent-config

Stampa agent-config.yml nel formato specificato (JSON o YAML). Se non viene specificato alcun formato, agent-config.yml viene stampato nel formato specificato in precedenza.

Esempio

ec2launch get-agent-config -f json

Usage

ec2launch get-agent-config [flags]

Flag

-h, --help

aiuto per get-agent-config

-f, --format string

formato di output del file agent-config: json, yaml

list-volumes

Elenca tutti i volumi di archiviazione collegati all'istanza, inclusi i volumi temporanei ed EBS.

Esempio

ec2launch list-volumes

Usage

ec2launch list-volumes

Flag

-h, --help

aiuto per list-volumes

reset

L'obiettivo principale di questa attività è reimpostare l'agente per la prossima esecuzione. A tale scopo, il comando reset elimina tutti i dati sullo stato dell'agente per EC2Launch v2 dalla directory EC2Launch locale (consultare Struttura della directory di EC2Launch v2). Il ripristino elimina facoltativamente i log di servizio e Sysprep.

Il comportamento degli script dipende dalla modalità in cui l'agente esegue gli script: in linea o distaccati.

Esempio

ec2launch reset -c

Usage

ec2launch reset [flags]

Flag

-c, --clean

pulisce i log delle istanze prima di reset

-h, --help

aiuto per reset

run

Esecuzioni di EC2Launch v2

Esempio

ec2launch run

Usage

ec2launch run [flags]

Flag

-h, --help

aiuto per run

status

Ottiene lo stato dell'agente EC2Launch v2. Blocca facoltativamente il processo fino al completamento dell'agente. Il codice di uscita del processo determina lo stato dell'agente:

Ad esempio:

ec2launch status -b

Usage

ec2launch status [flags]

Flag

-b,--block

blocca il processo fino al termine dell'esecuzione del'aggente

-h,--help

aiuto per status

sysprep

L'obiettivo principale di questa attività è reimpostare l'agente per la prossima esecuzione. A tale scopo, il comando sysprep reimposta lo stato dell'agente, aggiorna il file unattend.xml, disabilita RDP ed esegue Sysprep.

Il comportamento degli script dipende dalla modalità in cui l'agente esegue gli script: in linea o distaccati.

Ad esempio:

ec2launch sysprep

Usage

ec2launch sysprep [flags]

Flag

-c,--clean

pulisce i log delle istanze prima di sysprep

-h,--help

aiuto per Sysprep

-s,--shutdown

arresta l'istanza dopo sysprep

validate

Convalida il file agent-config C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml.

Esempio

ec2launch validate

Usage

ec2launch validate [flags]

Flag

-h , --help

aiuto per validate

version

Ottiene la versione eseguibile.

Esempio

ec2launch version

Usage

ec2launch version [flags]

Flag

-h, --help

aiuto per version

wallpaper

Imposta il nuovo sfondo sul percorso dello sfondo fornito (file .jpg) e visualizza i dettagli dell'istanza selezionata.

Sintassi

ec2launch wallpaper ^
--path="C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg" ^
--all-tags ^
--attributes=hostName,instanceId,privateIpAddress,publicIpAddress,instanceSize,availabilityZone,architecture,memory,network

Input

Configurazione dell'attività di EC2Launch v2

In questa sezione sono riportati lo schema, le attività, i dettagli e gli esempi di configurazione per agent-config.yml e i dati utente.

Schema: agent-config.yml

La struttura del file agent-config.yml è riportata di seguito. Nota che un'attività non può essere ripetuta nella stessa fase. Per le proprietà delle attività, consulta le descrizioni delle attività che seguono.

Struttura del documento: agent-config.yml

JSON

{
	"version": "1.1",
	"config": [
		{
			"stage": "string",
			"tasks": [
				{
					"task": "string",
					"inputs": {
						...
					}
				},
				...
			]
		},
		...
	]
}

YAML

version: 1.1
config:
- stage: string
  tasks:
  - task: string
	inputs:
	  ...
  ...
...

Esempio: agent-config.yml

Nell'esempio seguente vengono illustrate le impostazioni per il file di configurazione agent-config.yml.

version: 1.1
config:
- stage: boot
  tasks:
  - task: extendRootPartition
- stage: preReady
  tasks:
  - task: activateWindows
    inputs:
      activation:
        type: amazon
  - task: setDnsSuffix
    inputs:
      suffixes:
      - $REGION.ec2-utilities.amazonaws.com
  - task: setAdminAccount
    inputs:
      password:
        type: random
  - task: setWallpaper
    inputs:
      path: C:\ProgramData\Amazon\EC2Launch\wallpaper\Ec2Wallpaper.jpg
      attributes:
      - hostName
      - instanceId
      - privateIpAddress
      - publicIpAddress
      - instanceSize
      - availabilityZone
      - architecture
      - memory
      - network
- stage: postReady
  tasks:
  - task: startSsm

Configurare gli script dei dati utente di EC2Launch v2 che vengono eseguiti durante l'avvio o il riavvio

Gli esempi JSON e YAML seguenti mostrano la struttura del documento per i dati utente. Amazon EC2 analizza ogni attività rinominata nell'array tasks specificato nel documento. Ogni attività ha il proprio set di proprietà e requisiti. Per informazioni dettagliate, consulta la Definizioni delle attività di avvio di EC2Launch v2.

Struttura del documento: dati utente

JSON

{
	"version": "1.1",
	"tasks": [
		{
			"task": "string",
			"inputs": {
				...
			},
		},
		...
	]
}

YAML

version: 1.1
tasks:
- task: string
  inputs:
    ...
...

Esempio: dati utente

Per ulteriori informazioni su questi dati utente, vedere In che modo Amazon EC2 gestisce i dati degli utenti per le istanze Windows.

Il seguente esempio di documento YAML mostra uno script PowerShell che EC2Launch v2 esegue come dati utente per creare un file.

version: 1.1
tasks:
- task: executeScript
  inputs:
  - frequency: always
    type: powershell
    runAs: localSystem
    content: |-
      New-Item -Path 'C:\PowerShellTest.txt' -ItemType File

È possibile utilizzare un formato XML per i dati utente compatibile con le versioni precedenti dell'agente di avvio. EC2Launch v2 esegue lo script come attività executeScript nella fase UserData. Per conformarsi al comportamento di EC2Launch v1 ed EC2Config, lo script dei dati utente viene eseguito come processo attaccato/in linea per impostazione predefinita.

Puoi aggiungere tag opzionali per personalizzare la modalità di esecuzione dello script. Ad esempio, per eseguire lo script dei dati utente al riavvio dell'istanza e una volta all'avvio dell'istanza, puoi utilizzare il seguente tag:

<persist>true</persist>

Ad esempio:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<persist>true</persist>

Puoi specificare uno o più argomenti PowerShell con il tag <powershellArguments>. Se non viene passato alcun argomento, EC2Launch v2 aggiunge il seguente argomento per impostazione predefinita: -ExecutionPolicy Unrestricted.

Ad esempio:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<powershellArguments>-ExecutionPolicy Unrestricted -NoProfile -NonInteractive</powershellArguments>

Per eseguire uno script di dati utente XML come processo distaccato, aggiungi il seguente tag ai dati utente.

<detach>true</detach>

Ad esempio:

<powershell>
  $file = $env:SystemRoot + "\Temp" + (Get-Date).ToString("MM-dd-yy-hh-mm")
  New-Item $file -ItemType file
</powershell>
<detach>true</detach>

Log delle modifiche: dati utente

La tabella seguente elenca le modifiche apportate ai dati utente e le confronta con la versione dell'agente EC2Launch v2 applicabile.

* Se utilizzato con il file agent-config.yml predefinito.

Codici di uscita e riavvii EC2Launch v2

È possibile utilizzare EC2Launch v2 per definire come i codici di uscita vengono gestiti dagli script. Per impostazione predefinita, il codice di uscita dell'ultimo comando eseguito in uno script viene segnalato come codice di uscita per l'intero script. Ad esempio, se uno script include tre comandi e il primo comando ha esito negativo ma quelli seguenti hanno esito positivo, lo stato di esecuzione viene segnalato come success perché il comando finale ha avuto esito positivo.

Se si desidera che uno script riavvii un'istanza, è necessario specificare exit 3010 nello script, anche quando il riavvio è l'ultimo passo dello script. exit 3010 indica a EC2Launch v2 di riavviare l'istanza e richiamare nuovamente lo script fino a quando non restituisce un codice di uscita che non è 3010 o fino a quando non viene raggiunto il numero massimo di riavvii. EC2Launch v2 consente un massimo di 5 riavvii per attività. Se si tenta di riavviare un'istanza da uno script utilizzando un meccanismo diverso, ad esempio Restart-Computer, lo stato di esecuzione dello script non sarà coerente. Ad esempio, potrebbe rimanere bloccato in un ciclo di riavvio o non eseguire il riavvio.

Se utilizzi un formato di dati utente XML compatibile con agenti meno recenti, i dati utente potrebbero essere eseguiti più volte di quanto desideri. Per ulteriori informazioni, consulta Il servizio esegue i dati utente più di una volta nella sezione di risoluzione dei problemi.

EC2Launch v2 e Sysprep

Il servizio EC2Launch v2 esegue Sysprep, uno strumento Microsoft che ti permette di creare un'AMI di Windows personalizzata che può essere riutilizzata. Quando EC2Launch v2 chiama Sysprep, utilizza i file contenuti in %ProgramData%\Amazon\EC2Launch per determinare quali operazioni eseguire. Puoi modificare questi file indirettamente utilizzando la finestra di dialogo Impostazioni EC2Launch direttamente utilizzando un editor YAML o un editor di testo. Tuttavia esistono alcune impostazioni avanzate che non sono disponibili nella finestra di dialogoImpostazioni EC2Launch, quindi è necessario modificarle direttamente.

Se crei un'AMI da un'istanza dopo l'aggiornamento delle sue impostazioni, le nuove impostazioni vengono applicate a ogni istanza lanciata dalla nuova AMI. Per informazioni sulla creazione di un'AMI, consulta Creare un'AMI supportata da Amazon EBS.