本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定視窗執行個體的 EC2Launch V2 設定

本節包含如何設定 EC2Launch v2 設定的相關資訊。

使用 EC2Launch v2 設定對話方塊變更設定

以下是從EC2Launch對話方塊中輸入的設定建立的範例規劃YAML檔案。

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

EC2Launch使用 CLI

您可以使用指令行介面 (CLI) 來規劃您的EC2Launch設定和管理服務。下一節包含您可用來管理 EC2Launch v2 之CLI命令的說明和使用資訊。

collect-logs

收集的記錄檔EC2Launch、壓縮檔案，並將其放置在指定的目錄中。

範例

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

用途

ec2launch collect-logs [flags]

Flags

-h, --help

collect-logs 的說明

-o, --output string

壓縮輸出日誌的路徑

get-agent-config

以指定agent-config.yml的格式 (JSON或YAML) 列印。如果未指定任何格式，則會以先前指定的格式列印 agent-config.yml。

範例

ec2launch get-agent-config -f json

範例 2

下面的 PowerShell 命令顯示如何編輯和保存JSON格式的agent-config文件。

$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

用途

ec2launch get-agent-config [flags]

Flags

-h, --help

get-agent-config 的說明

-f, --format string

agent-config 檔案的輸出格式：json、yaml

list-volumes

列出連接至執行個體的所有儲存磁碟區，包括暫時磁碟區和磁碟區。EBS

範例

ec2launch list-volumes

用途

ec2launch list-volumes

Flags

-h, --help

list-volumes 的說明

重設

此任務的主要目標是在下次代理程式執行時重設該代理程式。若要這麼做，命reset令會從本機EC2Launch目錄刪除 EC2Launch v2 的所有代理程式狀態資料 (請參閱EC2Launchv2 目錄結構)。選擇性重設會刪除服務和 Sysprep 日誌。

指令碼行為取決於代理程式執行指令碼的模式 (內嵌或分離)。

範例

ec2launch reset -c

用途

ec2launch reset [flags]

Flags

-c, --clean

在 reset 前清除執行個體日誌

-h, --help

reset 的說明

run

運行 EC2Launch V2。

範例

ec2launch run

用途

ec2launch run [flags]

Flags

-h, --help

run 的說明

status

取得 EC2Launch v2 代理程式的狀態。選擇性地封鎖處理程序，直到代理程式完成為止。處理程序結束程式碼會決定代理程式狀態：

範例：

ec2launch status -b

用途

ec2launch status [flags]

Flags

-b,--block

封鎖處理程序，直到代理程式完成執行

-h,--help

status 的說明

sysprep

此任務的主要目標是在下次代理程式執行時重設該代理程式。為此，sysprep命令會重設代理程式狀態、更新unattend.xml檔案RDP、停用並執行 Sysprep。

指令碼行為取決於代理程式執行指令碼的模式 (內嵌或分離)。

範例：

ec2launch sysprep

用途

ec2launch sysprep [flags]

Flags

-c,--clean

在 sysprep 前清除執行個體日誌

-h,--help

Sysprep 說明

-s,--shutdown

在 sysprep 後關閉執行個體

validate

驗證 agent-config 檔案 C:\ProgramData\Amazon\EC2Launch\config\agent-config.yml。

範例

ec2launch validate

用途

ec2launch validate [flags]

Flags

-h , --help

validate 的說明

version

取得可執行版本。

範例

ec2launch version

用途

ec2launch version [flags]

Flags

-h, --help

version 的說明

桌布

將新桌布設定為提供的桌布路徑 (.jpg 檔案)，並顯示選取的執行個體詳細資料。

語法

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

輸入

EC2Launchv2 任務配置

本節包含 agent-config.yml 和使用者資料的組態結構描述任務、詳細資訊及範例。

結構描述︰agent-config.yml

agent-config.yml 檔案的結構如下所示。請注意，不能在同一階段重複任務。有關任務屬性，請參閱後面的任務說明。

文件結構：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:
	  ...
  ...
...

範例：agent-config.yml

下列範例顯示 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

設定啟動或重新開機期間執行的 EC2Launch v2 使用者資料指令碼

下列YAML範例JSON和範例顯示使用者資料的文件結構。Amazon 會EC2剖析您在文件中指定的tasks陣列中指定的每個任務。每個任務都有自己的屬性集和要求集。如需詳細資訊，請參閱 EC2Launchv2 啟動工作的工作定義。

文件結構：使用者資料

JSON

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

YAML

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

範例：使用者資料

如需使用者資料的詳細資訊，請參閱 Amazon 如何EC2處理 Windows 實例的用戶數據。

下列YAML文件範例顯示 EC2Launch v2 以使用者資料的身分執行以建立檔案的 PowerShell 指令碼。

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

您可以使用與舊版啟動代理程XML式相容的使用者資料格式。EC2Launchv2 將腳本作為UserData階段中的executeScript任務運行。為了符合 EC2Launch v1 和EC2Config行為，使用者資料指令碼依預設會以附加/內嵌程序的方式執行。

您可以新增選用標籤來自訂指令碼的執行方式。例如，除了在執行個體啟動時執行一次使用者資料指令碼之外，若還想在執行個體重新啟動時執行，您可以使用下列標記：

<persist>true</persist>

範例：

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

您可以使用<powershellArguments>標籤指定一個或多個 PowerShell 引數。如果沒有傳遞任何引數，EC2Launchv2 預設會新增下列引數：-ExecutionPolicy Unrestricted

範例：

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

若要將XML使用者資料指令碼做為分離處理程序執行，請將下列標記新增至您的使用者資料。

<detach>true</detach>

範例：

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

變更日誌：使用者資料

下表列出使用者資料的變更，並將其交叉參照至適用的 EC2Launch v2 代理程式版本。

* 與預設 agent-config.yml 檔案搭配使用時。

EC2Launchv2 退出代碼並重新啟動

您可以使用 EC2Launch v2 來定義腳本如何處理退出代碼。根據預設，在指令碼中執行的最後一個命令的結束程式碼會報告為整個指令碼的結束程式碼。例如，如果指令碼包含三個命令，而第一個命令失敗，但後續命令成功，則會因最終命令成功而將執行狀態報告為 success。

如果您希望指令碼重新啟動執行個體，則必須exit 3010在指令碼中指定，即使重新啟動是指令碼中的最後一個步驟也是如此。 exit 3010指示 EC2Launch v2 重新啟動執行個體並再次呼叫指令碼，直到傳回不是的結束代碼3010，或是達到最大重新啟動計數為止。EC2Launchv2 允許每個任務最多 5 次重新啟動。如果您嘗試使用不同的機制 (例如 Restart-Computer) 從指令碼重新啟動執行個體，則指令碼執行狀態將不一致。例如，狀態可能會卡在重新啟動迴圈或不執行重新啟動。

如果您使用的是與舊版代理程式相容的使用XML者資料格式，則使用者資料的執行次數可能會比您預期的要多。如需詳細資訊，請參閱故障診斷一節中的 服務會多次執行使用者資料。

EC2LaunchV2 和系統

EC2Launchv2 服務會執行 Sysprep，這是一個 Microsoft 工具，可讓您建立可重複使用AMI的自訂視窗。當 EC2Launch v2 呼叫 Sysprep 時，它會使用中的檔案%ProgramData%\Amazon\EC2Launch來決定要執行哪些作業。您可以使用EC2Launch設定對話方塊或直接使用編輯YAML器或文字編輯器來間接編輯這些檔案。但是，設定對話方塊中有些進階EC2Launch設定無法使用，因此您必須直接編輯這些項目。

如果您在更新執行個體設定後AMI從執行個體建立，則新設定會套用至從新執行個體啟動的任何執行個體AMI。若要取得有關建立的資訊AMI，請參閱創建一個 Amazon 支EBS持 AMI。