

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

# Buat versi baru dari resep gambar
<a name="create-image-recipes"></a>

Bagian ini menjelaskan cara membuat versi baru dari resep gambar.

**Topics**
+ [Buat versi resep gambar baru dari konsol](#create-image-recipe-version-console)
+ [Buat resep gambar dengan AWS CLI](#create-image-recipe-cli)
+ [Impor VM sebagai gambar dasar Anda di konsol](#import-vm-recipes)

## Buat versi resep gambar baru dari konsol
<a name="create-image-recipe-version-console"></a>

Saat Anda membuat versi resep baru, itu hampir sama dengan membuat resep baru. Perbedaannya adalah bahwa detail tertentu dipilih sebelumnya agar sesuai dengan resep dasar, dalam banyak kasus. Daftar berikut menjelaskan perbedaan antara membuat resep baru dan membuat versi baru dari resep yang sudah ada.

**Detail resep dasar dalam versi baru**
+ **Nama** - *Tidak dapat diedit*.
+ **Versi** - Diperlukan. Masukkan nomor versi yang ingin Anda buat dalam format *<major>. <minor>. *<patch>. Image Builder mendukung penambahan versi otomatis untuk resep, memungkinkan Anda menggunakan pola wildcard dalam versi resep Anda. Saat Anda membuat resep dengan versi wildcard seperti`1.0.x`, Image Builder secara otomatis menambah versi (misalnya,,`1.0.1`, `1.0.2``1.0.3`, dan seterusnya). Ini menghilangkan kebutuhan untuk melacak dan menambah versi resep secara manual. 
+ Opsi **Pilih gambar** - Dipilih sebelumnya, tetapi Anda dapat mengeditnya. Jika Anda mengubah pilihan Anda untuk sumber gambar dasar Anda, Anda mungkin kehilangan detail lain yang bergantung pada opsi asli yang Anda pilih.

  Untuk melihat detail yang terkait dengan pemilihan gambar dasar Anda, pilih tab yang cocok dengan pilihan Anda.

------
#### [ Managed image ]
  + **Sistem Operasi Gambar (OS)** - *Tidak dapat diedit*.
  + **Nama gambar** — Dipilih sebelumnya, berdasarkan kombinasi pilihan gambar dasar yang Anda buat untuk resep yang ada. Namun, jika Anda mengubah opsi **Pilih gambar**, Anda kehilangan **nama Gambar** yang telah dipilih sebelumnya.
  + **Opsi versi otomatis** — *Tidak* cocok dengan resep dasar Anda. Opsi gambar ini default ke opsi **Gunakan versi OS yang dipilih**.
**penting**  
Jika Anda menggunakan versi semantik untuk memulai build pipeline, pastikan Anda mengubah nilai ini menjadi **Gunakan** versi OS terbaru yang tersedia. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)

------
#### [ AWS Marketplace image ]
  + **Langganan** — Tab ini harus terbuka, dan gambar berlangganan dari AWS Marketplace harus dipilih sebelumnya agar sesuai dengan resep dasar Anda. Jika Anda mengubah gambar yang digunakan resep Anda sebagai gambar dasarnya, Anda mungkin kehilangan detail lain yang bergantung pada gambar asli yang Anda pilih.

  Untuk informasi selengkapnya tentang AWS Marketplace produk, lihat [Membeli produk](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-subscribing-to-products.html) di *Panduan AWS Marketplace Pembeli*.

------
#### [ Custom AMI ]

  **Sumber AMI** (Diperlukan) - Masukkan ID AMI atau parameter Penyimpanan Parameter AWS Systems Manager (SSM) yang berisi ID AMI untuk digunakan sebagai gambar dasar. Agen SSM harus sudah diinstal sebelumnya di AMI yang dipilih. 
  + **ID AMI** — Pengaturan ini tidak diisi sebelumnya dengan entri asli Anda. Masukkan ID AMI untuk gambar dasar Anda. Contoh:`ami-1234567890abcdef1`.
  + **Parameter SSM** — Masukkan nama atau ARN parameter SSM Parameter Store yang berisi ID AMI untuk gambar dasar Anda. Contoh: `/ib/test/param` atau `arn:aws:ssm:us-east-1:111122223333:parameter/ib/test/param`.

------
+ **Konfigurasi instans** - Pengaturan sudah dipilih sebelumnya, tetapi Anda dapat mengeditnya.
  + **Agen Systems Manager** - Anda dapat memilih atau mengosongkan kotak centang ini untuk mengontrol pemasangan agen Systems Manager pada gambar baru. Kotak centang dihapus secara default untuk menyertakan agen Systems Manager dalam gambar baru Anda. Untuk menghapus agen Systems Manager dari gambar akhir, pilih kotak centang agar agen tidak disertakan dalam AMI Anda.
  + **Data pengguna** — Anda dapat menggunakan area ini untuk menyediakan perintah, atau skrip perintah untuk dijalankan, saat meluncurkan instance build. Namun, nilai ini menggantikan perintah apa pun yang mungkin ditambahkan Image Builder untuk memastikan bahwa Systems Manager diinstal. Perintah ini termasuk skrip pembersihan yang biasanya dijalankan Image Builder untuk gambar Linux sebelum membuat gambar baru.

    Saat Image Builder meluncurkan instance, skrip data pengguna berjalan selama fase cloud-init, sebelum eksekusi komponen dimulai. Langkah ini dicatat ke file berikut pada contoh:`var/log/cloud-init.log`.
**catatan**  
Jika Anda memasukkan data pengguna, pastikan bahwa agen Systems Manager sudah diinstal sebelumnya pada image dasar Anda, atau bahwa Anda menyertakan instalasi dalam data pengguna Anda.
Untuk gambar Linux, pastikan bahwa langkah-langkah pembersihan dijalankan dengan menyertakan perintah untuk membuat file kosong bernama `perform_cleanup` dalam skrip data pengguna Anda. Image Builder mendeteksi file ini, dan menjalankan skrip pembersihan sebelum membuat gambar baru. Untuk informasi selengkapnya dan contoh skrip, lihat[Praktik keamanan terbaik untuk Image Builder](security-best-practices.md).
+ **Direktori kerja** - Dipilih sebelumnya, tetapi Anda dapat mengeditnya.
+ **Komponen** — Komponen yang sudah disertakan dalam resep ditampilkan di bagian **Komponen yang dipilih** di akhir setiap daftar komponen (build dan test). Anda dapat menghapus atau menyusun ulang komponen yang dipilih sesuai dengan kebutuhan Anda.

  Komponen pengerasan CIS tidak mengikuti aturan pemesanan komponen standar dalam resep Image Builder. Komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa tes benchmark berjalan terhadap gambar keluaran Anda.
**catatan**  
Daftar komponen build dan test menampilkan komponen yang tersedia berdasarkan tipe pemilik komponen. Untuk menambahkan komponen, pilih **Tambahkan komponen build**, dan pilih filter kepemilikan yang berlaku. Misalnya, untuk menambahkan komponen build yang terkait dengan AWS Marketplace produk, pilih`AWS Marketplace`. Ini membuka panel pilihan di sisi kanan antarmuka konsol yang mencantumkan AWS Marketplace komponen.  
Untuk komponen CIS, pilih`Third party managed`.

  Anda dapat mengonfigurasi pengaturan berikut untuk komponen yang Anda pilih:
  + **Opsi pembuatan versi** - Dipilih sebelumnya, tetapi Anda dapat mengubahnya. Kami menyarankan Anda memilih opsi **Gunakan versi komponen terbaru yang tersedia** untuk memastikan bahwa build gambar Anda selalu mengambil versi terbaru komponen. Jika Anda perlu menggunakan versi komponen tertentu dalam resep Anda, Anda dapat memilih **Tentukan versi komponen**, dan masukkan versi dalam kotak **Versi komponen** yang muncul.
  + **Parameter input** - Menampilkan parameter input yang diterima komponen. **Nilai** sudah diisi sebelumnya dengan nilai dari versi resep sebelumnya. Jika Anda menggunakan komponen ini untuk pertama kalinya dalam resep ini, dan nilai default ditentukan untuk parameter input, nilai default muncul di kotak **Nilai** dengan teks berwarna abu-abu. Jika tidak ada nilai lain yang dimasukkan, Image Builder menggunakan nilai default.

    Jika parameter input diperlukan, tetapi tidak memiliki nilai default yang ditentukan dalam komponen, Anda harus memberikan nilai. Image Builder tidak akan membuat versi resep jika ada parameter yang diperlukan yang hilang dan tidak memiliki nilai default yang ditentukan.
**penting**  
Parameter komponen adalah nilai teks biasa, dan masuk AWS CloudTrail. Kami menyarankan Anda menggunakan AWS Secrets Manager atau AWS Systems Manager Parameter Store untuk menyimpan rahasia Anda. Untuk informasi selengkapnya tentang Secrets Manager, lihat [Apa itu Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) dalam *AWS Secrets Manager User Guide*. Untuk informasi selengkapnya tentang AWS Systems Manager Parameter Store, lihat [AWS Systems Manager Parameter Menyimpan](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) di *Panduan AWS Systems Manager Pengguna*.

  Untuk memperluas pengaturan untuk **opsi Pembuatan versi** atau **Parameter input**, Anda dapat memilih panah di sebelah nama pengaturan. Untuk memperluas semua pengaturan untuk semua komponen yang dipilih, Anda dapat mengaktifkan tombol **Expand all** off and on.
+ **Penyimpanan (volume)** — sudah diisi sebelumnya. Volume root **Nama perangkat**, **Snapshot**, dan pilihan **IOPS**, tidak dapat diedit. Namun, Anda dapat mengubah semua pengaturan yang tersisa, seperti **Ukuran**. Anda juga dapat menambahkan volume baru, dan mengenkripsi volume baru atau yang sudah ada.

  Untuk mengenkripsi volume gambar yang dibuat Image Builder di bawah akun Anda di Wilayah sumber (tempat build berjalan), Anda harus menggunakan enkripsi volume penyimpanan dalam resep gambar. Enkripsi yang berjalan selama fase distribusi build hanya untuk gambar yang didistribusikan ke akun atau Wilayah lain.
**catatan**  
Jika Anda menggunakan enkripsi untuk volume Anda, Anda harus memilih kunci untuk setiap volume secara terpisah, bahkan jika kuncinya sama dengan yang digunakan untuk volume root.

**Untuk membuat versi resep gambar baru:**

1. Di bagian atas halaman detail resep, pilih **Buat versi baru**. Ini membawa Anda ke halaman **resep Buat gambar**.

1. Untuk membuat versi baru, buat perubahan, lalu pilih **Buat resep**.

   Gambar akhir Anda dapat berisi hingga empat kode produk dari produk dan komponen AWS Marketplace gambar. Jika gambar dasar dan komponen yang Anda pilih berisi lebih dari empat kode produk, Image Builder mengembalikan kesalahan saat Anda mencoba membuat resep.

Untuk informasi selengkapnya tentang cara membuat resep gambar saat Anda membuat pipeline gambar, lihat [Langkah 2: Pilih resep](start-build-image-pipeline.md#start-build-image-step2) di bagian **Memulai** panduan ini.

## Buat resep gambar dengan AWS CLI
<a name="create-image-recipe-cli"></a>

Untuk membuat resep gambar dengan `create-image-recipe` perintah Image Builder di AWS CLI, ikuti langkah-langkah berikut:

**Prasyarat**  
Sebelum Anda menjalankan perintah Image Builder di bagian ini untuk membuat resep gambar dari AWS CLI, Anda dapat secara opsional membuat komponen yang digunakan resep. Contoh resep gambar pada langkah berikut mengacu pada komponen contoh yang dibuat di [Buat komponen khusus dari AWS CLI](create-component.md#create-component-ib-cli) bagian panduan ini.

Jika Anda ingin memasukkan komponen dalam resep Anda, perhatikan ARNs yang ingin Anda sertakan. Anda juga dapat membuat resep tanpa komponen apa pun untuk menguji alur kerja yang ada AMIs atau hanya distribusi.

1. 

**Buat file JSON input CLI**

   Anda dapat memberikan semua input untuk **create-image-recipe** perintah dengan parameter perintah inline. Namun, perintah yang dihasilkan bisa sangat panjang. Untuk merampingkan perintah, Anda dapat menyediakan file JSON yang berisi semua pengaturan resep.
**catatan**  
Konvensi penamaan untuk nilai data dalam file JSON mengikuti pola yang ditentukan untuk parameter permintaan operasi Image Builder API. Untuk meninjau parameter permintaan operasi API, lihat [CreateImageRecipe](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_CreateImageRecipe.html)perintah di Referensi *API EC2 Image Builder*.  
Untuk memberikan nilai data sebagai parameter baris perintah, lihat nama parameter yang ditentukan dalam *Referensi AWS CLI Perintah*.

   Berikut adalah ringkasan parameter yang ditentukan oleh contoh-contoh ini:
   + **nama** (string, wajib) — Nama resep gambar.
   + **deskripsi** (string) — Deskripsi resep gambar.
   + **ParentImage** (string, required) - Gambar yang digunakan resep gambar sebagai dasar untuk gambar kustom Anda. Anda dapat menentukan gambar induk menggunakan salah satu opsi berikut:
     + ID AMI
     + Sumber daya gambar Image Builder ARN
     + AWS Systems Manager (SSM) Parameter Menyimpan parameter, diawali oleh`ssm:`, diikuti oleh nama parameter atau ARN.
     + AWS Marketplace ID produk
**catatan**  
Contoh Linux dan macOS menggunakan Image Builder AMI, dan contoh Windows menggunakan ARN.
   + **SemanticVersion** *<major>(string, required) - Masukkan nomor versi yang ingin Anda buat dalam format. <minor>. *<patch>. Image Builder mendukung penambahan versi otomatis untuk resep, memungkinkan Anda menggunakan pola wildcard dalam versi resep Anda. Saat Anda membuat resep dengan versi wildcard seperti`1.0.x`, Image Builder secara otomatis menambah versi (misalnya,,`1.0.1`, `1.0.2``1.0.3`, dan seterusnya). Ini menghilangkan kebutuhan untuk melacak dan menambah versi resep secara manual. Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)
   + **komponen** (array, opsional) - Berisi array `ComponentConfiguration` objek. Komponen bersifat opsional - Anda dapat membuat resep tanpa komponen apa pun untuk pengujian atau alur kerja distribusi:
**catatan**  
Image Builder menginstal komponen dalam urutan yang Anda tentukan dalam resep. Namun, komponen pengerasan CIS selalu berjalan terakhir untuk memastikan bahwa tes benchmark berjalan terhadap gambar keluaran Anda.
     + **ComponentARN** (string, diperlukan) — Komponen ARN.
**Tip**  
Untuk menggunakan salah satu contoh untuk membuat resep gambar Anda sendiri, Anda harus mengganti contoh ARNs dengan komponen yang Anda gunakan untuk resep Anda. ARNs 
     + **parameter** (array objek) — Berisi array `ComponentParameter` objek. Jika parameter input diperlukan, tetapi tidak memiliki nilai default yang ditentukan dalam komponen, Anda harus memberikan nilai. Image Builder tidak akan membuat versi resep jika ada parameter yang diperlukan yang hilang dan tidak memiliki nilai default yang ditentukan.
**penting**  
Parameter komponen adalah nilai teks biasa, dan masuk AWS CloudTrail. Kami menyarankan Anda menggunakan AWS Secrets Manager atau AWS Systems Manager Parameter Store untuk menyimpan rahasia Anda. Untuk informasi selengkapnya tentang Secrets Manager, lihat [Apa itu Secrets Manager?](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html) dalam *AWS Secrets Manager User Guide*. Untuk informasi selengkapnya tentang AWS Systems Manager Parameter Store, lihat [AWS Systems Manager Parameter Menyimpan](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) di *Panduan AWS Systems Manager Pengguna*.
       + **name** (string, required) — Nama parameter komponen yang akan ditetapkan.
       + **value** (array string, required) — Berisi array string untuk mengatur nilai untuk parameter komponen bernama. Jika ada nilai default yang ditentukan untuk komponen, dan tidak ada nilai lain yang disediakan, AWSTOE gunakan nilai default.
   + **additionalInstanceConfiguration**(object) — Tentukan setelan tambahan dan luncurkan skrip untuk instance build Anda.
     + **systemsManagerAgent**(object) — Berisi pengaturan untuk agen Systems Manager pada instance build Anda.
       + **uninstallAfterBuild**(Boolean) — Mengontrol apakah agen Systems Manager dihapus dari image build akhir Anda sebelum membuat AMI baru. Jika opsi ini diatur ke`true`, maka agen dihapus dari gambar akhir. Jika opsi diatur ke`false`, maka agen dibiarkan sehingga disertakan dalam AMI baru. Nilai default-nya adalah `false`.
**catatan**  
Jika `uninstallAfterBuild` atribut tidak disertakan dalam file JSON, dan kondisi berikut benar, maka Image Builder menghapus agen Systems Manager dari gambar akhir sehingga tidak tersedia di AMI:  
`userDataOverride`Kosong atau telah dihilangkan dari file JSON.
Image Builder secara otomatis menginstal agen Systems Manager pada instance build untuk sistem operasi yang tidak memiliki agen pra-instal pada image dasar.
     + **userDataOverride**(string) — Berikan perintah atau skrip perintah untuk dijalankan saat Anda meluncurkan instance build Anda.
**catatan**  
Data pengguna selalu dikodekan dengan basis 64. Misalnya, perintah berikut dikodekan sebagai: `IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==`  

       ```
       #!/bin/bash
       mkdir -p /var/bb/
       touch /var
       ```
Contoh Linux menggunakan nilai yang dikodekan ini.

------
#### [ Linux ]

   Gambar dasar (`parentImage`properti) dalam contoh berikut adalah AMI. Saat Anda menggunakan AMI, Anda harus memiliki akses ke AMI, dan AMI harus berada di Wilayah sumber (Wilayah yang sama tempat Image Builder menjalankan perintah). Simpan file sebagai`create-image-recipe.json`, dan gunakan dalam **create-image-recipe** perintah.

   ```
   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }
   ```

------
#### [ Windows ]

   Contoh berikut mengacu pada versi terbaru dari gambar Windows Server 2016 English Full Base. ARN dalam contoh ini mereferensikan gambar terbaru berdasarkan filter versi semantik yang telah Anda tentukan:. `arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x`

   ```
   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-imported-component/1.0.0/1"
   	}
   ]
   }
   ```

**catatan**  
Untuk mempelajari lebih lanjut tentang pembuatan versi semantik untuk sumber daya Image Builder, lihat. [Pembuatan versi semantik di Image Builder](ibhow-semantic-versioning.md)

------
#### [ macOS ]

   Gambar dasar (`parentImage`properti) dalam contoh berikut adalah AMI. Saat Anda menggunakan AMI, Anda harus memiliki akses ke AMI, dan AMI harus berada di Wilayah sumber (Wilayah yang sama tempat Image Builder menjalankan perintah). Simpan file sebagai`create-image-recipe.json`, dan gunakan dalam **create-image-recipe** perintah.

   ```
   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }
   ```

------

   **Contoh: Resep tanpa komponen**

   Anda dapat membuat resep tanpa komponen apa pun untuk menguji alur kerja yang ada AMIs atau hanya distribusi. Contoh berikut menunjukkan resep yang menggunakan AMI yang ada tanpa menerapkan komponen tambahan:

   ```
   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }
   ```

1. 

**Buat resepnya**

   Gunakan perintah berikut untuk membuat resep. Berikan nama file JSON yang Anda buat pada langkah sebelumnya dalam `--cli-input-json` parameter:

   ```
   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json
   ```
**catatan**  
Anda harus menyertakan notasi `file://` pada awal jalur file JSON.
Jalur untuk file JSON harus mengikuti konvensi yang sesuai untuk sistem operasi dasar tempat Anda menjalankan perintah. Misalnya, Windows menggunakan garis miring terbalik (\$1) untuk merujuk ke jalur direktori, sedangkan Linux dan macOS menggunakan garis miring maju (/).

   Gambar akhir Anda dapat berisi hingga empat kode produk dari produk dan komponen AWS Marketplace gambar. Jika gambar dasar dan komponen yang Anda pilih berisi lebih dari empat kode produk, Image Builder mengembalikan kesalahan saat menjalankan `create-image-recipe` perintah.

## Impor VM sebagai gambar dasar Anda di konsol
<a name="import-vm-recipes"></a>

Pada bagian ini, kami fokus pada cara mengimpor mesin virtual (VM) sebagai gambar dasar untuk resep gambar Anda. Kami tidak membahas langkah-langkah lain yang terlibat dengan membuat resep atau versi resep di sini. Untuk langkah-langkah tambahan untuk membuat resep gambar baru dengan wizard pembuatan pipeline di konsol Image Builder, lihat[Wisaya pipa: Buat AMI](start-build-image-pipeline.md). Untuk langkah-langkah tambahan untuk membuat resep gambar atau versi resep baru, lihat[Buat versi baru dari resep gambar](#create-image-recipes).

Untuk mengimpor VM sebagai gambar dasar untuk resep gambar Anda di konsol Image Builder, ikuti langkah-langkah berikut, bersama dengan langkah-langkah lain yang diperlukan, untuk membuat versi resep atau resep Anda.

1. Di bagian **Pilih gambar** untuk gambar dasar, pilih opsi **Impor gambar dasar**.

1. Pilih **Image Operating System (OS)** **dan versi OS** seperti biasanya.

### Konfigurasi impor VM
<a name="import-vm-recipe-console-config"></a>

Saat Anda mengekspor VM Anda dari lingkungan virtualisasi, proses itu membuat satu set file wadah disk atau lebih yang bertindak sebagai snapshot dari lingkungan, pengaturan, dan data VM Anda. Anda dapat menggunakan file-file ini untuk mengimpor VM Anda sebagai gambar dasar untuk resep gambar Anda. Untuk informasi selengkapnya tentang mengimpor VMs di Image Builder, lihat [Impor dan ekspor gambar VM](vm-import-export.md)

Untuk menentukan lokasi sumber impor Anda, ikuti langkah-langkah berikut:

**Impor sumber**  
Tentukan sumber untuk wadah disk gambar VM pertama atau snapshot yang akan diimpor di bagian **Disk container 1**.

1. **Sumber** — Ini bisa berupa bucket S3 atau snapshot EBS.

1. **Pilih lokasi disk S3** — Masukkan lokasi di Amazon S3 tempat gambar disk Anda disimpan. Untuk menelusuri lokasi, pilih **Browse S3**.

1. Untuk menambahkan wadah disk, pilih **Tambahkan wadah disk**.

**IAM Role**  
Untuk mengaitkan peran IAM dengan konfigurasi impor VM Anda, pilih peran dari daftar tarik-turun **peran IAM**, atau pilih **Buat peran baru untuk membuat peran baru**. Jika Anda membuat peran baru, halaman konsol Peran IAM akan terbuka di tab terpisah.

#### Pengaturan lanjutan - *opsional*
<a name="import-vm-recipe-console-opt"></a>

Pengaturan berikut bersifat opsional. Dengan pengaturan ini, Anda dapat mengonfigurasi enkripsi, lisensi, tag, dan lainnya untuk gambar dasar yang dibuat impor.

**Umum**

1. Tentukan **Nama** unik untuk gambar dasar. Jika Anda tidak memasukkan nilai, gambar dasar mewarisi nama resep.

1. Tentukan **Versi** untuk gambar dasar. Gunakan format berikut: `<major>.<minor>.<patch>`. Jika Anda tidak memasukkan nilai, gambar dasar mewarisi versi resep.

1. Anda juga dapat memasukkan **Deskripsi** untuk gambar dasar.

**Arsitektur gambar dasar**  
Untuk menentukan arsitektur sumber impor VM Anda, pilih nilai dari daftar **Arsitektur**.

**Enkripsi**  
Jika gambar disk VM Anda dienkripsi, Anda harus memberikan kunci untuk digunakan untuk proses impor. Untuk menentukan impor, pilih nilai dari daftar **Enkripsi (kunci KMS)**. AWS KMS key Daftar ini berisi kunci KMS yang dapat diakses akun Anda di Wilayah saat ini.

**Manajemen lisensi**  
Saat Anda mengimpor VM, proses impor secara otomatis mendeteksi OS VM dan menerapkan lisensi yang sesuai ke gambar dasar. Bergantung pada platform OS Anda, jenis lisensinya adalah sebagai berikut:
+ **Termasuk lisensi** - AWS Lisensi yang sesuai untuk platform Anda diterapkan pada gambar dasar Anda.
+ **Bawa lisensi Anda sendiri (BYOL)** - Mempertahankan lisensi dari VM Anda, jika berlaku.

Untuk melampirkan konfigurasi lisensi yang dibuat AWS License Manager dengan gambar dasar Anda, pilih dari daftar **nama konfigurasi Lisensi**. Untuk informasi selengkapnya tentang License Manager, lihat [Bekerja dengan AWS License Manager]()

**catatan**  
Konfigurasi lisensi berisi aturan lisensi berdasarkan ketentuan perjanjian perusahaan Anda.
Linux hanya mendukung lisensi BYOL.

**Tag (gambar dasar)**  
Tag menggunakan pasangan nilai kunci untuk menetapkan teks yang dapat dicari ke sumber daya Image Builder Anda. Untuk menentukan tag untuk gambar dasar yang diimpor, masukkan pasangan kunci-nilai dengan kotak **Kunci** dan **Nilai**.

Untuk menambahkan tanda, pilih **Tambahkan tanda**. Untuk menghapus sebuah tag, pilih **Hapus tag**.