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

# 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).