Criar código manualmente em repositórios de origem

Nesta página, explicamos como criar gatilhos manuais para criar código em repositórios de origem. Os acionadores manuais podem ser usados para invocar versões manualmente. Assim, é possível modificar os valores das variáveis de substituição definidas no momento da invocação antes de executá-las. Também é possível programar acionadores manuais para serem executados automaticamente em um horário específico.

Para saber como iniciar builds manualmente usando a CLI gcloud ou a API Cloud Build, consulte Como iniciar builds manualmente.

Antes de começar

  • Ative a API Cloud Build.

    Funções necessárias para ativar APIs

    Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão com o papel de Proprietário (roles/owner). Caso contrário, é possível receber essa permissão com o papel de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). Saiba como conceder papéis.

    Ativar a API

  • Prepare seu código-fonte.

Gatilhos manuais

Os gatilhoes manuais permitem configurar versões que são executadas apenas quando você invoca o gatilho em repositórios conectados. Por exemplo, você cria um pipeline para implantar seu código-fonte em um ambiente de teste ou ambiente de produção. É recomendável automatizar seu fluxo de trabalho, mas só pretende executar versões manualmente. Você pode definir gatilhos manuais.

Os acionadores manuais permitem invocar manualmente as versões:

  • Buscando código-fonte de um repositório hospedado com um branch ou tag especificados.
  • Parametrizar seu build com substituições que não precisam ser transmitidas manualmente sempre que você executa um build.
  • Como substituir valores de variáveis de substituição definidas no momento da invocação antes de invocar uma versão.

Para executar builds do diretório de trabalho local em vez de um repositório hospedado ou se quiser enviar builds sem criar um gatilho, execute o seguinte comando gcloud no diretório de trabalho:

gcloud builds submit --config BUILD_CONFIG SOURCE_CODE

Em que:

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

Para saber mais sobre como usar o comando gcloud para iniciar versões manualmente no diretório local, consulte Como iniciar versões manualmente.

Como criar gatilhos manuais

Console

Para criar um gatilho manual, faça o seguinte:

  1. Acesse a página Gatilhos:

    Abrir a página Acionadores

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

  3. Clique em Criar gatilho.

  4. Preencha as configurações de gatilho a seguir:

    • Nome: nome do acionador.

    • Região: selecione a região do seu gatilho.

      • Se você selecionar global como a região, o Cloud Build usará o pool padrão para executar o build.
      • Se você selecionar uma região não global e o arquivo de configuração de build associado ao gatilho especificar um pool particular, o Cloud Build usará o pool particular para executar o build. Nesse caso, a região especificada no gatilho precisa corresponder à região em que você criou o pool particular.
      • Se você selecionar uma região não global e o arquivo de configuração de build associado ao gatilho não especificar um pool particular, o Cloud Build usará o pool padrão para executar o build na mesma região do gatilho.

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

    • Evento: selecione Invocação manual para configurar o gatilho de modo que os builds sejam executados somente quando o gatilho for invocado manualmente.

    • Origem: selecione o repositório a ser criado quando o gatilho manual for executado.

    • Geração de repositórios: selecione 2ª geração.

    • Ramificação ou Tag: defina uma das seguintes opções:

      • Filial: defina um gatilho para o build nesse branch. É preciso especificar um valor literal. As expressões regulares não são compatíveis.
      • Tag: define um gatilho para o build nessa tag. É preciso especificar um valor literal. As expressões regulares não são compatíveis.

    • Configuração: selecione o arquivo de configuração do build localizado no seu repositório remoto ou crie um arquivo de configuração do build inline para usar no build.

      • Tipo: selecione o tipo de configuração a ser usado para seu build.
        • Arquivo de configuração do Cloud Build (yaml ou json): use um arquivo de configuração do build na sua configuração.
        • Dockerfile: use um Dockerfile para sua configuração.

      • Local: especifique o local de configuração.

        • Repositório: se o arquivo de configuração estiver no seu repositório remoto, forneça o local do arquivo de configuração do build, o diretório Dockerfile, ou o diretório buildpacks. Se o tipo de configuração do build for um Dockerfile ou um buildpack, você precisará fornecer um nome para a imagem resultante e, opcionalmente, um tempo limite para o seu build. Depois de fornecer o nome da imagem Dockerfile ou do buildpack, você verá uma visualização do comando docker build ou pack que seu build executará.
        • Inline: se você selecionou o arquivo de configuração do Cloud Build (yaml ou json) como opção de configuração, pode especificar a configuração do build inline. Clique em Abrir editor para gravar o arquivo de configuração do build no console Google Cloud usando a sintaxe YAML ou JSON. Clique em Concluído para salvar a configuração do build.

  5. Clique em Criar para criar seu gatilho manual.

gcloud

Para criar um gatilho manual, faça o seguinte:

  1. Abra uma janela do terminal.

  2. Execute o comando gcloud a seguir para criar um gatilho de compilação no projeto:

    gcloud builds triggers create manual \
  --region=REGION \
  --name=TRIGGER_NAME \
  --repository=projects/PROJECT_ID/locations/REGION/connections/CONNECTION_NAME/repositories/REPO_NAME \
  --branch=BRANCH_NAME \
  --build-config=BUILD_CONFIG_FILE \
  --service-account=SERVICE_ACCOUNT

Em que:

  • REGION é a região do gatilho.
  • TRIGGER_NAME é o nome do gatilho.
  • PROJECT_ID é o ID do projeto Google Cloud .
  • CONNECTION_NAME é o nome da conexão do host.
  • REPO_NAME é o nome do repositório;
  • BRANCH_NAME é o nome da ramificação. Também é possível especificar uma tag usando --tag ou um ID de commit usando --sha.
  • BUILD_CONFIG_FILE é o caminho para seu arquivo de configuração da compilação. Também é possível especificar um arquivo de configuração do build inline usando --inline-config ou um Dockerfile usando --dockerfile, --dockerfile-dir e dockerfile-image.
  • SERVICE_ACCOUNT é o e-mail associado à conta de serviço. Se você não incluir essa flag, uma conta de serviço padrão será usada.

Para uma lista completa de flags, consulte a referência de gcloud sobre como criar gatilhos manuais.

Como executar gatilhos manuais

Console

Para executar um gatilho manual usando o console do Google Cloud :

  1. Abra a página Gatilhos no console do Google Cloud .

    Abrir a página "Gatilhos"

  2. Localize o gatilho na lista.

  3. Clique em Executar gatilho.

    Depois de clicar em Executar gatilho, você verá o painel Executar gatilho no lado direito. Se tiver especificado campos como o nome da ramificação, da tag ou das variáveis de substituição, será possível substituí-los no momento da invocação.

    Se o gatilho usar um repositório com mais de 500 ramificações ou tags, algumas delas poderão estar ausentes das sugestões. Você ainda pode inserir um nome de ramificação ou tag manualmente.

    Se você especificou novos valores de variáveis para a substituição, clique em Executar gatilho para executar seu build.

    Para executar gatilhos manuais dentro da programação, consulte Como programar builds.

gcloud

Para executar um gatilho manual usando a ferramenta de linha de comando gcloud, execute o seguinte comando:

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

Em que:

  • TRIGGER_NAME é o nome do gatilho.
  • REGION é a região do gatilho.
  • BRANCH_NAME é o nome da ramificação. Também é possível especificar uma tag usando --tag ou um ID de commit usando --sha.
  • SUBSTITUTION_VAR (opcional) é o nome da variável do valor de substituição.
  • SUBSTITUTION_VALUE (opcional) é o valor associado à sua variável de substituição.

Para executar gatilhos manuais dentro da programação, consulte Como programar builds.

Próximas etapas