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 EC2 AMI alat Amazon

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

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

ec2- ami-tools-version

Deskripsi

Menjelaskan versi AMI alat.

Sintaks

ec2-ami-tools-version

Output

Informasi versi.

Contoh

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


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

ec2-bundle-image

Deskripsi

Membuat instance Linux yang didukung toko AMI dari image 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 RSA publik yang PEM dikodekan pengguna.

Wajib: Ya

jalur -k, --privatekey

Path ke file kunci PEM -encoded. RSA 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 bervariasi berdasarkan metode pemasangan AMI alat. Untuk Amazon Linux, sertifikat terletak di /opt/aws/amitools/ec2/etc/ec2/amitools/. Jika Anda menginstal AMI alat dari ZIP file RPM atau diSiapkan EC2 AMI alat Amazon, 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

Mendefinisikan bagaimana perangkat blok diekspos ke instance ini AMI jika jenis instance-nya 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 yang dibundel. AMI

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

Telah usang. Gunakan register-image untuk mengatur RAM disk jika diperlukan.

Wajib: Tidak

Output

Pesan status yang menjelaskan tahap dan status proses pembuatan paketan.

Contoh

Contoh ini membuat bundel AMI dari image 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 Linux yang didukung toko instance AMI dengan mengompresi, mengenkripsi, dan menandatangani salinan volume perangkat root untuk instance tersebut.

Amazon EC2 mencoba mewarisi kode produk, pengaturan kernel, pengaturan RAM disk, 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 yang didukung toko 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 RSA publik yang PEM dikodekan pengguna.

Wajib: Ya

jalur -k, --privatekey

Path ke file kunci PEM -encoded RSA 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

Mendefinisikan bagaimana perangkat blok diekspos ke instance ini AMI jika jenis instance-nya 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 sebaliknya akan dikecualikan dari AMI karena mungkin berisi informasi sensitif.

Wajib: Tidak

--no-filter

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

Wajib: Tidak

awalan -p, --prefix

Awalan nama file untuk file yang dibundelAMI.

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

Telah usang. Gunakan register-image untuk mengatur RAM disk jika diperlukan.

Wajib: Tidak

Output

Pesan status yang menjelaskan tahap dan status proses pemaketan.

Contoh

Contoh ini membuat bundel AMI dengan mengompresi, mengenkripsi, dan menandatangani snapshot dari 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 Anda menghapus bundel, Anda tidak dapat meluncurkan instance dari yang sesuaiAMI.

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 bundelAMI, diikuti dengan awalan jalur yang dibatasi '/' opsional

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 Menggunakan Kredensial Keamanan Sementara.

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

AMIAwalan nama file yang dibundel. 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

Layanan Amazon S3. URL

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 yang dibundel. AMI

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 instance Linux yang didukung toko AMI (misalnya, sertifikat, kernel, dan RAM disk) sehingga 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 RSA publik yang PEM dikodekan pengguna.

Wajib: Ya

jalur -k, --privatekey

Path ke file kunci PEM -encoded RSA 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 kernel dan RAM disk dalam file manifes dengan kernel dan RAM disk 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 bervariasi berdasarkan metode pemasangan AMI alat. Untuk Amazon Linux, sertifikat terletak di /opt/aws/amitools/ec2/etc/ec2/amitools/. Jika Anda menginstal AMI alat dari ZIP file diSiapkan EC2 AMI alat Amazon, 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 alih-alih kernel dan RAM disk. Untuk informasi selengkapnya, lihat Kernel yang disediakan pengguna di Panduan Pengguna Amazon Linux 2.

Wajib: Tidak

ramdisk_id --ramdisk

ID RAM disk yang akan dipilih.

penting

Kami menyarankan Anda menggunakan PV- GRUB alih-alih kernel dan RAM disk. 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 yang AMI ditentukan dalam my-ami.manifest.xml manifes 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 bundel dari Linux yang didukung toko instance. AMI

Sintaksis

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

Opsi

jalur -k, --privatekey

Jalur ke file kunci PEM -encoded RSA Anda.

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 untuk membuka bundel. AMI Direktori tujuan harus ada.

Default: Direktori saat ini.

Wajib: Tidak

Contoh

Linux ini dan UNIX contoh membongkar yang AMI 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 Linux yang didukung toko instance ke Amazon AMI S3 dan menetapkan daftar kontrol akses (ACLs) yang sesuai pada objek yang diunggah. Untuk informasi selengkapnya, lihat Buat instance yang didukung toko AMI.

catatan

Untuk mengunggah objek ke bucket S3 untuk Linux yang didukung toko instans AndaAMI, 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 AMI alatnya 1.5.18 atau yang lebih baru, perintah ini menetapkan bucket ACLs untuk.

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 Menggunakan Kredensial Keamanan Sementara.

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.

Layanan endpoint Amazon S3. URL

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 AMI bagian yang dibundel.

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

Sebagian besar AMI alat 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

Siapkan AMI alat

Konversikan instans Anda didukung toko AMI