

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Versões de tempo de execução na amostra de arquivo buildspec para CodeBuild
<a name="sample-runtime-versions"></a>

Se você usa a imagem padrão do Amazon Linux 2 (AL2) versão 1.0 ou posterior, ou a imagem padrão do Ubuntu versão 2.0 ou posterior, você pode especificar um ou mais tempos de execução na `runtime-versions` seção do seu arquivo buildspec. Os exemplos a seguir mostram como você pode alterar o runtime do projeto, especificar mais de um runtime e especificar um runtime que dependa de outro runtime. Para obter informações sobre tempos de execução com suporte, consulte [Imagens do Docker fornecidas por CodeBuild](build-env-ref-available.md).

**nota**  
Se você usar o Docker no contêiner de compilação, sua compilação deverá ser executada no modo privilegiado. Para obter mais informações, consulte [Execute AWS CodeBuild compilações manualmente](run-build.md) e [Criar um projeto de compilação no AWS CodeBuild](create-project.md). 

**Topics**
+ [Atualizar a versão do runtime no arquivo buildspec](sample-runtime-update-version.md)
+ [Especificar dois tempos de execução](sample-runtime-two-major-version-runtimes.md)

# Atualizar a versão do runtime no arquivo buildspec
<a name="sample-runtime-update-version"></a>

Modifique o runtime usado pelo projeto para uma nova versão atualizando a seção `runtime-versions` do arquivo buildspec. Os exemplos a seguir mostram como especificar as versões 8 e 11 do Java.
+ Uma seção `runtime-versions` que especifica a versão 8 de Java:

  ```
  phases:
    install:
      runtime-versions:
        java: corretto8
  ```
+ Uma seção `runtime-versions` que especifica a versão 11 de Java:

  ```
  phases:
    install:
      runtime-versions:
        java: corretto11
  ```

Os exemplos a seguir mostram como especificar diferentes versões do Python usando a imagem padrão 5.0 do Ubuntu ou a imagem padrão 3.0 do Amazon Linux 2:
+ Uma seção `runtime-versions` que especifica o Python versão 3.7: 

  ```
  phases:
    install:
      runtime-versions:
        python: 3.7
  ```
+ Uma seção `runtime-versions` que especifica o Python versão 3.8: 

  ```
  phases:
    install:
      runtime-versions:
        python: 3.8
  ```

Este exemplo demonstra um projeto que começa com o tempo de execução Java versão 8 e, depois, é atualizado para o tempo de execução Java versão 10. 

1. Faça o download e instale o Maven. Para obter mais informações, consulte [Downloading Apache Maven](https://maven.apache.org/download.cgi) e [Installing Apache Maven](https://maven.apache.org/install.html) no site da Apache Maven.

1. Alterne para um diretório vazio em seu computador ou instância local e execute este comando Maven.

   ```
   mvn archetype:generate "-DgroupId=com.mycompany.app" "-DartifactId=ROOT" "-DarchetypeArtifactId=maven-archetype-webapp" "-DinteractiveMode=false"
   ```

   Se tiver êxito, a estrutura de diretório e os arquivos serão criados.

   ```
   .
   └── ROOT
       ├── pom.xml
       └── src
           └── main
               ├── resources
               └── webapp
                   ├── WEB-INF
                   │   └── web.xml
                   └── index.jsp
   ```

1. Crie um arquivo denominado `buildspec.yml` com os conteúdos a seguir. Armazene o arquivo no diretório ` (root directory name)/my-web-app`. 

   ```
   version: 0.2
   
   phases:
     install:
       runtime-versions:
         java: corretto8
     build:
       commands:
         - java -version
         - mvn package
   artifacts:
     files:
       - '**/*'
     base-directory: 'target/my-web-app'
   ```

   No arquivo buildspec: 
   + A seção `runtime-versions` especifica que o projeto usa o tempo de execução Java versão 8. 
   + O comando `- java -version` exibe a versão de Java usada pelo seu projeto ao ser compilado. 

   A estrutura de arquivo deve se parecer com esta. 

   ```
   (root directory name)
   └── my-web-app
       ├── src
       │   ├── main
       │   ├── resources
       │   └── webapp
       │       └── WEB-INF
       │           └── web.xml
       │               └── index.jsp
       ├── buildspec.yml
       └── pom.xml
   ```

1. Faça upload do conteúdo do `my-web-app` diretório em um bucket de entrada do S3 ou em um repositório CodeCommit GitHub, ou Bitbucket. 
**Importante**  
Não faça upload de `(root directory name)` nem `(root directory name)/my-web-app`, apenas dos diretórios e arquivos em `(root directory name)/my-web-app`.   
Se você estiver usando um bucket de entrada do S3, crie um arquivo ZIP que contenha a estrutura de diretório e os arquivos e envie-o para o bucket de entrada. Não adicione `(root directory name)` nem `(root directory name)/my-web-app` ao arquivo ZIP, apenas aos diretórios e arquivos em `(root directory name)/my-web-app`.

1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Crie um projeto de compilação. Para obter mais informações, consulte [Criar um projeto de compilação (console)](create-project.md#create-project-console) e [Executar uma compilação (console)](run-build-console.md). Deixe todas as configurações em seus valores padrão, exceto estas configurações.
   + Em **Ambiente**:
     + Em **Imagem do ambiente**, escolha **Imagem gerenciada**.
     + Em **Sistema operacional**, escolha **Amazon Linux 2**. 
     +  Em **Runtime(s)**, selecione **Padrão**. 
     + Para **Imagem**, escolha **aws/codebuild/amazonlinux-x86\$164-standard:4.0**.

1. Selecione **Iniciar compilação**. 

1. Aceite os padrões em **Configuração de compilação** e escolha **Iniciar compilação**. 

1. Assim que a compilação for concluída, veja a saída da compilação na guia **Logs de compilação**. Você deve ver uma saída semelhante a: 

   ```
   [Container] Date Time Phase is DOWNLOAD_SOURCE
   [Container] Date Time CODEBUILD_SRC_DIR=/codebuild/output/src460614277/src
   [Container] Date Time YAML location is /codebuild/output/src460614277/src/buildspec.yml
   [Container] Date Time Processing environment variables
   [Container] Date Time Selecting 'java' runtime version 'corretto8' based on manual selections...
   [Container] Date Time Running command echo "Installing Java version 8 ..."
   Installing Java version 8 ... 
    
   [Container] Date Time Running command export JAVA_HOME="$JAVA_8_HOME" 
    
   [Container] Date Time Running command export JRE_HOME="$JRE_8_HOME" 
    
   [Container] Date Time Running command export JDK_HOME="$JDK_8_HOME" 
    
   [Container] Date Time Running command for tool_path in "$JAVA_8_HOME"/bin/* "$JRE_8_HOME"/bin/*;
   ```

1. Atualize a seção `runtime-versions` para Java versão 11: 

   ```
   install:
       runtime-versions:
         java: corretto11
   ```

1. Depois de salvar a alteração, execute a compilação novamente e veja a saída da compilação. A versão instalada de Java deverá ser 11. Você deve ver uma saída semelhante a: 

   ```
   [Container] Date Time Phase is DOWNLOAD_SOURCE
   [Container] Date Time CODEBUILD_SRC_DIR=/codebuild/output/src460614277/src
   [Container] Date Time YAML location is /codebuild/output/src460614277/src/buildspec.yml
   [Container] Date Time Processing environment variables
   [Container] Date Time Selecting 'java' runtime version 'corretto11' based on manual selections... 
   Installing Java version 11 ... 
    
   [Container] Date Time Running command export JAVA_HOME="$JAVA_11_HOME" 
    
   [Container] Date Time Running command export JRE_HOME="$JRE_11_HOME" 
    
   [Container] Date Time Running command export JDK_HOME="$JDK_11_HOME" 
    
   [Container] Date Time Running command for tool_path in "$JAVA_11_HOME"/bin/* "$JRE_11_HOME"/bin/*;
   ```

# Especificar dois tempos de execução
<a name="sample-runtime-two-major-version-runtimes"></a>

Você pode especificar mais de um tempo de execução no mesmo projeto de CodeBuild compilação. Este exemplo de projeto usa dois arquivos de origem: um que usa o tempo de execução Go e um que usa o tempo de execução Node.js. 

1. Crie um diretório denominado `my-source`. 

1. No diretório `my-source`, crie um diretório chamado `golang-app`. 

1. Crie um arquivo denominado `hello.go` com os conteúdos a seguir. Armazene o arquivo no diretório `golang-app`. 

   ```
   package main
   import "fmt"
   
   func main() {
     fmt.Println("hello world from golang")
     fmt.Println("1+1 =", 1+1)
     fmt.Println("7.0/3.0 =", 7.0/3.0)
     fmt.Println(true && false)
     fmt.Println(true || false)
     fmt.Println(!true)
     fmt.Println("good bye from golang")
   }
   ```

1. No diretório `my-source`, crie um diretório chamado `nodejs-app`. Ele deve estar no mesmo nível que o diretório `golang-app`. 

1. Crie um arquivo denominado `index.js` com os conteúdos a seguir. Armazene o arquivo no diretório `nodejs-app`. 

   ```
   console.log("hello world from nodejs");
   console.log("1+1 =" + (1+1));
   console.log("7.0/3.0 =" + 7.0/3.0);
   console.log(true && false);
   console.log(true || false);
   console.log(!true);
   console.log("good bye from nodejs");
   ```

1. Crie um arquivo denominado `package.json` com os conteúdos a seguir. Armazene o arquivo no diretório `nodejs-app`. 

   ```
   {
     "name": "mycompany-app",
     "version": "1.0.0",
     "description": "",
     "main": "index.js",
     "scripts": {
       "test": "echo \"run some tests here\""
     },
     "author": "",
     "license": "ISC"
   }
   ```

1. Crie um arquivo denominado `buildspec.yml` com os conteúdos a seguir. Armazene o arquivo no diretório `my-source`, no mesmo nível que os diretórios `nodejs-app` e `golang-app`. A seção `runtime-versions` especifica os runtimes do Node.js versão 12 e do Go versão 1.13. 

   ```
   version: 0.2
   
   phases:
     install:
       runtime-versions:
         golang: 1.13
         nodejs: 12
     build:
       commands:
         - echo Building the Go code...
         - cd $CODEBUILD_SRC_DIR/golang-app
         - go build hello.go 
         - echo Building the Node code...
         - cd $CODEBUILD_SRC_DIR/nodejs-app
         - npm run test
   artifacts:
     secondary-artifacts:
       golang_artifacts:
         base-directory: golang-app
         files:
           - hello
       nodejs_artifacts:
         base-directory: nodejs-app
         files:
           - index.js
           - package.json
   ```

1. A estrutura de arquivo deve se parecer com esta. 

   ```
   my-source
   ├── golang-app
   │   └── hello.go
   ├── nodejs.app
   │   ├── index.js
   │   └── package.json
   └── buildspec.yml
   ```

1. Faça upload do conteúdo do `my-source` diretório em um bucket de entrada do S3 ou em um repositório CodeCommit GitHub, ou Bitbucket.
**Importante**  
 Se você estiver usando um bucket de entrada do S3, crie um arquivo ZIP que contenha a estrutura de diretório e os arquivos e envie-o para o bucket de entrada. Não adicione `my-source` ao arquivo ZIP, apenas aos diretórios e arquivos em `my-source`.

1. Abra o AWS CodeBuild console em [https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1. Crie um projeto de compilação. Para obter mais informações, consulte [Criar um projeto de compilação (console)](create-project.md#create-project-console) e [Executar uma compilação (console)](run-build-console.md). Deixe todas as configurações em seus valores padrão, exceto estas configurações.
   + Em **Ambiente**:
     + Em **Imagem do ambiente**, escolha **Imagem gerenciada**.
     + Em **Sistema operacional**, escolha **Amazon Linux 2**.
     + Em **Runtime(s)**, selecione **Padrão**.
     + Para **Imagem**, escolha **aws/codebuild/amazonlinux-x86\$164-standard:4.0**.

1. Selecione **Create build project (Criar projeto de compilação)**. 

1. Selecione **Iniciar compilação**. 

1. Aceite os padrões em **Configuração de compilação** e escolha **Iniciar compilação**. 

1. Assim que a compilação for concluída, veja a saída da compilação na guia **Logs de compilação**. Você deve ver saída semelhante ao seguinte: Ela mostra a saída dos tempos de execução Go e Node.js. Ela também mostra a saída dos aplicativos Go e Node.js. 

   ```
   [Container] Date Time Processing environment variables
   [Container] Date Time Selecting 'golang' runtime version '1.13' based on manual selections...
   [Container] Date Time Selecting 'nodejs' runtime version '12' based on manual selections...
   [Container] Date Time Running command echo "Installing Go version 1.13 ..."
   Installing Go version 1.13 ... 
    
   [Container] Date Time Running command echo "Installing Node.js version 12 ..." 
   Installing Node.js version 12 ... 
    
   [Container] Date Time Running command n $NODE_12_VERSION
      installed : v12.20.1 (with npm 6.14.10)
   
   [Container] Date Time Moving to directory /codebuild/output/src819694850/src
   [Container] Date Time Registering with agent
   [Container] Date Time Phases found in YAML: 2
   [Container] Date Time  INSTALL: 0 commands
   [Container] Date Time  BUILD: 1 commands
   [Container] Date Time Phase complete: DOWNLOAD_SOURCE State: SUCCEEDED
   [Container] Date Time Phase context status code:  Message:
   [Container] Date Time Entering phase INSTALL
   [Container] Date Time Phase complete: INSTALL State: SUCCEEDED
   [Container] Date Time Phase context status code:  Message:  
   [Container] Date Time Entering phase PRE_BUILD 
   [Container] Date Time Phase complete: PRE_BUILD State: SUCCEEDED 
   [Container] Date Time Phase context status code:  Message:  
   [Container] Date Time Entering phase BUILD 
   [Container] Date Time Running command echo Building the Go code... 
   Building the Go code... 
    
   [Container] Date Time Running command cd $CODEBUILD_SRC_DIR/golang-app 
    
   [Container] Date Time Running command go build hello.go 
    
   [Container] Date Time Running command echo Building the Node code... 
   Building the Node code... 
    
   [Container] Date Time Running command cd $CODEBUILD_SRC_DIR/nodejs-app 
    
   [Container] Date Time Running command npm run test 
    
   > mycompany-app@1.0.0 test /codebuild/output/src924084119/src/nodejs-app 
   > echo "run some tests here" 
    
   run some tests here
   ```