Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Menyinkronkan produk ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
AWS Service Catalog memungkinkan Anda untuk menyinkronkan produk ke file template yang dikelola melalui penyedia repositori eksternal. AWS Service Catalog mengacu pada produk dengan jenis koneksi template ini sebagai produk yang disinkronkan dengan GIT. Opsi repositori termasuk GitHub, GitHub Enterprise, atau Bitbucket. Setelah Anda mengotorisasi akun repositori eksternal, Anda dapat membuat AWS Service Catalog produk baru atau memperbarui produk yang ada untuk disinkronkan ke file templat di repositori. Akun AWS Ketika perubahan dilakukan pada file template dan dilakukan dalam repositori (misalnya, menggunakan git-push), AWS Service Catalog secara otomatis mendeteksi perubahan dan membuat versi produk baru (artefak).
Topik
- Izin yang diperlukan untuk menyinkronkan produk ke file template eksternal
- Buat koneksi akun
- Melihat koneksi produk yang disinkronkan dengan Git
- Memperbarui koneksi produk yang disinkronkan dengan Git
- Menghapus koneksi produk yang disinkronkan dengan Git
- Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
- Wilayah AWS dukungan untuk produk yang disinkronkan dengan GIT
Izin yang diperlukan untuk menyinkronkan produk ke file template eksternal
Anda dapat menggunakan kebijakan berikut AWS Identity and Access Management (IAM) sebagai templat untuk memungkinkan AWS Service Catalog administrator menyinkronkan produk ke file templat dari repositori eksternal. Kebijakan ini mencakup izin yang diperlukan dari keduanya CodeConnections dan AWS Service Catalog. AWS Service Catalog merekomendasikan agar Anda menyalin kebijakan templat di bawah ini, dan juga menggunakan kebijakan AWS Service Catalog AWSServiceCatalogAdminFullAccess
terkelola saat mengaktifkan produk yang disinkronkan dengan repositori.
{ "Version": "2012-10-17", "Statement": [ { "Sid": "CodeStarAccess", "Effect": "Allow", "Action": [ "codestar-connections:UseConnection", "codestar-connections:PassConnection", "codestar-connections:CreateConnection", "codestar-connections:DeleteConnection", "codestar-connections:GetConnection", "codestar-connections:ListConnections", "codestar-connections:ListInstallationTargets", "codestar-connections:GetInstallationUrl", "codestar-connections:StartOAuthHandshake", "codestar-connections:UpdateConnectionInstallation", "codestar-connections:GetIndividualAccessToken" ], "Resource": "arn:aws:codestar-connections:*:*:connection/*" }, { "Sid": "CreateSLR", "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/sync.servicecatalog.amazonaws.com/AWSServiceRoleForServiceCatalogArtifactSync", "Condition": { "StringLike": { "iam:AWSServiceName": "sync.servicecatalog.amazonaws.com" } } } ] }
Buat koneksi akun
Sebelum menyinkronkan file template ke AWS Service Catalog produk, Anda harus membuat dan mengotorisasi koneksi satu kali. account-to-account Anda menggunakan koneksi ini untuk menentukan detail repositori yang berisi file template yang diinginkan. Anda dapat membuat koneksi menggunakan AWS Service Catalog konsol, CodeConnections konsol, AWS Command Line Interface (CLI), atau CodeConnections API.
Setelah membuat koneksi, Anda dapat menggunakan AWS Service Catalog konsol, AWS Service Catalog API, atau CLI untuk membuat produk yang disinkronkan AWS Service Catalog . AWS Service Catalog administrator dapat membuat produk baru atau memperbarui AWS Service Catalog produk yang ada berdasarkan file template di repositori dan cabang. Jika perubahan dilakukan di repositori, AWS Service Catalog secara otomatis mendeteksi perubahan dan membuat versi produk baru. Versi produk sebelumnya dipertahankan hingga batas versi yang ditentukan dan diberi status usang.
Selain itu, AWS Service Catalog secara otomatis membuat peran terkait layanan (SLR) setelah koneksi dibuat. SLR ini memungkinkan AWS Service Catalog untuk mendeteksi setiap perubahan file template yang berkomitmen ke repositori. SLR juga memungkinkan AWS Service Catalog untuk secara otomatis membuat versi produk baru untuk produk yang disinkronkan. Untuk informasi selengkapnya tentang izin dan fungsionalitas SLR, lihat Peran terkait layanan untuk. AWS Service Catalog
Untuk membuat produk baru yang disinkronkan dengan GIT
-
Di panel navigasi kiri, pilih Daftar produk, lalu pilih Buat produk.
-
Masukkan detail Produk.
-
Di Detail versi, pilih Tentukan repositori kode Anda menggunakan AWS CodeStar penyedia, lalu pilih tautan Buat AWS CodeStar koneksi baru.
-
Setelah Anda membuat koneksi, segarkan daftar koneksi, lalu pilih koneksi baru. Tentukan detail repositori, termasuk jalur file repositori, cabang, dan templat.
Untuk informasi tentang penggunaan file konfigurasi Terraform, lihat. Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
-
(Opsional saat membuat sumber daya AWS Service Catalog produk baru) Di bagian Detail Dukungan, tambahkan metadata untuk produk.
-
(Opsional saat membuat sumber daya AWS Service Catalog produk baru) Di bagian Tag, pilih Tambahkan tag baru dan masukkan pasangan Kunci dan Nilai.
-
-
Pilih Buat produk baru.
Untuk membuat beberapa produk yang disinkronkan dengan GIT
-
Di panel navigasi kiri AWS Service Catalog konsol, pilih Daftar produk, lalu pilih Buat beberapa produk yang dikelola oleh git.
-
Masukkan detail produk umum.
-
Di detail repositori eksternal, pilih AWS CodeStar koneksi, lalu tentukan repositori dan cabang.
-
Di panel Tambahkan produk, masukkan jalur file Template dan Nama produk. Pilih Tambahkan item baru dan lanjutkan menambahkan produk sesuai keinginan.
-
Setelah menambahkan semua produk yang diinginkan, pilih Massal membuat produk.
Untuk menghubungkan AWS Service Catalog produk yang ada ke repositori eksternal
-
Di panel navigasi kiri AWS Service Catalog konsol, pilih Daftar produk, lalu pilih Connect products to an external repository.
-
Pada halaman Pilih produk, pilih produk yang ingin Anda sambungkan ke repositori eksternal, lalu pilih Berikutnya.
-
Pada halaman Tentukan detail sumber, pilih AWS CodeStar koneksi yang ada, lalu tentukan repositori, cabang, dan jalur file templat.
-
Pilih Berikutnya.
-
Pada halaman Tinjau dan kirim, verifikasi detail koneksi, lalu pilih Connect products ke repositori eksternal.
Melihat koneksi produk yang disinkronkan dengan Git
Anda dapat menggunakan AWS Service Catalog konsol, API, atau AWS CLI untuk melihat detail koneksi repositori. Untuk AWS Service Catalog produk yang ditautkan ke file template, Anda dapat mengambil informasi tentang koneksi repositori dan terakhir kali template disinkronkan dengan produk dari Status Sinkronisasi Terakhir.
catatan
Anda dapat melihat informasi repositori dan Status Sinkronisasi Terakhir di tingkat produk. Pengguna harus memiliki izin IAM di CodeConnections API untuk melihat detail repositori. Lihat Izin yang diperlukan untuk menyinkronkan AWS Service Catalog produk ke file templat untuk informasi selengkapnya tentang kebijakan yang diperlukan untuk izin IAM ini.
Untuk melihat detail koneksi dan repositori menggunakan AWS Management Console
-
Di panel navigasi kiri, pilih Daftar produk.
-
Pilih produk dari daftar.
-
Pada halaman Produk, navigasikan ke bagian Detail sumber produk.
-
Untuk melihat ID revisi sumber untuk versi produk, pilih tautan Versi terakhir yang dibuat. Bagian Detail versi menampilkan ID revisi sumber.
Untuk melihat detail koneksi dan repositori menggunakan AWS CLI
Dari AWS CLI, jalankan perintah berikut:
$ aws servicecatalog describe-product-as-admin
$ aws servicecatalog describe-provisioning-artifact
$ aws servicecatalog search-product-as-admin
$ aws servicecatalog list-provisioning-artifacts
Memperbarui koneksi produk yang disinkronkan dengan Git
Anda dapat memperbarui koneksi akun yang ada dan produk yang disinkronkan dengan GIT menggunakan AWS Service Catalog konsol, AWS Service Catalog API, atau. AWS CLI
Untuk mempelajari cara menghubungkan AWS Service Catalog produk yang sudah ada ke file template, lihat Membuat koneksi produk baru yang disinkronkan dengan GIT.
Untuk memperbarui produk yang ada ke produk yang disinkronkan dengan GIT
-
Di panel navigasi kiri, pilih Daftar produk, lalu pilih salah satu opsi berikut:
-
Untuk memperbarui satu produk, pilih produk, navigasikan ke bagian Detail sumber produk, lalu pilih Edit detail.
-
Untuk memperbarui beberapa produk, pilih Connect products ke repositori eksternal, pilih hingga sepuluh produk, lalu pilih Next.
-
-
Di bagian Detail sumber produk, lakukan pembaruan berikut:
-
Tentukan koneksi.
-
Tentukan repositori.
-
Tentukan cabang.
-
Beri nama file template.
-
-
Pilih Simpan perubahan.
catatan
Untuk produk yang belum terhubung ke repositori eksternal, Anda dapat menggunakan opsi Connect to an external repository yang ditampilkan di peringatan di bagian atas halaman info produk setelah memilih produk.
Anda juga dapat menggunakan AWS Service Catalog konsol atau AWS CLI to
-
Connect AWS Service Catalog produk yang sudah ada ke file template di repositori eksternal
-
Perbarui metadata produk, termasuk nama produk, deskripsi, dan tag.
-
Konfigurasi ulang (perbarui sinkronisasi untuk menggunakan sumber repositori yang berbeda) koneksi untuk produk yang terhubung sebelumnya. AWS Service Catalog
Untuk memperbarui detail koneksi dan repositori menggunakan konsol AWS Service Catalog
-
Di panel navigasi kiri AWS Service Catalog konsol, pilih Daftar produk, lalu pilih produk yang saat ini terhubung ke repositori eksternal.
-
Di bagian Detail sumber produk, pilih Edit sumber produk.
-
Di bagian Detail sumber produk, tentukan repositori baru yang diinginkan.
-
Pilih Simpan perubahan.
Untuk memperbarui koneksi dan detail repositori menggunakan AWS CLI
Dari AWS CLI run the $ aws servicecatalog update-product
and $ aws servicecatalog update-provisioning-artifact
command.
Menghapus koneksi produk yang disinkronkan dengan Git
Anda dapat menghapus koneksi antara AWS Service Catalog produk dan file template menggunakan AWS Service Catalog konsol, CodeConnections API, atau file AWS CLI. Saat Anda memutuskan sambungan produk dari file templat, produk yang disinkronkan akan beralih ke AWS Service Catalog produk yang dikelola secara teratur. Setelah memutuskan sambungan produk, jika file template diubah dan dilakukan di repositori yang terhubung sebelumnya, perubahan tidak tercermin. Untuk menghubungkan kembali AWS Service Catalog produk ke file template di repositori eksternal, lihat Memperbarui koneksi dan produk yang disinkronkan. AWS Service Catalog
Untuk memutuskan sambungan produk yang disinkronkan dengan GIT menggunakan konsol AWS Service Catalog
-
Dalam AWS Management Console, pilih Daftar produk dari panel navigasi kiri.
-
Pilih produk dari daftar.
-
Pada halaman Produk, navigasikan ke bagian Detail sumber produk.
-
Pilih Putuskan sambungan.
-
Konfirmasikan tindakan, lalu pilih Putuskan sambungan.
Untuk memutuskan sambungan produk yang disinkronkan dengan GIT menggunakan AWS CLI
Dari AWS CLI, jalankan $ aws servicecatalog update-product
perintah. Dalam ConnectionParameters
input, hapus koneksi yang ditentukan.
Untuk menghapus koneksi menggunakan CodeConnections API atau AWS CLI
Di CodeConnections API atau AWS CLI, jalankan $ aws codestar-connections delete-connection
perintah.
Menyinkronkan produk Terraform ke file template dari GitHub, GitHub Enterprise, atau Bitbucket
Saat membuat produk yang disinkronkan GIT menggunakan file konfigurasi Terraform, jalur file hanya menerima format tar.gz. Format folder Terraform tidak diterima di jalur file.