Pornește orice platformă de la zero

Un inginer nou se alătură într-o luni. Cât timp până are sistemul rulând pe mașina lui, cu o bază de date populată, hot-reloading, și poate vedea efectul unei schimbări pe care tocmai a făcut-o?

Dacă răspunsul implică o pagină de wiki, răspunsul e greșit. Pentru că pagina de wiki descrie configurarea așa cum era când cineva a avut ultima dată o zi destul de proastă încât s-o scrie.

Răspunsul nostru sunt două comenzi.

make deps
make start

Asta e identic pe fiecare proiect pe care-l rulăm. Nu similar. Identic.

Declarat, dintr-o singură sursă

Stiva nu e un fișier compose scris manual. E declarată: ce servicii există, ce imagini rulează, ce porturi expun, ce volume montează, de ce depinde fiecare. Un tool compilează acea declarație într-o stivă locală care rulează.

Distincția contează mai mult decât pare la prima vedere. Un fișier compose scris manual e o a doua descriere a sistemului, întreținută în paralel cu cea de producție și divergând continuu de ea. Baza de date locală e o versiune în urmă. O variabilă de mediu pe care producția o setează lipsește local, iar o cale de cod care o citește nu e niciodată exercitată până când nu e exercitată de un client.

Când ambele medii compilează dintr-o singură declarație, acea clasă de diferență încetează să fie posibilă. Local și producție diferă unde sunt *declarate* să difere, sursă montată, un catcher de mail în loc de un releu SMTP real, observabilitate oprită, și nicăieri altundeva.

Hot reload e o proprietate a mediului, nu a editorului

Directoarele sursă se montează în containerele care rulează. Editarea unui fișier pe host reîncarcă procesul din interiorul containerului. Fără reconstrucție, fără restart, fără push de imagine.

Două detalii sunt ce face asta plăcut, nu fragil.

Primul e că directoarele de dependințe *nu* sunt montate de pe host. Un node_modules instalat pe host și montat într-un container Linux e un mod sigur de a pierde o după-amiază pe un binar nativ compilat pentru platforma greșită. Trăiește într-un volum numit, deținut de container, în schimb. Copia de pe host, dacă există una, există doar ca să țină fericit language server-ul editorului.

Al doilea e că migrările rulează la pornire. Containerul API aplică migrările în așteptare înainte să servească. Nu există stare în care codul așteaptă o coloană pe care baza de date locală n-o are, pentru că ridicarea stivei e ce le reconciliază.

Resetarea trebuie să fie ieftină

make db-reset

Șterge volumul, repornește, reaplică migrările. Înapoi la o stare cunoscută în câteva secunde.

Asta sună ca o comoditate. E mai aproape de o precondiție pentru muncă bună. Când resetarea e scumpă, inginerii o evită. Repară manual o stare locală stricată, acumulează o bază de date care nu seamănă cu nicio altă bază de date de nicăieri, și în cele din urmă lovesc un bug care se reproduce doar pentru ei. Când resetarea e ieftină, răspunsul corect la o stare locală confuză e s-o arunci, și mediul fiecăruia converge, nu diverge.

Verificarea care o menține adevărată

Documentația despre cum să rulezi un sistem se degradează pentru că nimic n-o testează. A noastră e verificată de faptul că e singura cale: nu există un mod alternativ de a porni stiva pe care un membru al echipei l-ar putea folosi în schimb și astfel să înceteze să observe că cea documentată s-a stricat.

Precizarea onestă e că asta ține atâta timp cât unealta e disponibilă și la zi. Un tool care a evoluat în timp ce instrucțiunile unui repository n-au făcut-o e aceeași problemă de wiki învechit, îmbrăcată mai bine. Pragurile de versiune sunt declarate din acest motiv, iar o versiune nepotrivită eșuează cu un mesaj care spune asta, în loc să eșueze pe jumătate cu ceva de nedescifrat.

De ce merită efortul

Câștigul evident e onboarding-ul: un inginer nou contribuie din prima zi, nu din a treia.

Câștigul mai mare e că elimină o categorie întreagă de dispută. Nimeni nu dezbate dacă un eșec e de mediu. Nimeni nu întreține un script privat de configurare. Nimeni nu e singura persoană care poate reproduce bug-ul. Mediul încetează să mai fie o variabilă, iar singurul lucru rămas de discutat e codul. Care e conversația care merită purtată.