{"meta":{"title":"Управление средами для развертывания","intro":"Вы можете создавать среды и защищать эти среды с помощью правил защиты развертывания. Задание, ссылающееся на среду, должно соответствовать любым правилам защиты среды перед запуском или доступом к секретам среды.","product":"GitHub Actions","breadcrumbs":[{"href":"/ru/actions","title":"GitHub Actions"},{"href":"/ru/actions/how-tos","title":"Инструкции"},{"href":"/ru/actions/how-tos/deploy","title":"Развернуть"},{"href":"/ru/actions/how-tos/deploy/configure-and-manage-deployments","title":"Настройка развертываний и управление ими"},{"href":"/ru/actions/how-tos/deploy/configure-and-manage-deployments/manage-environments","title":"Управление средами"}],"documentType":"article"},"body":"# Управление средами для развертывания\n\nВы можете создавать среды и защищать эти среды с помощью правил защиты развертывания. Задание, ссылающееся на среду, должно соответствовать любым правилам защиты среды перед запуском или доступом к секретам среды.\n\n## Необходимые компоненты\n\n> \\[!NOTE]\n> Пользователи с GitHub Free тарифными планами могут настраивать среды только для публичных репозиториев. Если вы преобразуете репозиторий из общедоступного в частный, все настроенные правила защиты и секреты среды будут игнорироваться, и вы не сможете настроить какие-либо среды. Если вы преобразуете репозиторий обратно в общедоступный, то получите доступ ко всем ранее настроенным правилам защиты и секретам среды.\n>\n> Организации с GitHub Team наличием и пользователи GitHub Pro могут настраивать среды для приватных репозиториев. Дополнительные сведения см. в разделе [Планы GitHub](/ru/get-started/learning-about-github/githubs-plans).\n\n* Общие сведения о средах см. в разделе [Развертывание с помощью GitHub Actions](/ru/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments#using-environments).\n* Сведения о доступных правилах см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments).\n\n## Создание среды\n\nЧтобы настроить среду в репозитории, относящемся к учетной записи пользователя, необходимо быть владельцем репозитория. Чтобы настроить среду в репозитории организации, необходимо иметь доступ уровня `admin`.\n\n> \\[!NOTE]\n>\n> * Создание среды в частном репозитории доступно организациям с GitHub Team и пользователям с GitHub Pro.\n> * Некоторые функции для сред не имеют или ограничены доступностью для частных репозиториев. Если вы не можете получить доступ к функции, описанной в приведенных ниже инструкциях, см. документацию, связанную на соответствующем шаге, чтобы получить сведения о доступности.\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Под именем репозитория щелкните **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-gear\" aria-label=\"gear\" role=\"img\"><path d=\"M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z\"></path></svg> Settings**. Если вкладка \"Параметры\" не отображается, выберите **раскрывающееся меню <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-kebab-horizontal\" aria-label=\"More\" role=\"img\"><path d=\"M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path></svg>** и нажмите кнопку **\"Параметры**\".\n\n   ![Снимок экрана: заголовок репозитория с вкладками. Вкладка \"Параметры\" выделена темно-оранжевым контуром.](/assets/images/help/repository/repo-actions-settings.png)\n3. На левой боковой панели щелкните **Среды**.\n4. Выберите **Новая среда**.\n5. Введите имя среды и нажмите кнопку **Настроить среду**. В именах сред регистр не учитывается. Имя среды не может превышать 255 символов и должно быть уникальным в репозитории.\n6. При необходимости укажите пользователей или команды, которые должны утверждать задания рабочих процессов, использующие эту среду. Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#required-reviewers).\n   1. Выберите **Обязательные рецензенты**.\n   2. Введите до 6 пользователей или команд. Только один из обязательных рецензентов должен утвердить задание, чтобы оно могло продолжить работу.\n   3. При необходимости, чтобы запретить пользователям утверждать рабочие процессы, которые они активировали, выберите **\"Запрет самостоятельной проверки**\".\n   4. Нажмите **Сохранить правила защиты**.\n7. При необходимости укажите время ожидания до разрешения заданиям рабочего процесса, использующим эту среду, продолжить работу. Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#wait-timer).\n   1. Выберите **Таймер ожидания**.\n   2. Введите количество минут ожидания.\n   3. Нажмите **Сохранить правила защиты**.\n8. При необходимости запретить обход настроенных правил защиты. Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#allow-administrators-to-bypass-configured-protection-rules).\n   1. Отмена выбора **разрешить администраторам обходить настроенные правила** защиты.\n   2. Нажмите **Сохранить правила защиты**.\n9. По желанию включить любые пользовательские правила защиты от развертывания, созданные с GitHub Appsпомощью . Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#custom-deployment-protection-rules).\n   1. Выберите правило настраиваемой защиты, которое вы хотите включить.\n   2. Нажмите **Сохранить правила защиты**.\n10. При необходимости укажите, какие ветви и теги можно развернуть в этой среде. Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#deployment-branches-and-tags).\n    1. Выберите нужный вариант в раскрывающемся списке **Ветви развертывания**.\n\n    2. Если выбраны **выбранные ветви и теги**, чтобы добавить новое правило, нажмите кнопку **\"Добавить ветвь развертывания\" или правило тега**\n\n    3. В выпадающем меню «Тип ссылки», в зависимости от того, какое правило вы хотите применить, нажмите **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-git-branch\" aria-label=\"git-branch\" role=\"img\"><path d=\"M9.5 3.25a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628A2.25 2.25 0 0 1 9.5 3.25Zm-6 0a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Zm8.25-.75a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z\"></path></svg> Ветвь** или **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-tag\" aria-label=\"tag\" role=\"img\"><path d=\"M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.752 1.752 0 0 1 1 7.775Zm1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2Z\"></path></svg> Тег**.\n\n    4. Введите шаблон имени для ветви или тега, который требуется разрешить.\n\n       > \\[!NOTE]\n       > Шаблоны имен должны быть настроены для ветвей или тегов по отдельности.\n\n    5. Нажмите кнопку **Добавить правило**.\n11. При необходимости добавьте секреты среды. Эти секреты доступны только для заданий рабочих процессов, использующих данную среду. Кроме того, задания рабочих процессов, использующие эту среду, могут получить доступ к этим секретам только после выполнения всех настроенных правил (например, обязательных рецензентов). Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#environment-secrets).\n    1. В разделе **Секреты среды** нажмите **Добавить секрет**.\n    2. Введите имя секрета.\n    3. Введите значение секрета.\n    4. Щелкните **Добавить секрет**.\n12. При необходимости добавьте переменные среды. Эти переменные доступны только для заданий рабочих процессов, использующих среду, и доступны только с помощью контекста [`vars`](/ru/actions/reference/workflows-and-actions/contexts#vars-context) . Дополнительные сведения см. в разделе [Развертывания и среды](/ru/actions/reference/workflows-and-actions/deployments-and-environments#environment-variables).\n    1. В разделе **переменные среды нажмите кнопку **\"Добавить переменную****\".\n    2. Введите имя переменной.\n    3. Введите значение переменной.\n    4. Нажмите кнопку **\"Добавить переменную**\".\n\nВы также можете создавать и настраивать среды с помощью REST API. Дополнительные сведения см. в разделе AUTOTITLE, AUTOTITLE[, ](/ru/rest/deployments/environments)\\[AUTOTITLE и [REST API endpoints для секретов GitHub Actions](/ru/rest/actions/secrets)]\\(/rest/actions/variables).[](/ru/rest/deployments/branch-policies)\n\nПри запуске рабочего процесса, ссылающегося на среду, которая не существует, будет создана среда с указанным именем. Если среда создается из неявных сборок страниц (например, из ветви или источника папок), исходная ветвь будет добавлена в среду в качестве правила защиты. В противном случае только что созданная среда не будет иметь правил защиты или секретов. Любой пользователь, который может изменять рабочие процессы в репозитории, может создавать среды с помощью файла рабочего процесса, но настраивать среду могут только администраторы репозитория.\n\n## Удаление среды\n\nЧтобы настроить среду в репозитории, относящемся к учетной записи пользователя, необходимо быть владельцем репозитория. Чтобы настроить среду в репозитории организации, необходимо иметь доступ уровня `admin`.\n\nПри удалении среды будут удалены все секреты и правила защиты, связанные с этой средой. Все задания из удаленной среды, находившиеся в состоянии ожидания из-за правил защиты, автоматически завершатся с ошибкой.\n\n1. На GitHubперейдите на главную страницу репозитория.\n2. Под именем репозитория щелкните **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-gear\" aria-label=\"gear\" role=\"img\"><path d=\"M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z\"></path></svg> Settings**. Если вкладка \"Параметры\" не отображается, выберите **раскрывающееся меню <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-kebab-horizontal\" aria-label=\"More\" role=\"img\"><path d=\"M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z\"></path></svg>** и нажмите кнопку **\"Параметры**\".\n\n   ![Снимок экрана: заголовок репозитория с вкладками. Вкладка \"Параметры\" выделена темно-оранжевым контуром.](/assets/images/help/repository/repo-actions-settings.png)\n3. На левой боковой панели щелкните **Среды**.\n4. Рядом с окружением, которое вы хотите удалить, нажмите <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-trash\" aria-label=\"Delete environment\" role=\"img\"><path d=\"M11 1.75V3h2.25a.75.75 0 0 1 0 1.5H2.75a.75.75 0 0 1 0-1.5H5V1.75C5 .784 5.784 0 6.75 0h2.5C10.216 0 11 .784 11 1.75ZM4.496 6.675l.66 6.6a.25.25 0 0 0 .249.225h5.19a.25.25 0 0 0 .249-.225l.66-6.6a.75.75 0 0 1 1.492.149l-.66 6.6A1.748 1.748 0 0 1 10.595 15h-5.19a1.75 1.75 0 0 1-1.741-1.575l-.66-6.6a.75.75 0 1 1 1.492-.15ZM6.5 1.75V3h3V1.75a.25.25 0 0 0-.25-.25h-2.5a.25.25 0 0 0-.25.25Z\"></path></svg>.\n5. Нажмите **\"Я понимаю, удалить эту среду**.\n\nВы также можете удалить среды с помощью REST API. Дополнительные сведения см. в разделе [Конечные точки REST API для репозиториев](/ru/rest/repos#environments).\n\n## Связь сред с развертываниями\n\nПри выполнении задания рабочего процесса, ссылающегося на среду, создается объект развертывания со свойством `environment` с названием вашей среды. По мере выполнения рабочего процесса создаются объекты состояния развертывания со свойством `environment` — имя вашей среды, свойством `environment_url` — URL-адрес среды (если указано в рабочем процессе), и свойством `state` — состояние задания.\n\nВы можете получить доступ к этим объектам с помощью REST API или API GraphQL. Вы также можете подписаться на эти события веб-перехватчика. Дополнительные сведения см. в разделе \\[AUTOTITLE, [Конечные точки REST API для репозиториев](/ru/rest/repos#deployments) (API GraphQL) или [Deployments](/ru/graphql/reference/deployments#object-deployment)]\\(/webhooks/webhook-events-and-payloads#deployment).\n\n## Следующие шаги\n\nGitHub Actions предоставляет несколько функций для управления вашими развертываниями. Дополнительные сведения см. в разделе [Развертывание с помощью GitHub Actions](/ru/actions/how-tos/deploy/configure-and-manage-deployments/control-deployments)."}