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

Mengedit spesifikasi build di konsol Amplify

Anda dapat menyesuaikan setelan build aplikasi dengan mengedit spesifikasi build di konsol Amplify. Setelan build diterapkan ke semua cabang di aplikasi Anda, kecuali untuk cabang yang memiliki amplify.yml file yang disimpan di repositori Git.

Anda dapat menggunakan contoh yang dijelaskan dalam topik berikut untuk memperbarui setelan build untuk skenario tertentu.

Menyetel setelan build khusus cabang dengan scripting

Anda dapat menggunakan penulisan bash shell untuk menentukan pengaturan build khusus cabang. Misalnya, skrip berikut menggunakan variabel lingkungan sistem $ AWS_BRANCH untuk menjalankan satu set perintah jika nama cabang utama dan serangkaian perintah yang berbeda jika nama cabang adalah dev.

frontend:
  phases:
    build:
      commands:
        - if [ "${AWS_BRANCH}" = "main" ]; then echo "main branch"; fi
        - if [ "${AWS_BRANCH}" = "dev" ]; then echo "dev branch"; fi

Mengatur perintah untuk menavigasi ke subfolder

Untuk monorepos, pengguna ingin dapat cd masuk ke folder untuk menjalankan build. Setelah Anda menjalankan cd perintah, itu berlaku untuk semua tahapan build Anda sehingga Anda tidak perlu mengulangi perintah dalam fase terpisah.

version: 1
env:
  variables:
    key: value
frontend:
  phases:
    preBuild:
      commands:
        - cd react-app
        - npm ci
    build:
      commands:
        - npm run build

Menerapkan backend dengan ujung depan untuk aplikasi Gen 1

amplifyPushPerintah adalah skrip pembantu yang membantu Anda dengan penerapan backend. Pengaturan build berikut secara otomatis menentukan lingkungan backend yang tepat untuk di-deploy di cabang saat ini.

version: 1
env:
  variables:
    key: value
backend:
  phases:
    build:
      commands:
        - amplifyPush --simple

Menyiapkan folder output

Pengaturan build berikut mengatur direktori output ke folder publik.

frontend:
  phases:
    commands:
      build:
        - yarn run build
  artifacts:
    baseDirectory: public

Menginstal paket sebagai bagian dari build

Anda dapat menggunakan yarn perintah npm or untuk menginstal paket selama pembuatan.

frontend:
  phases:
    build:
      commands:
        - npm install -g <package>
        - <package> deploy
        - yarn run build
  artifacts:
    baseDirectory: public

Menggunakan registri npm privat

Anda dapat menambahkan referensi ke registri privat di pengaturan build Anda atau menambahkannya sebagai variabel lingkungan.

build:
  phases:
    preBuild:
      commands:
        - npm config set <key> <value>
        - npm config set registry https://registry.npmjs.org
        - npm config set always-auth true
        - npm config set email hello@amplifyapp.com
        - yarn install

Menginstal paket OS

Gambar AL2 023 Amplify menjalankan kode Anda dengan nama pengguna yang tidak memiliki hak istimewa. amplify Amplify memberikan hak istimewa kepada pengguna ini untuk menjalankan perintah OS menggunakan perintah Linux. sudo Jika Anda ingin menginstal paket OS untuk dependensi yang hilang, Anda dapat menggunakan perintah seperti yum dan rpm dengan. sudo

Contoh bagian build berikut menunjukkan sintaks untuk menginstal paket OS menggunakan perintah. sudo

build:
  phases:
    preBuild:
      commands:
        - sudo yum install -y <package>

Menyetel penyimpanan nilai kunci untuk setiap build

envCache menyediakan penyimpanan kunci-nilai pada waktu build. Nilai-nilai yang disimpan di envCache hanya dapat diubah selama build dan dapat digunakan kembali pada build berikutnya. Dengan envCache, informasi dapat disimpan di lingkungan yang di-deploy dan tersedia untuk kontainer build di build yang berturutan. Tidak seperti nilai yang disimpan di envCache, perubahan pada variabel lingkungan selama build tidak muncul pada build selanjutnya.

Contoh penggunaan:

envCache --set <key> <value>
envCache --get <key>

Melewatkan build untuk komit

Untuk melompati build otomatis pada penerapan tertentu, sertakan teks [skip-cd] di akhir pesan penerapan.

Mematikan build otomatis pada setiap komit

Anda dapat mengonfigurasi Amplify untuk mematikan build otomatis pada setiap komit kode. Untuk mengatur, pilih Pengaturan aplikasi, Pengaturan cabang, lalu cari bagian Cabang yang mencantumkan cabang yang terhubung. Pilih cabang, lalu pilih Tindakan, Nonaktifkan pembuatan otomatis. Komit baru ke cabang itu tidak akan lagi memulai build baru.

Mengonfigurasi pembuatan dan penerapan frontend berbasis diff

Anda dapat mengonfigurasi Amplify untuk menggunakan build frontend berbasis diff. Jika diaktifkan, pada awal setiap build Amplify mencoba menjalankan diff di folder AndaappRoot, atau /src/ folder secara default. Jika tidak menemukan perbedaan apa pun, Amplify akan melompati langkah build, tes (jika dikonfigurasi), dan deploy frontend, serta tidak memperbarui aplikasi yang di-hosting.

Anda juga dapat mengatur variabel lingkungan AMPLIFY_DIFF_DEPLOY_ROOT agar menimpa path default dengan path yang berkaitan dengan root repo Anda, seperti dist.

Mengonfigurasi build backend berbasis diff untuk aplikasi Gen 1

Anda dapat mengonfigurasi Amplify Hosting untuk menggunakan build backend berbasis diff menggunakan variabel lingkungan. AMPLIFY_DIFF_BACKEND Saat Anda mengaktifkan build backend berbasis diff, pada awal setiap build Amplify mencoba menjalankan diff pada folder di repositori Anda. amplify Jika tidak menemukan perbedaan apa pun, Amplify akan melompati langkah build backend, dan tidak memperbarui sumber daya backend Anda. Jika proyek Anda tidak memiliki folder amplify di repositori, Amplify akan mengabaikan nilai variabel lingkungan AMPLIFY_DIFF_BACKEND.

Jika saat ini Anda memiliki perintah khusus yang ditentukan dalam pengaturan build fase backend Anda, build backend bersyarat tidak akan berfungsi. Jika Anda ingin perintah kustom tersebut berjalan, Anda harus memindahkannya ke fase frontend setelan build di amplify.yml file aplikasi Anda.