Etapa 2: Criar o arquivo buildspec

(Etapa anterior: Etapa 1: Criar o código-fonte)

Nesta etapa, você cria um arquivo de especificação de build (build spec). Um buildspec é uma coleção de comandos de compilação e configurações relacionadas, no formato YAML, CodeBuild usados para executar uma compilação. Sem uma especificação de compilação, CodeBuild não é possível converter com êxito sua entrada de compilação em saída de compilação nem localizar o artefato de saída de compilação no ambiente de compilação para fazer upload em seu bucket de saída.

Crie esse arquivo, nomeie-o buildspec.yml e salve-o no diretório raiz (de nível superior).

version: 0.2

phases:
  install:
    runtime-versions:
      java: corretto11
  pre_build:
    commands:
      - echo Nothing to do in the pre_build phase...
  build:
    commands:
      - echo Build started on `date`
      - mvn install
  post_build:
    commands:
      - echo Build completed on `date`
artifacts:
  files:
    - target/messageUtil-1.0.jar

Importante

Como a declaração de build spec deve corresponder ao YAML, o espaçamento na declaração de build spec é importante. Se o número de espaços em sua declaração de build spec não corresponder a essa, o build pode falhar imediatamente. Você pode usar um validador YAML para testar se a declaração de build spec é válida para o YAML.

nota

Em vez de incluir um arquivo de build spec em seu código-fonte, você pode declarar comandos de build separadamente ao criar um projeto de build. Isso é útil no caso de você compilar seu código-fonte com diferentes comandos de build sem atualizar o repositório de código fonte a cada vez. Para ter mais informações, consulte Sintaxe de buildspec.

Nesta declaração de build spec:

• version representa a versão do build spec padrão em uso. Essa declaração de build spec usa a última versão, 0.2.

• phases representa as fases do build durante as quais você pode instruir o CodeBuild para executar comandos. Essas fases de build são aqui listadas como install, pre_build, build e post_build. Não é possível alterar os nomes das fases de build, nem criar nomes adicionais.

  Neste exemplo, durante a build fase, CodeBuild executa o mvn install comando. Esse comando instrui o Apache Maven a compilar, testar e empacotar os arquivos classe Java em um artefato de saída do build. Para completar, alguns comandos echo são incluídos em cada fase de build, neste exemplo. Quando você visualizar informações de compilação detalhadas posteriormente neste tutorial, a saída desses comandos echo poderá ajudar a compreender melhor como o CodeBuild executa comandos e em que ordem. (Embora todas as fases da compilação estejam incluídas neste exemplo, não é necessário incluir uma fase da compilação se você não pretende executar comandos durante essa fase.) Para cada fase de compilação, CodeBuild executa cada comando especificado, um por vez, na ordem listada, do início ao fim.

• artifactsrepresenta o conjunto de artefatos de saída de compilação que são CodeBuild carregados no bucket de saída. filesrepresenta os arquivos a serem incluídos na saída da compilação. CodeBuild carrega o único messageUtil-1.0.jar arquivo encontrado no diretório target relativo no ambiente de compilação. O nome de arquivo messageUtil-1.0.jar e o nome de diretório target são baseados na maneira como o Apache Maven cria e armazena artefatos de saída do build somente para este exemplo. Em seus próprios builds, esses nomes de arquivos e diretórios são diferentes.

Para obter mais informações, consulte Referência de buildspec.

Neste momento, a estrutura de diretório deve se parecer como essa.

(root directory name)
    |-- pom.xml
    |-- buildspec.yml
    `-- src
         |-- main
         |     `-- java
         |           `-- MessageUtil.java
         `-- test
               `-- java
                     `-- TestMessageUtil.java

Próxima etapa

Etapa 3: Criar dois buckets do S3