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á.
# Imagens do Docker fornecidas por CodeBuild
Uma *imagem compatível* é a versão principal mais recente de uma imagem disponível CodeBuild e é atualizada com atualizações secundárias e de patch. CodeBuild otimiza a duração do provisionamento de compilações com imagens compatíveis, armazenando-as em cache nas Amazon Machine [Images (AMI) da máquina](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html#ami-using). Se você quiser se beneficiar do armazenamento em cache e minimizar a duração do provisionamento de sua compilação, selecione **Sempre usar a imagem mais recente para essa versão de tempo de execução na seção Versão** **da imagem** do CodeBuild console, em vez de uma versão mais granular, como. `aws/codebuild/amazonlinux-x86_64-standard:4.0-1.0.0`
**Topics**
+ [
# Obter a lista das imagens do Docker atuais
](build-env-ref-available-get.md)
+ [
# Imagens de computação do EC2
](ec2-compute-images.md)
+ [
# Imagens de computação do Lambda
](lambda-compute-images.md)
+ [
# Imagens obsoletas CodeBuild
](deprecated-images.md)
+ [
# Runtimes disponíveis
](available-runtimes.md)
+ [
# Versões do tempo de execução
](runtime-versions.md)
# Obter a lista das imagens do Docker atuais
CodeBuild atualiza frequentemente a lista de imagens do Docker para adicionar as imagens mais recentes e descontinuar as imagens antigas. Para obter a lista mais atual, faça um dos seguintes procedimentos:
+ No CodeBuild console, no assistente **Criar projeto de compilação** ou na página **Editar projeto de compilação**, em **Imagem do ambiente**, escolha **Imagem gerenciada**. Selecione nas listas suspensas **Operating system (Sistema operacional)**, **Runtime (Tempo de execução)** e **Runtime version (Versão do tempo de execução)**. Para acessar mais informações, consulte [Criar um projeto de compilação (console)](create-project.md#create-project-console) ou [Alterar configurações de um projeto de compilação (console)](change-project.md#change-project-console).
+ Para o AWS CLI, execute o `list-curated-environment-images` comando:
```
aws codebuild list-curated-environment-images
```
+ Para o AWS SDKs, chame a `ListCuratedEnvironmentImages` operação da sua linguagem de programação de destino. Para obter mais informações, consulte o [AWS SDKs e referência de ferramentas](sdk-ref.md).
# Imagens de computação do EC2
AWS CodeBuild suporta as seguintes imagens do Docker que estão disponíveis para computação do EC2 em. CodeBuild
**nota**
A imagem base da plataforma Windows Server Core 2019 só está disponível nas seguintes regiões:
Leste dos EUA (Norte da Virgínia)
Leste dos EUA (Ohio)
Oeste dos EUA (Oregon)
Europa (Irlanda)
| Plataforma | Identificador da imagem | Definição |
| --- | --- | --- |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:4.0 | [al/standard/4.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/4.0) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-standard:5.0 | [al/standard/5.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/5.0) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-standard:6.0 | [al/padrão/6.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/6.0) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:corretto8 | [al/standard/corretto8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/corretto8) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-standard:corretto11 | [al/standard/corretto11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/x86_64/standard/corretto11) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-standard:2.0 | [al/aarch64/standard/2,0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/aarch64/standard/2.0) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-standard:3.0 | [al/aarch64/standard/3,0](https://github.com/aws/aws-codebuild-docker-images/tree/master/al/aarch64/standard/3.0) |
| Ubuntu 20.04 | aws/codebuild/standard:5.0 | [ubuntu/standard/5.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/5.0) |
| Ubuntu 22.04 | aws/codebuild/standard:6.0 | [ubuntu/standard/6.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/6.0) |
| Ubuntu 22.04 | aws/codebuild/standard:7.0 | [ubuntu/standard/7.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/7.0) |
| Ubuntu 24.04 | aws/codebuild/standard:8.0 | [ubuntu/padrão/8.0](https://github.com/aws/aws-codebuild-docker-images/tree/master/ubuntu/standard/8.0) |
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-1.0 | N/D |
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-2.0 | N/D |
| Windows Server Core 2019 | aws/codebuild/windows-base:2019-3.0 | N/D |
| Windows Server Core 2022 | aws/codebuild/windows-base:2022-1.0 | N/D |
**nota**
Em 22 de novembro de 2024, os aliases para imagens de runtime padrão baseadas em Linux foram atualizados de `amazonlinux2` para `amazonlinux`. Nenhuma atualização manual é necessária, pois os aliases anteriores ainda são válidos.
# Imagens de computação do Lambda
AWS CodeBuild suporta as seguintes imagens do Docker que estão disponíveis para AWS Lambda computação em. CodeBuild
**Importante**
O atributo `on-failure` não é compatível ao usar a computação do Lambda ou a capacidade reservada. Esse atributo só funciona com imagens computacionais do EC2 fornecidas pelo. CodeBuild
**`aarch64`Arquitetura do**
| Plataforma | Identificador da imagem | Definição |
| --- | --- | --- |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet6 | [al- lambda/aarch64/dotnet 6](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/dotnet6) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet8 | [todos os lambda/aarch64/dotnet 8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/dotnet8) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.21 | [tudo- lambda/aarch64/go 1,21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/go1.21) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.24 | [al- lambda/aarch64/go 1,24](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/go1.24) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto11 | [tudo- lambda/aarch64/corretto 11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto11) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto17 | [tudo- lambda/aarch64/corretto 17](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto17) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto21 | [tudo- lambda/aarch64/corretto 21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/corretto21) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs18 | [todos- lambda/aarch64/nodejs 18](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs18) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs20 | [al- lambda/aarch64/nodejs 20](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs20) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs22 | [tudo- lambda/aarch64/nodejs 22](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/nodejs22) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.11 | [al- lambda/aarch64/python 3,11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.11) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.12 | [al- lambda/aarch64/python 3,12](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.12) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.13 | [al- lambda/aarch64/python 3,13](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/python3.13) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.2 | [al- lambda/aarch64/ruby 3,2](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/ruby3.2) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.4 | [al- lambda/aarch64/ruby 3.4](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/aarch64/ruby3.4) |
**`x86_64`Arquitetura do**
| Plataforma | Identificador da imagem | Definição |
| --- | --- | --- |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:dotnet6 | [al- lambda/x86\$164/dotnet 6](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/dotnet6) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:dotnet8 | [todos os lambda/x86\$164/dotnet 8](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/dotnet8) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:go1.21 | [tudo- lambda/x86\$164/go 1,21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/go1.21) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:go1.24 | [al- lambda/x86\$164/go 1,24](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/go1.24) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto11 | [tudo- lambda/x86\$164/corretto 11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto11) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto17 | [tudo- lambda/x86\$164/corretto 17](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto17) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:corretto21 | [tudo- lambda/x86\$164/corretto 21](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/corretto21) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs18 | [todos- lambda/x86\$164/nodejs 18](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs18) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs20 | [al- lambda/x86\$164/nodejs 20](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs20) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:nodejs22 | [tudo- lambda/x86\$164/nodejs 22](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/nodejs22) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.11 | [al- lambda/x86\$164/python 3,11](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.11) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.12 | [al- lambda/x86\$164/python 3,12](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.12) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:python3.13 | [al- lambda/x86\$164/python 3,13](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/python3.13) |
| Amazon Linux 2 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:ruby3.2 | [al- lambda/x86\$164/ruby 3,2](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/ruby3.2) |
| Amazon Linux 2023 | aws/codebuild/amazonlinux-x86\$164-lambda-standard:ruby3.4 | [al- lambda/x86\$164/ruby 3.4](https://github.com/aws/aws-codebuild-docker-images/tree/master/al-lambda/x86_64/ruby3.4) |
# Imagens obsoletas CodeBuild
Uma *imagem obsoleta é uma imagem* que não é mais armazenada em cache nem atualizada pelo. CodeBuild Uma imagem obsoleta não recebe mais atualizações de versão secundária nem atualizações de versão de patch e, como não estão mais atualizadas, usá-las pode não ser seguro. Se seu CodeBuild projeto estiver configurado para usar uma versão de imagem mais antiga, o processo de provisionamento baixará essa imagem do docker e a usará para criar o ambiente de tempo de execução em contêineres, o que pode aumentar a duração do provisionamento e a duração geral da compilação.
CodeBuild descontinuou as seguintes imagens do Docker. Ainda é possível usar essas imagens, mas elas não serão armazenadas em cache no host de compilação e resultarão em tempos de provisionamento mais altos.
| Plataforma | Identificador da imagem | Definição | Data da substituição |
| --- | --- | --- | --- |
| Amazon Linux 2 | aws/codebuild/amazonlinux2-x86\$164-standard:3.0 | al2/standard/3.0 | 9 de maio de 2023 |
| Ubuntu 18.04 | aws/codebuild/standard:4.0 | ubuntu/standard/4.0 | 31 de março de 2023 |
| Amazon Linux 2 | aws/codebuild/amazonlinux2-aarch64-standard:1.0 | al2/aarch64/standard/1.0 | 31 de março de 2023 |
| Ubuntu 18.04 | aws/codebuild/standard:3.0 | ubuntu/standard/3.0 | 30 de junho de 2022 |
| Amazon Linux 2 | aws/codebuild/amazonlinux2-x86\$164-standard:2.0 | al2/standard/2.0 | 30 de junho de 2022 |
**Topics**
+ [
# Obter a lista das imagens do Docker atuais
](build-env-ref-available-get.md)
+ [
# Imagens de computação do EC2
](ec2-compute-images.md)
+ [
# Imagens de computação do Lambda
](lambda-compute-images.md)
+ [
# Imagens obsoletas CodeBuild
](deprecated-images.md)
+ [
# Runtimes disponíveis
](available-runtimes.md)
+ [
# Versões do tempo de execução
](runtime-versions.md)
# Runtimes disponíveis
Você pode especificar um ou mais runtimes na seção `runtime-versions` do arquivo buildspec. Se o runtime depender de outro runtime, você também poderá especificar seu runtime dependente no arquivo buildspec. Se você não especificar nenhum tempo de execução no arquivo buildspec, CodeBuild escolhe os tempos de execução padrão que estão disponíveis na imagem que você usa. Se você especificar um ou mais tempos de execução, CodeBuild usará somente esses tempos de execução. Se um tempo de execução dependente não for especificado, CodeBuild tentará escolher o tempo de execução dependente para você.
**nota**
Se uma versão de tempo de execução não for especificada, CodeBuild usa a versão padrão. A versão padrão pode mudar quando uma versão padrão anterior atinge o fim da vida útil (EOL). Para evitar alterações inesperadas no ambiente de compilação, recomendamos especificar uma versão de tempo de execução no arquivo buildspec.
Para obter mais informações, consulte [Specify runtime versions in the buildspec file](build-spec-ref.md#runtime-versions-buildspec-file).
[Specify runtime versions in the buildspec file](build-spec-ref.md#runtime-versions-buildspec-file).
.
**Topics**
+ [
## Runtimes de imagens do Linux
](#linux-runtimes)
+ [
## Runtimes de imagens do macOS
](#macOS-runtimes)
+ [
## Runtimes de imagens do Windows
](#windows-runtimes)
## Runtimes de imagens do Linux
A tabela a seguir contém os runtimes disponíveis e as imagens padrão do Linux compatíveis.
**Runtimes das plataformas Ubuntu e Amazon Linux**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/available-runtimes.html)
## Runtimes de imagens do macOS
**Importante**
As imagens CodeBuild selecionadas para compilações do Mac contêm o macOS e o Xcode pré-instalados. Ao usar o software Xcode, você reconhece, compreende e concorda com o Contrato do [Xcode e da Apple SDKs ](https://www.apple.com/legal/sla/docs/xcode.pdf). Se você não aceita os termos e condições do contrato, não use o software Xcode. Em vez disso, forneça suas próprias imagens de máquina da Amazon (AMIs). Para obter mais informações, consulte [Como configurar uma frota macOS de capacidade reservada?](fleets.md#fleets.configure-macos).
A tabela a seguir contém os runtimes disponíveis compatíveis com macOS.
**Runtimes da plataforma macOS**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/available-runtimes.html)
## Runtimes de imagens do Windows
A imagem base do Windows Server Core 2019 contém os runtimes a seguir.
**Runtimes da plataforma Windows**
| Nome do runtime | Windows Server Core 2019 standard: versões 1.0 | Windows Server Core 2019 standard: versões 2.0 | Windows Server Core 2019 standard: versões 3.0 |
| --- | --- | --- | --- |
| dotnet | 3.15,0 | 3.16.07.0 | 8.0 |
| dotnet sdk | 3.15,0 | 3.16.07.0 | 8.0 |
| golang | 1.14 | 1,18 | 1,211,221,23 |
| gradle | 6.7 | 7.6 | 8,12 |
| java | Corretto11 | Corretto11Corretto17 | Corretto8Corretto11Corretto17Corretto21 |
| maven | 3.6 | 3.8 | 3.9 |
| nodejs | 14,15 | 16.19 | 20,1822.13 |
| php | 7.4 | 8.1 | 8.38.4 |
| powershell | 7.1 | 7.2 | 7.4 |
| python | 3.8 | 3.10 | 3.103.113.123.13 |
| ruby | 2.7 | 3.1 | 3.23.33.4 |
# Versões do tempo de execução
Ao especificar um runtime na seção [`runtime-versions`](build-spec-ref.md#build-spec.phases.install.runtime-versions) do arquivo buildspec, é possível indicar uma versão específica, uma versão principal específica e a versão secundária mais recente, ou a versão mais recente. A tabela a seguir lista os tempos de execução disponíveis e como especificá-los. Nem todas as versões de runtime estão disponíveis em todas as imagens. A seleção da versão de runtime também não é compatível com as imagens personalizadas. Para obter mais informações, consulte [Runtimes disponíveis](available-runtimes.md). Se você quiser instalar e usar uma versão de runtime personalizada em vez das versões de tempo de execução pré-instaladas, consulte [Versões de runtime personalizadas](#custom-runtime).
**Versões de runtime das plataformas Ubuntu e Amazon Linux 2**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/runtime-versions.html)
Você pode usar uma especificação de compilação para instalar outros componentes (por exemplo AWS CLI, Apache Maven, Apache Ant, Mocha ou similares) durante a fase de compilação. RSpec `install` Para obter mais informações, consulte [Exemplo de buildspec](build-spec-ref.md#build-spec-ref-example).
## Versões de runtime personalizadas
Em vez de usar as versões de tempo de execução CodeBuild pré-instaladas em imagens gerenciadas, você pode instalar e usar as versões personalizadas de sua escolha. A tabela a seguir lista os runtimes personalizados disponíveis e como especificá-los.
**nota**
A seleção da versão de runtime personalizada só é compatível com imagens do Ubuntu e Amazon Linux.
**Versões de runtime personalizadas**
| Nome do runtime | Sintaxe | Exemplo |
| --- | --- | --- |
| dotnet | `..` | `5.0.408` |
| golang | `.` `..` | `1.19` `1.19.1` |
| java | `corretto` | `corretto15` |
| nodejs | `` `.` `..` | `14` `14.21` `14.21.3` |
| php | `..` | `8.0.30` |
| python | `` `.` `..` | `3` `3.7` `3.7.16` |
| ruby | `..` | `3.0.6` |
### Exemplo de buildspec de runtime personalizado
Veja um exemplo de buildspec que especifica versões de runtime personalizadas.
```
version: 0.2
phases:
install:
runtime-versions:
java: corretto15
php: 8.0.30
ruby: 3.0.6
golang: 1.19
python: 3.7
nodejs: 14
dotnet: 5.0.408
```