Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
bootstrap alur sam
Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model Antarmuka Baris Perintah (AWS SAM CLI) sam local pipeline bootstrap subkomando.
Untuk pengantar AWS SAM CLI, lihat Apa itu AWS SAM CLI?
Yang sam pipeline bootstrap subcommand menghasilkan yang diperlukan AWS sumber daya infrastruktur untuk terhubung ke Anda CI/CD sistem. Langkah ini harus dijalankan untuk setiap tahap penerapan dalam pipeline Anda sebelum menjalankan sam pipeline init perintah.
Subperintah ini mengatur yang berikut AWS sumber daya infrastruktur:
-
Opsi untuk mengonfigurasi izin pipeline melalui:
-
Pengguna IAM pipeline dengan ID kunci akses dan kredensional akses kunci rahasia untuk dibagikan dengan CI/CD sistem.
catatanKami merekomendasikan memutar kunci akses secara teratur. Untuk informasi lebih lanjut, lihat Putar kunci akses secara teratur untuk kasus penggunaan yang memerlukan kredenSIAL jangka panjang di Panduan Pengguna IAM.
-
Didukung CI/CD platform melalui OIDC. Untuk pengenalan tentang penggunaan OIDC dengan AWS SAM pipa, pergi ke Cara menggunakan otentikasi OIDC dengan pipeline AWS SAM.
-
-
Sebuah CloudFormation eksekusi peran IAM diasumsikan oleh CloudFormation untuk menyebarkan AWS SAM aplikasi.
-
Ember Amazon S3 untuk menampung AWS SAM artefak.
-
Opsional, repositori citra Amazon ECR untuk menahan paket deployment Lambda citra kontainer (jika Anda memiliki sumber daya dari tipe paket
Image).
Jangan lari sam pipeline bootstrap dengan file konfigurasi yang tidak tepercaya. Penyedia OIDC file dan pengaturan izin menentukan siapa yang dapat mengambil peran IAM yang dibuat oleh perintah ini.
Penggunaan
$sam pipeline bootstrap<options>
Opsi
--bitbucket-repo-uuidTEXT-
UUID repositori Bitbucket. Opsi ini khusus untuk menggunakan Bitbucket OIDC untuk izin.
catatanNilai ini dapat ditemukan di https://bitbucket.org/
workspace/repository/admin/addon/admin/pipelines/sambungkan --bucketTEXT-
ARN dari bucket Amazon S3 yang menampung AWS SAM artefak.
--cicd-providerTEXT-
The CI/CD platform untuk AWS SAM pipa.
--cloudformation-execution-roleTEXT-
ARN dari peran IAM yang akan diasumsikan oleh CloudFormation saat menerapkan tumpukan aplikasi. Berikan hanya jika Anda ingin menggunakan peran Anda sendiri. Jika tidak, perintah akan membuat peran baru.
--config-envTEXT-
Nama lingkungan yang menentukan nilai parameter default dalam file konfigurasi yang akan digunakan. Nilai default-nya adalah
default. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi. --config-filePATH-
Path dan nama file dari file konfigurasi yang berisi nilai parameter default untuk digunakan. Nilai default-nya adalah
samconfig.tomldi root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat AWS SAMCLIberkas konfigurasi. --confirm-changeset | --no-confirm-changeset-
Minta untuk mengkonfirmasi penyebaran sumber daya Anda.
--create-image-repository | --no-create-image-repository-
Tentukan apakah akan membuat repositori citra Amazon ECR jika tidak ada yang disediakan. Repositori Amazon ECR menyimpan gambar wadah Lambda Event Functions, atau lapisan yang memiliki jenis paket
Image. Nilai default-nya--no-create-image-repository. --debug-
Mengaktifkan pencatatan debug dan mencetak pesan debug yang AWS SAM CLI menghasilkan, dan untuk menampilkan stempel waktu.
--deployment-branchTEXT-
Nama cabang tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Tindakan OIDC untuk izin.
--github-orgTEXT-
Yang GitHub organisasi tempat repositori milik. Jika tidak ada organisasi, masukkan nama pengguna pemilik repositori. Opsi ini khusus untuk menggunakan GitHub Tindakan OIDC untuk izin.
--github-repoTEXT-
Nama GitHub repositori tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Tindakan OIDC untuk izin.
--gitlab-groupTEXT-
Yang GitLab kelompok tempat repositori milik. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.
--gitlab-projectTEXT-
Yang GitLab nama proyek. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.
--help, -h-
Menunjukkan pesan ini dan keluar.
--image-repositoryTEXT-
ARN dari repositori gambar Amazon ECR yang menyimpan gambar wadah fungsi Lambda, atau lapisan yang memiliki jenis paket
Image. Jika tersedia, opsi--create-image-repositorydiabaikan. Jika tidak disediakan dan--create-image-repositoryditentukan, perintah membuat satu. --interactive | --no-interactive-
Nonaktifkan permintaan interaktif untuk parameter bootstrap dan gagal jika ada parameter yang diperlukan yang hilang. Nilai default-nya adalah
--interactive. Untuk perintah ini,--stageadalah satu-satunya parameter yang diperlukan.catatanJika
--no-interactiveDitentukan bersama dengan--use-oidc-provider, semua parameter yang diperlukan untuk penyedia OIDC Anda harus disertakan. --oidc-client-idTEXT-
ID klien dikonfigurasi untuk digunakan dengan penyedia OIDC Anda.
--oidc-provider[github-actions | gitlab | bitbucket-pipelines]-
Nama CI/CD penyedia yang akan digunakan untuk izin OIDC. GitLab, GitHub, dan Bitbucket didukung.
--oidc-provider-urlTEXT-
URL untuk penyedia OIDC. Nilai harus dimulai dengan
https://. --permissions-provider[oidc | iam]-
Pilih penyedia izin untuk mengambil peran eksekusi pipeline. Nilai default-nya adalah
iam. --pipeline-execution-roleTEXT-
ARN IAM role yang akan diterima oleh pengguna alur untuk beroperasi pada tahap ini. Berikan hanya jika Anda ingin menggunakan peran Anda sendiri. Jika tidak disediakan, perintah ini akan membuat peran baru.
--pipeline-userTEXT-
Nama Sumber Daya Amazon (ARN) dari pengguna IAM yang memiliki ID kunci akses dan kunci akses rahasia yang dibagikan dengan CI/CD sistem. Ini digunakan untuk memberikan izin pengguna IAM ini untuk mengakses yang sesuai AWS akun. Jika tidak disediakan, perintah akan membuat pengguna IAM bersama dengan ID kunci akses dan kredenSIAL kunci akses rahasia.
--profileTEXT-
Profil spesifik dari file kredensi Anda yang didapat AWS kredenSIAL.
--regionTEXT-
Yang AWS Wilayah untuk digunakan. Misalnya,
us-east-1. --save-params-
Simpan parameter yang Anda berikan di baris perintah ke AWS SAM file konfigurasi.
--stageTEXT-
Nama tahap deployment yang sesuai. Ini digunakan sebagai akhiran untuk yang dibuat AWS sumber daya infrastruktur.
Pemecahan Masalah
Kesalahan: Parameter yang diperlukan hilang
Kapan --no-interactive Ditentukan bersama dengan --use-oidc-provider dan salah satu parameter yang diperlukan tidak disediakan, pesan kesalahan ini akan ditampilkan bersama dengan deskripsi parameter yang hilang.
Contoh
Contoh berikut menciptakan AWS sumber daya yang dibutuhkan untuk membuat CI/CD sistem, dan mengaktifkan pencatatan debug dan mencetak pesan debug yang dihasilkan oleh AWS SAM CLI: menggunakan peristiwa yang dihasilkan untuk pengujian lokal dengan menggunakan s3.json acara untuk memanggil fungsi Lambda secara lokal
$sam pipeline bootstrap --debug