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

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

 AWS Serverless Application Model Command Line Interface (AWS SAM CLI) mengemas AWS SAM aplikasi.

Perintah ini membuat `.zip` file kode dan dependensi Anda, dan mengunggah file ke Amazon Simple Storage Service (Amazon S3). AWS SAM memungkinkan enkripsi untuk semua file yang disimpan di Amazon S3. Kemudian mengembalikan salinan AWS SAM template Anda, menggantikan referensi ke artefak lokal dengan lokasi Amazon S3 tempat perintah mengunggah artefak.

Secara default ketika Anda menggunakan perintah ini, AWS SAMCLI mengasumsikan bahwa direktori kerja Anda saat ini adalah direktori root proyek Anda. Yang AWS SAMCLI pertama mencoba menemukan file template yang dibangun menggunakan [sam build](sam-cli-command-reference-sam-build.md) perintah, yang terletak di `.aws-sam` subfolder, dan diberi nama`template.yaml`. Selanjutnya, AWS SAMCLI mencoba untuk menemukan file template bernama `template.yaml` atau `template.yml` di direktori kerja saat ini. Jika Anda menentukan `--template` opsi, AWS SAMCLI perilaku default diganti, dan hanya akan mengemas AWS SAM templat itu dan sumber daya lokal yang ditunjuknya.

**catatan**  
[sam deploy](sam-cli-command-reference-sam-deploy.md) sekarang secara implisit melakukan fungsionalitas dari `sam package`. Anda dapat menggunakan perintah [sam deploy](sam-cli-command-reference-sam-deploy.md) langsung ke paket dan men-deploy aplikasi Anda.

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

```
$ sam package <arguments> <options>
```

## Pendapat
<a name="sam-cli-command-reference-sam-package-args"></a>

**ID Sumber Daya**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
ID fungsi Lambda ke paket.  
Argumen ini opsional. Jika aplikasi Anda berisi satu fungsi Lambda, AWS SAM CLI akan mengemasnya. Jika aplikasi Anda berisi beberapa fungsi, berikan ID fungsi untuk mengemas satu fungsi.  
*Nilai yang valid*: ID logis sumber daya atau ARN sumber daya.

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

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-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-package-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).

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

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Membatalkan file yang ada di bucket Amazon S3. Tentukan bendera ini untuk mengunggah artefak bahkan jika artefak tersebut cocok dengan artefak yang ada di bucket Amazon S3.

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

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

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-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 opsi ini tidak ditentukan, maka AWS SAM gunakan kunci enkripsi yang dikelola Amazon S3.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Opsional) Peta metadata yang akan dilampirkan ke semua artefak yang direferensikan dalam templat Anda.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Jangan tampilkan baris progres saat mengunggah artefak ke Amazon S3.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Jalur ke file tempat perintah menulis templat terkemas. Jika Anda tidak menentukan jalur, perintah menulis templat ke output standar.

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

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

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Buat bucket Amazon S3 secara otomatis untuk digunakan untuk pengemasan. Jika Anda menentukan `--resolve-s3` opsi `--s3-bucket` dan opsi, maka kesalahan akan terjadi.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Nama bucket Amazon S3 tempat perintah ini mengunggah artefak Anda. Jika artefak Anda lebih besar dari 51.200 byte, maka opsi `--s3-bucket` atau opsi diperlukan. `--resolve-s3` Jika Anda menentukan `--resolve-s3` opsi `--s3-bucket` dan opsi, maka kesalahan akan terjadi.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Prefiks yang ditambahkan ke nama artefak diunggah ke bucket Amazon S3. Nama prefiks adalah nama jalur (nama folder) untuk bucket Amazon S3. Ini hanya berlaku untuk fungsi yang dilaporkan dengan tipe paket `Zip`.

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

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Opsional) Daftar profil penandatanganan untuk menandatangani paket deployment Anda. Parameter ini mengambil daftar pasangan kunci-nilai, dengan penjeasan kunci adalah nama fungsi atau lapisan untuk menandatangani, dan nilai adalah profil penandatanganan, dengan pemilik profil opsional yang terbatasi `:`. Misalnya, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

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

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Output JSON untuk CloudFormation template. YAML digunakan secara default.

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

Contoh berikut membuat dan mengemas artefak untuk fungsi CodeDeploy dan aplikasi Lambda. Artefak diunggah ke bucket Amazon S3. Output dari perintah adalah file baru bernama`package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```