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

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

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

`sam build`Perintah menyiapkan aplikasi untuk langkah-langkah selanjutnya dalam alur kerja pengembang, seperti pengujian lokal atau penyebaran ke file. AWS Cloud

## Penggunaan
<a name="ref-sam-cli-build-usage"></a>

```
$ sam build <arguments> <options>
```

## Pendapat
<a name="ref-sam-cli-build-args"></a>

**ID Sumber Daya**  <a name="ref-sam-cli-build-args-resource-id"></a>
Tidak wajib. Instruksikan AWS SAM untuk membangun sumber daya tunggal yang dideklarasikan dalam [AWS SAM template](what-is-sam-overview.md#what-is-sam-template). Artefak build untuk sumber daya yang ditentukan akan menjadi satu-satunya yang tersedia untuk perintah berikutnya dalam alur kerja, mis. `sam package` dan `sam deploy`.

## Opsi
<a name="ref-sam-cli-build-options"></a>

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Selesaikan jalur relatif ke fungsi atau kode sumber lapisan sehubungan dengan direktori ini. Gunakan opsi ini jika Anda ingin mengubah cara jalur relatif ke folder kode sumber diselesaikan. Secara default, jalur relatif diselesaikan sehubungan dengan lokasi templat AWS SAM .  
Selain sumber daya dalam aplikasi root atau tumpukan yang sedang Anda bangun, opsi ini juga memberlakukan aplikasi atau tumpukan nest.  
Opsi ini berlaku untuk tipe sumber daya dan properti 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`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Izinkan atau tolak fitur beta.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
Jalur ke direktori tempat artefak build disimpan. Direktori ini dan semua isinya akan dihapus dengan opsi ini.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
URI dari citra kontainer yang ingin Anda tarik untuk build. Secara default, AWS SAM menarik citra kontainer dari Amazon ECR Publik. Gunakan opsi ini untuk menarik citra dari lokasi lain.  
Anda dapat menentukan opsi ini beberapa kali. Setiap instans dari opsi ini dapat mengambil baik string atau pasangan kunci-nilai. Jika Anda menentukan string, string adalah URI citra kontainer untuk digunakan untuk semua sumber daya dalam aplikasi Anda. Misalnya, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Jika Anda menentukan pasangan kunci-nilai, kuncinya adalah nama sumber daya, dan nilainya adalah URI citra kontainer untuk digunakan untuk sumber daya tersebut. Sebagai contoh, `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Dengan pasangan kunci-nilai, Anda dapat menentukan citra kontainer yang berbeda untuk sumber daya yang berbeda.  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
Berikan `--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:  
+ `--hook-name`
+ `--use-container `
*Default*: `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Mengaktifkan atau menonaktifkan build cache. Gunakan opsi ini untuk menggunakan kembali artefak build yang belum berubah dari build sebelumnya. AWS SAM mengevaluasi apakah Anda telah mengubah file apa pun di direktori proyek Anda. Secara default, build tidak di-cache. Jika `--no-cached` opsi dipanggil, itu akan mengganti `cached = true` pengaturan di samconfig.toml.  
AWS SAM tidak mengevaluasi apakah Anda telah mengubah modul pihak ketiga yang bergantung pada proyek Anda, di mana Anda belum menyediakan versi tertentu. Misalnya, jika fungsi Python Anda menyertakan `requirements.txt` file dengan entri`requests=1.x`, dan versi modul permintaan terbaru berubah dari `1.1` ke`1.2`, maka AWS SAM tidak menarik versi terbaru hingga Anda menjalankan build yang tidak di-cache.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
Direktori tempat artefak cache disimpan saat `--cached` ditentukan. Direktori cache default adalah `.aws-sam/cache`.

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

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Variabel lingkungan yang akan diteruskan ke kontainer build. Anda dapat menentukan opsi ini beberapa kali. Setiap instans opsi ini mengambil pasangan kunci-nilai, dengan penjelasan kunci adalah variabel sumber daya dan lingkungan, dan nilai adalah nilai variabel lingkungan. Sebagai contoh: `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
Nama jalur dan file dari file JSON yang berisi nilai-nilai untuk variabel lingkungan kontainer ini. Untuk informasi selengkapnya tentang file variabel lingkungan kontainer, lihat [File variabel lingkungan kontainer](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Opsi ini hanya berlaku jika opsi `--use-container` ditentukan, jika tidak akan terjadi kesalahan.

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

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Menentukan nama atau ID dari Docker jaringan yang ada yang kontainer Docker Lambda harus terhubung ke, bersama dengan jaringan jembatan default. Jika tidak ditentukan, kontainer Lambda hanya terhubung ke jaringan jembatan Docker default.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
Nama sumber daya untuk dikecualikan dari`sam build`. Misalnya, jika template Anda berisi`Function1`,`Function2`, `Function3` dan Anda menjalankan`sam build --exclude Function2`, hanya `Function1` dan `Function3` akan dibangun.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Menunjukkan pesan ini dan keluar.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
Nama hook yang digunakan untuk memperluas AWS SAMCLI fungsionalitas.  
Nilai yang diterima:`terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
Jalur ke file manifest dependensi kustom (misalnya, package.json) yang akan digunakan bukan default.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Memastikan symlink yang AWS SAMCLI selalu dipasang yang ada dalam file untuk dibangun atau dipanggil. Ini hanya berlaku untuk symlink di direktori tingkat atas (yaitu, symlink yang langsung berada di root fungsi). Secara default, symlink tidak dipasang kecuali yang diperlukan `build-in-source` untuk digunakan `node_modules` di NodeJS.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Opsi yang memungkinkan Anda menggunakan toolkit IDE untuk mengatur perilaku default. Anda juga dapat menggunakan `sam build --no-use-container` untuk menjalankan build di mesin lokal Anda alih-alih wadah docker.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Mengaktifkan build paralel. Gunakan opsi ini untuk membangun fungsi dan lapisan AWS SAM template Anda secara paralel. Secara default, fungsi dan lapisan dibangun secara berurutan.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Opsional) String yang berisi penggantian CloudFormation parameter yang dikodekan sebagai pasangan nilai kunci. Menggunakan format yang sama dengan AWS Command Line Interface (AWS CLI). Misalnya: '`ParameterKey`=`KeyPairName`, `ParameterValue` = `MyKey` `ParameterKey` =`InstanceType`, `ParameterValue` =`t1.micro`'. Opsi ini tidak kompatibel dengan`--hook-name`.

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

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
 Wilayah AWS Untuk menyebarkan ke. Misalnya, us-east-1.

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

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Melewati tahap persiapan jika tidak ada perubahan infrastruktur yang dilakukan. Gunakan dengan `--hook-name` opsi.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Menentukan apakah perintah harus melewatkan menarik ke bawah citra Docker terbaru untuk waktu aktif Lambda.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
Path dan nama file file AWS SAM template`[default: template.[yaml|yml]]`. Opsi ini tidak kompatibel dengan`--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
Jalur relatif atau absolut ke direktori tingkat atas yang berisi file Terraform konfigurasi atau kode sumber fungsi Anda. Jika file-file ini terletak di luar direktori yang berisi modul Terraform root Anda, gunakan opsi ini untuk menentukan jalur absolut atau relatifnya. Opsi ini mengharuskan `--hook-name` diatur ke`terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Jika fungsi Anda tergantung pada paket yang memiliki dependensi terkompilasi secara native, gunakan opsi ini untuk membangun fungsi Anda di dalam kontainer Docker mirip Lambda.

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

Untuk contoh terperinci dan panduan mendalam tentang penggunaan `sam build` subperintah, lihat. [Pengantar bangunan dengan AWS SAM](using-sam-cli-build.md)