Menyesuaikan image build - AWS Amplify Hosting
Mengonfigurasi image build kustom untuk aplikasiMenggunakan versi paket dan dependensi tertentu dalam image build

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

Menyesuaikan image build

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.

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

Persyaratan gambar build kustom

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

  2. c URL: Saat kami meluncurkan gambar khusus Anda, kami mengunduh runner build kami ke dalam wadah Anda, dan oleh karena itu kami memerlukan c URL untuk hadir. 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. Buka SSH: Untuk mengkloning repositori Anda dengan aman, kami memerlukan Open SSH untuk mengatur SSH kunci sementara selama pembuatan. SSHPaket Open 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 diinstal pada gambar. Ini hanya diperlukan untuk build yang memerlukan NPM paket atau perintah khusus 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 digunakan NPM untuk menginstal paket Hugo-Extended saat Anda mengatur penggantian untuk Hugo.

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 berbagai versi Node. Saat Anda menyetel override, fitur penggantian paket Amplify menggunakan 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 image build kustom untuk aplikasi

Gunakan prosedur berikut untuk mengonfigurasi image build kustom untuk aplikasi di konsol Amplify.

Untuk mengonfigurasi image build kustom yang dihosting di Amazon ECR

  1. Lihat Memulai di panduan Pengguna ECR Publik Amazon untuk menyiapkan repositori ECR Publik Amazon dengan image 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 ECR Publik Amazon 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.

Menggunakan versi paket dan dependensi tertentu dalam image build

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 sudah diinstal 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.

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.