{"meta":{"title":"Gerenciar ambientes para implantação","intro":"Você pode criar ambientes e proteger esses ambientes com regras de proteção de implantação. Um trabalho que faz referência a um ambiente deve seguir quaisquer regras de proteção para o ambiente antes de executar ou acessar os segredos do ambiente.","product":"GitHub Actions","breadcrumbs":[{"href":"/pt/actions","title":"GitHub Actions"},{"href":"/pt/actions/how-tos","title":"Instruções"},{"href":"/pt/actions/how-tos/deploy","title":"Implantar"},{"href":"/pt/actions/how-tos/deploy/configure-and-manage-deployments","title":"Configurar e gerenciar implantações"},{"href":"/pt/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments","title":"Gerenciar ambientes"}],"documentType":"article"},"body":"# Gerenciar ambientes para implantação\n\nVocê pode criar ambientes e proteger esses ambientes com regras de proteção de implantação. Um trabalho que faz referência a um ambiente deve seguir quaisquer regras de proteção para o ambiente antes de executar ou acessar os segredos do ambiente.\n\n## Pré-requisitos\n\n> \\[!NOTE]\n> Os usuários com planos GitHub Free só podem configurar ambientes para repositórios públicos. Se você converter um repositório de público em privado, todas as regras de proteção ou segredos de ambiente configurados serão ignorados, e você não conseguirá configurar nenhum ambiente. Se você converter seu repositório de volta para público, você terá acesso a todas as regras de proteção e segredos de ambiente previamente configurados.\n>\n> Organizações com GitHub Team e usuários com GitHub Pro podem configurar ambientes para repositórios privados. Para saber mais, confira [Planos do GitHub](/pt/get-started/learning-about-github/githubs-plans).\n\n* Para obter informações gerais sobre ambientes, confira [Implantando com GitHub Actions](/pt/actions/concepts/use-cases/deploying-with-github-actions#using-environments).\n* Para obter informações sobre as regras disponíveis, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments).\n\n## Criando um ambiente\n\nPara configurar um ambiente em um repositório de conta pessoal, você deve ser o proprietário do repositório. Para configurar um ambiente em um repositório da organização, você precisa ter acesso de `admin`.\n\n> \\[!NOTE]\n>\n> * A criação de um ambiente em um repositório privado está disponível para organizações com GitHub Team e usuários com GitHub Pro.\n> * Alguns recursos para ambientes não estão disponíveis ou têm disponibilidade limitada para repositórios privados. Se você não conseguir acessar um recurso descrito nas instruções abaixo, confira a documentação vinculada na etapa relacionada para obter as informações de disponibilidade.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n3. Na barra lateral esquerda, clique em **Ambientes**.\n4. Clique em **Novo ambiente**.\n5. Insira um nome para o ambiente e clique em **Configurar ambiente**. Os nomes de ambiente não diferenciam maiúsculas de minúsculas. Um nome de ambiente não pode exceder 255 caracteres e deve ser único dentro do repositório.\n6. Opcionalmente, especifique as pessoas ou equipes que devem aprovar os trabalhos do fluxo de trabalho que usam esse ambiente. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#required-reviewers).\n 1. Selecione **Revisores necessários**.\n 2. Insira até até 6 pessoas ou equipes. Apenas um dos revisores precisam aprovar o trabalho para que prossiga.\n 3. Opcionalmente, para impedir que os usuários aprovem as execuções de fluxos de trabalho que eles dispararam, selecione **Impedir a auto-revisão**.\n 4. Clique em **Salvar regras de proteção**.\n7. Opcionalmente, especifique o tempo a esperar antes de permitir que os trabalhos do fluxo de trabalho que usam esse ambiente prossigam. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#wait-timer).\n 1. Selecione **Temporizador de espera**.\n 2. Insira o número de minutos para esperar.\n 3. Clique em **Salvar regras de proteção**.\n8. Opcionalmente, impedir a ignorância das regras de proteção configuradas. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#allow-administrators-to-bypass-configured-protection-rules).\n 1. Desmarque **Permitir que os administradores ignorem as regras de proteção configuradas**.\n 2. Clique em **Salvar regras de proteção**.\n9. Opcionalmente, habilite quaisquer regras personalizadas de proteção de implantação que tenham sido criadas com o GitHub Apps. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#custom-deployment-protection-rules).\n 1. Selecione a regra de proteção personalizada que você deseja habilitar.\n 2. Clique em **Salvar regras de proteção**.\n10. Opcionalmente, especifique quais branches e tags podem ser implantados neste ambiente. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#deployment-branches-and-tags).\n 1. Selecione a opção desejada no menu suspenso **Branches de implantação**.\n\n 2. Se você escolheu **Ramos e etiquetas selecionados**, para adicionar uma nova regra, clique em **Adicionar regra de implantação de ramo ou etiqueta**\n\n 3. No menu suspenso \"Ref type\", dependendo da regra que você deseja aplicar, selecione ** Branch** ou ** Tag**.\n\n 4. Insira o padrão de nome do branch ou tag que você deseja permitir.\n\n > \\[!NOTE]\n > Os padrões de nomes devem ser configurados individualmente para branches ou rótulos.\n\n 5. Clique em **Adicionar regra**.\n11. Opcionalmente, adicione segredos de ambiente. Esses segredos só estão disponíveis para trabalhos de fluxo de trabalho que usam o ambiente. Além disso, os trabalhos do fluxo de trabalho que usam este ambiente só podem acessar esses segredos após qualquer regra configurada (por exemplo, revisores obrigatórios) ser aprovada. Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#environment-secrets).\n 1. Em **Segredos do ambiente**, clique em **Adicionar Segredo**.\n 2. Insira o nome do segredo.\n 3. Insira o valor do segredo.\n 4. Clique em **Adicionar segredo**.\n12. Opcionalmente, adicione variáveis de ambiente. Essas variáveis só ficam disponíveis para trabalhos de fluxo de trabalho que usam o ambiente e só podem ser acessadas usando o contexto [`vars`](/pt/actions/learn-github-actions/contexts#vars-context). Para saber mais, confira [Implantações e ambientes](/pt/actions/reference/deployments-and-environments#environment-variables).\n 1. Em **Variáveis de ambiente**, clique em **Adicionar Variável**.\n 2. Informe o nome da variável.\n 3. Informe o valor da variável.\n 4. Clique em **Adicionar variável**.\n\nTambém é possível criar e configurar ambientes por meio da API REST. Para saber mais, confira [Endpoints da API REST para contextos de implantação](/pt/rest/deployments/environments), [Pontos de extremidade da API REST para segredos do GitHub Actions](/pt/rest/actions/secrets), [Pontos de extremidade da API REST para variáveis de GitHub Actions](/pt/rest/actions/variables) e [Pontos de extremidade da API REST para políticas de branch de implantação](/pt/rest/deployments/branch-policies).\n\nExecutar um fluxo de trabalho que faz referência a um ambiente que não existe criará um ambiente com o nome referenciado. Se o ambiente for criado a partir da execução de builds de página implícitos (por exemplo, a partir de uma ramificação ou pasta de origem), a ramificação de origem será adicionada como uma regra de proteção ao ambiente. Caso contrário, o novo ambiente criado não terá nenhuma regra de proteção ou segredo configurado. Qualquer pessoa que possa editar fluxos de trabalho no repositório pode criar ambientes por meio de um arquivo de fluxo de trabalho, mas apenas os administradores do repositório podem configurar o ambiente.\n\n## Excluir um ambiente\n\nPara configurar um ambiente em um repositório de conta pessoal, você deve ser o proprietário do repositório. Para configurar um ambiente em um repositório da organização, você precisa ter acesso de `admin`.\n\nA exclusão de um ambiente apagará todos os segredos e regras de proteção associados ao ambiente. Todos os trabalhos que estejam atualmente em espera devido às regras de proteção do ambiente eliminado falharão automaticamente.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n3. Na barra lateral esquerda, clique em **Ambientes**.\n4. Ao lado do ambiente que você deseja excluir, clique em .\n5. Clique em **Entendi. Excluir este ambiente**.\n\nTambém é possível excluir ambientes por meio da API REST. Para saber mais, confira [Pontos de extremidade da API REST para repositórios](/pt/rest/repos#environments).\n\n## Como os ambientes relacionam-se com as implantações\n\nQuando um trabalho de fluxo de trabalho que referencia um ambiente é executado, ele cria um objeto de implantação com a propriedade `environment` definida como o nome do ambiente. À medida que o fluxo de trabalho progride, ele também cria objetos de status de implantação com a propriedade `environment` definida como o nome do ambiente, a propriedade `environment_url` definida como a URL para o ambiente (se especificado no fluxo de trabalho) e a propriedade `state` definida como o status do trabalho.\n\nVocê pode acessar esses objetos por meio da API REST ou API do GraphQL. Você também pode se inscrever nesses eventos de webhook. Para obter mais informações, confira [Pontos de extremidade da API REST para repositórios](/pt/rest/repos#deployments), [Objetos](/pt/graphql/reference/objects#deployment) (API do GraphQL) ou [Eventos e cargas de webhook](/pt/webhooks-and-events/webhooks/webhook-events-and-payloads#deployment).\n\n## Próximas etapas\n\nGitHub Actions fornece várias funcionalidades para gerenciar suas implantações. Para saber mais, confira [Implantando com GitHub Actions](/pt/actions/deployment/about-deployments/deploying-with-github-actions)."}