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

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model `sam local pipeline bootstrap` subperintah Command Line Interface (AWS SAMCLI).

Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)

`sam pipeline bootstrap`Subperintah menghasilkan sumber daya AWS infrastruktur yang diperlukan untuk terhubung ke sistem CI/CD Anda. Langkah ini harus dijalankan untuk setiap tahap penerapan di pipeline Anda sebelum menjalankan **sam pipeline init** perintah.

Subperintah ini menyiapkan sumber daya AWS infrastruktur berikut:
+ Opsi untuk mengonfigurasi izin pipa melalui:
  + Pengguna IAM pipeline dengan ID kunci akses dan kredenal akses kunci rahasia untuk dibagikan dengan sistem. CI/CD 
**catatan**  
Kami merekomendasikan memutar kunci akses secara teratur. Untuk informasi selengkapnya, lihat [Memutar kunci akses secara teratur untuk kasus penggunaan yang memerlukan kredensil jangka panjang](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials) di Panduan Pengguna *IAM*.
  +  CI/CD Platform yang didukung melalui OIDC. Untuk pengenalan tentang penggunaan OIDC dengan AWS SAM pipeline, buka. [Cara menggunakan otentikasi OIDC dengan pipeline AWS SAM](deploying-with-oidc.md)
+ Peran CloudFormation eksekusi IAM diasumsikan oleh CloudFormation untuk menyebarkan aplikasi. AWS SAM 
+ Ember Amazon S3 untuk menampung artefak. AWS SAM 
+ Opsional, repositori citra Amazon ECR untuk menahan paket deployment Lambda citra kontainer (jika Anda memiliki sumber daya dari tipe paket `Image`).

## Penggunaan
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Opsi
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 UUID dari repositori Bitbucket. Opsi ini khusus untuk menggunakan Bitbucket OIDC untuk izin.  
Nilai ini dapat ditemukan di https://bitbucket.org/*workspace*/*repository*/admin/addon/admin/pipelines/openid-connect 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
ARN dari ember Amazon S3 yang menampung artefak. AWS SAM 

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
 CI/CD Platform untuk AWS SAM pipa.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
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-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
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](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Path dan nama file dari file konfigurasi yang berisi nilai parameter default yang akan digunakan. Nilai default-nya adalah `samconfig.toml` di root direktori proyek. Untuk informasi selengkapnya tentang file konfigurasi, lihat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Prompt untuk mengonfirmasi penyebaran sumber daya Anda.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Tentukan apakah akan membuat repositori citra Amazon ECR jika tidak ada yang disediakan. Repositori Amazon ECR menyimpan gambar kontainer fungsi Lambda, atau lapisan yang memiliki jenis paket. `Image` Nilai default-nya `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Mengaktifkan logging debug dan mencetak pesan debug yang AWS SAMCLI dihasilkan, dan untuk menampilkan stempel waktu.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Nama cabang tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
 GitHub Organisasi tempat repositori milik. Jika tidak ada organisasi, masukkan nama pengguna pemilik repositori. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Nama GitHub repositori tempat penerapan akan terjadi. Opsi ini khusus untuk menggunakan GitHub Actions OIDC untuk izin.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
 GitLab Grup tempat repositori milik. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Nama GitLab proyek. Opsi ini khusus untuk menggunakan GitLab OIDC untuk izin.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
ARN dari repositori gambar Amazon ECR yang menyimpan gambar kontainer fungsi Lambda, atau lapisan yang memiliki jenis paket. `Image` Jika tersedia, opsi `--create-image-repository` diabaikan. Jika tidak disediakan dan `--create-image-repository` ditentukan, perintah membuat satu.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Nonaktifkan prompt interaktif untuk parameter bootstrap dan gagal jika ada parameter yang diperlukan yang hilang. Nilai default-nya adalah `--interactive`. Untuk perintah ini, `--stage` adalah satu-satunya parameter yang diperlukan.  
Jika `--no-interactive` ditentukan bersama dengan`--use-oidc-provider`, semua parameter yang diperlukan untuk penyedia OIDC Anda harus disertakan.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
ID klien dikonfigurasi untuk digunakan dengan penyedia OIDC Anda.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Nama CI/CD penyedia yang akan digunakan untuk izin OIDC. GitLab, GitHub, dan Bitbucket didukung.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
URL untuk penyedia OIDC. Nilai harus dimulai dengan**https://**.

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Pilih penyedia izin untuk mengambil peran eksekusi pipeline. Nilai default-nya adalah **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
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-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
Nama Sumber Daya Amazon (ARN) dari pengguna IAM memiliki ID kunci akses dan kunci akses rahasia yang dibagikan dengan sistem. CI/CD Ini digunakan untuk memberikan izin pengguna IAM ini untuk mengakses AWS akun yang sesuai. Jika tidak disediakan, perintah akan membuat pengguna IAM bersama dengan ID kunci akses dan kredenal kunci akses rahasia.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Profil spesifik dari file kredensialmu yang mendapat AWS kredensialnya.

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
 AWS Wilayah untuk dikerahkan ke. Misalnya, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Simpan parameter yang Anda berikan pada baris perintah ke file AWS SAM konfigurasi.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Nama tahap deployment yang sesuai. Ini digunakan sebagai akhiran untuk sumber daya AWS infrastruktur yang dibuat.

## Pemecahan masalah
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Kesalahan: Parameter yang diperlukan tidak ada
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

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
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

Contoh berikut membuat AWS sumber daya yang diperlukan untuk membuat CI/CD sistem Anda, dan mengaktifkan pencatatan debug dan mencetak pesan debug yang dihasilkan oleh AWS SAMCLI: menggunakan peristiwa yang dihasilkan untuk pengujian lokal dengan menggunakan `s3.json` peristiwa untuk menjalankan fungsi Lambda secara lokal

```
$ sam pipeline bootstrap --debug
```