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à.

Configura le impostazioni EC2Launch v2 per le istanze di Windows

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

Modificate le impostazioni utilizzando la finestra di EC2Launch dialogo delle impostazioni v2

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

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

Configura EC2Launch v2 usando il CLI

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

collect-logs

Raccoglie i file di registroEC2Launch, li comprime e li colloca in una directory specificata.

Esempio

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

Utilizzo

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 (JSONoYAML). Se non viene specificato alcun formato, agent-config.yml viene stampato nel formato specificato in precedenza.

Esempio

ec2launch get-agent-config -f json

Esempio 2

I PowerShell comandi seguenti mostrano come modificare e salvare il agent-config file nel JSON formato.

$config = & "$env:ProgramFiles/Amazon/EC2Launch/EC2Launch.exe" --format json | ConvertFrom-Json
$jumboFrame =@"
{
   "task": "enableJumboFrames"
}
"@
$config.config | %{if($_.stage -eq 'postReady'){$_.tasks += (ConvertFrom-Json -InputObject $jumboFrame)}}
$config | ConvertTo-Json -Depth 6 | Out-File -encoding UTF8
$env:ProgramData/Amazon/EC2Launch/config/agent-config.yml

Utilizzo

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 quelli effimeri e i volumi. EBS

Esempio

ec2launch list-volumes

Utilizzo

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 reset comando elimina tutti i dati sullo stato dell'agente per la versione EC2Launch 2 dalla directory locale EC2Launch (vedi). EC2Launchstruttura delle cartelle 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

Utilizzo

ec2launch reset [flags]

Flag

-c, --clean

pulisce i log delle istanze prima di reset

-h, --help

aiuto per reset

run

Esegue EC2Launch v2.

Esempio

ec2launch run

Utilizzo

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:

Esempio:

ec2launch status -b

Utilizzo

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 sysprep comando reimposta lo stato dell'agente, aggiorna il unattend.xml fileRDP, disabilita ed esegue Sysprep.

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

Esempio:

ec2launch sysprep

Utilizzo

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

Utilizzo

ec2launch validate [flags]

Flag

-h , --help

aiuto per validate

version

Ottiene la versione eseguibile.

Esempio

ec2launch version

Utilizzo

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

EC2Launchconfigurazione del task 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.0",
	"config": [
		{
			"stage": "string",
			"tasks": [
				{
					"task": "string",
					"inputs": {
						...
					}
				},
				...
			]
		},
		...
	]
}

YAML

version: 1.0
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.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

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

I seguenti YAML esempi mostrano JSON la struttura del documento per i dati utente. Amazon EC2 analizza ogni attività denominata nell'tasksarray specificato nel documento. Ogni attività ha il proprio set di proprietà e requisiti. Per informazioni dettagliate, consulta la Definizioni delle attività per le attività di avvio 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 YAML documento mostra uno PowerShell script che la EC2Launch versione 2 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 XML formato per i dati utente compatibile con le versioni precedenti del Launch Agent. EC2Launchv2 esegue lo script come executeScript attività nella UserData fase. Per conformarsi alla EC2Launch v1 e al EC2Config comportamento, lo script dei dati utente viene eseguito come processo allegato/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>

Esempio:

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

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

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 XML utente come processo indipendente, aggiungi il seguente tag ai tuoi dati utente.

<detach>true</detach>

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 ai dati utente e le rimanda alla versione dell'agente EC2Launch v2 applicabile.

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

EC2Launchcodici di uscita e riavvii 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 desideri che uno script riavvii un'istanza, devi specificarlo exit 3010 nello script, anche se il riavvio è l'ultimo passaggio dello script. exit 3010indica alla EC2Launch v2 di riavviare l'istanza e richiamare nuovamente lo script finché non restituisce un codice di uscita diverso o finché non viene 3010 raggiunto il numero massimo di riavvii. EC2Launchv2 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 si utilizza un formato di dati XML utente compatibile con gli agenti precedenti, i dati utente potrebbero essere eseguiti più volte del previsto. Per ulteriori informazioni, consulta Il servizio esegue i dati utente più di una volta nella sezione di risoluzione dei problemi.

EC2Launchv2 e Sysprep

Il servizio EC2Launch v2 esegue Sysprep, uno strumento Microsoft che consente di creare un Windows personalizzato AMI che può essere riutilizzato. Quando la versione EC2Launch v2 chiama Sysprep, utilizza i file per determinare le operazioni da eseguire. %ProgramData%\Amazon\EC2Launch È possibile modificare questi file indirettamente utilizzando la finestra di dialogo EC2Launchdelle impostazioni o direttamente utilizzando un YAML editor o un editor di testo. Tuttavia, alcune impostazioni avanzate non sono disponibili nella finestra di dialogo delle EC2Launchimpostazioni, quindi è necessario modificare direttamente tali voci.

Se ne create una AMI da un'istanza dopo averne aggiornato le impostazioni, le nuove impostazioni vengono applicate a qualsiasi istanza lanciata dalla nuovaAMI. Per informazioni sulla creazione di un fileAMI, consultaCrea un account supportato EBS da Amazon AMI.