Visão geral do Cloud Build

O Cloud Build é um serviço que executa seus builds 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.

Você também pode usar o Cloud Build para proteger sua cadeia de suprimentos de software. Os recursos do Cloud Build atendem aos requisitos do nível 3 dos Níveis da cadeia de suprimentos para artefatos de software (SLSA). Para 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 manualmente as criações no Cloud Build usando a Google Cloud CLI ou a API Cloud Build ou usar acionadores de versão do Cloud Build para criar um fluxo de trabalho de integração contínua/entrega contínua (CI/CD) que inicia novas criaçõ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 criação usando a CLI gcloud, a API Cloud Build ou a página Histórico de criações na seção Cloud Build do consoleGoogle Cloud , que mostra detalhes e registros de cada criação executada pelo Cloud Build. Para instruções, consulte Como ver os resultados da criaçã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 o Docker Engine versão 20.10.24.

Interfaces do Cloud Build

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

No console Google Cloud , é possível ver os resultados do build do Cloud Build na página Histórico do build e automatizar os builds em Gatilhos de build.

Use a CLI gcloud para criar e gerenciar versões. Também é possível executar comandos para realizar tarefas como enviar uma versão, listar versões e cancelar uma versão.

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 particulares

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 recursos entre o pool padrão e o pool particular, consulte Visão geral dos pools particulares.

Criar segurança

O Cloud Build oferece vários recursos para proteger seus builds, incluindo:

  • Builds automatizadas

    Um build automatizado ou com script define todas as etapas de build no script ou na configuração, incluindo as etapas para recuperar o código-fonte e 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 de build para fornecer etapas de build ao Cloud Build.

    Os builds automatizados oferecem 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 a partir de builds locais pode introduzir muitas preocupações de segurança, inconsistências e ineficiências no processo de build.

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

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

  • Procedência do build

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

    Os metadados de procedência incluem detalhes como os resumos das imagens criadas, os locais da origem de entrada, a cadeia de ferramentas e a duração do build.

    Gerar a origem do build ajuda você a:

    • Verificar 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 build não confiável.

    É possível usar mecanismos de alertas e políticas para usar de maneira proativa os dados de procedência da build. Por exemplo, é possível criar políticas que permitam apenas implantações de código criado com base em fontes verificadas.

    O Cloud Build pode gerar procedência de build para imagens de contêiner que oferecem garantia de nível 3 do SLSA. Para mais informações, consulte Como ver a origem da build.

  • Ambiente de build efêmero

    Os ambientes efêmeros são temporários e duram apenas uma invocação de build. Após o build, o ambiente é limpo ou excluído. Os builds efêmeros garantem que o serviço e as etapas de build sejam executados em um ambiente efêmero, como um contêiner ou uma VM. Em vez de reutilizar um ambiente de build atual, o serviço provisiona um novo ambiente para cada build e o destrói após a conclusão do processo.

    Os ambientes efêmeros 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 efêmero oferece aos invasores a oportunidade de injetar arquivos e conteúdo maliciosos. Um ambiente efêmero 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 build e o destrói depois.

  • Políticas de implantação

    É possível integrar o Cloud Build à autorização binária para verificar atestados de build e bloquear implantações de imagens que não foram geradas pelo Cloud Build. Esse processo pode reduzir o risco de implantação de software não autorizado.

  • Chaves de criptografia gerenciadas pelo cliente

    O Cloud Build oferece conformidade com as chaves de criptografia gerenciadas pelo cliente (CMEK) por padrão. Os usuários não precisam configurar nada especificamente. O Cloud Build oferece conformidade com a CMEK criptografando o disco permanente (DP) com tempo de build 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 por engenheiros do Google nem pela equipe de suporte e não pode ser restaurado. Os dados que foram protegidos usando essa chave estão permanentemente inacessíveis. Para mais informações, consulte Conformidade com CMEK no Cloud Build.

  • Painel de insights de segurança

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

    Esse painel mostra as seguintes informações:

    • Nível da cadeia de suprimentos para artefatos de software (SLSA): identifica o nível de maturidade do processo de build de software de acordo com a especificação do SLSA.

    • Vulnerabilidades: uma visão geral de todas as vulnerabilidades encontradas nos seus artefatos e o nome da imagem verificada pelo Artifact Analysis. Clique no nome da imagem para ver os detalhes da vulnerabilidade.

    • Detalhes do build: detalhes do build, como o builder e o link para visualizar registros.

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

Para saber como usar o Cloud Build com outros produtos e recursos do Google Cloud para proteger sua cadeia de suprimentos de software, consulte Segurança da cadeia de suprimentos de software.

A seguir