Gambar build kustom dan pembaruan paket langsung

Gambar build kustom

Anda dapat menggunakan gambar build kustom untuk menyediakan lingkungan build khusus untuk aplikasi Amplify. Jika Anda memiliki dependensi tertentu yang membutuhkan waktu lama untuk diinstal selama build menggunakan container default Amplify, Anda dapat membuat image Docker Anda sendiri dan mereferensikannya selama pembuatan. Gambar dapat di-host di Amazon Elastic Container Registry Public.

catatan

Pengaturan build dapat dilihat di menu Hosting konsol Amplify hanya jika aplikasi disiapkan untuk penerapan berkelanjutan dan terhubung ke repositori git. Untuk langkah-langkah seputar jenis deployment ini, lihat Memulai dengan kode yang ada.

Ketentuan gambar build kustom

Agar image build kustom berfungsi sebagai image build Amplify, image tersebut harus memenuhi persyaratan berikut:

1. Distribusi Linux yang mendukung GNU C Library (glibc), seperti Amazon Linux, dikompilasi untuk arsitektur x86-64.

2. cURL: Ketika meluncurkan gambar kustom Anda, kami mengunduh build runner kami ke kontainer Anda sehingga harus ada cURL. Jika dependensi ini hilang, build langsung gagal tanpa keluaran apa pun karena build-runner kami tidak dapat menghasilkan output apa pun.

3. Git: Git harus terinstal pada gambar untuk membuat klon repositori Git Anda. Jika ketergantungan ini hilang, langkah repositori Kloning akan gagal.

4. OpenSSH: Untuk mengkloning repositori Anda dengan aman, kami memerlukan OpenSSH untuk mengatur kunci SSH sementara selama pembuatan. Paket OpenSSH menyediakan perintah yang dibutuhkan build runner untuk melakukan ini.

5. Bash dan The Bourne Shell: Kedua utilitas ini digunakan untuk menjalankan perintah pada waktu pembuatan. Jika tidak diinstal, build Anda mungkin gagal sebelum memulai.

6. Node.js+npm: Pelari build kami tidak menginstal Node. Sebaliknya, itu bergantung pada Node dan NPM yang diinstal pada gambar. Ini hanya diperlukan untuk build yang memerlukan paket NPM atau perintah terkait Node. Namun, kami sangat menyarankan untuk menginstalnya karena ketika ada, Amplify build runner dapat menggunakan alat ini untuk meningkatkan eksekusi build. Fitur penggantian paket Amplify menggunakan NPM untuk menginstal paket Hugo-Extended saat Anda mengatur penggantian untuk Hugo.

Paket-paket berikut tidak diperlukan, tetapi kami sangat menyarankan Anda untuk menginstalnya.

1. NVM (Node Version Manager): Kami menyarankan Anda menginstal pengelola versi ini jika Anda perlu menangani versi yang berbeda dariNode. Saat Anda menyetel override, fitur penggantian paket Amplify digunakan NVM untuk mengubah versi Node.js sebelum setiap build.

2. Wget: Amplify dapat menggunakan Wget utilitas untuk mengunduh file selama proses pembuatan. Kami menyarankan Anda menginstalnya di gambar khusus Anda.

3. Tar: Amplify dapat menggunakan Tar utilitas untuk membuka kompres file yang diunduh selama proses pembuatan. Kami menyarankan Anda menginstalnya di gambar khusus Anda.

Mengonfigurasi gambar build kustom

Untuk mengonfigurasi gambar build kustom yang di-hosting di Amazon ECR

1. Lihat Memulai di Panduan pengguna Amazon ECR Public untuk mengatur repositori Amazon ECR Public dengan gambar Docker.

2. Masuk ke AWS Management Console dan buka konsol Amplify.

3. Pilih aplikasi yang gambar build kustomnya akan dikonfigurasi.

4. Di panel navigasi, pilih Hosting, Build settings.

5. Di halaman Pengaturan build, di bagian Pengaturan gambar build, pilih Edit.

6. Pada halaman Edit pengaturan gambar build, perluas menu Build image, dan pilih Custom Build Image.

7. Masukkan nama repo Amazon ECR Public yang Anda buat di langkah pertama. Di sinilah gambar build Anda di-hosting. Misalnya, jika nama repo ecr-examplerepo, Anda harus memasukkan public.ecr.aws/xxxxxxxx/ecr-examplerepo.

8. Pilih Simpan.

Pembaruan paket langsung

Pembaruan paket langsung memungkinkan Anda menentukan versi paket dan dependensi yang akan digunakan dalam image build default Amplify. Gambar build default dilengkapi dengan beberapa paket dan dependensi yang telah terinstal sebelumnya (misalnya Hugo, CLI Amplify, Yarn, dll.). Dengan pembaruan paket langsung, Anda dapat menimpa versi dependensi ini dan menentukan versi tertentu, atau memastikan bahwa versi terbaru selalu terinstal.

Jika pembaruan paket langsung diaktifkan, sebelum build berjalan, build runner akan terlebih dahulu memperbarui (atau menurunkan versi) dependensi terkait. Cara ini akan meningkatkan waktu build sesuai dengan waktu yang diperlukan untuk memperbarui dependensi, tetapi, kelebihannya, Anda dapat memastikan versi dependensi yang sama digunakan untuk membangun aplikasi Anda.

Awas

Menyetel versi Node.js ke yang terbaru menyebabkan build gagal. Sebagai gantinya, Anda harus menentukan versi Node.js yang tepat, seperti18,21.5, atauv0.1.2.

Mengonfigurasi pembaruan paket langsung

Untuk mengonfigurasi pembaruan paket langsung

1. Masuk ke AWS Management Console dan buka konsol Amplify.

2. Pilih aplikasi yang pembaruan paket langsungnya akan dikonfigurasi.

3. Di panel navigasi, pilih Hosting, Build settings.

4. Di halaman Pengaturan build, di bagian Pengaturan gambar build, pilih Edit.

5. Pada halaman Edit pengaturan gambar build, daftar pembaruan paket Live, pilih Tambah baru.

6. Untuk Package, pilih dependensi yang akan diganti.

7. Untuk Versi, pilih versi default terbaru atau masukkan versi dependensi tertentu. Jika Anda menggunakan versi terbaru, dependensi akan selalu ditingkatkan ke versi terbaru yang tersedia.

8. Pilih Simpan.