Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat tumpukan dari sumber daya yang ada
Topik ini menunjukkan cara membuat tumpukan dari AWS sumber daya yang ada dengan mendeskripsikannya dalam templat. Untuk memindai sumber daya yang ada dan secara otomatis membuat templat yang dapat Anda gunakan untuk mengimpor sumber daya yang ada ke CloudFormation atau mereplikasi sumber daya di akun baru, lihat[Hasilkan templat dari sumber daya yang ada dengan generator IAc](generate-IaC.md).
**Prasyarat**
Sebelum memulai, Anda harus memiliki hal-hal berikut:
+ Template yang menjelaskan semua sumber daya yang Anda inginkan di tumpukan baru. Simpan template secara lokal atau di bucket Amazon S3.
+ Untuk setiap sumber daya yang ingin Anda impor, sertakan yang berikut ini:
+ properti dan nilai properti yang menentukan konfigurasi sumber daya saat ini.
+ pengidentifikasi unik untuk sumber daya, seperti nama sumber daya. Untuk informasi selengkapnya, lihat [Pengidentifikasi sumber daya](import-resources-manually.md#resource-import-identifiers-unique-ids).
+ [DeletionPolicyatribut](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-attribute-deletionpolicy.html).
**Topics**
+ [Contoh Templat](#resource-import-new-stack-example-template)
+ [Buat tumpukan dari sumber daya yang ada menggunakan Konsol Manajemen AWS](#resource-import-new-stack-console)
+ [Buat tumpukan dari sumber daya yang ada menggunakan AWS CLI](#resource-import-new-stack-cli)
## Contoh Templat
Dalam panduan ini, kami menganggap Anda menggunakan contoh template berikut, yang disebut`TemplateToImport.json`, yang menentukan dua tabel DynamoDB yang dibuat di luar. CloudFormation `ServiceTable`dan `GamesTable` merupakan target impor.
**catatan**
Template ini dimaksudkan sebagai contoh saja. Untuk menggunakannya untuk tujuan pengujian Anda sendiri, ganti sumber daya sampel dengan sumber daya dari akun Anda.
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Description": "Import test",
"Resources": {
"ServiceTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Service",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
},
"GamesTable": {
"Type": "AWS::DynamoDB::Table",
"DeletionPolicy": "Retain",
"Properties": {
"TableName": "Games",
"AttributeDefinitions": [
{
"AttributeName": "key",
"AttributeType": "S"
}
],
"KeySchema": [
{
"AttributeName": "key",
"KeyType": "HASH"
}
],
"ProvisionedThroughput": {
"ReadCapacityUnits": 5,
"WriteCapacityUnits": 1
}
}
}
}
}
```
## Buat tumpukan dari sumber daya yang ada menggunakan Konsol Manajemen AWS
1. Masuk ke Konsol Manajemen AWS dan buka CloudFormation konsol di [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Pada halaman **Tumpukan**, pilih **Buat Tumpukan**, lalu pilih **Dengan sumber daya yang ada (sumber daya impor)**.
![\[Buat tumpukan dari pilihan sumber daya yang ada dalam konsol.\]](http://docs.aws.amazon.com/id_id/AWSCloudFormation/latest/UserGuide/images/create-stack-with-existing-resources.png)
1. Baca halaman **Gambaran Umum Impor** untuk daftar hal yang harus Anda berikan selama operasi ini. Lalu, pilih **Selanjutnya**.
1. Di halaman **Tentukan templat**, berikan templat Anda menggunakan salah satu metode berikut, lalu pilih **Selanjutnya**.
+ Pilih **URL Amazon S3**, lalu tentukan URL untuk templat Anda di kotak teks.
+ Pilih **Unggah file templat**, lalu telusuri templat Anda.
1. Di halaman **Identifikasi sumber daya**, identifikasi setiap sumber daya target. Untuk informasi selengkapnya, lihat [Pengidentifikasi sumber daya](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. Di bawah **Properti pengidentifikasi**, pilih jenis pengidentifikasi sumber daya. Misalnya, sumber daya `AWS::DynamoDB::Table` dapat diidentifikasi menggunakan `TableName` properti.
1. Di bawah **Nilai pengidentifikasi**, ketikkan nilai properti yang sebenarnya. Misalnya, `TableName` untuk `GamesTable` sumber daya di templat contoh adalah `Games`.
1. Pilih **Berikutnya**.
1. Di halaman **Tentukan detail tumpukan**, ubah parameter apa pun, lalu pilih **Selanjutnya**. Ini secara otomatis membuat set perubahan.
**penting**
Operasi impor gagal jika Anda mengubah parameter yang sudah ada yang memulai operasi membuat, memperbarui, atau menghapus.
1. Pada *stack-name* halaman **Tinjauan**, konfirmasikan bahwa sumber daya yang benar sedang diimpor, lalu pilih **Impor sumber daya**. Ini secara otomatis mengeksekusi perubahan set yang dibuat pada langkah terakhir.
Panel **Peristiwa** halaman **Detail tumpukan** untuk tampilan tumpukan baru Anda.
![\[Tab Peristiwa di konsol.\]](http://docs.aws.amazon.com/id_id/AWSCloudFormation/latest/UserGuide/images/import-events.png)
1. (Opsional) Jalankan deteksi drift pada tumpukan untuk memastikan templat dan konfigurasi sebenarnya cocok dengan sumber daya yang diimpor. Untuk informasi lebih lanjut tentang mendeteksi penyimpangan, lihat. [Mendeteksi penyimpangan di seluruh tumpukan CloudFormation](detect-drift-stack.md)
1. (Opsional) Jika sumber daya yang diimpor tidak cocok dengan konfigurasi templat yang diharapkan, perbaiki konfigurasi templat atau perbarui sumber daya secara langsung. Dalam panduan ini, kita memperbaiki konfigurasi templat untuk mencocokkan konfigurasi yang sebenarnya.
1. [Kembalikan operasi impor](resource-import-revert.md#resource-import-revert-console) untuk sumber daya yang terpengaruh.
1. Tambahkan target impor ke templat Anda lagi, memastikan bahwa konfigurasi templat cocok dengan konfigurasi yang sebenarnya.
1. Ulangi langkah 2 - 8 menggunakan template yang dimodifikasi untuk mengimpor sumber daya lagi.
## Buat tumpukan dari sumber daya yang ada menggunakan AWS CLI
1. Untuk mempelajari properti mana yang mengidentifikasi setiap jenis sumber daya dalam template, jalankan **get-template-summary** perintah, tentukan URL S3 template. Misalnya, sumber daya `AWS::DynamoDB::Table` dapat diidentifikasi menggunakan `TableName` properti. Untuk `GamesTable` sumber daya dalam templat contoh, nilai `TableName` adalah `Games`. Anda akan membutuhkan informasi ini di langkah berikutnya.
```
aws cloudformation get-template-summary \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json
```
Untuk informasi selengkapnya, lihat [Pengidentifikasi sumber daya](import-resources-manually.md#resource-import-identifiers-unique-ids).
1. Buat daftar sumber daya aktual dari template Anda dan pengenal uniknya dalam format string JSON berikut.
```
[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]
```
Atau, Anda dapat menentukan parameter berformat JSON dalam file konfigurasi.
Misalnya, untuk mengimpor `ServiceTable` dan`GamesTable`, Anda dapat membuat *ResourcesToImport.txt* file yang berisi konfigurasi berikut.
```
[
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"GamesTable",
"ResourceIdentifier":{
"TableName":"Games"
}
},
{
"ResourceType":"AWS::DynamoDB::Table",
"LogicalResourceId":"ServiceTable",
"ResourceIdentifier":{
"TableName":"Service"
}
}
]
```
1. Untuk membuat set perubahan, gunakan **create-change-set** perintah berikut dan ganti teks placeholder. Untuk `--change-set-type` opsi, tentukan nilai**IMPORT**. Untuk `--resources-to-import` opsi, ganti string JSON sampel dengan string JSON aktual yang baru saja Anda buat.
```
aws cloudformation create-change-set \
--stack-name TargetStack --change-set-name ImportChangeSet \
--change-set-type IMPORT \
--template-url https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/TemplateToImport.json \
--resources-to-import '[{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"GamesTable","ResourceIdentifier":{"TableName":"Games"}},{"ResourceType":"AWS::DynamoDB::Table","LogicalResourceId":"ServiceTable","ResourceIdentifier":{"TableName":"Service"}}]'
```
**catatan**
`--resources-to-import`tidak mendukung YAMAL sebaris. Persyaratan untuk menghindari tanda kutip dalam string JSON bervariasi tergantung pada terminal Anda. Untuk informasi selengkapnya, lihat [Menggunakan tanda kutip di dalam string](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) di *AWS Command Line Interface Panduan Pengguna*.
Atau, Anda dapat menggunakan URL file sebagai masukan untuk `--resources-to-import` opsi, seperti yang ditunjukkan pada contoh berikut.
```
--resources-to-import file://ResourcesToImport.txt
```
1. Tinjau perubahan yang ditetapkan untuk memastikan sumber daya yang benar akan diimpor.
```
aws cloudformation describe-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. Untuk memulai set perubahan dan mengimpor sumber daya, gunakan **execute-change-set** perintah berikut dan ganti teks placeholder. Setelah berhasil menyelesaikan operasi `(IMPORT_COMPLETE)`, sumber daya berhasil diimpor.
```
aws cloudformation execute-change-set \
--change-set-name ImportChangeSet --stack-name TargetStack
```
1. (Opsional) Jalankan deteksi drift pada `IMPORT_COMPLETE` tumpukan untuk memastikan templat dan konfigurasi sebenarnya cocok dengan sumber daya yang diimpor. Untuk informasi lebih lanjut tentang mendeteksi penyimpangan, lihat. [Mendeteksi penyimpangan di sumber daya tumpukan individu](detect-drift-resource.md)
1. Jalankan deteksi drift pada tumpukan yang ditentukan.
```
aws cloudformation detect-stack-drift --stack-name TargetStack
```
Jika berhasil, perintah ini mengembalikan output sampel berikut.
```
{ "Stack-Drift-Detection-Id" : "624af370-311a-11e8-b6b7-500cexample" }
```
1. Lihat kemajuan operasi deteksi drift untuk ID deteksi drift tumpukan yang ditentukan.
```
aws cloudformation describe-stack-drift-detection-status \
--stack-drift-detection-id 624af370-311a-11e8-b6b7-500cexample
```
1. Lihat informasi drift untuk sumber daya yang telah diperiksa untuk drift di tumpukan yang ditentukan.
```
aws cloudformation describe-stack-resource-drifts --stack-name TargetStack
```
1. (Opsional) Jika sumber daya yang diimpor tidak cocok dengan konfigurasi templat yang diharapkan, perbaiki konfigurasi templat atau perbarui sumber daya secara langsung. Dalam panduan ini, kita memperbaiki konfigurasi templat untuk mencocokkan konfigurasi yang sebenarnya.
1. [Kembalikan operasi impor](resource-import-revert.md#resource-import-revert-cli) untuk sumber daya yang terpengaruh.
1. Tambahkan target impor ke templat Anda lagi, memastikan bahwa konfigurasi templat cocok dengan konfigurasi yang sebenarnya.
1. Ulangi langkah 3 - 6 menggunakan template yang dimodifikasi untuk mengimpor sumber daya lagi.