Memahami spesifikasi build - AWS Amplify Hosting

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

Memahami spesifikasi build

Spesifikasi build untuk aplikasi Amplify adalah kumpulan YAML pengaturan dan perintah build yang Amplify gunakan untuk menjalankan build Anda. Daftar berikut menjelaskan pengaturan ini dan bagaimana mereka digunakan.

versi

Nomor YAML versi Amplify.

appRoot

Jalur dalam repositori tempat aplikasi ini berada. Diabaikan kecuali beberapa aplikasi didefinisikan.

env

Tambahkan variabel lingkungan ke bagian ini. Anda juga dapat menambahkan variabel lingkungan menggunakan konsol.

backend

Jalankan CLI perintah Amplify untuk menyediakan backend, memperbarui fungsi Lambda, atau skema GraphQL sebagai bagian dari penerapan berkelanjutan.

frontend

Jalankan perintah build frontend.

pengujian

Jalankan perintah selama fase pengujian. Pelajari cara menambahkan tes ke aplikasi.

membangun fase

Frontend, backend, dan tes terdiri dari tiga fase yang mewakili perintah yang dijalankan selama setiap urutan build.

  • preBuild- preBuild Skrip berjalan sebelum build sebenarnya dimulai, tetapi setelah Amplify menginstal dependensi.

  • build - Perintah build Anda.

  • postBuild- Skrip pasca-build berjalan setelah build selesai dan Amplify telah menyalin semua artefak yang diperlukan ke direktori output.

buildpath

Jalur yang digunakan untuk menjalankan build. Amplify menggunakan jalur ini untuk menemukan artefak build Anda. Jika Anda tidak menentukan jalur, Amplify menggunakan root aplikasi monorepo, misalnya. apps/app

artefak>direktori dasar

Direktori tempat artefak build Anda ada.

artefak>file

Tentukan file dari artefak yang ingin Anda terapkan. Masukkan **/* untuk memasukkan semua file.

cache

Menentukan dependensi build-time seperti folder node_modules. Selama build pertama, jalur yang disediakan di sini di-cache. Pada build berikutnya, Amplify mengembalikan cache ke jalur yang sama sebelum menjalankan perintah Anda.

Amplify menganggap semua jalur cache yang disediakan relatif terhadap root proyek Anda. Namun, Amplify tidak mengizinkan melintasi di luar root proyek. Misalnya, jika Anda menentukan jalur absolut, build akan berhasil tanpa kesalahan, tetapi jalur tidak akan di-cache.

Contoh spesifikasi build berikut menunjukkan YAML sintaks dasar.

version: 1
env:
  variables:
    key: value
backend:
  phases:
    preBuild:
      commands:
        - *enter command*
    build:
      commands:
        - *enter command*
    postBuild:
        commands:
        - *enter command*
frontend:
  buildpath:
  phases:
    preBuild:
      commands:
        - cd react-app
        - npm ci
    build:
      commands:
        - npm run build
  artifacts:
    files:
        - location
        - location
    discard-paths: yes
    baseDirectory: location
  cache:
    paths:
        - path # A cache path relative to the project root
        - path # Traversing outside of the project root is not allowed
test:
  phases:
    preTest:
      commands:
        - *enter command*
    test:
      commands:
        - *enter command*
    postTest:
      commands:
        - *enter command*
  artifacts:
    files:
        - location
        - location
    configFilePath: *location*
    baseDirectory: *location*