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

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

Halaman ini memberikan informasi referensi untuk AWS Serverless Application Model perintah Command Line Interface (AWS SAMCLI)`sam sync`.
+ Untuk pengantar AWS SAMCLI, lihat [Apa itu AWS SAMCLI?](what-is-sam-overview.md#what-is-sam-cli)
+ Untuk dokumentasi tentang penggunaan AWS SAMCLI, lihat[AWS SAM CLI](using-sam-cli.md).

`sam sync`Perintah menyinkronkan perubahan aplikasi lokal ke file. AWS Cloud

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

```
$ sam sync <options>
```

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

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Selesaikan jalur relatif ke fungsi atau kode sumber lapisan sehubungan dengan direktori ini. Gunakan opsi ini untuk mengubah cara jalur relatif ke folder kode sumber diselesaikan. Secara default, jalur relatif diselesaikan sehubungan dengan lokasi AWS SAM template.  
Selain sumber daya dalam aplikasi root atau tumpukan yang Anda buat, opsi ini juga berlaku untuk aplikasi atau tumpukan bersarang. Selain itu, opsi ini berlaku untuk jenis dan properti sumber daya berikut:  
+ Tipe sumber daya: Properti `AWS::Serverless::Function`: `CodeUri`
+ Tipe sumber daya: Atribut Sumber Daya`AWS::Serverless::Function`: Entri `Metadata`: `DockerContext`
+ Tipe sumber daya: Properti `AWS::Serverless::LayerVersion`: `ContentUri`
+ Tipe sumber daya: Properti `AWS::Lambda::Function`: `Code`
+ Tipe sumber daya: Properti `AWS::Lambda::LayerVersion`: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
URI untuk [gambar kontainer](serverless-image-repositories.md#serverless-image-repository-uris) yang ingin Anda gunakan saat membangun aplikasi Anda. Secara default, AWS SAM menggunakan URI repositori gambar kontainer dari Amazon [Elastic Container Registry (Amazon ECR) Registry ECR) Public.](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) Tentukan opsi ini untuk menggunakan gambar yang berbeda.  
Anda dapat menggunakan opsi ini beberapa kali dalam satu perintah. Setiap opsi menerima string atau pasangan kunci-nilai.  
+ **String** - Tentukan URI gambar kontainer yang akan digunakan semua sumber daya dalam aplikasi Anda. Berikut ini adalah contohnya:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Pasangan nilai kunci** - Tentukan nama sumber daya sebagai kunci dan URI gambar kontainer yang akan digunakan dengan sumber daya itu sebagai nilai. Gunakan format ini untuk menentukan URI gambar kontainer yang berbeda untuk setiap sumber daya dalam aplikasi Anda. Berikut ini adalah contohnya:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Menyediakan `--build-in-source` untuk membangun proyek Anda langsung di folder sumber.  
`--build-in-source`Opsi ini mendukung runtime dan metode build berikut:  
+ **Runtime** - Setiap Node.js runtime yang didukung oleh opsi. `sam init --runtime`
+ **Membangun metode** —`Makefile`,`esbuild`.
`--build-in-source`Opsi ini tidak kompatibel dengan opsi berikut:  
+ `--use-container `
*Default*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Daftar kemampuan yang Anda tentukan untuk memungkinkan CloudFormation untuk membuat tumpukan tertentu. Beberapa templat tumpukan mungkin menyertakan sumber daya yang dapat memengaruhi izin di Anda Akun AWS. Misalnya, dengan membuat pengguna baru AWS Identity and Access Management (IAM). Tentukan opsi ini untuk mengganti nilai default. Nilai-nilai yang valid meliputi:  
+ KEMAMPUAN\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ CAPABILITY\$1RESOURCE\$1POLICY
+ CAPABILITY\$1AUTO\$1EXPAND
*Default*: `CAPABILITY_NAMED_IAM` dan `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
Secara default, AWS SAM sinkronisasi semua sumber daya dalam aplikasi Anda. Tentukan opsi ini untuk menyinkronkan hanya sumber daya kode, yang meliputi yang berikut ini:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Untuk menyinkronkan sumber daya kode, AWS SAM gunakan AWS layanan APIs secara langsung, alih-alih AWS CloudFormation menerapkannya. Untuk memperbarui CloudFormation tumpukan Anda, jalankan **sam sync --watch** atau**sam deploy**.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-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-sync-options-config-file"></a>
Jalur 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).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Menentukan apakah untuk memisahkan dependensi fungsi individu ke lapisan lain untuk mempercepat proses sinkronisasi.  
*Default*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Nama repositori Amazon Elastic Container Registry (Amazon ECR) tempat perintah ini mengunggah citra fungsi Anda. Diperlukan untuk fungsi yang dilaporkan dengan tipe paket `Image`.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Pemetaan fungsi ke URI repositori Amazon ECR mereka. Fungsi referensi dengan ID logisnya. Berikut ini adalah contohnya:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Anda dapat menentukan opsi ini beberapa kali dalam satu perintah.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
ID kunci AWS Key Management Service (AWS KMS) yang digunakan untuk mengenkripsi artefak yang diam di bucket Amazon S3. Jika Anda tidak menentukan opsi ini, AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Peta metadata untuk dilampirkan ke semua artefak yang Anda referensikan di template Anda.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Daftar ARNs topik Amazon Simple Notification Service (Amazon SNS) CloudFormation yang terkait dengan tumpukan.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Opsi yang memungkinkan Anda menggunakan toolkit IDE untuk mengatur perilaku default.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan kunci-nilai. Gunakan format yang sama dengan AWS Command Line Interface (AWS CLI). AWS SAMCLIFormatnya adalah kunci eksplisit dan kata kunci nilai, setiap penggantian dipisahkan oleh spasi. Berikut adalah dua contoh:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Menentukan jenis sumber daya untuk sinkronisasi. Untuk menyinkronkan beberapa sumber daya, Anda dapat menentukan opsi ini beberapa kali. Opsi ini didukung dengan `--code` opsi. Nilai harus menjadi salah satu sumber daya yang terdaftar di bawah`--code`. Misalnya, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Menentukan ID sumber daya untuk disinkronkan. Untuk menyinkronkan beberapa sumber daya, Anda dapat menentukan opsi ini beberapa kali. Opsi ini didukung dengan `--code` opsi. Misalnya, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
Nama Sumber Daya Amazon (ARN) dari peran IAM yang CloudFormation diasumsikan saat menerapkan kumpulan perubahan.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Nama bucket Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3) tempat perintah ini mengunggah template Anda. CloudFormation Jika template Anda lebih besar dari 51.200 byte, maka opsi `--s3-bucket` atau `--resolve-s3` opsi diperlukan. Jika Anda menentukan opsi `--s3-bucket` dan `--resolve-s3` opsi, maka terjadi kesalahan.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Awalan ditambahkan ke nama artefak yang Anda unggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3. Ini hanya berlaku untuk fungsi yang dideklarasikan dengan jenis `Zip` paket.

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

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Menentukan `--skip-deploy-sync` untuk melewati sinkronisasi infrastruktur awal jika tidak diperlukan. Ini AWS SAMCLI akan membandingkan AWS SAM template lokal Anda dengan CloudFormation template yang diterapkan dan melakukan penerapan hanya jika perubahan terdeteksi.  
Menentukan `--no-skip-deploy-sync` untuk melakukan CloudFormation penyebaran setiap kali `sam sync` dijalankan.  
Untuk mempelajari selengkapnya, lihat [Lewati CloudFormation penerapan awal](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Default*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Nama CloudFormation tumpukan untuk aplikasi Anda.  
Opsi ini diperlukan.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Daftar tag untuk dikaitkan dengan tumpukan yang dibuat atau diperbarui. CloudFormation juga menyebarkan tag ini ke sumber daya di tumpukan yang mendukungnya.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
Path dan nama file tempat AWS SAM template Anda berada.  
Jika Anda menentukan opsi ini, maka AWS SAM gunakan hanya templat dan sumber daya lokal yang ditunjukkannya.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Jika fungsi Anda bergantung pada paket yang memiliki dependensi yang dikompilasi secara native, gunakan opsi ini untuk membangun fungsi Anda di dalam wadah -like. AWS LambdaDocker  
Saat ini, opsi ini tidak kompatibel dengan`--dependency-layer`. Jika Anda menggunakan `--use-container` dengan`--dependency-layer`, AWS SAMCLI menginformasikan Anda dan melanjutkan dengan`--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Memulai proses yang mengawasi aplikasi lokal Anda untuk perubahan dan secara otomatis menyinkronkannya ke file. AWS Cloud Secara default, ketika Anda menentukan opsi ini, AWS SAM menyinkronkan semua sumber daya dalam aplikasi Anda saat Anda memperbaruinya. Dengan opsi ini, AWS SAM melakukan CloudFormation penyebaran awal. Kemudian, AWS SAM menggunakan AWS layanan APIs untuk memperbarui sumber daya kode. AWS SAM digunakan CloudFormation untuk memperbarui sumber daya infrastruktur saat Anda memperbarui AWS SAM template Anda.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Mengecualikan file atau folder agar tidak diamati untuk perubahan file. Untuk menggunakan opsi ini, juga `--watch` harus disediakan.  
Opsi ini menerima pasangan kunci-nilai:  
+ **Kunci** — ID logis dari fungsi Lambda dalam aplikasi Anda.
+ **Nilai** - Nama file atau folder terkait untuk dikecualikan.
Saat Anda memperbarui file atau folder apa pun yang ditentukan dengan `--watch-exclude` opsi, tidak AWS SAM CLI akan memulai sinkronisasi. Namun, ketika pembaruan ke file atau folder lain memulai sinkronisasi, file atau folder ini akan disertakan dalam sinkronisasi itu.  
Anda dapat memberikan opsi ini beberapa kali dalam satu perintah.

## Contoh
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Untuk contoh tentang menggunakan perintah ini, lihat[Opsi untuk perintah sinkronisasi sam](using-sam-cli-sync.md#using-sam-cli-sync-options).