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

# Mengkonfigurasi AWS SAMCLI
<a name="using-sam-cli-configure"></a>

Salah satu manfaatnya AWS SAM adalah mengoptimalkan waktu pengembang dengan menghapus tugas yang berulang. AWS SAMCLItermasuk file konfigurasi bernama `samconfig` untuk tujuan ini. Secara default, tidak ada konfigurasi yang AWS SAMCLI diperlukan, tetapi Anda dapat memperbarui file konfigurasi Anda untuk memungkinkan Anda menjalankan perintah dengan parameter yang lebih sedikit dengan memungkinkan AWS SAM untuk mereferensikan parameter khusus Anda dalam file konfigurasi Anda. Contoh dalam tabel berikut menunjukkan bagaimana Anda dapat mengoptimalkan perintah Anda:


| Asal | Dioptimalkan dengan `samconfig` | 
| --- | --- | 
| **sam build --cached --parallel --use-containers** | **sam build** | 
| **sam local invoke --env-vars locals.json** | **sam local invoke** | 
| **sam local start-api --env-vars locals.json --warm-containers EAGER** | **sam local start-api** | 

 AWS SAMCLIIni menyediakan seperangkat perintah untuk membantu pengembang membuat, mengembangkan, dan menyebarkan aplikasi tanpa server. Masing-masing perintah ini dapat dikonfigurasi dengan bendera opsional berdasarkan preferensi aplikasi dan pengembang. Untuk informasi selengkapnya, lihat [AWS SAMCLIkonten di GitHub](https://github.com/aws/aws-sam-cli)

Topik di bagian ini menunjukkan cara membuat [AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md) dan menyesuaikan pengaturan defaultnya untuk mengoptimalkan waktu pengembangan untuk aplikasi tanpa server Anda.

**Topics**
+ [Cara membuat file konfigurasi Anda (`samconfig`file)](#using-sam-cli-configure-create)
+ [Konfigurasikan pengaturan proyek](#using-sam-cli-configure-project)
+ [Konfigurasikan kredensil dan pengaturan dasar](#using-sam-cli-configure-basic)

## Cara membuat file konfigurasi Anda (`samconfig`file)
<a name="using-sam-cli-configure-create"></a>

File AWS SAMCLI konfigurasi (nama file`samconfig`) adalah file teks yang biasanya menggunakan struktur TOMB, tetapi juga bisa dalam YAMB. Saat menggunakan Template Mulai AWS Cepat, file ini dibuat saat Anda menjalankan **sam init** perintah. Anda dapat memperbarui file ini saat Anda menyebarkan aplikasi menggunakan **sam deploy -\$1-guided** perintah.

Setelah penyebaran selesai, `samconfig` file berisi profil bernama `default` jika Anda menggunakan nilai default. Saat Anda menjalankan kembali **deploy** perintah, AWS SAM terapkan pengaturan konfigurasi yang disimpan dari profil ini.

Manfaat dari `samconfig` file ini adalah AWS SAM menyimpan pengaturan konfigurasi untuk perintah lain yang tersedia selain perintah deploy. Di luar nilai-nilai yang dibuat pada penerapan baru, ada sejumlah atribut yang dapat Anda atur dalam `samconfig` file yang dapat menyederhanakan aspek lain dari alur kerja pengembang. AWS SAMCLI

## Konfigurasikan pengaturan proyek
<a name="using-sam-cli-configure-project"></a>

Anda dapat menentukan pengaturan khusus proyek, seperti nilai parameter AWS SAMCLI perintah, dalam file konfigurasi yang akan digunakan dengan. AWS SAMCLI Untuk informasi selengkapnya tentang file konfigurasi ini, lihat[AWS SAMCLIberkas konfigurasi](serverless-sam-cli-config.md).

### Menggunakan file konfigurasi
<a name="using-sam-cli-configure-project-using"></a>

File konfigurasi disusun berdasarkan lingkungan, perintah, dan nilai parameter. Untuk informasi selengkapnya, lihat [Dasar-dasar file konfigurasi](serverless-sam-cli-config.md#serverless-sam-cli-config-basics).

**Untuk mengkonfigurasi lingkungan baru**

1. Tentukan lingkungan baru Anda di file konfigurasi Anda.

   Berikut ini adalah contoh menentukan `prod` lingkungan baru:

------
#### [ MAKAM ]

   ```
   [prod.global.parameters]
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
   ```

------

1. Tentukan nilai parameter sebagai pasangan nilai kunci di bagian parameter file konfigurasi.

   Berikut ini adalah contoh menentukan nama stack aplikasi Anda untuk `prod` lingkungan.

------
#### [ MAKAM ]

   ```
   [prod.global.parameters]
   stack_name = "prod-app"
   ```

------
#### [ YAML ]

   ```
   prod:
     global:
       parameters:
         stack_name: prod-app
   ```

------

1. Gunakan `--config-env` opsi untuk menentukan lingkungan yang akan digunakan.

   Berikut ini adalah contohnya:

   ```
   $ sam deploy --config-env "prod"
   ```

**Untuk mengkonfigurasi nilai parameter**

1. Tentukan AWS SAMCLI perintah yang ingin Anda konfigurasikan nilai parameternya. Untuk mengkonfigurasi nilai parameter untuk semua AWS SAMCLI perintah, gunakan `global` pengenal.

   Berikut ini adalah contoh menentukan nilai parameter untuk `sam deploy` perintah `default` lingkungan:

------
#### [ MAKAM ]

   ```
   [default.deploy.parameters]
   confirm_changeset = true
   ```

------
#### [ YAML ]

   ```
   default:
     deploy:
       parameters:
         confirm_changeset: true
   ```

------

   Berikut ini adalah contoh menentukan nilai parameter untuk semua AWS SAMCLI perintah di `default` lingkungan:

------
#### [ MAKAM ]

   ```
   [default.global.parameters]
   stack_name = "sam-app"
   ```

------
#### [ YAML ]

   ```
   default:
     global:
       parameters:
         stack_name: sam-app
   ```

------

1. Anda juga dapat menentukan nilai parameter dan memodifikasi file konfigurasi Anda melalui aliran AWS SAMCLI interaktif.

   Berikut ini adalah contoh aliran `sam deploy --guided` interaktif:

   ```
   $ sam deploy --guided
   
   Configuring SAM deploy
   ======================
   
       Looking for config file [samconfig.toml] :  Found
       Reading default arguments  :  Success
   
       Setting default arguments for 'sam deploy'
       =========================================
       Stack Name [sam-app]: ENTER
       AWS Region [us-west-2]: ENTER
       #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
       Confirm changes before deploy [Y/n]: n
       #SAM needs permission to be able to create roles to connect to the resources in your template
       Allow SAM CLI IAM role creation [Y/n]: ENTER
       #Preserves the state of previously provisioned resources when an operation fails
       Disable rollback [y/N]: ENTER
       HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
       Save arguments to configuration file [Y/n]: ENTER
       SAM configuration file [samconfig.toml]: ENTER
       SAM configuration environment [default]: ENTER
   ```

Untuk informasi selengkapnya, lihat [Membuat dan memodifikasi file konfigurasi](serverless-sam-cli-config.md#serverless-sam-cli-config-using).

### Contoh
<a name="using-sam-cli-configure-project-examples"></a>

#### TOMLContoh dasar
<a name="using-sam-cli-configure-project-examples-toml"></a>

Berikut ini adalah contoh file `samconfig.toml` konfigurasi:

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

#### YAMLContoh dasar
<a name="using-sam-cli-configure-project-examples-yaml"></a>

Berikut ini adalah contoh file `samconfig.yaml` konfigurasi:

```
version 0.1
default:
  global:
    parameters:
      stack_name: sam-app
  build:
    parameters:
      cached: true
      parallel: true
  deploy:
    parameters:
      capabilities: CAPABILITY_IAM
      confirm_changeset: true
      resolve_s3: true
  sync:
    parameters:
      watch: true
  local_start_api:
    parameters:
      warm_containers: EAGER
prod:
  sync:
    parameters:
      watch: false
```

## Konfigurasikan kredensil dan pengaturan dasar
<a name="using-sam-cli-configure-basic"></a>

Gunakan AWS Command Line Interface (AWS CLI) untuk mengonfigurasi pengaturan dasar seperti AWS kredensil, nama wilayah default, dan format output default. Setelah dikonfigurasi, Anda dapat menggunakan pengaturan ini dengan file AWS SAMCLI. Untuk mempelajari lebih lanjut, lihat berikut ini dari *Panduan AWS Command Line Interface Pengguna*:
+ [Dasar-dasar konfigurasi](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)
+ [Konfigurasi dan pengaturan file kredensi](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)
+ [Profil bernama untuk AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)
+ [Menggunakan profil bernama IAM Identity Center diaktifkan](https://docs.aws.amazon.com/cli/latest/userguide/sso-using-profile.html)

Untuk petunjuk penyiapan cepat, lihat[Langkah 5: Gunakan AWS CLI untuk mengkonfigurasi AWS kredensil](prerequisites.md#prerequisites-configure-credentials).