4digital.cloud4digital.cloud
← Engineering

Kontrola zmian w infrastrukturze

Terraform w działającym środowisku

W skrócie: Objąłem istniejącą infrastrukturę zarządzaniem jako kodem bez przebudowy działających usług. Zgodność konfiguracji potwierdziłem planami bez zmian, a proces migracji stanu — osobnymi testami.

01 / Dla Twojej organizacji

Środowisko, które działa od lat i było konfigurowane ręcznie albo różnymi narzędziami, można objąć zarządzaniem jako kodem bez przebudowy. Zyskuje wtedy kontrolę zmian, przegląd i historię konfiguracji, a działająca konfiguracja zostaje zachowana.

Pierwsza zmiana jest możliwa dopiero wtedy, gdy kod dokładnie opisuje stan obecny, a stan Terraformu ma blokady, kopie i sprawdzoną drogę powrotu. Przejęcie nie wymaga ponownego budowania usług.

02 / Realizacja na zapleczu 4digital

Tak przejąłem część zaplecza 4digital, m.in. DNS, dostęp Zero Trust, repozytoria kodu i magazyn sekretów, a stan istniejących projektów przeniosłem do prywatnego serwisu z pełną historią zmian. Punkt wyjścia: pusty backend nie oznacza, że zasobów nie ma. Pracę oparłem na czterech zasadach:

  • Najpierw import, potem zarządzanie — przejęcie jest zakończone dopiero wtedy, gdy terraform plan pokazuje „No changes”.
  • Jeden właściciel każdego obiektu — Ansible odpowiada za hosty i usługi systemowe, Terraform za wszystko, co jest za API usługi. Punkt przekazania jest jawny.
  • Import tylko do odczytu — w izolowanym środowisku dostęp do usługi przechodził przez most dopuszczający wyłącznie zapytania GET, więc przejęcie nie mogło wpłynąć na jej działanie.
  • Migracja z możliwością powrotu — każdy plik stanu kopiowany bajt w bajt pod blokadą, z weryfikacją lineage i serial, kopią w chronionym magazynie migawek i blokadą starego miejsca, która zatrzymuje zapis ze starej konfiguracji.

Zbudowałem prywatny serwis stanu Terraform za warstwą dostępu Zero Trust. Każdy stan ma własny obiekt, który serializuje zapisy i utrzymuje trwałą blokadę bez automatycznego wygasania. Przed każdą zmianą poprzednia i nowa wersja stanu są archiwizowane jako migawki adresowane treścią, chronione przed nadpisaniem i usunięciem przez 30 dni; jeśli migawki nie da się zapisać, zapis stanu jest wstrzymany. Terraform łączy się przez krótkotrwały lokalny przekaźnik, więc nie dostaje klucza do magazynu, a sekrety dostępu nie trafiają do metadanych backendu ani do zapisanych planów.

Przywracanie stanu wymaga tego samego lineage, sprawdza bieżący hash i podbija serial. Usunięcia stanu, zmiany lineage i zapisu nieaktualnej wersji narzędzie odmawia, także przy state push -force. Wrapper uruchamiający Terraform nie wykona planu ani wdrożenia, dopóki stan nie zostanie wpisany do przeglądanego katalogu przejętych stanów.

Usługi przejmowałem kolejno: osobny stan dla każdej, import, plan bez zmian i wpis do katalogu. Granica między Ansible a Terraformem przesuwa się w jednej zmianie: gdy obiekt trafia do Terraformu, znika z konfiguracji Ansible.

03 / Rezultat

Wybrane działające usługi mają konfigurację opisaną i zaimportowaną do Terraformu. Plan bez zmian potwierdza zgodność punktu wyjścia. Przyjęcie konfiguracji nie uruchamia automatycznie wdrożeń — pierwsza modyfikacja wymaga osobnego planu i zatwierdzenia. Hasła, tokeny i zawartość repozytoriów świadomie zostały poza Terraformem: zakres przejęcia obejmuje to, czym rzeczywiście warto zarządzać w kodzie.

Wartość: kontrola zmian, historia konfiguracji i powtarzalne zarządzanie infrastrukturą — bez konieczności zastępowania środowiska, które już działa.

04 / Wybrane dowody

  • Plan bez zmian dla każdej przejętej usługi, potwierdzony w dwóch kolejnych cyklach.
  • Pliki stanu przeniesione bajt w bajt, z zachowaniem historii zmian i blokadą migracyjną potwierdzoną próbą.
  • Próba serwisu stanu na żywo: plan bez zmian, konkurencyjna blokada, przywrócenie z migawki i ponowny plan bez zmian.
  • Dane po przejęciu bez zmian: pełna kontrola integralności repozytoriów, zgodność artefaktów, tożsamości i uprawnień.
Źródło doświadczenia
Własne zaplecze 4digital
Kompetencja
Infrastruktura jako kod
Obszary technologiczne
Terraform · Ansible · Cloudflare Access, Workers, Durable Objects i R2 · Vault · sops · Forgejo · Migracja stanu