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

# Planejar uma compilação no AWS CodeBuild
<a name="planning"></a>

Antes de usar o AWS CodeBuild, é necessário responder a estas perguntas:

1. **Onde o código-fonte é armazenado?** O CodeBuild no momento é compatível com a compilação pelos provedores de repositórios de código-fonte a seguir. O código-fonte deve conter um arquivo de especificação de compilação (buildspec). *buildspec* é uma coleção de comandos de compilação e configurações relacionadas, no formato YAML, que o CodeBuild usa para executar uma compilação. É possível declarar um buildspec em uma definição de projeto de compilação. 

     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/planning.html)

1. **Que comandos de build você precisa executar e em que ordem?** Por padrão, o CodeBuild baixa a entrada de compilação do provedor que você especificar e faz upload da saída de compilação para o bucket especificado. Você usa a buildspec para instruir como a entrada de compilação obtida por download é convertida na saída de compilação esperada. Para obter mais informações, consulte a [Referência de buildspec](build-spec-ref.md).

1. **De que runtimes e ferramentas você precisa para executar o build?** Por exemplo, você está fazendo um build para Java, Ruby, Python ou Node.js? O build precisa de Maven ou Ant, ou de um compilador para Java, Ruby ou Python? O build precisa de Git, AWS CLI, ou outras ferramentas? 

   O CodeBuild executa as compilações em ambientes que usam imagens do Docker. Essas imagens do Docker devem ser armazenadas em um tipo de repositório compatível com o CodeBuild. Isso inclui o repositório de imagens do Docker do CodeBuild, o Docker Hub e o Amazon Elastic Container Registry (Amazon ECR). Para obter mais informações sobre o repositório de imagens do Docker no CodeBuild, consulte [Imagens do Docker fornecidas por CodeBuild](build-env-ref-available.md).

1. **Você precisa de recursos da AWS que não são fornecidos automaticamente pelo CodeBuild? Em caso afirmativo, de quais políticas de segurança esses recursos precisam?** Por exemplo, talvez seja necessário modificar o perfil de serviço do CodeBuild para permitir que o CodeBuild funcione com esses recursos. 

1. **Deseja que o CodeBuild funcione com a VPC?** Em caso positivo, você precisa do ID da VPC, dos IDs de sub-rede e dos IDs de security group para a configuração da VPC. Para obter mais informações, consulte [Use AWS CodeBuild com a Amazon Virtual Private Cloud](vpc-support.md).

Depois de responder a essas perguntas, você deverá ter as configurações e recursos necessários para executar com êxito um build. Para executar seu build, você pode:
+ Use o console do AWS CodeBuild, a AWS CLI ou os SDKs da AWS. Para obter mais informações, consulte [Executar compilações manualmente](run-build.md).
+ Crie ou identifique um pipeline no AWS CodePipeline e, então, adicione uma compilação ou uma ação de teste que instrua o CodeBuild a testar automaticamente o código, executar a compilação ou ambos. Para obter mais informações, consulte [Use CodeBuild com CodePipeline](how-to-create-pipeline.md).