Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
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.
Commands
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
dancn-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
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
-
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 adalahdebian.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.
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 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
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
-
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
-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
-
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
-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 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 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 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
dancn-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 lokasiEU
(dan bukaneu-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 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 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 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 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.