Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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.
Commands
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
dancn-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
dancn-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 adalahdebian.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.
Wilayah
us-gov-west-1
dancn-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
dancn-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
-ayour_access_key_id
-syour_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
-syour_secret_access_key
-k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -d mybundleDownloading 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 operasiDescribeRegions
danDescribeImages
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
dancn-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
dancn-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 lokasiEU
(dan bukaneu-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 bukaneu-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 lokasiEU
(dan bukaneu-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 menjadius-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
-syour_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.