Skip to main content

Usando ambientes para trabalhos

Especifique um ambiente para um trabalho.

Visão geral

Use jobs.<job_id>.environment para definir o ambiente que o trabalho referencia. Todas as regras de proteção para implantação têm de ser aprovadas para que um trabalho que faça referência ao ambiente seja enviado a um executor. Para obter mais informações, confira "Usando ambientes para implantação".

Você pode fornecer o ambiente como apenas o ambiente name ou como um objeto de ambiente com o name e a url. A URL é mapeada para environment_url na a API de implantações. Para obter mais informações sobre a API de implantações, confira "Pontos de extremidade da API REST para repositórios".

Exemplo: Usando um único nome de ambiente

environment: staging_environment

Exemplo: Usando o nome de ambiente e URL

environment:
  name: production_environment
  url: https://github.com

O valor de url pode ser uma expressão. Contextos de expressão permitidos: github, inputs, vars, needs, strategy, matrix, job, runner e env. Para obter mais informações sobre expressões, confira "Expressões".

Exemplo: Usando a saída como URL

environment:
  name: production_environment
  url: ${{ steps.step_id.outputs.url_output }}

O valor de name pode ser uma expressão. Contextos de expressão permitidos: github, inputs, vars, needs, strategy e matrix. Para obter mais informações sobre expressões, confira "Expressões".

Exemplo: usando uma expressão como nome de ambiente

environment:
  name: ${{ github.ref_name }}