Compile manualmente código em repositórios de origem

Esta página explica como criar acionadores manuais para criar código em repositórios de origem. Os acionadores manuais podem ser usados para invocar compilações manualmente, com a capacidade de substituir os valores das variáveis de substituição definidas no momento da invocação antes de executar uma compilação. Também pode agendar acionadores manuais para serem executados automaticamente a uma hora específica.

Para saber como iniciar compilações manualmente através da CLI gcloud ou da API Cloud Build, consulte o artigo Iniciar compilações manualmente.

Antes de começar

  • Enable the Cloud Build API.

    Enable the API

  • Tenha o código-fonte pronto.

Acionadores manuais

Os acionadores manuais permitem-lhe configurar compilações que só são executadas quando invoca o acionador em repositórios ligados. Suponhamos que está a criar um pipeline para implementar o seu código fonte num ambiente de preparação ou de produção. Pode querer automatizar o seu fluxo de trabalho, mas apenas pretende executar compilações manualmente. Pode definir acionadores manuais para o fazer.

Os acionadores manuais permitem-lhe invocar compilações manualmente das seguintes formas:

  • Obter código fonte de um repositório alojado com um ramo ou uma etiqueta especificada.
  • Parametrizar a compilação com substituições que não precisam de ser transmitidas manualmente sempre que executa uma compilação.
  • Substituir os valores das variáveis de substituição definidas no momento da invocação antes de invocar uma compilação.

Se quiser executar compilações a partir do seu diretório de trabalho local em vez de um repositório alojado ou quiser enviar compilações sem criar um acionador, pode executar o seguinte comando gcloud no seu diretório de trabalho:

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

Onde:

  • BUILD_CONFIG é o caminho para o ficheiro de configuração de compilação.
  • SOURCE_CODE é o caminho ou o código-fonte do URL.

Para saber como usar o comando gcloud para iniciar compilações manualmente no diretório local, consulte o artigo Iniciar compilações manualmente.

Criar acionadores manuais

Consola

Para criar um acionador manual:

  1. Abra a página Acionadores:

    Abra a página Acionadores

  2. Selecione o projeto na parte superior da página e clique em Abrir.

  3. Clique em Criar acionador.

  4. Introduza as seguintes definições do acionador:

    • Nome: um nome para o acionador.

    • Região: selecione a região para o seu acionador.

      • Se selecionar global como a região, o Cloud Build usa o conjunto predefinido para executar a compilação.
      • Se selecionar uma região não global e o ficheiro de configuração de compilação associado ao acionador especificar um pool privado, o Cloud Build usa o pool privado para executar a compilação. Neste caso, a região especificada no acionador tem de corresponder à região onde criou o seu conjunto privado.
      • Se selecionar uma região não global e o ficheiro de configuração de compilação associado ao acionador não especificar um conjunto privado, o Cloud Build usa o conjunto predefinido para executar a compilação na mesma região que o acionador.

    • Descrição (opcional): uma descrição do acionador.

    • Evento: selecione Invocar manualmente para configurar o acionador de modo que as compilações só sejam executadas quando o acionador for invocado manualmente.

    • Origem: selecione o repositório a compilar quando o acionador manual é executado. Pode especificar 1st generation (1.ª geração) ou 2nd generation (2.ª geração) como origem.

    • Revisão: selecione a ramificação ou a etiqueta a criar quando o acionador manual for executado.

    • Branch: defina um acionador para criar nesta ramificação. Tem de especificar um valor literal. Atualmente, as expressões regulares não são suportadas.

    • Etiqueta: defina um acionador para criar com base nesta etiqueta. Tem de especificar um valor literal. Atualmente, as expressões regulares não são suportadas.

    • Configuração: selecione o ficheiro de configuração de compilação localizado no seu repositório remoto ou crie um ficheiro de configuração de compilação inline para usar na sua compilação.

      • Tipo: selecione o tipo de configuração a usar para a sua compilação.
        • Ficheiro de configuração do Cloud Build (YAML ou JSON): use um ficheiro de configuração de compilação para a sua configuração.
        • Dockerfile: use um Dockerfile para a sua configuração.

      • Localização: especifique a localização da configuração.

        • Repositório: se o ficheiro de configuração estiver localizado no seu repositório remoto, indique a localização do ficheiro de configuração de compilação, do Dockerfilediretório ou do diretório de pacotes de compilação. Se o seu tipo de configuração de compilação for Dockerfile ou um buildpack, tem de fornecer um nome para a imagem resultante e, opcionalmente, um limite de tempo para a compilação. Quando tiver indicado o nome da imagem Dockerfile ou do buildpack, é apresentada uma pré-visualização do comando docker build ou pack que a sua compilação vai executar.
        • Inline: se selecionou Ficheiro de configuração do Cloud Build (YAML ou JSON) como opção de configuração, pode especificar a configuração de compilação inline. Clique em Abrir editor para escrever o ficheiro de configuração de compilação na Google Cloud consola com a sintaxe YAML ou JSON. Clique em Concluído para guardar a configuração de compilação.

  5. Clique em Criar para criar o acionador manual.

gcloud

Para ver uma lista completa de flags, consulte a referência gcloud para saber como criar acionadores manuais.

Executar acionadores manuais

Consola

Para executar um acionador manual através da Google Cloud consola:

  1. Abra a página Acionadores na Google Cloud consola.

    Abra a página de acionadores

  2. Localize o acionador na lista.

  3. Clique em Executar acionador.

    Depois de clicar em Executar acionador, é apresentado o painel da janela Executar acionador no lado direito. Se especificou campos como um nome de filial, um nome de etiqueta ou variáveis de substituição, pode substituir estes campos no momento da invocação.

    Se especificou novos valores de variáveis para a substituição, clique em Executar acionador para executar a compilação.

    Para executar acionadores manuais de acordo com um agendamento, consulte o artigo Agendar compilações.

gcloud

Para executar um acionador manual através da ferramenta de linha de comandos gcloud, execute o seguinte comando:

      gcloud builds triggers run TRIGGER_NAME \
         --region=REGION \
         --branch=BRANCH_NAME \
         --substitutions=SUBSTITUTION_VAR=SUBSTITUTION_VALUE

Onde:

  • TRIGGER_NAME é o nome do acionador.
  • REGION é a região do seu acionador.
  • BRANCH_NAME é o nome da sua filial. Também pode especificar uma etiqueta através de --tag ou um ID de confirmação através de --sha.
  • [Opcional]SUBSTITUTION_VAR é o nome da variável do valor de substituição.
  • [Opcional] SUBSTITUTION_VALUE é o valor associado à variável de substituição.

Para executar acionadores manuais de acordo com um horário, consulte o artigo Agendar compilações.

Passos seguintes