Gunakan perintah register-on-premises-instance (ARN pengguna IAM) untuk mendaftarkan instance lokal

Untuk menetapkan izin (CLI)

1. Buat file dengan konten kebijakan berikut di instans atau perangkat Amazon EC2 yang Anda gunakan untuk memanggil. AWS CLI Beri nama file sepertiCodeDeploy-OnPrem-Permissions.json, lalu simpan file tersebut.

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

   catatan

   Sebaiknya batasi kebijakan ini hanya untuk bucket Amazon S3 yang perlu diakses instans lokal Anda. Jika Anda membatasi kebijakan ini, pastikan juga memberikan akses ke bucket Amazon S3 yang berisi AWS CodeDeploy agen. Jika tidak, kesalahan mungkin terjadi setiap kali CodeDeploy agen diinstal atau diperbarui pada instans lokal terkait.

   Contoh:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource": [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-north-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-2/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",        
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-2/*",
           "arn:aws:s3:::aws-codedeploy-me-central-1/*",
           "arn:aws:s3:::aws-codedeploy-me-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }
     ]
   }

2. Panggil perintah put-user-policy, tentukan nama pengguna IAM (dengan --user-name opsi), nama untuk kebijakan (dengan --policy-name opsi), dan jalur ke dokumen kebijakan yang baru dibuat (dengan opsi). --policy-document Misalnya, dengan asumsi bahwa CodeDeploy-OnPrem-Permissions.json file berada di direktori (folder) yang sama dari mana Anda memanggil perintah ini:

   penting

   Pastikan untuk menyertakan file:// sebelum nama file. Diperlukan dalam perintah ini.

   aws iam put-user-policy --user-name CodeDeployUser-OnPrem --policy-name CodeDeploy-OnPrem-Permissions --policy-document file://CodeDeploy-OnPrem-Permissions.json

Untuk menetapkan izin (konsol)

1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

2. Pada panel navigasi, pilih Kebijakan, lalu pilih Buat kebijakan. (Jika tombol Memulai muncul, pilihlah, lalu pilih Buat Kebijakan.)

3. Di sebelah Buat Kebijakan Anda Sendiri, pilih Pilih.

4. Di kotak Nama Kebijakan, ketik nama untuk kebijakan ini (misalnya,CodeDeploy-OnPrem-Permissions).

5. Di kotak Dokumen Kebijakan, ketik atau tempel ekspresi izin berikut, yang AWS CodeDeploy memungkinkan penerapan revisi aplikasi dari bucket Amazon S3 apa pun yang ditentukan dalam kebijakan ke instance lokal atas nama pengguna IAM:

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

6. Pilih Buat Kebijakan.

7. Di panel navigasi, pilih Users (Pengguna).

8. Dalam daftar pengguna, telusuri dan pilih nama pengguna IAM yang Anda buat. Langkah 1: Membuat pengguna IAM untuk instans lokal

9. Pada tab Izin, di Kebijakan Ter kelola, pilih Lampirkan Kebijakan.

10. Pilih kebijakan bernamaCodeDeploy-OnPrem-Permissions, lalu pilih Lamp irkan Kebijakan.

Untuk mendapatkan kredenSIAL (CLI)

1. Panggil perintah list-access-keys, tentukan nama pengguna IAM (dengan --user-name opsi) dan menanyakan hanya ID kunci akses (dengan opsi dan). --query --output Contoh:

   aws iam list-access-keys --user-name CodeDeployUser-OnPrem --query "AccessKeyMetadata[*].AccessKeyId" --output text

2. Jika tidak ada tombol yang muncul di output atau informasi tentang hanya satu tombol muncul di output, panggil perintah create-access-key, tentukan nama pengguna IAM (dengan opsi): --user-name

   aws iam create-access-key --user-name CodeDeployUser-OnPrem

   Dalam output panggilan ke create-access-key perintah, perhatikan nilai SecretAccessKey bidang AccessKeyId dan. Anda akan membutuhkan informasi iniLangkah 4: Menambahkan file konfigurasi ke instance lokal.

   penting

   Ini akan menjadi satu-satunya waktu Anda akan memiliki akses ke kunci akses rahasia ini. Jika Anda lupa atau kehilangan akses ke kunci akses rahasia ini, Anda harus membuat yang baru dengan mengikuti langkah-langkah diLangkah 3: Dapatkan kredenSIAL pengguna IAM.

3. Jika dua kunci akses sudah terdaftar, Anda harus menghapus salah satunya dengan memanggil perintah delete-access-key, menentukan nama pengguna IAM (dengan --user-name opsi), dan ID kunci akses untuk dihapus (dengan opsi). --access-key-id Kemudian panggil create-access-key perintah, seperti yang dijelaskan sebelumnya pada langkah ini. Berikut contoh memanggil delete-access-key perintah:

   aws iam delete-access-key --user-name CodeDeployUser-OnPrem --access-key-id access-key-ID

   penting

   Jika Anda memanggil delete-access-key perintah untuk menghapus salah satu kunci akses ini, dan instance lokal sudah menggunakan kunci akses ini seperti yang dijelaskan dalamLangkah 4: Menambahkan file konfigurasi ke instance lokal, Anda harus mengikuti instruksi Langkah 4: Menambahkan file konfigurasi ke instance lokal lagi untuk menentukan ID kunci akses yang berbeda dan kunci akses rahasia yang terkait dengan pengguna IAM ini. Jika tidak, penerapan apa pun ke instans lokal tersebut mungkin macet dalam status tertunda abadi atau gagal sama sekali.

Untuk mendapatkan kredenSIAL (konsol)

1. 1. Buka konsol IAM di https://console.aws.amazon.com/iam/.

   2. Jika daftar pengguna tidak ditampilkan, di panel navigasi, pilih Pengguna.

   3. Dalam daftar pengguna, telusuri dan pilih nama pengguna IAM yang Anda buat. Langkah 1: Membuat pengguna IAM untuk instans lokal

2. Pada tab Kredensibilitas keamanan, jika tidak ada kunci atau hanya satu kunci yang terdaftar, pilih Buat kunci akses.

   Jika dua kunci akses terdaftar, Anda harus menghapus salah satunya. Pilih H apus di sebelah salah satu tombol akses, lalu pilih Buat kunci akses.

   penting

   Jika Anda memilih H apus di sebelah salah satu kunci akses ini, dan instans lokal sudah menggunakan kunci akses ini seperti yang dijelaskan dalamLangkah 4: Menambahkan file konfigurasi ke instance lokal, Anda harus mengikuti instruksi Langkah 4: Menambahkan file konfigurasi ke instance lokal lagi untuk menentukan ID kunci akses dan kunci akses rahasia yang berbeda yang terkait dengan pengguna IAM ini. Jika tidak, penerapan ke instans lokal tersebut mungkin macet dalam status tertunda abadi atau gagal sama sekali.

3. Pilih Tampilkan dan catat ID kunci akses dan kunci akses rahasia. Anda akan membutuhkan informasi ini untuk langkah selanjutnya. Atau, Anda dapat memilih Unduh file.csv untuk menyimpan salinan ID kunci akses dan kunci akses rahasia.

   penting

   Kecuali Anda membuat catatan atau mengunduh kredensialnya, ini akan menjadi satu-satunya waktu Anda akan memiliki akses ke kunci akses rahasia ini. Jika Anda lupa atau kehilangan akses ke kunci akses rahasia ini, Anda harus membuat yang baru dengan mengikuti langkah-langkah diLangkah 3: Dapatkan kredenSIAL pengguna IAM.

4. Pilih Tut up untuk kembali ke IAM User Name halaman Pengguna >.

1. Buat file bernama codedeploy.onpremises.yml (untuk instans lokal Ubuntu Server atau RHEL) atau conf.onpremises.yml (untuk instans lokal Windows Server) di lokasi berikut pada instance lokal:

   • Untuk Ubuntu Server: /etc/codedeploy-agent/conf

   • Untuk Windows Server: C:\ProgramData\Amazon\CodeDeploy

2. Gunakan editor teks untuk menambahkan informasi berikut ke conf.onpremises.yml file codedeploy.onpremises.yml atau yang baru dibuat:

   ---
   aws_access_key_id: secret-key-id
   aws_secret_access_key: secret-access-key
   iam_user_arn: iam-user-arn
   region: supported-region

   Di mana:

   • secret-key-idadalah ID kunci rahasia pengguna IAM yang sesuai yang Anda catat di Langkah 1: Membuat pengguna IAM untuk instans lokal atauLangkah 3: Dapatkan kredenSIAL pengguna IAM.

   • secret-access-keyadalah kunci akses rahasia pengguna IAM yang sesuai yang Anda catat di Langkah 1: Membuat pengguna IAM untuk instans lokal atauLangkah 3: Dapatkan kredenSIAL pengguna IAM.

   • iam-user-arnadalah ARN pengguna IAM yang Anda catat sebelumnya. Langkah 1: Membuat pengguna IAM untuk instans lokal

   • supported-regionadalah pengidentifikasi Wilayah yang didukung CodeDeploy oleh lokasi CodeDeploy aplikasi, grup penerapan, dan revisi aplikasi Anda (misalnya,us-west-2). Untuk daftar Wilayah, lihat Wil ayah dan titik akhir di Referensi Umum AWS.

   penting

   Jika Anda memilih H apus di sebelah salah satu kunci akses diLangkah 3: Dapatkan kredenSIAL pengguna IAM, dan instans lokal Anda sudah menggunakan ID kunci akses terkait dan kunci akses rahasia, Anda harus mengikuti petunjuk di dalam Langkah 4: Menambahkan file konfigurasi ke instance lokal untuk menentukan ID kunci akses dan kunci akses rahasia yang berbeda yang terkait dengan pengguna IAM ini. Jika tidak, penerapan apa pun ke instans lokal Anda mungkin macet dalam status tertunda abadi atau gagal sama sekali.

1. Untuk menginstal instans AWS CLI di lokasi, ikuti petunjuk dalam Menyiapkan dengan AWS CLI di Panduan AWS Command Line Interface Pengguna.

   catatan

   CodeDeploy perintah untuk bekerja dengan instans lokal tersedia di versi 1.7.19 dari. AWS CLI Jika Anda memiliki versi yang AWS CLI sudah diinstal, Anda dapat memeriksa versinya dengan meneleponaws --version.

2. Untuk mengonfigurasi AWS CLI instans lokal, ikuti petunjuk di Konfigurasi AWS CLI di Panduan AWS Command Line Interface Pengguna.

   penting

   Saat Anda mengkonfigurasi AWS CLI (misalnya, dengan memanggil aws configure perintah), pastikan untuk menentukan ID kunci rahasia dan kunci akses rahasia pengguna IAM yang memiliki, minimal, izin AWS akses berikut selain izin akses yang ditentukan dalamPrasyarat untuk mengonfigurasi instans lokal. Hal ini memungkinkan Anda untuk mengunduh dan menginstal CodeDeploy agen pada instans lokal:

   JSON

   {
     "Version":"2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::amzn-s3-demo-bucket1/*"
         ]
       }     
     ]
   }
   

   JSON

   {
     "Version":"2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "*"
         ]
       }     
     ]
   }
   

   Izin akses ini dapat ditetapkan ke pengguna IAM yang Anda buat di Langkah 1: Membuat pengguna IAM untuk instans lokal atau pengguna IAM yang berbeda. Untuk menetapkan izin ini ke pengguna IAM, ikuti petunjuk diLangkah 1: Membuat pengguna IAM untuk instans lokal, menggunakan izin akses ini alih-alih yang ada di langkah itu.

1. Sebelum Anda dapat menggunakan AWS CLI, Anda memerlukan ARN pengguna dari pengguna IAM yang Anda buat. Langkah 1: Membuat pengguna IAM untuk instans lokal Jika Anda belum memiliki ARN pengguna, panggil perintah get-user, tentukan nama pengguna IAM (dengan --user-name opsi) dan menanyakan hanya ARN pengguna (dengan opsi dan): --query --output

   aws iam get-user --user-name CodeDeployUser-OnPrem --query "User.Arn" --output text

2. Panggil perintah register-on-premises- instance, tentukan:

   • Nama yang secara unik mengidentifikasi instance lokal (dengan --instance-name opsi).

     penting

     Untuk membantu mengidentifikasi instance lokal, terutama untuk tujuan debugging, kami sangat menyarankan Anda menentukan nama yang dipetakan ke beberapa karakteristik unik dari instance lokal (misalnya, nomor seri atau pengenal aset internal, jika berlaku). Jika Anda menentukan alamat MAC sebagai nama, ketahuilah bahwa alamat MAC berisi karakter yang CodeDeploy tidak memungkinkan, seperti titik dua (:). Untuk daftar karakter yang diizinkan, lihatCodeDeploy kuota.

   • ARN pengguna dari pengguna IAM yang Anda buat Langkah 1: Membuat pengguna IAM untuk instans lokal (dengan --iam-user-arn opsi).

     Contoh:

     aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem

Untuk menandai instance lokal (CLI)

• Panggil perintah add-tags-to-on- premises-instance, tentukan:

  • Nama yang secara unik mengidentifikasi instance lokal (dengan --instance-names opsi).

  • Nama kunci tag instans lokal dan nilai tag yang ingin Anda gunakan (dengan --tags opsi). Anda harus menentukan nama dan nilai. CodeDeploy tidak mengizinkan tag instans lokal yang hanya memiliki nilai.

    Contoh:

    aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem

Untuk menandai instance lokal (konsol)

1. Masuk ke Konsol Manajemen AWS dan buka CodeDeploy konsol di https://console.aws.amazon.com/codedeploy.

   catatan

   Masuk dengan pengguna yang sama dengan yang Anda aturMemulai dengan CodeDeploy.

2. Dari CodeDeploy menu, pilih On-premises instance.

3. Dalam daftar instans lokal, pilih panah di sebelah instance lokal yang ingin Anda tandai.

4. Dalam daftar tag, pilih atau masukkan kunci tag dan nilai tag yang diinginkan. Setelah Anda memasukkan kunci tag dan nilai tag, baris lain muncul. Anda dapat mengulangi ini hingga 10 tag. Untuk menghapus tag, pilih ikon hapus ( ).

5. Setelah Anda menambahkan tag, pilih Per barui Tag.