4digital.cloud4digital.cloud
← Engineering

Bezpieczne wydania

Wydanie zgodne z zatwierdzoną wersją

W skrócie: Kontrola wydań porównuje wdrożoną wersję z zatwierdzonym artefaktem. Powtarzalność budowania opiera się na zidentyfikowanych i usuniętych źródłach niedeterministyczności, potwierdzonych określonymi próbami.

01 / Dla Twojej organizacji

Zielony pipeline mówi, że proces się zakończył, ale nie mówi, co dokładnie działa na produkcji. Przy incydencie, audycie albo cofnięciu wydania potrzebna jest pewna odpowiedź: która wersja jest wdrożona i czy to ta, którą zatwierdzono.

Kontrola wydań porównuje wdrożenie z zatwierdzonym artefaktem, a powtarzalność budowania pozwala ten artefakt odtworzyć i sprawdzić. Razem pozwalają szybko ustalić, co działa na produkcji, i wrócić do znanej wersji.

02 / Realizacja na zapleczu 4digital

Na zapleczu 4digital — w serwisach WWW oraz bibliotece i usłudze JVM — obie zdolności opierają się na porównaniu bajtów, a nie na deklaracji narzędzi:

  • Wydanie jako wersja w repozytorium — stan serwera można porównać z konkretnym commitem, a cofnięcie jest wdrożeniem wskazanego commitu.
  • Porównanie przed nadpisaniem — wdrożenie zatrzymuje się, jeśli serwer nie odpowiada żadnej znanej wersji.
  • Sprawdzenie po wydaniu — produkcja jest porównywana plik po pliku z buildem wydania i z tym, co sprawdzono przed produkcją.
  • Powtarzalność jako wymaganie — ten sam commit ma dawać te same bajty; każda różnica jest błędem do wyjaśnienia, a nie szumem.

Kontrola wydań. Skrypty wydania działają domyślnie w trybie próbnym, odmawiają nadpisania wersji, której same nie wdrożyły, i cofają serwis do wskazanego commitu jednym poleceniem. Po wydaniu kontrola porównuje serwowane pliki z buildem wydania i z wersją sprawdzoną przed produkcją. Przy wdrożeniu usługi JVM artefakt wyjęty z obrazu kontenera jest porównywany z buildem.

Powtarzalność budowania. W bibliotece JVM przyczyny różnic między buildami ustaliłem na poziomie bajtów: ścieżkę źródła zapisywaną przez kompilator w metadanych oraz znaczniki czasu, kolejność wpisów i uprawnienia w archiwach. Poprawki weszły do kontraktu buildu, a weryfikator przy rozbieżności nazywa jej klasę, zamiast wymagać ponownej analizy binarnej. Artefakt, który nie przejdzie porównania, nie jest publikowany.

03 / Rezultat

W procesie wydania sprawdzam kandydata przed publikacją, a następnie porównuję z nim serwowane pliki. Kontrola po wdrożeniu pozwala wykryć rozbieżność i podjąć decyzję o korekcie lub cofnięciu wydania. W badanym rejestrze artefaktów próba nadpisania wydanej wersji została odrzucona.

Powtarzalność budowania jest częścią kontraktu buildu. Każde nowe środowisko lub moduł obejmuję tym samym pomiarem, zamiast zakładać zgodność.

Wartość: każde wdrożenie można powiązać z zatwierdzoną wersją i wykryć niezgodności, a w serwisach WWW także wrócić do znanego stanu bez zgadywania, co zostało wcześniej opublikowane.

04 / Wybrane dowody

  • Weryfikacja wydania serwisów WWW: porównanie opublikowanych plików z buildem wydania i wersją sprawdzoną przed produkcją.
  • Próba pełnego cyklu: wydanie, powtórzenie bez zmian, kolejne wydanie i cofnięcie do poprzedniej wersji, z weryfikacją plików bajt w bajt.
  • Próba nadpisania wydanej wersji w rejestrze artefaktów odrzucona, a odczyt po próbie zwrócił niezmienione bajty.
  • Przyczyny różnic między buildami JVM ustalone na poziomie metadanych kompilatora i archiwów; zgodność bajtowa artefaktu zbudowanego na dwóch niezależnych hostach potwierdzona próbą.
  • Artefakt wyjęty z obrazu kontenera porównany z buildem przed wdrożeniem usługi.
Źródło doświadczenia
Własne zaplecze 4digital
Kompetencja
Wydania i integralność artefaktów
Obszary technologiczne
CI/CD · Powtarzalne buildy · Gradle i Scala 3 · Rejestr artefaktów · Kontenery · Weryfikacja wydań · Wdrożenia z możliwością cofnięcia