Entendendo a especificação de construção

A especificação de compilação de um aplicativo Amplify é uma coleção de YAML configurações e comandos de compilação que o Amplify usa para executar sua compilação. A lista a seguir descreve essas configurações e como elas são usadas.

versão

O número da YAML versão do Amplify.

appRoot

O caminho dentro do repositório em que esse aplicativo reside em. Ignorado, a menos que vários aplicativos sejam definidos.

env

Adicione variáveis de ambiente a essa seção. Também é possível adicionar variáveis de ambiente usando o console.

back-end

Execute CLI comandos do Amplify para provisionar um back-end, atualizar funções Lambda ou esquemas do GraphQL como parte da implantação contínua.

front-end

Executa comandos de compilação de front-end.

teste

Execute comandos durante uma fase de teste. Saiba como adicionar testes ao seu aplicativo.

fases da compilação

O front-end, o back-end e o teste têm três fases que representam os comandos executados durante cada sequência da compilação.

• preBuild- O preBuild script é executado antes do início da compilação real, mas depois que o Amplify instala as dependências.

• build (criação) – Seus comandos de criação.

• postBuild- O script de pós-construção é executado após a conclusão da compilação e o Amplify ter copiado todos os artefatos necessários para o diretório de saída.

buildpath

O caminho a ser usado para executar a compilação. O Amplify usa esse caminho para localizar seus artefatos de compilação. Se você não especificar um caminho, o Amplify usa a raiz do aplicativo monorepo, por exemplo apps/app.

artifacts>base-directory

O diretório no qual os artefatos de compilação existem.

artifacts>files

Especifique os arquivos dos artefatos que você deseja implantar. Digite **/* para incluir todos os arquivos.

cache

Especifica dependências de tempo de compilação, como a pasta node_modules, e é sugerida automaticamente com base no gerenciador de pacotes e na estrutura em que o aplicativo está integrado. Durante a primeira compilação, todos os caminhos aqui são armazenados em cache e, nas compilações subsequentes, reinflamos o cache e usamos essas dependências em cache sempre que possível para acelerar o tempo de construção.

Referência de YAML sintaxe da especificação de compilação

O exemplo a seguir de uma especificação de compilação demonstra a YAML sintaxe básica.

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
        - path
test:
  phases:
    preTest:
      commands:
        - *enter command*
    test:
      commands:
        - *enter command*
    postTest:
      commands:
        - *enter command*
  artifacts:
    files:
        - location
        - location
    configFilePath: *location*
    baseDirectory: *location*