Темы



Всегда актуальны: как мы автоматизировали безопасный доступ и порядок в репозиториях общей организации

Коротко сгенерировано ИИ по тексту статьи
  • Evergreen ежеквартально проверяет внешних участников: нужным сохраняют доступ, остальным его отзывают.
  • 1-го числа система отмечает неактивные репозитории, а 16-го архивирует те, где активность не возобновилась.
  • Приложение использует GitHub Actions, задачи и файлы состояния в Git; репозитории не удаляются, изменения можно отменить.

Почему это важно: Это помогает безопасно поддерживать порядок в крупной организации: в общей организации GitHub более 1 400 сотрудников.

Используйте встроенные возможности GitHub, чтобы проверять доступ внешних участников и архивировать неактивные репозитории.

Decorative illustration featuring Ducky inside a translucent cube surrounded by green geometric blocks.

15 октября 2026 года
| 8 минут

Работа с внешними участниками может добавить забот владельцу репозитория. Нужно выяснять, кому всё ещё нужен доступ, менять разрешения по мере развития проектов и архивировать репозитории, когда они выполнили свою задачу.

Чтобы справляться с этим, владельцам репозиториев приходится отслеживать участников, сроки и последующие действия для каждого репозитория. Чем масштабнее становится проект, тем сложнее поддерживать такой порядок вручную и тем проще отложить эту работу.

Мы столкнулись с этой проблемой в общей организации, где сотрудники GitHub («Hubbers») сотрудничают с клиентами и партнёрами в рамках пробных запусков продуктов и проектов по оказанию профессиональных услуг. Нашим решением стала Evergreen — приложение GitHub, созданное на основе встроенных возможностей GitHub. Приведённые ниже рабочие процессы демонстрируют подход, который можно адаптировать для своей организации.

Знакомьтесь: Evergreen

Evergreen — это приложение GitHub, автоматизирующее поддержание порядка в организации с помощью двух рабочих процессов:

  1. Проверка доступа внешних участников. Каждый квартал проверяется список внешних участников каждого репозитория. Тем, кто нужен, доступ сохраняют, а остальных удаляют.
  2. Обнаружение и архивирование неактивных репозиториев. Репозитории, в которых давно не было действий пользователей, помечаются и получают предупреждение, а затем (если изменений по-прежнему нет) архивируются.

В основе всего лежали два принципа:

Безопасность прежде всего. Если никто не отвечает на запрос проверки доступа, мы не оставляем доступ как есть в надежде на лучшее, а отзываем его. Безопасный результат — это поведение по умолчанию.

Ничего не уничтожать. Evergreen никогда не удалит репозиторий или его содержимое. Архивированные репозитории можно восстановить, а каждое изменение доступа записывается в задачу для отслеживания в самом репозитории. Поэтому исправить ошибку так же просто, как скопировать и вставить текст в Copilot.

Как это работает: один мозг — много рук

Под капотом Evergreen — небольшой сервер веб-перехватчиков на Go, работающий в контейнере. Но самое интересное — это слаженная работа компонентов. Каждый из них — стандартная функция GitHub: приложение GitHub, запланированные действия, веб-перехватчики, задачи, пользовательские свойства и обычные файлы в репозитории. Ничего экзотического не нужно создавать с нуля.

Контроллер, который следит за временем

Специальный репозиторий-контроллер служит Evergreen часами и хранилищем памяти. Четыре рабочих процесса GitHub Actions запускаются по расписанию repository_dispatch раз в квартал, после чего приложение просыпается и выполняет работу:

ДеньРабочий процессЧто происходит
1-е числоПроверка неактивных репозиториевПомечаются репозитории без недавней активности пользователей, создаётся задача-предупреждение
8-е числоПроверка доступаФиксируется список внешних участников, для каждого репозитория создаётся задача со списком проверки
16-е числоОчистка неактивных репозиториевАрхивируются репозитории, которые остаются неактивными после льготного периода
23-е числоОчистка доступаАвтоматически отзывается доступ, если на запрос проверки не ответили

Проверки открываются за две недели до запуска очистки, а встроенный льготный период не позволяет случайному ручному запуску преждевременно привести к расправе. Каждый рабочий процесс также поддерживает workflow_dispatch, поэтому при необходимости любой этап можно запустить вручную.

Состояние, для которого можно git blame

Evergreen отслеживает состояние каждого репозитория в отдельном JSON-файле, который сохраняется в репозитории-контроллере по пути state/repos/.json. Там хранится снимок списка пользователей с доступом, дата открытия проверки, срок ответа, сведения о том, кто принял решение, и итог. Вот пример завершённой проверки: сотрудник Hubbers сохранил доступ Alice, но не продлил его для Bob.

{
  "repo_id": 123456789,
  "full_name": "the-org/acme-trial",
  "last_seen_at": "2026-04-13T00:05:00Z",
  "access_review": {
    "deadline": "2026-04-27T00:00:00Z",
    "status": "renewed",
    "collaborators_at_open": [
      { "login": "alice", "name": "Alice Example", "permission": "admin" },
      { "login": "bob", "name": "Bob Example", "permission": "write" }
    ],
    "renewed_logins": ["alice"],
    "decided_by": "carol-hubber",
    "decided_at": "2026-04-15T16:42:10Z",
    "tracking_issue": { "repo_id": 123456789, "number": 42 }
  },
  "staleness": {
    "last_activity_at": "2026-04-15T16:42:10Z",
    "warned_at": null,
    "archive_deadline": null,
    "status": "active",
    "tracking_issue": null
  }
}

И главное: поскольку состояние хранится просто в файлах Git, история коммитов и есть журнал аудита. Хотите узнать, почему прошлой весной кто-то потерял доступ? git log файл состояния. Отслеживать изменения в отдельной базе данных или специально созданной системе аудита не нужно.

IssueOps там, где это действительно важно

Evergreen взаимодействует с пользователями через задачи в каждом репозитории. Когда начинается проверка доступа, в каждом репозитории появляется задача со списком проверки:

Screenshot of an access review issue titled

Модель взаимодействия приятно проста: отметьте галочками тех, кто должен сохранить доступ, а затем закройте задачу. Вот и всё. Когда задача закрывается, Evergreen реагирует на событие веб-перехватчика issues.closed, считывает галочки, сохраняет доступ отмеченным участникам и отзывает его у остальных. Затем приложение оставляет комментарий с подтверждением, точно указывая, кому доступ сохранили, а кому отозвали.

Quarterly outside-collaborator access review flowchart. A dispatch snapshots outside collaborators and opens a checklist issue in each repository. If a team member closes the issue, checked collaborators retain access and unchecked collaborators have access revoked. If no one responds by the deadline, everyone’s access is automatically revoked. Both paths log the decision in the issue and state.

Решение могут принять только нужные люди

Закрытие задачи проверки доступа — действие с повышенными привилегиями, поэтому Evergreen контролирует его. Если задачу закрывает человек, который не является сотрудником Hubbers, приложение незаметно открывает её снова и оставляет комментарий с объяснением причины. Решения учитываются, только если их принимают уполномоченные люди.

Уведомления нужных людей

Есть одна тонкость: мы знаем, что на запрос проверки должны отвечать сотрудники Hubbers, но не всегда знали, кто именно из них отвечает за конкретный репозиторий.

Evergreen определяет, кого нужно уведомить, используя последовательность резервных вариантов:

  1. Если в репозитории задано пользовательское свойство evergreen_repo_owner (@user или @org/team), используется оно.
  2. В противном случае приложение проверяет недавних авторов задач и коммитов и добавляет в копию тех, кто входит в команду проверки доступа, то есть сотрудников Hubbers, которые действительно работают в этом репозитории.

В результате ответственные за репозитории автоматически получают уведомления, и никому не нужно вести таблицу «кто за что отвечает».

Безопасность прежде всего — и никакого открытия по умолчанию

Если срок проверки истекает и ответа нет, система очистки отзывает доступ у всех участников из сохранённого списка. Мы предусмотрели один неочевидный крайний случай: что, если часть доступов удастся отозвать, а остальные операции завершатся временной ошибкой API? Отметить проверку как «завершённую», пока отзыв доступа ещё не выполнен, означало бы допустить незаметную несогласованность, чего мы хотели избежать.

Поэтому Evergreen действует по принципу закрытого отказа. Если не удаётся отозвать хотя бы один доступ, проверка остаётся ожидающей, а задача — открытой; при следующем запуске система повторит попытку для оставшихся участников. Статус «доступ отозван» фиксируется, только когда все операции успешно завершены. А список тех, у кого доступ отозвали, записывается в задачу, поэтому для восстановления доступа достаточно снова добавить указанные там имена пользователей.

Удобство для пользователей: автоматизация с заботой о людях

У автоматизированной рутинной работы репутация офисной пожарной сигнализации: она громкая, её легко игнорировать, и обычно она срабатывает, пока вы готовите что-то совершенно безобидное. Мы приложили все усилия, чтобы Evergreen воспринималась совершенно иначе:

  • Работа приходит к вам. Всё происходит в виде задачи в вашем репозитории.
  • Система отмечает нужных людей. Не нужно выяснять: «Кто за это отвечает?»
  • Запрос сформулирован предельно ясно. В каждой задаче указано, что нужно сделать, точный срок и что произойдёт, если её проигнорировать.
  • Система напоминает заранее. До наступления срока появляется комментарий-напоминание — никаких неожиданных отзывов доступа.
  • Есть возможность отказаться. Владельцы организации (Hubbers) могут отключить участие, задав пользовательское свойство (evergreen_exempt_from_access_review или evergreen_exempt_from_archive).

Осторожное внедрение

Автоматизация управления доступом и архивации репозиториев требует осторожного внедрения, особенно в крупной активной организации (в нашей — более 1 400 сотрудников Hubbers, а клиентов и партнёров ещё больше). Мы хотели, чтобы первый запуск прошёл совершенно незаметно. Вот несколько практик, которые помогли этого добиться:

Сначала пробный запуск. В Evergreen предусмотрен режим DRY_RUN: он регистрирует все изменения, которые система внесла бы, не затрагивая участников или репозитории. Мы запустили его в настоящей организации и внимательно изучали журналы, пока не убедились, что предлагаемым решениям можно доверять.

Рассказывайте обо всём заранее и подробно. Прежде чем включить систему, мы сообщили, что произойдёт, когда именно и что потребуется сделать, чтобы первая задача не стала для кого-либо сюрпризом. Мы заметили: когда вы в седьмой раз сообщаете одно и то же большой группе, многие, вероятно, слышат это впервые.

Отслеживайте всё с помощью Splunk. Evergreen передаёт структурированные журналы logfmt в отдельный индекс Splunk. Благодаря этому мы обнаружили реальные крайние случаи (пустые списки участников, необычные разрешения, репозитории с отключёнными задачами) и уточнили логику до того, как они стали проблемой.

Учитывайте ограничения платформы. Когда вы создаёте задачи и публикуете комментарии во всех репозиториях крупной организации, вы упираетесь во вторичные ограничения GitHub на частоту создания контента: 80 запросов в минуту и 500 в час. Это продуманная превентивная мера против злоупотреблений системой, но при масштабной автоматизации IssueOps её необходимо учитывать заранее.

Поэтому Evergreen изначально работает с заданным темпом. Система обрабатывает репозитории пакетами, разделяет вызовы, создающие контент, интервалом в пару секунд и делает паузы между пакетами, чтобы скользящее временное окно успело обновиться. При этом учитываются только репозитории, в которых действительно создаётся контент: если в спокойном квартале подходящих репозиториев нет, обработка всё равно проходит быстро. Мы предпочли заранее избегать ограничений, а не реагировать на них постфактум.

Какие уроки мы усвоили

  • Пусть безопасный вариант будет вариантом по умолчанию. Сначала обеспечьте безопасный отказ, а затем упростите ответ настолько, чтобы к нему редко приходилось прибегать.
  • Используйте уже имеющиеся инструменты. Задачи, веб-перехватчики, пользовательские свойства и история Git заменили специально созданный интерфейс, очередь заданий и базу данных аудита.
  • Встраивайте процессы в привычную рабочую среду. Задача в репозитории лучше панели мониторинга, которую никто не откроет.
  • Журналы помогают отменить изменения. Запись каждого изменения в задачу превратила «ой» в «вставь эти три имени пользователей в сеанс Copilot».
  • Учитывайте ограничения. В организации крупного масштаба ограничения частоты запросов — не крайний случай, а ключевой фактор проектирования.

Поддерживайте порядок в организации с Evergreen

За рутинные задачи по поддержанию порядка легко взяться не сразу, зато они отлично поддаются автоматизации. Секрет не в героических спринтах по наведению порядка, а в том, чтобы безопасные и несложные дела выполнялись по расписанию, с заботой о людях и возможностью отменить изменения.

Это и есть Evergreen. А поскольку приложение полностью построено на встроенных возможностях GitHub, вы можете самостоятельно внедрить такой же подход.

Хотите превратить поддержание порядка в репозиториях в рутину? Начните с одной регулярной задачи по проверке доступа или архивации, а затем автоматизируйте её с помощью приложений GitHub, actions, задач и пользовательских свойств.

Автор

Greg Mohler

Старший инженер по предоставлению услуг в GitHub, увлечённый пересечением разработки программного обеспечения и безопасности, а также помощью компаниям сосредоточиться на инновациях, росте и скорости выхода на рынок.

Похожие публикации

Узнайте больше о GitHub

Docs

Документация

Всё, что нужно для освоения GitHub, в одном месте.

GitHub

GitHub

Создавайте будущее на GitHub — платформе, где каждый и отовсюду может создать что угодно.

Customer stories

Истории клиентов

Познакомьтесь с компаниями и инженерными командами, которые создают проекты с помощью GitHub.

GitHub Universe 2026

GitHub Universe 2026

Присоединяйтесь к нам 28–29 октября в Сан-Франциско или онлайн на GitHub Universe — главном мероприятии для разработчиков, объединяющем людей, агентов и код со всего мира.

У нас есть и рассылки

Советы, технические руководства и лучшие практики для разработчиков — в нашей рассылке, выходящей раз в две недели.

Ваш адрес электронной почты

© GitHub Engineering