Comprensione delle specifiche di build - AWS Amplify Ospitare

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Comprensione delle specifiche di build

La specifica di build per un'applicazione Amplify è una raccolta YAML di impostazioni e comandi di compilazione che Amplify utilizza per eseguire la build. L'elenco seguente descrive queste impostazioni e come vengono utilizzate.

version

Il numero di versione di YAML Amplify.

appRoot

Il percorso all'interno del repository in cui risiede questa applicazione. Ignorato a meno che non vengano definite più applicazioni.

env

Aggiungi variabili di ambiente a questa sezione. Si possono aggiungere variabili d'ambiente anche dalla console.

backend

Esegui i comandi CLI Amplify per fornire un backend, aggiornare le funzioni Lambda o gli schemi GraphQL come parte della distribuzione continua.

frontend

Esegui i comandi di compilazione del frontend.

test

Esegui i comandi durante una fase di test. Scopri come aggiungere test alla tua app.

fasi di costruzione

Il frontend, il backend e il test hanno tre fasi che rappresentano i comandi eseguiti durante ogni sequenza della build.

  • preBuild- Lo preBuild script viene eseguito prima dell'inizio della build effettiva, ma dopo che Amplify installa le dipendenze.

  • build: i comandi di compilazione.

  • postBuild- Lo script post-build viene eseguito al termine della compilazione e Amplify ha copiato tutti gli artefatti necessari nella directory di output.

percorso di compilazione

Il percorso da utilizzare per eseguire la build. Amplify utilizza questo percorso per localizzare gli artefatti della tua build. Se non specifichi un percorso, Amplify utilizza la root dell'app monorepo, ad esempio. apps/app

artifacts>base-directory

La directory in cui esistono gli artefatti della build.

artefatti>file

Specificate i file degli artefatti che desiderate distribuire. Inserisci **/* per includere tutti i file.

cache

Specifica le dipendenze in fase di compilazione, ad esempio la cartella node_modules. Durante la prima build, i percorsi forniti qui vengono memorizzati nella cache. Nelle build successive, Amplify ripristina la cache sugli stessi percorsi prima di eseguire i comandi.

Amplify considera tutti i percorsi di cache forniti come relativi alla radice del progetto. Tuttavia, Amplify non consente l'attraversamento al di fuori della radice del progetto. Ad esempio, se specifichi un percorso assoluto, la compilazione avrà esito positivo senza errori, ma il percorso non verrà memorizzato nella cache.

Il seguente esempio di specifica di build illustra la sintassi di baseYAML.

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*