Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Usando ambientes para trabalhos

Especifique um ambiente para um trabalho.

Observação: no momento, não há suporte para os executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Visão geral

Use jobs.<job_id>.environment para definir o ambiente que o trabalho referencia. Todas as regras de proteção do ambiente 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 "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 }}