Opsi 1: Menyebarkan ke Service Catalog tanpa file konfigurasi Opsi 2: Menyebarkan ke Service Catalog menggunakan file konfigurasi

Tutorial: Membuat pipeline yang menyebarkan ke Service Catalog

Service Catalog memungkinkan Anda untuk membuat dan menyediakan produk berdasarkanAWS CloudFormation template. Tutorial ini menunjukkan cara membuat dan mengonfigurasi alur untuk men-deploy templat produk Anda ke Service Catalog dan menyampaikan perubahan yang telah Anda buat di repositori sumber Anda (sudah Amazon S3). GitHub CodeCommit

catatan

Jika 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 gagal.

Pertama, Anda membuat produk di Service Catalog, dan kemudian Anda membuat pipeline diAWS CodePipeline. Tutorial ini menyediakan dua pilihan untuk menyiapkan konfigurasi men-deploy:

Buat produk di Service Catalog dan upload file template ke repositori sumber Anda. Menyediakan versi produk dan konfigurasi penyebaran di CodePipeline konsol (tanpa file konfigurasi terpisah). Lihat Opsi 1: Menyebarkan ke Service Catalog tanpa file konfigurasi.

catatan
File templat dapat dibuat dalam format YAKL atau JSON.
Buat produk di Service Catalog dan upload file template ke repositori sumber Anda. Menyediakan versi produk dan konfigurasi penyebaran dalam file konfigurasi terpisah. Lihat Opsi 2: Menyebarkan ke Service Catalog menggunakan file konfigurasi.

Opsi 1: Menyebarkan ke Service Catalog tanpa file konfigurasi

Dalam contoh ini, Anda mengunggah fileAWS CloudFormation template sampel untuk bucket S3, dan kemudian membuat produk Anda di Service Catalog. Selanjutnya, Buatlah alur Anda dan tentukan konfigurasi men-deploy di CodePipeline konsol.

Langkah 1: Unggah file template sampel ke repositori sumber

Buka editor teks. Buat contoh template dengan menempelkan berikut ini 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 CloudFormation untuk membuat bucket S3 yang dapat digunakan oleh Service Catalog.

UnggahS3_template.json file keAWS CodeCommit repositori Anda.

Langkah 2: Buat Produk di Service Catalog

Sebagai administrator TI, masuk ke konsol Service Catalog, buka halaman Produk, lalu pilih Unggah produk baru.
Pada halaman Upload produk baru, lengkapi hal-hal berikut:
1. Di Nama Produk, masukkan nama yang ingin Anda gunakan untuk produk baru Anda.
2. Dalam Deskripsi, masukkan deskripsi katalog produk. Deskripsi ini ditampilkan dalam daftar produk untuk membantu pengguna dalam memilih produk yang benar.
3. Di Disediakan oleh, masukkan nama departemen atau administrator Anda.
4. Pilih Selanjutnya.
(Opsional) Di Masukkan detail dukungan, masukkan informasi kontak untuk dukungan produk, dan pilih Berikutnya.
Dalam Detail versi, lengkapi yang berikut ini:
1. Pilih Mengunggah file templat. JelajahiS3_template.json file Anda dan unggah.
2. Dalam Judul versi, masukkan nama versi produk (misalnya,devops S3 v2).
3. Di Deskripsi, masukkan detail yang membedakan versi ini dari versi lain.
4. Pilih Selanjutnya.
Pada halaman Tinjau, verifikasi bahwa informasinya benar, lalu pilih Buat.
Pada halaman Produk, di browser, salin URL produk baru Anda. Ini berisi ID Produk. Salin dan simpan 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 produk adalahprod-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 dari halaman ini, Anda harus menggunakan CLI untuk mendapatkan ID produk Anda.

Setelah beberapa detik, produk akan muncul di halaman Produk. Mungkin Anda perlu menyegarkan peramban untuk melihat produk dalam daftar.

Langkah 3: Buat alur Anda

Untuk memberi nama pipeline Anda dan memilih parameter untuk pipeline Anda, lakukan hal berikut:
1. Masuk keAWS Management Console dan buka CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.
2. Pilih Memulai. Pilih Buat alur, dan kemudian masukkan nama untuk alur Anda.
3. Dalam peran Layanan, pilih Peran layanan baru untuk memungkinkan CodePipeline untuk membuat peran layanan dalam IAM.
4. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, lalu pilih Berikutnya.
Untuk menambahkan tahap sumber, lakukan hal berikut:
1. Di Penyedia sumber, pilih AWS CodeCommit.
2. Di Nama repositori dan nama cabang, masukkan repositori dan cabang yang ingin Anda gunakan untuk tindakan sumber Anda.
3. Pilih Selanjutnya.
Di Tambahkan tahap, pilih Lewati tahap pembuatan, pilih Lewati tahap pembuatan, pilih Lewati lagi.
Pada tahap Add deploy, selesaikan hal berikut:
1. Di Penyebaran penyedia, pilih AWS Service Catalog.
2. Untuk konfigurasi penerapan, pilih Masukkan konfigurasi penyebaran.
3. Di ID Produk, tempel ID produk yang Anda salin dari konsol Service Catalog.
4. Di jalur file Template, masukkan path relatif tempat file template disimpan.
5. Di Jenis produk, pilih AWS CloudFormationtemplate.
6. Di Nama versi produk, masukkan nama versi produk yang Anda tentukan di Service Catalog. Jika Anda ingin mengubah template diterapkan ke versi produk baru, masukkan nama versi produk yang belum digunakan untuk versi produk sebelumnya dalam produk yang sama.
7. Untuk artefak Input, pilih artefak input sumber.
8. Pilih Selanjutnya.
Di Tinjau, tinjau pengaturan pipeline Anda, lalu pilih Buat.
Setelah pipeline Anda berjalan dengan sukses, pada tahap penyebaran, pilih Detail. Ini membuka produk Anda di Service Catalog.
Di bawah informasi produk Anda, pilih nama versi Anda untuk membuka template produk. Lihat penyebaran template.

Langkah 4: Mendorong perubahan dan memverifikasi produk Anda di Service Catalog

Lihat pipeline Anda di CodePipeline konsol, dan pada tahap sumber Anda, pilih Detail. AWS CodeCommitRepositori sumber Anda terbuka di konsol. Pilih Edit, dan buat perubahan pada file (misalnya, ke deskripsi).
```
"Description": "Name of Amazon S3 bucket to hold and version website content"
```
Tetapkan dan ajukan perubahan Anda. alur Anda dimulai setelah Anda mendorong perubahan. Saat menjalankan pipeline selesai, pada tahap penyebaran, pilih Detail untuk membuka produk Anda di Service Catalog.
Di bawah informasi produk Anda, pilih nama versi baru untuk membuka template produk. Lihat perubahan template yang diterapkan.

Opsi 2: Menyebarkan ke Service Catalog menggunakan file konfigurasi

Dalam contoh ini, Anda mengunggah fileAWS CloudFormation template sampel untuk bucket S3, dan kemudian membuat produk Anda di Service Catalog. Anda juga mengunggah file konfigurasi terpisah yang menentukan konfigurasi penerapan Anda. Selanjutnya, Anda membuat pipeline dan menentukan lokasi file konfigurasi Anda.

Langkah 1: Unggah file template sampel ke repositori sumber

Buka editor teks. Buat contoh template dengan menempelkan berikut ini 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 CloudFormation untuk membuat bucket S3 yang dapat digunakan oleh Service Catalog.

UnggahS3_template.json file keAWS CodeCommit repositori Anda.

Langkah 2: Buat file konfigurasi men-deploy produk

Buka editor teks. Buat file konfigurasi untuk produk Anda. File konfigurasi digunakan untuk menentukan parameter/preferensi penyebaran Service Catalog Anda. Anda menggunakan file ini ketika membuat alur Anda.

Sampel ini menyediakanProductVersionName “devops S3 v2" dan aProductVersionDescription dariMyProductVersionDescription. Jika Anda ingin memiliki perubahan template diterapkan 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 pipeline Anda berjalan.
Unggahsample_config.json file keAWS CodeCommit repositori Anda. Pastikan Anda mengunggah file ini ke repositori sumber Anda.

Langkah 3: Buat Produk di Service Catalog

Sebagai administrator TI, masuk ke konsol Service Catalog, buka halaman Produk, lalu pilih Unggah produk baru.
Pada halaman Upload produk baru, lengkapi hal-hal berikut:
1. Di Nama Produk, masukkan nama yang ingin Anda gunakan untuk produk baru Anda.
2. Dalam Deskripsi, masukkan deskripsi katalog produk. Deskripsi ini muncul di daftar produk untuk membantu pengguna dalam memilih produk yang benar.
3. Di Disediakan oleh, masukkan nama departemen atau administrator Anda.
4. Pilih Selanjutnya.
(Opsional) Di Masukkan detail dukungan, masukkan informasi kontak dukungan produk, lalu pilih Berikutnya.
Dalam Detail versi, lengkapi yang berikut ini:
1. Pilih Mengunggah file templat. JelajahiS3_template.json file Anda dan unggah.
2. Di Judul versi, masukkan nama versi produk (mis.
3. Di Deskripsi, masukkan detail yang membedakan versi ini dari versi lain.
4. Pilih Selanjutnya.
Pada halaman Tinjauan, verifikasi bahwa informasi sudah benar, lalu pilih Konfirmasi dan unggah.
Pada halaman Produk, di browser, salin URL produk baru Anda. Ini berisi ID Produk. Salin dan simpan ID produk ini. Anda gunakan 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 produk adalahprod-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 dari halaman ini, Anda harus menggunakan CLI untuk mendapatkan ID produk Anda.

Setelah beberapa detik, produk akan muncul di halaman Produk. Mungkin Anda perlu menyegarkan peramban untuk melihat produk dalam daftar.

Langkah 4: Buat alur Anda

Untuk memberi nama pipeline Anda dan memilih parameter untuk pipeline Anda, lakukan hal berikut:
1. Masuk keAWS Management Console dan buka CodePipeline konsol di https://console.aws.amazon.com/codepipeline/.
2. Pilih Memulai. Pilih Buat alur, dan kemudian masukkan nama untuk alur Anda.
3. Dalam peran Layanan, pilih Peran layanan baru untuk memungkinkan CodePipeline untuk membuat peran layanan dalam IAM.
4. Biarkan pengaturan di bawah Pengaturan lanjutan pada defaultnya, lalu pilih Berikutnya.
Untuk menambahkan tahap sumber, lakukan hal berikut:
1. Di Penyedia sumber, pilih AWS CodeCommit.
2. Di Nama repositori dan nama cabang, masukkan repositori dan cabang yang ingin Anda gunakan untuk tindakan sumber Anda.
3. Pilih Selanjutnya.
Di Tambahkan tahap, pilih Lewati tahap pembuatan, pilih Lewati tahap pembuatan, pilih Lewati lagi.
Pada tahap Add deploy, selesaikan hal berikut:
1. Di Penyebaran penyedia, pilih AWS Service Catalog.
2. Pilih Gunakan file konfigurasi.
3. Di ID Produk, tempel ID produk yang Anda salin dari konsol Service Catalog.
4. Di jalur file konfigurasi, masukkan path file file konfigurasi di repositori Anda.
5. Pilih Selanjutnya.
Di Tinjau, tinjau pengaturan pipeline Anda, lalu pilih Buat.
Setelah pipeline berjalan dengan sukses, pada tahap penerapan Anda, pilih Detail untuk membuka produk Anda di Service Catalog.
Di bawah informasi produk Anda, pilih nama versi Anda untuk membuka template produk. Lihat penyebaran template.

Langkah 5: Mendorong perubahan dan memverifikasi produk Anda di Service Catalog

Lihat pipeline Anda di CodePipeline konsol, dan pada tahap sumber, pilih Detail. AWS CodeCommitRepositori sumber Anda terbuka di konsol. Pilih Edit, lalu buat perubahan pada file (misalnya, ke deskripsi).
```
"Description": "Name of Amazon S3 bucket to hold and version website content"
```
Tetapkan dan ajukan perubahan Anda. alur Anda dimulai setelah Anda mendorong perubahan. Saat menjalankan pipeline selesai, pada tahap penyebaran, pilih Detail untuk membuka produk Anda di Service Catalog.
Di bawah informasi produk Anda, pilih nama versi baru untuk membuka template produk. Lihat perubahan template yang diterapkan.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Tutorial: Menguji aplikasi iOS denganAWS Device Farm

Tutorial: Buat alur denganAWS CloudFormation