Visão geral do Cloud Build

O Cloud Build é um serviço que executa suas versões no Google Cloud.

O Cloud Build pode importar o código-fonte de uma variedade de repositórios ou espaços do Cloud Storage, executar uma versão para suas especificações e produzir artefatos como contêineres Docker ou arquivos Java.

Também é possível usar o Cloud Build para proteger sua cadeia de suprimentos de software. Os recursos do Cloud Build atendem aos requisitos do nível 3 da cadeia de suprimentos para artefatos de software (SLSA). Para conferir orientações sobre como proteger seus processos de build, consulte Proteger builds.

Configuração da compilação e etapas de compilação

Você pode gravar uma configuração da versão para fornecer instruções ao Cloud Build sobre quais tarefas executar. Você pode configurar versões para buscar dependências, executar testes de unidade, análises estáticas e testes de integração e criar artefatos com ferramentas de versão, como docker, gradle, maven, bazel e gulp.

O Cloud Build executa sua versão como uma série de etapas de versão, em que cada uma delas é executada em um contêiner do Docker. Executar etapas de versão é análogo à execução de comandos em um script.

É possível usar as etapas de versão fornecidas pelo Cloud Build e pela comunidade dele ou gravar suas próprias etapas de versão personalizadas:

Cada etapa de criação é executada com o respectivo contêiner anexado a uma rede local do Docker chamada cloudbuild. Isso permite que as etapas de versão se comuniquem entre si e compartilhem dados. Para mais informações sobre a rede cloudbuild, consulte Rede do Cloud Build.

É possível usar imagens Docker Hub padrão no Cloud Build, como Ubuntu e Gradle.

Como iniciar versões

É possível iniciar versões manualmente no Cloud Build usando a Google Cloud CLI ou a API Cloud Build, ou usar acionadores de compilação do Cloud Build para criar um fluxo de trabalho automatizado de integração/entrega contínua (CI/CD) que inicia novas versões em resposta a mudanças de código.

É possível integrar acionadores de versão com muitos repositórios de código, incluindo Cloud Source Repositories, GitHub e Bitbucket.

Como ver os resultados do build

É possível ver os resultados da versão usando a CLI gcloud, a API Cloud Build ou a página Histórico da versão na seção do Cloud Build no Console do Google Cloud, que exibe detalhes e registros para cada compilação executada pelo Cloud Build. Para instruções, consulte Como ver os resultados da versão.

Como funciona a versão

Nas etapas a seguir, descrevemos, de modo geral, o ciclo de vida de uma versão do Cloud Build:

  1. Prepare o código do seu aplicativo e os recursos necessários.
  2. Crie um arquivo de solicitação de versão, no formato YAML ou JSON, que contenha instruções para o Cloud Build.
  3. Envie a versão para o Cloud Build.
  4. O Cloud Build executa sua versão com base na solicitação de versão que você forneceu.
  5. Se aplicável, todos os artefatos criados são enviados para o Artifact Registry.

Docker

O Cloud Build usa o Docker para executar builds. Para cada etapa da criação, o Cloud Build executa um contêiner de Docker como uma instância de docker run. Atualmente, o Cloud Build está executando a versão 20.10.17 do mecanismo Docker.

Interfaces do Cloud Build

É possível usar o Cloud Build com o console do Google Cloud, a ferramenta de linha de comando gcloud ou a API REST do Cloud Build.

No console do Google Cloud, é possível ver os resultados da versão do Cloud Build na página Histórico da versão e automatizar versões em Gatilhos de versão.

É possível usar a CLI gcloud para criar e gerenciar versões. Também é possível executar comandos para realizar tarefas como enviar um build, listar builds e cancelar um build.

Você pode solicitar versões usando a API REST Cloud Build.

Igual a outras APIs do Cloud Platform, você precisa autorizar o acesso usando OAuth2. Depois de autorizar o acesso, você pode usar a API para iniciar novas versões, ver o status e os detalhes da versão, listar versões por projeto e cancelar versões em execução.

Para saber mais informações, consulte a documentação da API.

Pools padrão e privados

Por padrão, quando você executa uma versão no Cloud Build, ela é executada em um ambiente hospedado e seguro com acesso à Internet pública. Cada versão é executada no próprio worker e está isolada de outras cargas de trabalho. É possível personalizar seu build de várias maneiras, incluindo aumentando o tamanho do tipo de máquina ou alocando mais espaço em disco. O pool padrão tem limites de personalização do ambiente, especialmente em torno do acesso à rede privada.

Pools particulares são pools particulares e dedicados de workers que oferecem maior personalização no ambiente de criação, incluindo a capacidade de acessar recursos em uma rede particular. Os pools particulares, semelhantes aos pools padrão, são hospedados e totalmente gerenciados pelo Cloud Build e escalonados para cima e para baixo até zero, sem infraestrutura para configurar, fazer upgrade ou escalonar. Como os pools privados são recursos específicos do cliente, é possível configurá-los de outras maneiras.

Para saber mais sobre pools particulares e a diferença de atributos entre o pool padrão e o particular, consulte a Visão geral do pool particular.

Desenvolver a segurança

O Cloud Build oferece vários recursos para proteger as versões, incluindo:

  • Builds automatizados

    Um build automatizado ou com script define todas as etapas do build no script ou na configuração da build, incluindo etapas para recuperar o código-fonte e etapas para criar o código. O único comando manual, se houver, é o comando para executar o build. O Cloud Build usa um arquivo de configuração da versão para fornecer etapas de compilação ao Cloud Build.

    Os builds automatizados fornecem consistência nas etapas de build. No entanto, também é importante executar builds em um ambiente consistente e confiável.

    Embora os builds locais possam ser úteis para fins de depuração, o lançamento de software de builds locais pode introduzir muitos problemas de segurança, inconsistências e ineficiências no processo de build.

    • Permitir builds locais é uma maneira de um invasor com a intenção maliciosa modificar o processo de build.
    • Inconsistências nos ambientes locais e nas práticas do desenvolvedor dificultam a reprodução dos builds e o diagnóstico de problemas.

    Nos requisitos do framework SLSA, os builds automatizados são um requisito do SLSA de nível 1, e o uso de um serviço de build em vez de ambientes de desenvolvedor para builds é um requisito para o SLSA de nível 2.

  • Procedência do build

    A procedência do build é uma coleção de dados verificáveis sobre um build.

    Os metadados de origem incluem detalhes como os resumos das imagens criadas, os locais da origem de entrada, o conjunto de ferramentas e a duração da compilação.

    A geração da procedência da compilação ajuda você a:

    • Verifique se um artefato criado foi criado de um local de origem confiável e por um sistema de build confiável.
    • Identifique o código injetado de um local de origem ou sistema de compilação não confiável.

    É possível usar mecanismos de alerta e política para aproveitar os dados de procedência da compilação de maneira proativa. Por exemplo, é possível criar políticas que permitam apenas implantações de código criado a partir de origens verificadas.

    O Cloud Build pode gerar a procedência da build para imagens de contêiner que fornecem garantia de nível 3 da SLSA. Para saber mais, consulte Como visualizar a procedência da compilação.

  • Ambiente de build temporário

    Ambientes temporários são temporários e servem para durar uma única invocação de build. Após a criação, o ambiente é excluído permanentemente ou excluído. Os builds temporários garantem que o serviço e as etapas de build sejam executados em um ambiente temporário, como um contêiner ou uma VM. Em vez de reutilizar um ambiente de build já existente, o serviço de build provisiona um novo ambiente para cada build e o destrói após a conclusão do processo de build.

    Ambientes temporários garantem builds limpos, já que não há arquivos residuais ou configurações de ambiente de builds anteriores que possam interferir no processo de build. Um ambiente não temporário oferece uma oportunidade para que os invasores injetem arquivos e conteúdos maliciosos. Um ambiente temporário também reduz a sobrecarga de manutenção e as inconsistências no ambiente de build.

    O Cloud Build configura um novo ambiente de máquina virtual para cada compilação e o destrói após a criação.

  • Políticas de implantação

    É possível integrar o Cloud Build com autorização binária para verificar os atestados da versão e bloquear as implantações de imagens que não são geradas pelo Cloud Build. Esse processo pode reduzir o risco de implantar software não autorizado.

  • Chaves de criptografia gerenciadas pelo cliente

    O Cloud Build fornece conformidade com as chaves de criptografia gerenciadas pelo cliente (CMEK, na sigla em inglês) por padrão. Os usuários não precisam configurar nada especificamente. O Cloud Build fornece conformidade com a CMEK criptografando o disco permanente (DP) de tempo de compilação com uma chave temporária gerada para cada build. A chave é gerada exclusivamente para cada build.

    Assim que o build é concluído, a chave é apagada da memória e destruída. Ele não é armazenado em nenhum lugar, não pode ser acessado pelos engenheiros ou pela equipe de suporte do Google e não pode ser restaurado. Os dados que foram protegidos usando essa chave ficam permanentemente inacessíveis. Para mais informações, consulte Compliance com CMEK no Cloud Build.

  • Painel de insights de segurança

    O Cloud Build inclui um painel Insights de segurança no Console do Google Cloud que exibe uma visão geral de alto nível de várias métricas de segurança. Use esse painel para identificar e mitigar riscos no processo de build.

    Esse painel mostra as seguintes informações:

    • Nível da cadeia de suprimentos para artefatos de software (SLSA, na sigla em inglês): identifica o nível de maturidade do processo de criação de software de acordo com a especificação do SLSA (em inglês).

    • Vulnerabilidades: uma visão geral de todas as vulnerabilidades encontradas nos seus artefatos e o nome da imagem que o Artifact Analysis verificado. Você pode clicar no nome da imagem para visualizar os detalhes da vulnerabilidade. Por exemplo, na captura de tela, clique em java-guestbook-backend.

    • Detalhes da versão: detalhes da versão, como o builder e o link para ver registros.

    • Procedência do build: procedência do build.

  • Escudo de entrega de software

    O Cloud Build faz parte da solução Software Delivery Shield. O Software Delivery Shield é uma solução completa e totalmente gerenciada de segurança da cadeia de suprimentos de software que ajuda a melhorar a postura de segurança dos fluxos de trabalho e ferramentas do desenvolvedor, dependências de software, sistemas de CI/CD usados para criar e implantar seu software e ambientes de execução, como o Google Kubernetes Engine e o Cloud Run. Para saber como usar o Cloud Build com outros componentes do Software Delivery Shield para melhorar a postura de segurança da cadeia de suprimentos de software, consulte a Visão geral do Software Delivery Shield.

A seguir