

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á.

# O que é AWS CodeBuild?
<a name="welcome"></a>

AWS CodeBuild é um serviço de criação totalmente gerenciado na nuvem. CodeBuild compila seu código-fonte, executa testes de unidade e produz artefatos prontos para serem implantados. CodeBuild elimina a necessidade de provisionar, gerenciar e escalar seus próprios servidores de compilação. Ele fornece ambientes de compilação com pacotes predefinidos para linguagens populares de programação e ferramentas de compilação, como Apache Maven, Gradle, entre outras. Você também pode personalizar ambientes de compilação CodeBuild para usar suas próprias ferramentas de compilação. CodeBuild escala automaticamente para atender às solicitações de pico de construção.

CodeBuild fornece os seguintes benefícios:
+  **Totalmente gerenciado** — CodeBuild elimina a necessidade de configurar, corrigir, atualizar e gerenciar seus próprios servidores de compilação.
+  **Sob demanda** — CodeBuild escala sob demanda para atender às suas necessidades de construção. Você paga somente pela quantidade de minutos de compilação que consumir.
+  **Pronto para uso** — CodeBuild fornece ambientes de construção pré-configurados para as linguagens de programação mais populares. Tudo o que você precisa fazer é apontar para o seu script de compilação para iniciar sua primeira compilação.

Para obter mais informações, consulte [AWS CodeBuild](https://aws.amazon.com/codebuild/). 

## Como correr CodeBuild
<a name="welcome-quick-look"></a>

Você pode usar o AWS CodePipeline console AWS CodeBuild ou para executar CodeBuild. Você também pode automatizar a execução do CodeBuild usando o AWS Command Line Interface (AWS CLI) ou o. AWS SDKs



![\[O diagrama mostra como CodeBuild funciona com AWS CLI ou AWS SDKs.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/overview.png)




Como mostra o diagrama a seguir, você pode adicionar CodeBuild como uma ação de construção ou teste ao estágio de construção ou teste de um pipeline em AWS CodePipeline. AWS CodePipeline é um serviço de entrega contínua que você pode usar para modelar, visualizar e automatizar as etapas necessárias para liberar seu código. Isso inclui a compilação de seu código. Um *pipeline* é uma construção de fluxo de trabalho que descreve como as alterações de código atravessam um processo de lançamento.



![\[O diagrama mostra como CodeBuild funciona com AWS CodePipeline.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/pipeline.png)




Para usar CodePipeline para criar um pipeline e depois adicionar uma ação de CodeBuild criação ou teste, consulte[Use CodeBuild com CodePipeline](how-to-create-pipeline.md). Para obter mais informações sobre CodePipeline, consulte o [Guia AWS CodePipeline do usuário](https://docs.aws.amazon.com/codepipeline/latest/userguide/).

O CodeBuild console também fornece uma maneira de pesquisar rapidamente seus recursos, como repositórios, criar projetos, aplicativos de implantação e pipelines. Selecione **Go to resource** (Acessar recurso) ou pressione a tecla `/` e insira o nome do recurso. Qualquer correspondência aparecerá na lista. As pesquisas não diferenciam letras maiúsculas de minúsculas. Só é possível ver recursos para os quais você tem permissão de visualizar. Para obter mais informações, consulte [Visualizar recursos no console](console-resources.md). 

## Preços para CodeBuild
<a name="welcome-pricing"></a>

Para obter mais informações, consulte [Definição de preço do CodeBuild ](https://aws.amazon.com/codebuild/pricing).

## Como faço para começar com CodeBuild?
<a name="welcome-getting-started"></a>

É recomendável que você realize as etapas a seguir:

1. **Saiba** mais CodeBuild lendo as informações em[Conceitos](concepts.md).

1. **Experimente** CodeBuild um cenário de exemplo seguindo as instruções em[Conceitos básicos que usam o console](getting-started-overview.md#getting-started).

1. **Use** CodeBuild em seus próprios cenários seguindo as instruções em[Planejar uma compilação](planning.md).

# AWS CodeBuild conceitos
<a name="concepts"></a>

Os conceitos a seguir são importantes para entender como CodeBuild funciona.

**Topics**
+ [

## Como CodeBuild funciona
](#concepts-how-it-works)
+ [

## Próximas etapas
](#concepts-next-steps)

## Como CodeBuild funciona
<a name="concepts-how-it-works"></a>

O diagrama a seguir mostra o que acontece quando você executa uma compilação com CodeBuild: 



![\[Um diagrama de como CodeBuild funciona a execução de uma compilação.\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/images/arch.png)




1. Como entrada, você deve CodeBuild fornecer um projeto de construção. Um *projeto de compilação* inclui informações sobre como executar uma compilação, incluindo onde obter o código-fonte, qual ambiente de compilação usar, quais comandos de compilação executar e onde armazenar a saída da compilação. Um *ambiente de compilação* representa uma combinação de sistema operacional, tempo de execução da linguagem de programação e ferramentas CodeBuild usadas para executar uma compilação. Para obter mais informações, consulte:
   + [Criar um projeto de compilação](create-project.md)
   + [Referência de ambiente de compilação](build-env-ref.md)

1. CodeBuild usa o projeto de construção para criar o ambiente de construção.

1. CodeBuild baixa o código-fonte no ambiente de compilação e, em seguida, usa a especificação de compilação (buildspec), conforme definida no projeto de compilação ou incluída diretamente no código-fonte. Um *buildspec* é uma coleção de comandos de compilação e configurações relacionadas, no formato YAML, CodeBuild usados para executar uma compilação. Para obter mais informações, consulte o [Referência de buildspec](build-spec-ref.md).

1. Se houver alguma saída de compilação, o ambiente de compilação fará upload de sua saída para um bucket do S3. O ambiente de compilação também pode executar tarefas especificadas no buildspec (por exemplo, enviar notificações de compilação a um tópico do Amazon SNS). Para ver um exemplo, consulte [Exemplo de notificações de compilação](sample-build-notifications.md).

1. Enquanto a compilação está em execução, o ambiente de compilação envia informações para CodeBuild a Amazon CloudWatch Logs.

1. Enquanto a compilação estiver em execução, você pode usar o AWS CodeBuild console ou AWS SDKs obter informações resumidas CodeBuild e detalhadas da compilação do Amazon CloudWatch Logs. AWS CLI Se você usa AWS CodePipeline para executar compilações, pode obter informações limitadas de CodePipeline compilação em.

## Próximas etapas
<a name="concepts-next-steps"></a>

Agora que você sabe mais sobre isso AWS CodeBuild, recomendamos as próximas etapas:

1. **Experimente** CodeBuild em um cenário de exemplo seguindo as instruções em[Conceitos básicos que usam o console](getting-started-overview.md#getting-started).

1. **Use** CodeBuild em seus próprios cenários seguindo as instruções em[Planejar uma compilação](planning.md).