Tutorial: Buat pipa yang menyebarkan keAWS Service Catalog - AWS CodePipeline

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Tutorial: Buat pipa yang menyebarkan keAWS Service Catalog

AWS Service Catalogmemungkinkan Anda untuk membuat dan menyediakan produk berdasarkanAWS CloudFormationtemplat. Tutorial ini menunjukkan Anda bagaimana membuat dan mengonfigurasi alur untuk men-deploy templat produk Anda keAWS Service Catalogdan menyampaikan perubahan yang telah Anda buat di repositori sumber Anda (sudah dibuat di GitHub, CodeCommit, atau Amazon S3).

catatan

Saat Amazon S3 adalah penyedia sumber untuk pipeline Anda, Anda harus mengunggah ke bucket semua file sumber yang dikemas sebagai satu file.zip. Jika tidak, tindakan sumber akan gagal.

Pertama, Anda membuat produk diAWS Service Catalog, dan kemudian Anda membuat pipa diAWS CodePipeline. Tutorial ini menyediakan dua opsi untuk menyiapkan konfigurasi deployment:

Opsi 1: Deploy keAWS Service Catalogtanpa file konfigurasi

Dalam contoh ini, Anda mengunggah sampelAWS CloudFormationfile template untuk bucket S3, dan kemudian buat produk AndaAWS Service Catalog. Selanjutnya, Buatlah alur Anda dan tentukan konfigurasi deploy di konsol CodePipeline.

Langkah 1: Upload file template sampel ke repositori sumber

  1. Buka editor teks. Buat contoh template dengan menempelkan berikut ke dalam file. Simpan file sebagai S3_template.json.

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "CloudFormation Sample Template S3_Bucket: Sample template showing how to create a privately accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "Properties": {} } }, "Outputs": { "BucketName": { "Value": { "Ref": "S3Bucket" }, "Description": "Name of Amazon S3 bucket to hold website content" } } }

    Template ini memungkinkanAWS CloudFormationuntuk membuat bucket S3 yang dapat digunakan olehAWS Service Catalog.

  2. UnggahS3_template.jsonfile keAWS CodeCommitrepositori.

Langkah 2: Membuat produk diAWS Service Catalog

  1. Sebagai administrator TI, masuk keAWS Service Catalogkonsol, pergi keProdukhalaman, dan kemudian pilihUnggah produk baru.

  2. PadaUnggah produk baruhalaman, selesaikan hal berikut:

    1. MasukNama Produk, masukkan nama yang ingin Anda gunakan untuk produk baru Anda.

    2. MasukDeskripsi, masukkan deskripsi katalog produk. Deskripsi ini ditampilkan dalam daftar produk untuk membantu pengguna dalam memilih produk yang benar.

    3. MasukDisediakan oleh, masukkan nama departemen IT atau administrator Anda.

    4. Pilih Selanjutnya.

  3. (Opsional)Masukkan detail dukungan, masukkan informasi kontak untuk dukungan produk, dan pilihSelanjutnya.

  4. MasukRincian versi, selesaikan hal berikut:

    1. PilihMengunggah file templat. MenjelajahiS3_template.jsonfile dan meng-upload.

    2. MasukJudul versi, masukkan nama versi produk (misalnya,devops S3 v2).

    3. MasukDeskripsi, masukkan rincian yang membedakan versi ini dari versi lain.

    4. Pilih Selanjutnya.

  5. PadaTinjauhalaman, verifikasi bahwa informasi sudah benar, lalu pilihBuat.

  6. PadaProdukhalaman, di browser, salin URL produk baru Anda. Ini berisi ID Produk. Menyalin dan mempertahankan ID produk ini. Anda menggunakannya ketika Anda membuat pipa Anda di CodePipeline.

    Berikut adalah URL untuk produk bernamamy-product. Untuk mengekstrak ID produk, salin nilai antara tanda sama (=) dan ampersand (&). Dalam contoh ini, ID produkprod-example123456.

    https://<region-URL>/servicecatalog/home?region=<region>#/admin-products?productCreated=prod-example123456&createdProductTitle=my-product
    catatan

    Salin URL untuk produk Anda sebelum Anda menavigasi jauh dari halaman. Setelah Anda menavigasi jauh dari halaman ini, Anda harus menggunakan CLI untuk mendapatkan ID produk Anda.

    Setelah beberapa detik, produk Anda muncul diProdukhalaman. Mungkin Anda perlu menyegarkan peramban untuk melihat produk dalam daftar.

Langkah 3: Membuat alur Anda

  1. Untuk memberi nama pipa Anda dan pilih parameter untuk pipa Anda, lakukan hal berikut:

    1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttps://console.aws.amazon.com/codepipeline/.

    2. PilihMemulai. PilihMembuat alur, dan kemudian masukkan nama untuk alur Anda.

    3. MasukPeran layanan, pilihPeran layanan baruuntuk memungkinkan CodePipeline untuk membuat peran layanan di IAM.

    4. Biarkan pengaturan di bawahPengaturan lanjutandi default mereka, dan kemudian memilihSelanjutnya.

  2. Untuk menambahkan tahap sumber, lakukan hal berikut:

    1. MasukPenyedia Sumber, pilihAWS CodeCommit.

    2. MasukNama repositoridanNama cabang, masukkan repositori dan cabang yang ingin Anda gunakan untuk tindakan sumber Anda.

    3. Pilih Selanjutnya.

  3. MasukTambahkan tahap, pilihLewati tahap, dan kemudian menerima pesan peringatan dengan memilihLewatilagi.

  4. MasukTambahkan tahap, selesaikan hal berikut:

    1. MasukDeploy Provider, pilihAWSService Catalog.

    2. Untuk konfigurasi penyebaran, pilihMasukkan konfigurasi deployment.

    3. MasukID Produk, tempelkan ID produk yang Anda salin dariAWS Service Catalogkonsol.

    4. MasukJalur file templat, masukkan path relatif tempat file template disimpan.

    5. MasukTipe produk, pilihAWS CloudFormationtemplat.

    6. MasukNama versi Produk, masukkan nama versi produk yang Anda tentukanAWS Service Catalog. Jika Anda ingin mengubah template dikerahkan ke versi produk baru, masukkan nama versi produk yang belum digunakan untuk versi produk sebelumnya dalam produk yang sama.

    7. Untukartefak Masukan, pilih artefak masukan sumber.

    8. Pilih Selanjutnya.

  5. MasukTinjau, tinjau pengaturan alur Anda, lalu pilihBuat.

  6. Setelah pipeline Anda berjalan dengan sukses, pada tahap penyebaran, pilihRincian. Ini membuka produk Anda diAWS Service Catalog.

    
              Lihat alur AndaAWS Service Catalogdeploy tahap
  7. Di bawah informasi produk Anda, pilih nama versi Anda untuk membuka template produk. Lihat penyebaran template.

Langkah 4: Dorong perubahan dan verifikasi produk AndaAWS Service Catalog

  1. Lihat pipeline Anda di konsol CodePipeline, dan pada tahap sumber Anda, pilihRincian. Sumber AndaAWS CodeCommitrepositori terbuka di konsol. PilihMengedit, dan membuat perubahan dalam file (misalnya, untuk deskripsi).

    "Description": "Name of Amazon S3 bucket to hold and version website content"
  2. Komit dan dorong perubahan Anda. Pipeline Anda dimulai setelah Anda mendorong perubahan. Ketika menjalankan pipa selesai, pada tahap penyebaran, pilihRincianuntuk membuka produk AndaAWS Service Catalog.

  3. Di bawah informasi produk Anda, pilih nama versi baru untuk membuka template produk. Lihat perubahan template yang dikerahkan.

Opsi 2: Deploy keAWS Service Catalogmenggunakan file konfigurasi

Dalam contoh ini, Anda mengunggah sampelAWS CloudFormationfile template untuk bucket S3, dan kemudian buat produk AndaAWS Service Catalog. Anda juga mengunggah file konfigurasi terpisah yang menentukan konfigurasi penyebaran Anda. Selanjutnya, Anda membuat pipa Anda dan menentukan lokasi file konfigurasi Anda.

Langkah 1: Upload file template sampel ke repositori sumber

  1. Buka editor teks. Buat contoh template dengan menempelkan berikut ke dalam file. Simpan file sebagai S3_template.json.

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "CloudFormation Sample Template S3_Bucket: Sample template showing how to create a privately accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "Properties": {} } }, "Outputs": { "BucketName": { "Value": { "Ref": "S3Bucket" }, "Description": "Name of Amazon S3 bucket to hold website content" } } }

    Template ini memungkinkanAWS CloudFormationuntuk membuat bucket S3 yang dapat digunakan olehAWS Service Catalog.

  2. UnggahS3_template.jsonfile keAWS CodeCommitrepositori.

Langkah 2: Buat file konfigurasi penyebaran produk Anda

  1. Buka editor teks. Buat file konfigurasi untuk produk Anda. File konfigurasi digunakan untuk menentukanAWS Service Catalogparameter deployment parameter/preferensi. Anda menggunakan file ini ketika Anda membuat alur Anda.

    Sampel ini menyediakanProductVersionNamedari “devops S3 v2" danProductVersionDescriptiondariMyProductVersionDescription. Jika Anda ingin mengubah template dikerahkan ke versi produk baru, cukup masukkan nama versi produk yang belum digunakan untuk versi produk sebelumnya dalam produk yang sama.

    Simpan file sebagai sample_config.json.

    { "SchemaVersion": "1.0", "ProductVersionName": "devops S3 v2", "ProductVersionDescription": "MyProductVersionDescription", "ProductType": "CLOUD_FORMATION_TEMPLATE", "Properties": { "TemplateFilePath": "/S3_template.json" } }

    File ini membuat informasi versi produk untuk Anda setiap kali pipa Anda berjalan.

  2. Unggahsample_config.jsonfile keAWS CodeCommitrepositori. Pastikan Anda meng-upload file ini ke repositori sumber Anda.

Langkah 3: Membuat produk diAWS Service Catalog

  1. Sebagai administrator TI, masuk keAWS Service Catalogkonsol, pergi keProdukhalaman, dan kemudian pilihUnggah produk baru.

  2. PadaUnggah produk baruhalaman, selesaikan hal berikut:

    1. MasukNama Produk, masukkan nama yang ingin Anda gunakan untuk produk baru Anda.

    2. MasukDeskripsi, masukkan deskripsi katalog produk. Deskripsi ini muncul dalam daftar produk untuk membantu pengguna dalam memilih produk yang benar.

    3. MasukDisediakan oleh, masukkan nama departemen IT atau administrator Anda.

    4. Pilih Selanjutnya.

  3. (Opsional)Masukkan detail dukungan, masukkan informasi kontak dukungan produk, dan kemudian pilihSelanjutnya.

  4. MasukDetail versi, selesaikan hal berikut:

    1. PilihMengunggah file templat. JelajahiS3_template.jsonfile dan meng-upload.

    2. MasukJudul versi, masukkan nama versi produk (misalnya, “devops S3 v2").

    3. MasukDeskripsi, masukkan rincian yang membedakan versi ini dari versi lain.

    4. Pilih Selanjutnya.

  5. Pada halaman Tinjauan, verifikasi bahwa informasi sudah benar, lalu pilih Konfirmasi dan unggah.

  6. PadaProdukhalaman, di browser, salin URL produk baru Anda. Ini berisi ID Produk. Menyalin dan mempertahankan ID produk ini. Anda gunakan saat membuat pipa Anda di CodePipeline.

    Berikut adalah URL untuk produk bernamamy-product. Untuk mengekstrak ID produk, salin nilai antara tanda sama (=) dan ampersand (&). Dalam contoh ini, ID produkprod-example123456.

    https://<region-URL>/servicecatalog/home?region=<region>#/admin-products?productCreated=prod-example123456&createdProductTitle=my-product
    catatan

    Salin URL untuk produk Anda sebelum Anda menavigasi jauh dari halaman. Setelah Anda menavigasi jauh dari halaman ini, Anda harus menggunakan CLI untuk mendapatkan ID produk Anda.

    Setelah beberapa detik, produk Anda muncul diProdukhalaman. Mungkin Anda perlu menyegarkan peramban untuk melihat produk dalam daftar.

Langkah 4: Membuat alur Anda

  1. Untuk memberi nama pipa Anda dan pilih parameter untuk pipa Anda, lakukan hal berikut:

    1. Masuk keAWS Management Consoledan buka konsol CodePipeline dihttps://console.aws.amazon.com/codepipeline/.

    2. PilihMemulai. PilihMembuat alur, lalu masukkan nama untuk pipeline Anda.

    3. MasukPeran layanan, pilihPeran layanan baruuntuk memungkinkan CodePipeline untuk membuat peran layanan di IAM.

    4. Biarkan pengaturan di bawahPengaturan lanjutandi default mereka, dan kemudian memilihSelanjutnya.

  2. Untuk menambahkan tahap sumber, lakukan hal berikut:

    1. MasukPenyedia sumber, pilihAWS CodeCommit.

    2. MasukNama repositoridanNama cabang, masukkan repositori dan cabang yang ingin Anda gunakan untuk tindakan sumber Anda.

    3. Pilih Selanjutnya.

  3. MasukTambahkan tahap, pilihLewati tahap, dan kemudian menerima pesan peringatan dengan memilihLewatilagi.

  4. MasukTambahkan tahap, selesaikan hal berikut:

    1. MasukDeploy Provider, pilihAWSService Catalog.

    2. PilihGunakan file konfigurasi.

    3. MasukID Produk, tempelkan ID produk yang Anda salin dariAWS Service Catalogkonsol.

    4. MasukJalur file, masukkan path file dari file konfigurasi di repositori Anda.

    5. Pilih Selanjutnya.

  5. MasukTinjau, tinjau pengaturan alur Anda, lalu pilihBuat.

  6. Setelah pipeline berjalan dengan sukses, pada tahap penyebaran Anda, pilihRincianuntuk membuka produk AndaAWS Service Catalog.

    
              Lihat alur AndaAWS Service Catalogdeploy tahap
  7. Di bawah informasi produk Anda, pilih nama versi Anda untuk membuka template produk. Lihat penyebaran template.

Langkah 5: Dorong perubahan dan verifikasi produk Anda di Service Catalog

  1. Lihat pipeline Anda di konsol CodePipeline, dan pada tahap sumber, pilihRincian. Sumber AndaAWS CodeCommitrepositori terbuka di konsol. PilihMengedit, dan kemudian membuat perubahan dalam file (misalnya, untuk deskripsi).

    "Description": "Name of Amazon S3 bucket to hold and version website content"
  2. Komit dan dorong perubahan Anda. Pipeline Anda dimulai setelah Anda mendorong perubahan. Ketika menjalankan pipa selesai, pada tahap penyebaran, pilihRincianuntuk membuka produk AndaAWS Service Catalog.

  3. Di bawah informasi produk Anda, pilih nama versi baru untuk membuka template produk. Lihat perubahan template yang dikerahkan.