Przejdź do treści

Wymagani recenzenci GitHuba a brama zatwierdzeń DueReason

Wymagani recenzenci środowiska GitHub zatwierdzają osobę, nie wiążą się z payloadem. Zobacz, jak szablon gate-production-deploy DueReason dodaje to na wierzchu.

Aktualizacja · 7 min czytania

W skrócie

  • Wymagani recenzenci środowiska GitHub to osoby wskazane przy konfiguracji środowiska; do sześciu, a do uruchomienia joba wystarczy zatwierdzenie jednej z nich. To zatwierdzenie nie jest związane z SHA commita, tagiem ani celem wdrożenia tak, jak wiąże się podpisany grant.
  • Reguły gałęzi i tagów wdrożeniowych ograniczają wdrożenie wyłącznie po nazwie gałęzi lub tagu -- nie ma warunku na żadnym innym polu tego, co jest wdrażane, np. na wartości środowiska wewnątrz samego payloadu.
  • Szablon gate-production-deploy DueReason dodaje workflow kluczowany po payload.environment: produkcja wymaga zgody grupy zatwierdzających, staging zatwierdza się automatycznie, a wynikiem jest podpisany, jednorazowy grant związany z dokładnym repo, SHA i środowiskiem.
  • Te dwa mechanizmy się uzupełniają, nie konkurują: wymagani recenzenci (albo wymagany status check) nadal bramkują samo scalenie lub joba; grant z bramy to coś, co krok verify sprawdza przed wdrożeniem -- także przy późniejszym ręcznym ponownym uruchomieniu albo rollbacku, których zatwierdzenie wymaganego recenzenta z oryginalnego przebiegu nigdy nie objęło.

Środowiska GitHub Actions już dziś pozwalają wymagać podpisu osoby, zanim job dotykający production zostanie uruchomiony. Jeśli Twój zespół trafia na granice tego mechanizmu -- więcej warunków dla zatwierdzających niż "tych sześciu ludzi", albo potrzeba użycia tej samej bramki poza GitHub Actions w ogóle -- oto co wymagani recenzenci robią dziś, gdzie się to kończy i co się zmienia, gdy przed tym samym wdrożeniem postawisz szablon gate-production-deploy DueReason.

Co dziś robią wymagani recenzenci GitHuba

Ustawienie Required reviewers środowiska wskazuje do sześciu osób lub zespołów; job odwołujący się do środowiska czeka ze statusem "Waiting", aż jedna z nich go zatwierdzi, i kończy się automatycznie niepowodzeniem, jeśli nikt tego nie zrobi w ciągu 30 dni. Recenzenci muszą mieć co najmniej dostęp do odczytu repozytorium, a opcjonalnie można wymagać, by osoba, która uruchomiła wdrożenie, nie mogła go sama zatwierdzić. Nic z tego nie jest warunkowe względem samego wdrożenia -- ta sama lista recenzentów dotyczy środowiska niezależnie od tego, jaki commit, tag czy gałąź są akurat wdrażane.

Deployment branches and tags to druga reguła ochrony środowiska: ogranicza, które nazwy gałęzi lub tagów w ogóle mogą się do niego wdrażać (brak ograniczenia, tylko chronione gałęzie, albo lista wzorców nazw dopasowywanych do GITHUB_REF przebiegu workflow). To lista dozwolonych nazw gałęzi, a nie warunek na czymkolwiek innym w samym wdrożeniu.

Gdzie się to kończy

Wymagani recenzenci odpowiadają na pytanie "czy uprawniona osoba kliknęła zatwierdź", a nie "czy to konkretne wdrożenie spełnia regułę zależną od własnego payloadu". Z tego, jak działa ta funkcja, wynikają wprost dwie luki:

  • Brak powiązania z payloadem. Zatwierdzenie jest zapisane względem środowiska i przebiegu; nic w nim nie jest kryptograficznie związane z dokładnym SHA commita, tagiem obrazu czy celem, który ostatecznie się wdraża. Późniejsze ręczne ponowne uruchomienie tego samego, już zatwierdzonego workflow albo rollback do starszego commita nie jest niezależnie sprawdzane względem tego, co faktycznie zatwierdzono -- dokumentacja GitHuba opisuje zatwierdzenie wymaganego recenzenta jako dotyczące joba, a nie jako podpisany obiekt, który system docelowy może zweryfikować offline.
  • Brak warunkowego kierowania zatwierdzających poza nazwą gałęzi. Nie da się powiedzieć "wymagaj drugiej grupy tylko wtedy, gdy celem jest production, a payload nazywa konkretne pole środowiska" -- reguły gałęzi i tagów wdrożeniowych dopasowują wzorce nazw gałęzi lub tagów, a wymagani recenzenci to stała lista na środowisko, a nie reguła oceniana względem dowolnych pól payloadu.

Żadna z tych luk nie jest błędem środowisk GitHub -- mechanizm jest ograniczony do jobów GitHub Actions odwołujących się do środowiska. Pipeline, który nie jest workflowem GitHub Actions -- GitLab CI, Jenkins, hook pre-sync Argo CD albo własna powłoka agenta programistycznego AI -- w ogóle nie ma wbudowanego odpowiednika.

Co dodaje gate-production-deploy

DueReason ma szablon gate-production-deploy, instalowany bezpośrednio ze strony konfiguracji Bramy agentów dokładnie na ten przypadek: agent programistyczny AI albo pipeline CI chce otagować lub wdrożyć, a cel produkcyjny powinien wymagać zgody, której staging nie potrzebuje. Jego akcja (gate.production-deploy) przyjmuje payload z repo, sha, environment (staging albo production) i opcjonalnym tag, a dwa workflow kierują ruch po payload.environment: Production wymaga jednej osoby z grupy Agent approvers, bez wymaganych dowodów; Staging zatwierdza się automatycznie, bez żadnych kroków. Ten warunek jest oceniany względem payloadu, który dostało DueReason, a nie nazwy gałęzi, którą GitHub wywnioskował z GITHUB_REF.

Po zatwierdzeniu wynikiem jest podpisany, jednorazowy grant związany z dokładnym hashem repo/sha/environment -- a nie stan checkboxa na środowisku. Krok verify (duereason-gate verify, albo odpowiednik wzorca wymaganego status checku opisany w przewodniku o ochronie wdrożeń produkcyjnych) sprawdza ten grant offline względem opublikowanych kluczy DueReason przed wdrożeniem i odrzuca grant dla innego SHA, innego środowiska albo takiego, który już wygasł -- również przy ręcznym ponownym uruchomieniu albo rollbacku, których zatwierdzenie wymaganego recenzenta z oryginalnego przebiegu nigdy nie objęło.

Strona polityki -- decydowanie, które polecenia powłoki, pushe git tag czy wywołania MCP w ogóle powinny złożyć taki wniosek -- to zadanie @duereason/gate, opisane od A do Z w przewodniku o Bramie agentów. Ten pakiet jest opublikowany w npm: npm install -g @duereason/gate instaluje go już dziś. Kod adapterów dla Claude Code, Cursor, Hermes, OpenCode, Codex, Gemini CLI, Windsurf, git hooks i samodzielnego proxy MCP jest w tym samym pakiecie, a Ustawienia > Brama agentów generują akcję, workflow, ograniczony klucz API i plik polityki w tym samym miejscu.

To uzupełnia wymaganych recenzentów, nie ich zastępuje

Nic tutaj nie przemawia za usunięciem wymaganych recenzentów GitHuba ze środowiska, które już ich ma. Job GitHub Actions wdrażający do chronionego środowiska nadal czeka na swoich wymaganych recenzentów dokładnie tak, jak skonfigurowano; agent bramkowany przez DueReason albo pipeline spoza GitHuba dodaje drugi, związany z payloadem test przed tym samym celem produkcyjnym -- ten sam dwuwarstwowy wzorzec, test przy agencie i test przy celu, opisany dla przypadku git-hook i CI w ochronie wdrożeń produkcyjnych. Uruchomienie obu nie jest nadmiarowe: zatwierdzenie wymaganego recenzenta pokrywa "osoba z dostępem kliknęła zatwierdź przy tym przebiegu"; grant pokrywa "ten dokładny payload został zatwierdzony i nic się od tego czasu nie zmieniło".

Pytania

Czy to zastępuje wymaganych recenzentów środowisk GitHub?
Nie. Wymagani recenzenci nadal bramkują sam job GitHub Actions, dokładnie tak, jak skonfigurowano. gate-production-deploy dodaje osobne, związane z payloadem zatwierdzenie i podpisany grant przed wdrożeniem, które chce wykonać agent albo pipeline spoza GitHuba -- oba działają obok siebie, nie zamiast siebie.
Czy wymagani recenzenci potrafią już kierować warunkowo po wartości środowiska, tak jak robią to workflow gate-production-deploy?
Nie na dowolnym polu payloadu. Wymagani recenzenci to stała lista recenzentów na środowisko GitHub, a reguły gałęzi i tagów wdrożeniowych ograniczają tylko po wzorcu nazwy gałęzi lub tagu. Kierowanie workflow po payload.environment, tak jak robią to workflow Production i Staging w gate-production-deploy, wymaga warunku ocenianego względem własnego payloadu wdrożenia, którego wymagani recenzenci nie mają.
Czy @duereason/gate da się już zainstalować?
Tak. npm install -g @duereason/gate instaluje go już dziś. Ustawienia > Brama agentów generują akcję gate-production-deploy, jej workflow, ograniczony klucz API i politykę .duereason/gate.yml; adaptery dla narzędzi (Claude Code, Cursor, Hermes, OpenCode, Codex, Gemini CLI, Windsurf, git hooks, samodzielne proxy MCP) są w tym samym pakiecie npm.

Dodaj warunkową bramę, której środowiska GitHub nie potrafią

Zainstaluj gate-production-deploy z Ustawień > Brama agentów i kieruj wdrożenia produkcyjne oraz stagingowe po własnym payloadzie, z podpisanym grantem, który krok verify sprawdzi offline.

Załóż konto

Źródła

Poradnik wyjaśnia przepisy tak, jak je rozumiemy; nie jest poradą prawną. Sprawdź tekst urzędowy i prawo krajowe, które może dodać obowiązki.

Zacznij z DueReason

Załóż bezpłatne konto, wypróbuj na żywo albo porozmawiaj z nami o swoim procesie.

Otrzymuj nowości o produkcie