Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Konfigurasikan pengaturan EC2Launch v2 untuk instance Windows

Bagian ini berisi informasi tentang cara mengonfigurasi pengaturan EC2Launch untukv2.

Ubah pengaturan EC2Launch menggunakanv2 kotak dialog pengaturan

Berikut ini adalah contoh YAML file konfigurasi yang dibuat dari pengaturan yang dimasukkan dalam EC2Launch dialog.

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

Konfigurasikan EC2Launch v2 menggunakan CLI

Anda dapat menggunakan Command Line Interface (CLI) untuk mengonfigurasi EC2Launch pengaturan dan mengelola layanan. Bagian berikut ini berisi deskripsi dan informasi penggunaan untuk CLI perintah yang dapat Anda gunakan untuk EC2Launch mengelolav2.

collect-logs

Mengumpulkan file log untukEC2Launch, zip file, dan tempatkan di direktori yang ditentukan.

Contoh

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

Penggunaan

ec2launch collect-logs [flags]

Bendera

-h, --help

bantuan untuk collect-logs

-o, --output string

jalur ke file log output zip

get-agent-config

Mencetak agent-config.yml dalam format yang ditentukan (JSONatauYAML). Jika tidak ada format yang ditentukan, agent-config.yml dicetak dalam format yang ditentukan sebelumnya.

Contoh

ec2launch get-agent-config -f json

Contoh 2

PowerShell Perintah berikut menunjukkan cara mengedit dan menyimpan agent-config file dalam JSON format.

$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

Penggunaan

ec2launch get-agent-config [flags]

Bendera

-h, --help

bantuan untuk get-agent-config

-f, --format string

format output file agent-config: json, yaml

list-volumes

Daftar semua volume penyimpanan yang dilampirkan ke instance, termasuk fana dan EBS volume.

Contoh

ec2launch list-volumes

Penggunaan

ec2launch list-volumes

Bendera

-h, --help

bantuan untuk list-volumes

atur ulang

Tujuan utama dari tugas ini adalah untuk mengatur ulang agen untuk waktu berikutnya yang dijalankan. Untuk melakukan itu, reset perintah menghapus semua data status agen untuk EC2Launch v2 dari EC2Launch direktori lokal (lihatEC2Launchv2 struktur direktori). Reset opsional menghapus layanan dan log Sysprep.

Perilaku skrip tergantung pada mode apa agen menjalankan skrip — inline, atau terpisah.

Contoh

ec2launch reset -c

Penggunaan

ec2launch reset [flags]

Bendera

-c, --clean

membersihkan log instans sebelum reset

-h, --help

bantuan untuk reset

run

LariEC2Launch v2.

Contoh

ec2launch run

Penggunaan

ec2launch run [flags]

Bendera

-h, --help

bantuan untuk run

status

Mendapat status agen EC2Launch v2. Memblokir proses secara opsional sampai agen selesai. Kode keluar proses menentukan status agen:

Contoh:

ec2launch status -b

Penggunaan

ec2launch status [flags]

Bendera

-b,--block

memblokir proses sampai agen selesai berjalan

-h,--help

bantuan untuk status

sysprep

Tujuan utama dari tugas ini adalah untuk mengatur ulang agen untuk waktu berikutnya yang dijalankan. Untuk melakukan itu, sysprep perintah me-reset status agen, memperbarui unattend.xml file, menonaktifkanRDP, dan menjalankan Sysprep.

Perilaku skrip tergantung pada mode apa agen menjalankan skrip — inline, atau terpisah.

Contoh:

ec2launch sysprep

Penggunaan

ec2launch sysprep [flags]

Bendera

-c,--clean

membersihkan log instans sebelum sysprep

-h,--help

bantuan untuk Sysprep

-s,--shutdown

mematikan instans setelah sysprep

validasi

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

Contoh

ec2launch validate

Penggunaan

ec2launch validate [flags]

Bendera

-h , --help

bantuan untuk validate

versi

Mendapatkan versi yang dapat dieksekusi.

Contoh

ec2launch version

Penggunaan

ec2launch version [flags]

Bendera

-h, --help

bantuan untuk version

wallpaper

Menyetel wallpaper baru ke jalur wallpaper yang disediakan (file.jpg), dan menampilkan detail instans yang dipilih.

Sintaksis

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

Masukan

EC2Launchkonfigurasi tugas v2

Bagian ini mencakup skema, tugas, detail, dan contoh konfigurasi untuk agent-config.yml dan data pengguna.

Skema: agent-config.yml

Struktur agent-config.yml file ditunjukkan di bawah ini. Perhatikan bahwa tugas tidak dapat diulang dalam tahap yang sama. Untuk properti tugas, lihat deskripsi tugas yang mengikuti.

Struktur dokumen: 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:
	  ...
  ...
...

Contoh: agent-config.yml

Contoh berikut menunjukkan pengaturan untuk file konfigurasi 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

Konfigurasikan skrip data pengguna EC2Launch v2 yang berjalan selama peluncuran atau reboot

Berikut JSON dan YAML contoh menunjukkan struktur dokumen untuk data pengguna. Amazon EC2 mem-parsing setiap tugas bernama dalam tasks array yang Anda tentukan dalam dokumen. Setiap tugas memiliki set properti dan persyaratan sendiri. Untuk detailnya, lihat Definisi tugas untuk tugas startup EC2Launch v2.

Struktur dokumen: data pengguna

JSON

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

YAML

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

Contoh: data pengguna

Untuk informasi selengkapnya tentang data pengguna, lihat Bagaimana Amazon EC2 menangani data pengguna untuk instans Windows.

Contoh YAML dokumen berikut menunjukkan PowerShell skrip yang EC2Launch v2 berjalan sebagai data pengguna untuk membuat file.

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

Anda dapat menggunakan XML format untuk data pengguna yang kompatibel dengan versi agen peluncuran sebelumnya. EC2Launchv2 menjalankan skrip sebagai executeScript tugas di UserData panggung. Agar sesuai dengan EC2Launch v1 dan EC2Config perilaku, skrip data pengguna berjalan sebagai proses terlampir/sebaris secara default.

Anda dapat menambahkan tanda opsional untuk menyesuaikan cara skrip Anda berjalan. Misalnya, untuk menjalankan skrip data pengguna saat instans di-boot ulang selain satu kali saat instans diluncurkan, Anda dapat menggunakan tanda berikut:

<persist>true</persist>

Contoh:

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

Anda dapat menentukan satu atau lebih PowerShell argumen dengan <powershellArguments> tag. Jika tidak ada argumen yang diteruskan, EC2Launch v2 menambahkan argumen berikut secara default:-ExecutionPolicy Unrestricted.

Contoh:

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

Untuk menjalankan skrip data XML pengguna sebagai proses terpisah, tambahkan tag berikut ke data pengguna Anda.

<detach>true</detach>

Contoh:

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

Log perubahan: data pengguna

Tabel berikut mencantumkan perubahan untuk data pengguna, dan referensi silang ke versi agen EC2Launch v2 yang berlaku.

* Bila digunakan dengan file agent-config.yml default.

EC2LaunchKode keluar v2 dan reboot

Anda dapat menggunakan EC2Launch v2 untuk menentukan bagaimana kode keluar ditangani oleh skrip Anda. Secara default, kode keluar dari perintah terakhir yang dijalankan dalam skrip dilaporkan sebagai kode keluar untuk seluruh skrip. Sebagai contoh, jika skrip mencakup tiga perintah dan perintah pertama gagal tetapi perintah yang berikutnya berhasil, maka status berjalan dilaporkan sebagai success karena perintah akhir berhasil.

Jika Anda ingin skrip me-reboot instans, maka Anda harus menentukan exit 3010 dalam skrip Anda, bahkan ketika reboot adalah langkah terakhir dalam skrip Anda. exit 3010menginstruksikan EC2Launch v2 untuk me-reboot instance dan memanggil skrip lagi sampai mengembalikan kode keluar yang tidak3010, atau sampai jumlah reboot maksimum tercapai. EC2Launchv2 memungkinkan maksimal 5 reboot per tugas. Jika Anda mencoba untuk me-reboot instans dari skrip dengan menggunakan mekanisme yang berbeda, seperti, Restart-Computermaka status berjalan skrip akan menjadi tidak konsisten. Sebagai contoh, skrip mungkin terjebak dalam loop mulai ulang atau tidak melakukan restart.

Jika Anda menggunakan format data XML pengguna yang kompatibel dengan agen yang lebih lama, maka data pengguna dapat berjalan lebih banyak daripada yang Anda inginkan. Untuk informasi selengkapnya, lihat Layanan menjalankan data pengguna lebih dari satu kali di bagian Pemecahan Masalah.

EC2Launchv2 dan Sysprep

EC2LaunchItuv2 layanan menjalankan Sysprep, alat Microsoft yang memungkinkan Anda untuk membuat Windows AMI yang dapat digunakan kembali. Saat EC2Launch v2 memanggil Sysprep, ia menggunakan file %ProgramData%\Amazon\EC2Launch untuk menentukan operasi mana yang akan dilakukan. Anda dapat mengedit file ini secara tidak langsung menggunakan kotak dialog EC2Launchpengaturan, atau langsung menggunakan YAML editor atau editor teks. Namun, ada beberapa pengaturan lanjutan yang tidak tersedia di kotak dialog EC2Launchpengaturan, jadi Anda harus mengedit entri tersebut secara langsung.

Jika Anda membuat sebuah AMI instans setelah memperbarui pengaturannya, pengaturan baru tersebut diterapkan ke setiap instans yang diluncurkan dari yang baruAMI. Untuk informasi tentang membuatAMI, lihatBuat Amazon yang EBS didukung AMI.