Menggunakan variabel lingkungan dalam aplikasi Amplify - AWS Amplify Hosting
Amplify referensi variabel lingkunganVariabel lingkungan kerangka kerja frontend

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

Menggunakan variabel lingkungan dalam aplikasi Amplify

Variabel lingkungan adalah pasangan nilai kunci yang dapat Anda tambahkan ke pengaturan aplikasi Anda untuk membuatnya tersedia untuk Amplify Hosting. Sebagai praktik terbaik, Anda dapat menggunakan variabel lingkungan untuk mengekspos data konfigurasi aplikasi. Semua variabel lingkungan yang Anda tambahkan dienkripsi untuk mencegah akses nakal.

Amplify memberlakukan batasan berikut pada variabel lingkungan yang Anda buat.

  • Amplify tidak memungkinkan Anda membuat nama variabel lingkungan dengan awalan. AWS Awalan ini dicadangkan untuk Amplify penggunaan internal saja.

  • Nilai variabel lingkungan tidak dapat melebihi 5500 karakter.

penting

Jangan gunakan variabel lingkungan untuk menyimpan rahasia. Untuk aplikasi Gen 2, gunakan fitur manajemen Rahasia di konsol Amplify. Untuk informasi selengkapnya, lihat Rahasia dan vars lingkungan di Amplify Documentation. Untuk aplikasi Gen 1, simpan rahasia dalam rahasia lingkungan yang dibuat menggunakan AWS Systems Manager Parameter Store. Untuk informasi selengkapnya, lihat Mengelola rahasia lingkungan.

Amplify referensi variabel lingkungan

Variabel lingkungan berikut dapat diakses secara default dalam konsol Amplify.

Nama variabel Deskripsi Nilai contoh

_BUILD_TIMEOUT

Durasi batas waktu build dalam menit.

Nilai minimum adalah 5.

Nilai maksimumnya adalah 120.

30

_LIVE_UPDATES

Alat akan ditingkatkan ke versi terbaru.

[{"name":"Amplify CLI","pkg":"@aws-amplify/cli","type":"npm","version":"latest"}]

USER_DISABLE_TESTS

Langkah pengujian dilewati selama pembuatan. Anda dapat menonaktifkan pengujian untuk semua cabang atau cabang tertentu di aplikasi.

Variabel lingkungan ini digunakan untuk aplikasi yang melakukan pengujian selama fase build. Untuk informasi selengkapnya tentang pengaturan variabel ini, lihatMematikan pengujian untuk aplikasi atau cabang Amplify.

true

AWS_APP_ID

ID aplikasi build saat ini

abcd1234

AWS_BRANCH

Nama cabang build saat ini

main, develop, beta, v2.0

AWS_BRANCH_ARN

Cabang Amazon Resource Name (ARN) dari build saat ini

aws:arn:amplify:us-west-2:123456789012:appname/branch/...

AWS_CLONE_URL

URL klon yang digunakan untuk mengambil isi repositori git

git@github.com:<user-name>/<repo-name>.git

AWS_COMMIT_ID

ID komit dari build saat ini

“KEPALA” untuk rebuild

abcd1234

AWS_JOB_ID

ID tugas build saat ini.

ID tugas mencakup beberapa ‘0’ yang ditambahkan sehingga panjangnya selalu sama.

0000000001

AWS_PULL_REQUEST_ID

ID permintaan tarik dari build pratinjau web permintaan tarik.

Variabel lingkungan ini tidak tersedia saat digunakan AWS CodeCommit sebagai penyedia repositori Anda.

1

AWS_PULL_REQUEST_SOURCE_BRANCH

Nama cabang fitur untuk pratinjau permintaan tarik yang dikirimkan ke cabang aplikasi di konsol Amplify.

featureA

AWS_PULL_REQUEST_DESTINATION_BRANCH

Nama cabang aplikasi di konsol Amplify tempat permintaan tarik cabang fitur dikirimkan.

main

AMPLIFY_AMAZON_CLIENT_ID

ID klien Amazon

123456

AMPLIFY_AMAZON_CLIENT_SECRET

Rahasia klien Amazon

example123456

AMPLIFY_FACEBOOK_CLIENT_ID

ID klien Facebook

123456

AMPLIFY_FACEBOOK_CLIENT_SECRET

Rahasia klien Facebook

example123456

AMPLIFY_GOOGLE_CLIENT_ID

ID klien Google

123456

AMPLIFY_GOOGLE_CLIENT_SECRET

Rahasia klien Google

example123456

AMPLIFY_DIFF_DEPLOY

Mengaktifkan atau menonaktifkan deployment frontend berbasis diff. Untuk informasi selengkapnya, lihat Mengonfigurasi pembuatan dan penerapan frontend berbasis diff.

true

AMPLIFY_DIFF_DEPLOY_ROOT

Path yang digunakan untuk perbandingan deployment frontend berbasis diff, bergantung pada root repositori.

dist

AMPLIFY_DIFF_BACKEND

Aktifkan atau nonaktifkan build backend berbasis diff. Ini hanya berlaku untuk aplikasi Gen 1. Untuk informasi selengkapnya, silakan lihat Mengonfigurasi build backend berbasis diff untuk aplikasi Gen 1

true

AMPLIFY_BACKEND_PULL_ONLY

Amplify mengelola variabel lingkungan ini. Ini hanya berlaku untuk aplikasi Gen 1. Untuk informasi selengkapnya, silakan lihat Mengedit frontend yang ada agar mengarah ke backend berbeda

true

AMPLIFY_BACKEND_APP_ID

Amplify mengelola variabel lingkungan ini. Ini hanya berlaku untuk aplikasi Gen 1. Untuk informasi selengkapnya, silakan lihat Mengedit frontend yang ada agar mengarah ke backend berbeda

abcd1234

AMPLIFY_SKIP_BACKEND_BUILD

Jika Anda tidak memiliki bagian backend dalam spesifikasi build dan ingin menonaktifkan build backend, setel variabel lingkungan ini ke. true Ini hanya berlaku untuk aplikasi Gen 1.

true

AMPLIFY_ENABLE_DEBUG_OUTPUT

Atur variabel ini true untuk mencetak jejak tumpukan di log. Ini berguna untuk men-debug kesalahan build backend.

true

AMPLIFY_MONOREPO_APP_ROOT

Path yang digunakan untuk menentukan root aplikasi dari aplikasi monorepo, bergantung pada root repositori.

apps/react-app

AMPLIFY_USERPOOL_ID

ID untuk kumpulan pengguna Amazon Cognito yang diimpor untuk autentikasi

us-west-2_example

AMPLIFY_WEBCLIENT_ID

ID untuk klien aplikasi yang akan digunakan oleh aplikasi web

Klien aplikasi harus dikonfigurasi dengan akses ke kumpulan pengguna Amazon Cognito yang ditentukan oleh variabel lingkungan AMPLIFY_USERPOOL_ID.

123456

AMPLIFY_NATIVECLIENT_ID

ID untuk klien aplikasi yang akan digunakan oleh aplikasi asli

Klien aplikasi harus dikonfigurasi dengan akses ke kumpulan pengguna Amazon Cognito yang ditentukan oleh variabel lingkungan AMPLIFY_USERPOOL_ID.

123456

AMPLIFY_IDENTITYPOOL_ID

ID untuk kumpulan identitas Amazon Cognito

example-identitypool-id

AMPLIFY_PERMISSIONS_BOUNDARY_ARN

ARN untuk kebijakan IAM untuk digunakan sebagai batas izin yang berlaku untuk semua peran IAM yang dibuat oleh Amplify.

arn:aws:iam::123456789012:policy/example-policy

AMPLIFY_DESTRUCTIVE_UPDATES

Setel variabel lingkungan ini ke true untuk memungkinkan GraphQL API diperbarui dengan operasi skema yang berpotensi menyebabkan kehilangan data.

true
catatan

Variabel AMPLIFY_AMAZON_CLIENT_ID dan AMPLIFY_AMAZON_CLIENT_SECRET lingkungan adalah OAuth token, bukan kunci AWS akses dan kunci rahasia.

Variabel lingkungan kerangka kerja frontend

Jika Anda mengembangkan aplikasi dengan kerangka kerja frontend yang mendukung variabel lingkungannya sendiri, penting untuk dipahami bahwa ini tidak sama dengan variabel lingkungan yang Anda konfigurasikan di konsol Amplify. Misalnya, React (dengan prefiks REACT_APP) dan Gatsby (dengan prefiks GATSBY) memungkinkan Anda untuk membuat variabel lingkungan waktu aktif yang diintegrasikan secara otomatis ke dalam build produksi frontend Anda oleh kerangka kerja tersebut. Guna memahami efek penggunaan variabel lingkungan ini untuk menyimpan nilai, lihat dokumentasi terkait kerangka kerja frontend yang Anda gunakan.

Menyimpan nilai sensitif, seperti kunci API, di dalam variabel lingkungan dengan prefiks kerangka kerja frontend bukanlah praktik terbaik dan sangat tidak dianjurkan. Untuk contoh penggunaan variabel lingkungan waktu build Amplify untuk tujuan ini, lihatMengakses variabel lingkungan pada waktu pembuatan.