ec2- ami-tools-version ec2-bundle-image ec2-bundle-vol ec2-delete-bundle ec2-download-bundle ec2-migrate-manifest ec2-unbundle ec2-upload-bundle Opsi umum

Referensi alat Amazon EC2 AMI

Anda dapat menggunakan perintah AMI tools untuk membuat dan mengelola Linux yang didukung toko instance. AMIs Untuk menyiapkan alat, lihat Siapkan alat Amazon EC2 AMI.

Untuk informasi tentang kunci akses Anda, lihat Mengelola kunci akses untuk pengguna IAM di Panduan Pengguna IAM.

ec2- ami-tools-version

Deskripsi

Menjelaskan versi alat AMI.

Sintaksis

ec2-ami-tools-version

Output

Informasi versi.

Contoh

Perintah contoh ini menampilkan informasi versi untuk alat AMI yang Anda gunakan.


[ec2-user ~]$ ec2-ami-tools-version
1.5.2 20071010

ec2-bundle-image

Deskripsi

Membuat AMI Linux yang didukung penyimpanan instans dari gambar sistem operasi yang dibuat dalam file loopback.

Sintaksis

ec2-bundle-image -c path -k path -u account -i path [-d path] [--ec2cert path] [-r architecture] [--productcodes code1,code2,...] [-B mapping] [-p prefix]

Opsi

jalur -c, --cert

File sertifikat kunci publik RSA yang dienkode PEM.

Wajib: Ya

jalur -k, --privatekey

Jalur menuju file kunci RSA yang dienkode PEM. Anda akan perlu menentukan kunci ini untuk membuka paketan ini, jadi simpanlah di tempat yang aman. Perhatikan bahwa kunci tidak harus didaftarkan ke AWS akun Anda.

Wajib: Ya

akun -u, --user

ID AWS akun pengguna, tanpa tanda hubung.

Wajib: Ya

jalur -i, --image

Jalur ke gambar yang akan dipaketkan.

Wajib: Ya

jalur -d, --destination

Direktori untuk membuat paketan.

Default: /tmp

Wajib: Tidak

jalur --ec2cert

Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.

Wilayah us-gov-west-1 dan cn-north-1 menggunakan sertifikat kunci publik non-default dan jalur ke sertifikat tersebut harus ditetapkan dengan opsi ini. Jalur ke sertifikat berbeda-beda tergantung metode instalasi alat AMI. Untuk Amazon Linux, sertifikat terletak di /opt/aws/amitools/ec2/etc/ec2/amitools/. Jika Anda menginstal alat AMI dari file RPM atau ZIP di Siapkan alat Amazon EC2 AMI, sertifikat berada di $EC2_AMITOOL_HOME/etc/ec2/amitools/.

Wajib: Hanya untuk Wilayah us-gov-west-1 dan cn-north-1.

arsitektur -r, --arch

Arsitektur gambar. Jika Anda tidak memberikan arsitektur pada baris perintah, Anda akan diminta memberikannya saat pembuatan paketan dimulai.

Nilai yang valid: i386 | x86_64

Wajib: Tidak

kode1,kode2,... --productcodes

Kode produk yang dilampirkan ke gambar pada waktu pendaftaran, dipisahkan dengan koma.

Wajib: Tidak

pemetaan -B, --block-device-mapping

Menentukan bagaimana perangkat blok terpapar ke instans AMI ini jika tipe instans mendukung perangkat yang ditentukan.

Tentukan daftar pasangan kunci-nilai yang dipisahkan koma, di mana setiap kunci adalah nama virtual dan setiap nilai adalah nama perangkat yang terkait. Nama virtual mencakup hal berikut:

ami—Perangkat sistem file root, seperti yang terlihat oleh instans
root—Perangkat sistem file root, seperti yang terlihat oleh kernel
swap—Perangkat pertukaran, seperti yang terlihat oleh instans
ephemeralN—Volume penyimpanan instans ke-N

Wajib: Tidak

awalan -p, --prefix

Awalan nama file untuk file AMI yang dipaketkan.

Default: Nama file gambar. Misalnya, jika jalur gambar adalah /var/spool/my-image/version-2/debian.img, awalan default-nya adalah debian.img.

Wajib: Tidak

kernel_id --kernel

Tidak lagi digunakan. Gunakan register-image untuk mengatur kernel.

Wajib: Tidak

ramdisk_id --ramdisk

Tidak lagi digunakan. Gunakan register-image untuk mengatur disk RAM jika diperlukan.

Wajib: Tidak

Output

Pesan status yang menjelaskan tahap dan status proses pembuatan paketan.

Contoh

Contoh ini membuat paketan AMI dari gambar sistem operasi yang dibuat dalam file loopback.


[ec2-user ~]$ ec2-bundle-image -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -u 111122223333 -i image.img -d bundled/ -r x86_64
Please specify a value for arch [i386]: 
Bundling image file...
Splitting bundled/image.gz.crypt...
Created image.part.00
Created image.part.01
Created image.part.02
Created image.part.03
Created image.part.04
Created image.part.05
Created image.part.06
Created image.part.07
Created image.part.08
Created image.part.09
Created image.part.10
Created image.part.11
Created image.part.12
Created image.part.13
Created image.part.14
Generating digests for each part...
Digests generated.
Creating bundle manifest...
ec2-bundle-image complete.

ec2-bundle-vol

Deskripsi

Membuat AMI Linux yang didukung oleh penyimpanan instans dengan mengompresi, mengenkripsi, dan menandatangani salinan volume perangkat root untuk instans tersebut.

Amazon EC2 mencoba mewarisi kode produk, pengaturan kernel, pengaturan disk RAM, dan memblokir pemetaan perangkat dari instance.

Secara default, proses paketan mengecualikan file yang mungkin berisi informasi sensitif. File ini termasuk *.sw, *.swo, *.swp, *.pem, *.priv, *id_rsa*, *id_dsa* *.gpg, *.jks, */.ssh/authorized_keys, dan */.bash_history. Untuk menyertakan semua file ini, gunakan opsi --no-filter. Untuk menyertakan beberapa file ini, gunakan opsi --include.

Untuk informasi selengkapnya, lihat Buat instance store-backed AMI.

Sintaksis

ec2-bundle-vol -c path -k path -u account [-d path] [--ec2cert path] [-r architecture] [--productcodes code1,code2,...] [-B mapping] [--all] [-e directory1,directory2,...] [-i file1,file2,...] [--no-filter] [-p prefix] [-s size] [--[no-]inherit] [-v volume] [-P type] [-S script] [--fstab path] [--generate-fstab] [--grub-config path]

Opsi

jalur -c, --cert

File sertifikat kunci publik RSA yang dienkode PEM.

Wajib: Ya

jalur -k, --privatekey

Jalur menuju file kunci RSA yang dienkode PEM milik pengguna.

Wajib: Ya

akun -u, --user

ID AWS akun pengguna, tanpa tanda hubung.

Wajib: Ya

tujuan -d, --destination

Direktori untuk membuat paketan.

Default: /tmp

Wajib: Tidak

jalur --ec2cert

Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.

Wajib: Hanya untuk Wilayah us-gov-west-1 dan cn-north-1.

arsitektur -r, --arch

Arsitektur gambar. Jika Anda tidak memberikannya pada baris perintah, Anda akan diminta untuk memberikannya saat pembuatan paketan dimulai.

Nilai yang valid: i386 | x86_64

Wajib: Tidak

kode1,kode2,... --productcodes

Kode produk yang dilampirkan ke gambar pada waktu pendaftaran, dipisahkan dengan koma.

Wajib: Tidak

pemetaan -B, --block-device-mapping

Menentukan bagaimana perangkat blok terpapar ke instans AMI ini jika tipe instans mendukung perangkat yang ditentukan.

Tentukan daftar pasangan kunci-nilai yang dipisahkan koma, di mana setiap kunci adalah nama virtual dan setiap nilai adalah nama perangkat yang terkait. Nama virtual mencakup hal berikut:

ami—Perangkat sistem file root, seperti yang terlihat oleh instans
root—Perangkat sistem file root, seperti yang terlihat oleh kernel
swap—Perangkat pertukaran, seperti yang terlihat oleh instans
ephemeralN—Volume penyimpanan instans ke-N

Wajib: Tidak

-a, --all

Membuat paketan semua direktori, termasuk yang ada di sistem file yang dipasang dari jauh.

Wajib: Tidak

direktori1,direktori2,... -e, --exclude

Daftar jalur dan file direktori mutlak yang akan dikecualikan dari operasi paketan. Parameter ini menimpa opsi --all. Jika ada pengecualian, direktori dan subdirektori yang tercantum dengan parameter tidak akan dipaketkan dengan volume.

Wajib: Tidak

file1,file2,... -i, --include

Daftar file yang akan disertakan dalam operasi paketan. File yang ditentukan akan dikecualikan dari AMI karena mungkin mengandung informasi sensitif.

Wajib: Tidak

--no-filter

Jika ditentukan, kami tidak akan mengecualikan file dari AMI karena file tersebut mungkin berisi informasi sensitif.

Wajib: Tidak

awalan -p, --prefix

Awalan nama file untuk file AMI yang dipaketkan.

Default: image

Wajib: Tidak

ukuran -s, --size

Ukuran, dalam MB (1024 * 1024 byte), dari file gambar yang akan dibuat. Ukuran maksimalnya adalah 10240 MB.

Default: 10240

Wajib: Tidak

--[no-]inherit

Mengindikasikan apakah gambar harus mewarisi metadata instans (default-nya adalah mewarisi). Pembuatan paketan gagal jika Anda mengaktifkan --inherit, tetapi metadata instans tidak dapat diakses.

Wajib: Tidak

volume -v, --volume

Jalur mutlak ke volume yang dipasang dari tempat untuk membuat paketan.

Default: Direktori root (/)

Wajib: Tidak

tipe -P, --partition

Menunjukkan apakah gambar disk harus menggunakan tabel partisi. Jika Anda tidak menentukan tipe tabel partisi, default-nya adalah tipe yang digunakan pada perangkat blok induk volume, jika berlaku. Jika tidak, default-nya adalah gpt.

Nilai yang valid: mbr | gpt | none

Wajib: Tidak

skrip -S, --script

Skrip kustomisasi akan dijalankan tepat sebelum pembuatan paketan. Skrip harus menantikan satu argumen, titik pemasangan volume.

Wajib: Tidak

jalur --fstab

Jalur ke fstab yang akan dipaketkan ke dalam gambar. Jika ini tidak ditentukan, Amazon EC2 bundles /etc/fstab.

Wajib: Tidak

--generate-fstab

Bundel volume menggunakan fstab EC2 yang disediakan Amazon.

Wajib: Tidak

--grub-config

Jalur menuju file konfigurasi grub alternatif untuk dipaketkan ke dalam gambar. Secara default, ec2-bundle-vol menunggu /boot/grub/menu.lst atau /boot/grub/grub.conf ada pada gambar hasil klona. Opsi ini memungkinkan Anda menentukan jalur ke file konfigurasi grub alternatif, yang kemudian akan disalin menggantikan default (jika ada).

Wajib: Tidak

kernel_id --kernel

Tidak lagi digunakan. Gunakan register-image untuk mengatur kernel.

Wajib: Tidak

ramdisk_id--ramdisk

Tidak lagi digunakan. Gunakan register-image untuk mengatur disk RAM jika diperlukan.

Wajib: Tidak

Output

Pesan status yang menjelaskan tahap dan status proses pemaketan.

Contoh

Contoh ini membuat AMI paketan dengan mengompresi, mengenkripsi, dan menandatangani snapshot sistem file root mesin lokal.


[ec2-user ~]$ ec2-bundle-vol -d /mnt -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -c cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -u 111122223333 -r x86_64
  Copying / into the image file /mnt/image...
  Excluding:
       sys
       dev/shm
       proc
       dev/pts
       proc/sys/fs/binfmt_misc
       dev
       media
       mnt
       proc
       sys
       tmp/image
       mnt/img-mnt
  1+0 records in
  1+0 records out
  mke2fs 1.38 (30-Jun-2005)
  warning: 256 blocks unused.

  Splitting /mnt/image.gz.crypt...
  Created image.part.00
  Created image.part.01
  Created image.part.02
  Created image.part.03
  ...
  Created image.part.22
  Created image.part.23
  Generating digests for each part...
  Digests generated.
  Creating bundle manifest...
  Bundle Volume complete.

ec2-delete-bundle

Deskripsi

Menghapus paketan tertentu dari penyimpanan Amazon S3. Setelah menghapus paketan, Anda tidak dapat meluncurkan instans dari AMI terkait.

Sintaksis

ec2-delete-bundle -b bucket -a access_key_id -s secret_access_key [-t token] [--url url] [--region region] [--sigv version] [-m path] [-p prefix] [--clear] [--retry] [-y]

Opsi

bucket -b, --bucket

Nama bucket Amazon S3 yang berisi paketan AMI, diikuti dengan awalan jalur opsional yang dibatasi ‘/’

Wajib: Ya

access_key_id -a, --access-key

ID kunci AWS akses.

Wajib: Ya

secret_access_key -s, --secret-key

Kunci akses AWS rahasia.

Wajib: Ya

token -t, --delegation-token

Token delegasi untuk diteruskan ke AWS permintaan. Untuk informasi selengkapnya, lihat Kredensyal keamanan sementara di Panduan Pengguna IAM.

Wajib: Hanya saat Anda menggunakan kredensial keamanan sementara.

Default: Nilai dari variabel lingkungan AWS_DELEGATION_TOKEN (jika diatur).

wilayah--region

Wilayah yang akan digunakan dalam tanda tangan permintaan.

Default: us-east-1

Wajib: Wajib jika menggunakan tanda tangan versi 4

version --sigv

Versi tanda tangan yang digunakan ketika menandatangani permintaan.

Nilai yang valid: 2 | 4

Default: 4

Wajib: Tidak

path-m, --manifest

Jalur ke file manifes.

Wajib: Anda harus menentukan --prefix atau --manifest.

awalan -p, --prefix

Awalan nama file AMI yang dipaketkan. Berikan seluruh awalan. Misalnya, jika awalannya adalah image.img, gunakan -p image.img dan bukan -p image.

Wajib: Anda harus menentukan --prefix atau --manifest.

--clear

Menghapus bucket Amazon S3 jika kosong setelah menghapus paketan tertentu.

Wajib: Tidak

--retry

Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.

Wajib: Tidak

-y, --yes

Secara otomatis mengasumsikan jawaban semua permintaan adalah ya.

Wajib: Tidak

Output

Amazon EC2 menampilkan pesan status yang menunjukkan tahapan dan status proses penghapusan.

Contoh

Contoh ini menghapus paketan dari Amazon S3.


[ec2-user ~]$ ec2-delete-bundle -b amzn-s3-demo-bucket -a your_access_key_id -s your_secret_access_key
Deleting files:
amzn-s3-demo-bucket/image.manifest.xml
amzn-s3-demo-bucket/image.part.00
amzn-s3-demo-bucket/image.part.01
amzn-s3-demo-bucket/image.part.02
amzn-s3-demo-bucket/image.part.03
amzn-s3-demo-bucket/image.part.04
amzn-s3-demo-bucket/image.part.05
amzn-s3-demo-bucket/image.part.06
Continue? [y/n]
y
Deleted amzn-s3-demo-bucket/image.manifest.xml
Deleted amzn-s3-demo-bucket/image.part.00
Deleted amzn-s3-demo-bucket/image.part.01
Deleted amzn-s3-demo-bucket/image.part.02
Deleted amzn-s3-demo-bucket/image.part.03
Deleted amzn-s3-demo-bucket/image.part.04
Deleted amzn-s3-demo-bucket/image.part.05
Deleted amzn-s3-demo-bucket/image.part.06
ec2-delete-bundle complete.

ec2-download-bundle

Deskripsi

Mengunduh Linux yang didukung toko instans tertentu AMIs dari penyimpanan Amazon S3.

Sintaksis

ec2-download-bundle -b bucket -a access_key_id -s secret_access_key -k path [--url url] [--region region] [--sigv version] [-m file] [-p prefix] [-d directory] [--retry]

Opsi

bucket -b, --bucket

Nama bucket Amazon S3 tempat paketan berada, diikuti dengan awalan jalur opsional yang dibatasi ‘/’.

Wajib: Ya

access_key_id -a, --access-key

ID kunci AWS akses.

Wajib: Ya

secret_access_key -s, --secret-key

Kunci akses AWS rahasia.

Wajib: Ya

jalur -k, --privatekey

Kunci privat yang digunakan untuk mendekripsi manifes.

Wajib: Ya

url --url

URL layanan Amazon S3.

Default: https://s3.amazonaws.com/

Wajib: Tidak

wilayah --region

Wilayah yang akan digunakan dalam tanda tangan permintaan.

Default: us-east-1

Wajib: Wajib jika menggunakan tanda tangan versi 4

versi --sigv

Versi tanda tangan yang digunakan ketika menandatangani permintaan.

Nilai yang valid: 2 | 4

Default: 4

Wajib: Tidak

file -m, --manifest

Nama file manifes (tanpa jalur). Kami sarankan Anda untuk menentukan manifes (-m) atau awalan(-p).

Wajib: Tidak

awalan -p, --prefix

Awalan nama file untuk file AMI yang dipaketkan.

Default: image

Wajib: Tidak

direktori -d, --directory

Direktori tempat paketan yang diunduh disimpan. Direktori harus ada.

Default: Direktori kerja saat ini.

Wajib: Tidak

--retry

Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.

Wajib: Tidak

Output

Pesan status yang menunjukkan berbagai tahap proses pengunduhan ditampilkan.

Contoh

Contoh ini membuat direktori bundled (menggunakan perintah Linux mkdir) dan mengunduh paketan dari bucket Amazon S3 amzn-s3-demo-bucket.


[ec2-user ~]$ mkdir bundled
[ec2-user ~]$ ec2-download-bundle -b amzn-s3-demo-bucket/bundles/bundle_name -m image.manifest.xml -a your_access_key_id -s your_secret_access_key -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -d mybundle
Downloading manifest image.manifest.xml from amzn-s3-demo-bucket to mybundle/image.manifest.xml ...
Downloading part image.part.00 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.00 ...
Downloaded image.part.00 from amzn-s3-demo-bucket
Downloading part image.part.01 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.01 ...
Downloaded image.part.01 from amzn-s3-demo-bucket
Downloading part image.part.02 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.02 ...
Downloaded image.part.02 from amzn-s3-demo-bucket
Downloading part image.part.03 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.03 ...
Downloaded image.part.03 from amzn-s3-demo-bucket
Downloading part image.part.04 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.04 ...
Downloaded image.part.04 from amzn-s3-demo-bucket
Downloading part image.part.05 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.05 ...
Downloaded image.part.05 from amzn-s3-demo-bucket
Downloading part image.part.06 from amzn-s3-demo-bucket/bundles/bundle_name to mybundle/image.part.06 ...
Downloaded image.part.06 from amzn-s3-demo-bucket

ec2-migrate-manifest

Deskripsi

Memodifikasi AMI Linux yang didukung penyimpanan instans (misalnya, sertifikat, kernel, dan disk RAM) agar mendukung Wilayah yang berbeda.

Sintaksis

ec2-migrate-manifest -c path -k path -m path {(-a access_key_id -s secret_access_key --region region) | (--no-mapping)} [--ec2cert ec2_cert_path] [--kernel kernel-id] [--ramdisk ramdisk_id]

Opsi

jalur -c, --cert

File sertifikat kunci publik RSA yang dienkode PEM.

Wajib: Ya

jalur -k, --privatekey

Jalur menuju file kunci RSA yang dienkode PEM milik pengguna.

Wajib: Ya

jalur --manifest

Jalur ke file manifes.

Wajib: Ya

access_key_id -a, --access-key

ID kunci AWS akses.

Wajib: Wajib jika menggunakan pemetaan otomatis.

secret_access_key -s, --secret-key

Kunci akses AWS rahasia.

Wajib: Wajib jika menggunakan pemetaan otomatis.

wilayah --region

Wilayah untuk dicari di file pemetaan.

Wajib: Wajib jika menggunakan pemetaan otomatis.

--no-mapping

Menonaktifkan pemetaan otomatis kernel dan disk RAM.

Selama migrasi, Amazon EC2 mengganti disk kernel dan RAM dalam file manifes dengan kernel dan disk RAM yang dirancang untuk wilayah tujuan. Kecuali parameter --no-mapping diberikan, ec2-migrate-bundle dapat menggunakan operasi DescribeRegions dan DescribeImages untuk melakukan pemetaan otomatis.

Wajib: Wajib jika Anda tidak menyediakan opsi -a, -s, dan --region yang digunakan untuk pemetaan otomatis.

jalur --ec2cert

Jalur ke sertifikat kunci publik Amazon EC2 X.509 digunakan untuk mengenkripsi manifes gambar.

Wilayah us-gov-west-1 dan cn-north-1 menggunakan sertifikat kunci publik non-default dan jalur ke sertifikat tersebut harus ditetapkan dengan opsi ini. Jalur ke sertifikat berbeda-beda tergantung metode instalasi alat AMI. Untuk Amazon Linux, sertifikat terletak di /opt/aws/amitools/ec2/etc/ec2/amitools/. Jika Anda menginstal alat AMI dari file ZIP di Siapkan alat Amazon EC2 AMI, sertifikat berada di $EC2_AMITOOL_HOME/etc/ec2/amitools/.

Wajib: Hanya untuk Wilayah us-gov-west-1 dan cn-north-1.

kernel_id --kernel

ID kernel yang akan dipilih.

penting

Kami menyarankan Anda menggunakan PV-GRUB dibandingkan kernel dan disk RAM. Untuk informasi selengkapnya, lihat Kernel yang disediakan pengguna di Panduan Pengguna Amazon Linux 2.

Wajib: Tidak

ramdisk_id --ramdisk

ID disk RAM yang akan dipilih.

penting

Kami menyarankan Anda menggunakan PV-GRUB dibandingkan kernel dan disk RAM. Untuk informasi selengkapnya, lihat Kernel yang disediakan pengguna di Panduan Pengguna Amazon Linux 2.

Wajib: Tidak

Output

Pesan status yang menjelaskan tahap dan status proses pembuatan paketan.

Contoh

Contoh ini menyalin AMI yang ditentukan dalam manifes my-ami.manifest.xml dari AS ke UE.


[ec2-user ~]$ ec2-migrate-manifest --manifest my-ami.manifest.xml --cert cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --privatekey pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem --region eu-west-1 

Backing up manifest...
Successfully migrated my-ami.manifest.xml It is now suitable for use in eu-west-1.

ec2-unbundle

Deskripsi

Membuat ulang paketan dari AMI Linux yang didukung penyimpanan instans.

Sintaksis

ec2-unbundle -k path -m path [-s source_directory] [-d destination_directory]

Opsi

jalur -k, --privatekey

Jalur menuju file kunci RSA yang dienkode PEM.

Wajib: Ya

jalur -m, --manifest

Jalur ke file manifes.

Wajib: Ya

source_directory -s, --source

Direktori yang berisi paketan.

Default: Direktori saat ini.

Wajib: Tidak

destination_directory -d, --destination

Direktori tempat membongkar paketan AMI. Direktori tujuan harus ada.

Default: Direktori saat ini.

Wajib: Tidak

Contoh

Contoh Linux dan UNIX ini membongkar paketan AMI yang ditentukan dalam file image.manifest.xml.


[ec2-user ~]$ mkdir unbundled
$ ec2-unbundle -m mybundle/image.manifest.xml -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -s mybundle -d unbundled
$ ls -l unbundled
total 1025008
-rw-r--r-- 1 root root 1048578048 Aug 25 23:46 image.img

Output

Pesan status yang menunjukkan berbagai tahap proses pembongkaran paketan ditampilkan.

ec2-upload-bundle

Deskripsi

Mengunggah bundel untuk AMI Linux yang didukung toko instance ke Amazon S3 dan menyetel daftar kontrol akses (ACLs) yang sesuai pada objek yang diunggah. Untuk informasi selengkapnya, lihat Buat instance store-backed AMI.

catatan

Untuk mengunggah objek ke bucket S3 untuk AMI Linux yang didukung toko instans Anda, ACLs harus diaktifkan untuk bucket. Jika tidak, Amazon tidak EC2 akan dapat mengatur ACLs objek yang akan diunggah. Jika bucket tujuan Anda menggunakan setelan yang diberlakukan pemilik bucket untuk Kepemilikan Objek S3, ini tidak akan berfungsi karena ACLs dinonaktifkan. Untuk informasi selengkapnya, lihat Mengendalikan kepemilikan objek yang diunggah menggunakan Kepemilikan Objek S3.

Sintaksis

ec2-upload-bundle -b bucket -a access_key_id -s secret_access_key [-t token] -m path [--url url] [--region region] [--sigv version] [--acl acl] [-d directory] [--part part] [--retry] [--skipmanifest]

Opsi

bucket -b, --bucket

Nama bucket Amazon S3 untuk menyimpan paketan, diikuti dengan awalan jalur opsional yang dibatasi ‘/’. Jika bucket tidak tersedia, bucket akan dibuat jika namanya tersedia. Selain itu, jika bucket tidak ada dan versi alat AMI adalah 1.5.18 atau yang lebih baru, perintah ini menetapkan bucket ACLs untuk bucket.

Wajib: Ya

access_key_id -a, --access-key

ID kunci AWS akses Anda.

Wajib: Ya

secret_access_key -s, --secret-key

Kunci akses AWS rahasia Anda.

Wajib: Ya

token -t, --delegation-token

Token delegasi untuk diteruskan ke AWS permintaan. Untuk informasi selengkapnya, lihat Kredensyal keamanan sementara di Panduan Pengguna IAM.

Wajib: Hanya saat Anda menggunakan kredensial keamanan sementara.

Default: Nilai dari variabel lingkungan AWS_DELEGATION_TOKEN (jika diatur).

jalur -m, --manifest

Jalur ke file manifes. File manifes dibuat selama proses pembuatan paketan dan dapat ditemukan di direktori yang berisi paketan tersebut.

Wajib: Ya

url --url

Tidak lagi digunakan. Gunakan opsi --region sebagai gantinya kecuali jika bucket Anda dibatasi ke lokasi EU (dan bukan eu-west-1). Bendera --location adalah satu-satunya cara untuk menarget batasan lokasi tertentu.

URL layanan titik akhir Amazon S3.

Default: https://s3.amazonaws.com/

Wajib: Tidak

wilayah --region

Wilayah yang akan digunakan dalam tanda tangan permintaan untuk bucket S3 tujuan.

Jika bucket tidak ada dan Anda tidak menentukan Wilayah, alat akan membuat bucket tanpa batasan lokasi (di us-east-1).
Jika bucket tidak ada dan Anda menentukan Wilayah, alat akan membuat bucket di Wilayah yang ditentukan.
Jika bucket tersedia dan Anda tidak menentukan Wilayah, alat ini akan menggunakan lokasi bucket.
Jika bucket tersedia dan Anda menentukan us-east-1 sebagai Wilayah, alat ini akan menggunakan lokasi aktual bucket tanpa pesan kesalahan apa pun, setiap file yang cocok akan ditimpa.
Jika bucket tersedia dan Anda menetapkan Wilayah (selain us-east-1) yang tidak sesuai dengan lokasi aktual bucket, alat akan keluar dengan kesalahan.

Jika bucket Anda dibatasi ke lokasi EU (dan bukan eu-west-1), gunakan bendera --location sebagai gantinya. Bendera --location adalah satu-satunya cara untuk menarget batasan lokasi tertentu.

Default: us-east-1

Wajib: Wajib jika menggunakan tanda tangan versi 4

versi --sigv

Versi tanda tangan yang digunakan ketika menandatangani permintaan.

Nilai yang valid: 2 | 4

Default: 4

Wajib: Tidak

acl --acl

Kebijakan daftar kontrol akses dari gambar yang dipaketkan.

Nilai yang valid: public-read | aws-exec-read

Default: aws-exec-read

Wajib: Tidak

direktori -d, --directory

Direktori yang berisi bagian AMI yang dipaketkan.

Default: Direktori yang berisi file manifes (lihat opsi -m).

Wajib: Tidak

bagian --part

Mulai mengunggah bagian tertentu dan semua bagian berikutnya. Sebagai contoh, --part 04.

Wajib: Tidak

--retry

Otomatis mencoba ulang semua kesalahan Amazon S3, hingga lima kali per operasi.

Wajib: Tidak

--skipmanifest

Tidak mengunggah manifes.

Wajib: Tidak

lokasi --location

Tidak lagi digunakan. Gunakan opsi --region sebagai gantinya, kecuali jika bucket Anda dibatasi ke lokasi EU (dan bukan eu-west-1). Bendera --location adalah satu-satunya cara untuk menarget batasan lokasi tersebut.

Batasan lokasi tujuan bucket Amazon S3. Jika bucket tersedia dan Anda menetapkan lokasi yang tidak sesuai dengan lokasi aktual bucket, alat akan keluar dengan kesalahan. Jika bucket tersedia dan Anda tidak menentukan lokasi, alat ini akan menggunakan lokasi bucket. Jika bucket tidak tersedia dan Anda menentukan lokasi, alat akan membuat bucket di lokasi yang ditentukan. Jika bucket tidak ada dan Anda tidak menentukan lokasi, alat akan membuat bucket tanpa batasan lokasi (di us-east-1).

Default: Jika --region ditentukan, lokasi diatur ke Wilayah yang ditentukan. Jika --region tidak ditentukan, lokasi secara default menjadi us-east-1.

Wajib: Tidak

Output

Amazon EC2 menampilkan pesan status yang menunjukkan tahapan dan status proses unggahan.

Contoh

Contoh ini mengunggah paketan yang ditentukan oleh manifes image.manifest.xml.


[ec2-user ~]$ ec2-upload-bundle -b amzn-s3-demo-bucket/bundles/bundle_name -m image.manifest.xml -a your_access_key_id -s your_secret_access_key
Creating bucket...
Uploading bundled image parts to the S3 bucket amzn-s3-demo-bucket ...
Uploaded image.part.00
Uploaded image.part.01
Uploaded image.part.02
Uploaded image.part.03
Uploaded image.part.04
Uploaded image.part.05
Uploaded image.part.06
Uploaded image.part.07
Uploaded image.part.08
Uploaded image.part.09
Uploaded image.part.10
Uploaded image.part.11
Uploaded image.part.12
Uploaded image.part.13
Uploaded image.part.14
Uploading manifest ...
Uploaded manifest.
Bundle upload completed.

Opsi umum untuk alat AMI

Sebagian besar alat AMI menerima parameter opsional berikut.

--help, -h: Menampilkan pesan bantuan.
--version: Menampilkan versi dan pemberitahuan hak cipta.
--manual: Menampilkan entri manual.
--batch: Berjalan dalam mode batch, menahan perintah interaktif.
--debug: Menampilkan informasi yang dapat berguna saat pemecahan masalah.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Mengatur alat AMI

Konversikan AMI yang didukung oleh instance store-backed Anda