NetSendo v2.3.1: szybsze aktualizacje w chmurze po każdym wydaniu

Jeśli prowadzisz marketing na hostowanej platformie, liczy się czas między wydaniem poprawki a jej uruchomieniem na Twojej instancji. Szczególnie wtedy, gdy poprawka zamyka lukę bezpieczeństwa. Do tej pory instancje NetSendo Cloud dowiadywały się o nowych wersjach dzięki nocnemu sprawdzaniu rejestru przez dostawcę hostingu. Wydanie mogło więc czekać nawet dobę, zanim proces aktualizacji w ogóle je zauważył.

NetSendo v2.3.1 usuwa to czekanie. Gdy obraz Docker nowej wersji zostanie opublikowany, pipeline wydań od razu wysyła podpisane powiadomienie do katalogu NetSendo Cloud. Instancje hostowane od razu wiedzą o nowej wersji, a pilne wydania bezpieczeństwa są instalowane natychmiast.

🚀 Co nowego w v2.3.1

Zamiast „sprawdzimy w nocy”: „jest nowa wersja”

Stary proces przypominał sprawdzanie skrzynki pocztowej raz na dobę, wieczorem. List mógł przyjść rano, ale nikt nie zaglądał do skrzynki aż do wieczora. Nowy proces działa jak dzwonek do drzwi. Gdy tylko wydanie jest gotowe, katalog Aderlo dostaje o nim informację.

Tak to działa:

1. Do repozytorium NetSendo trafia tag nowej wersji (vX.Y.Z).
2. Workflow .github/workflows/docker-publish.yml buduje i publikuje obraz Docker.
3. Po publikacji obrazu workflow wysyła podpisane wywołanie do katalogu wydań Aderlo.
4. Katalog zapisuje nową wersję, a aktualizacja instancji NetSendo Cloud zostaje zaplanowana.

Dwie ścieżki wdrożenia

Gdy katalog zna już wydanie, aktualizacja idzie jedną z dwóch ścieżek:

• ✅ Zwykłe wydania są instalowane na instancjach hostowanych w nocy, grupa po grupie. To ogranicza zakłócenia i skutki ewentualnych nieprzewidzianych problemów.
• ✅ Wydania bezpieczeństwa to wydania z sekcją ### Security w opisie. Są instalowane natychmiast, bez czekania na nocne okno.

Przykład opisu wydania, które trafi na szybką ścieżkę:

## v2.3.2

### Security

- Fixed an authorization check in ...

### Fixed

- ...

⚠️ Ważne: Sekcja ### Security oznacza natychmiastową instalację w NetSendo Cloud. Używaj jej wyłącznie do poprawek podatności. Dodatkowe zabezpieczenia, aktualizacje zależności bez znanej podatności i ogólne ulepszenia umieszczaj w sekcji ### Changed lub ### Fixed.

Klucz do jednego zadania

Wywołanie do Aderlo jest podpisane sekretem zapisanym jako ADERLO_RELEASE_KEY w sekretach GitHub Actions repozytorium. Ten klucz celowo ma ograniczone uprawnienia: może tylko odświeżyć katalog. Nie daje dostępu do instancji ani danych klientów. To zasada najmniejszych uprawnień: jeśli dane uwierzytelniające wyciekną, szkody powinny być jak najmniejsze.

ℹ️ Uwaga: Zmiana dotyczy tylko NetSendo Cloud, które hostuje Aderlo. Instalacje self-hosted nie są objęte zmianą. Nadal sam decydujesz, kiedy pobrać i wdrożyć nowe wersje.

💼 Korzyści i przypadki użycia

🛠️ Krok po kroku: co musisz zrobić

Jeśli korzystasz z NetSendo Cloud

1. Nic nie musisz konfigurować

   Aktualizacje są planowane automatycznie po publikacji obrazu wydania.

2. Spodziewaj się nocnych aktualizacji

   Zwykłe wydania trafiają na instancje w nocnym oknie, grupa po grupie.

3. Śledź opisy wydań

   Sprawdzaj wydania na GitHubie, żeby wiedzieć, co się zmieniło. Wydania bezpieczeństwa mogą przyjść poza nocnym oknem.

Jeśli hostujesz NetSendo samodzielnie

Twoja konfiguracja się nie zmienia. Pobieraj nowe wersje, kiedy chcesz, na przykład:

docker compose pull
docker compose up -d

Pełną procedurę aktualizacji dla Twojego wdrożenia znajdziesz w dokumentacji.

Jeśli współtworzysz lub utrzymujesz NetSendo

1. Oznaczaj wydania tagiem vX.Y.Z

   Powiadomienie do Cloud jest wysyłane po publikacji obrazu dla tagu wersji.

2. Zostaw ### Security dla podatności

   Ten nagłówek oznacza „zainstaluj wszędzie od razu”. Nie używaj go do innych zmian.

3. Traktuj ADERLO_RELEASE_KEY jako sekret

   Przechowuj go tylko w sekretach GitHub Actions. Nigdy nie wypisuj go w logach ani nie dodawaj do repozytorium.

💡 Częsty błąd: Dodanie nagłówka ### Security „na wszelki wypadek” pomija etapowe nocne wdrożenie na wszystkich instancjach hostowanych. Jeśli nie masz pewności, czy zmiana naprawia podatność, zostaw ją w zwykłym trybie.

🏁 Podsumowanie

v2.3.1 to niewielka zmiana w pipeline wydań, ale pomaga każdemu klientowi NetSendo Cloud. Nowe wersje nie czekają już na nocne sprawdzenie rejestru. Zwykłe aktualizacje trafiają na instancje hostowane w nocy, grupa po grupie, a poprawki bezpieczeństwa są instalowane natychmiast. Klucz podpisujący może tylko odświeżyć katalog, a instalacje self-hosted działają tak jak wcześniej.

Użytkownicy self-hosted nadal sami decydują o aktualizacjach, a użytkownicy Cloud dostają je teraz szybciej.