Membangun referensi spesifikasi - AWS Amplify Hosting

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

Membangun referensi spesifikasi

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

versi

Nomor versi YAMLAmplify.

appRoot

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

env

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

backend

Menjalankan perintah CLI Amplify untuk menyediakan backend, memperbarui fungsi Lambda, atau skema GraphQL sebagai bagian dari deployment kontinu.

frontend

Menjalankan perintah build frontend.

pengujian

Menjalankan perintah selama fase tes. Pelajari cara menambahkan tes ke aplikasi.

fase membangun

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

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

  • build - Perintah build Anda.

  • postBuild - Skrip post-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. apps/app

artefak>direktori dasar

Direktori tempat artefak build Anda disimpan.

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 sintaks YAMAL 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*