Wszystkie podręczniki
W trakcie budowy · wersja robocza wymaga manifestu wydania

Podręcznik techniczny

Co musi zawierać pakiet instalacyjny?

Jasna umowa między konkretną wersją, wdrażającym i operacją.

Publiczność
Wdrażający, zarządca infrastruktury, bezpieczeństwo, DERS L2/L3
Wynik
Przed instalacją jasne jest, co dokładnie zostanie wdrożone, w jakich wersjach i w jaki sposób wyniki będą weryfikowane.

01

Manifest release

  1. Zidentyfikuj produkt, wersję, datę wydania, obsługiwany kanał i status wsparcia.
  2. Dla każdej usługi podaj pełną nazwę obrazu, niezmienny tag i skrót SHA-256.
  3. Dołącz macierz zgodności usług, bazy danych, Docker Engine/Compose, systemu operacyjnego i architektury procesora.
  4. Wypisz zmiany schematu, kolejność migracji, zmiany powodujące przerwanie migracji, znane problemy i obsługiwaną ścieżkę z poprzednich wersji.

02

Pliki dostaw

  • compose.yaml i wszelkie profile dla wdrożeń minimalnych, pełnych i integracyjnych
  • .env.example bez haseł, certyfikatów i rzeczywistych tokenów
  • lista sekretów i jak je bezpiecznie przesyłać
  • konfiguracja odwrotnego serwera proxy lub jej dokładne wymagania
  • polecenia migracji i inicjalizacji
  • kontrole stanu zdrowia, testy dymne i oczekiwane wyniki
  • procedura tworzenia kopii zapasowej, przywracania i wycofywania
  • informacje o wydaniu, SBOM i lista znanych ograniczeń

03

O czym nie należy myśleć

Jeśli wartość nie znajduje się w manifeście lub podręczniku, instalacja zostanie zatrzymana, a właściciel wydania zostanie poproszony o jej dodanie.

  • nazwa lub tag obrazu
  • port wystawiony poza sieć wewnętrzną
  • domyślne hasło
  • kolejność migracji bazy danych
  • zgodność komponentów
  • punkt końcowy zdrowia i znaczenie jego stanów