Kaip perduoti svetainę kitai programuotojų komandai?

Perdavimas dažniausiai laikomas atliktu tada, kai atsiunčiamas kodo archyvas ir keli slaptažodžiai. Praktikoje tikras patikrinimas yra kitas: ar naujoji komanda gali pati padaryti nedidelį pakeitimą ir jį išleisti į veikiančią svetainę, niekam nepaskambinusi. Kol tai neįrodyta, perdavimas yra pažadas, ne faktas. Šis skirtumas svarbus, nes trūkstamos dalys išaiškėja tada, kai reikia skubaus taisymo.

Trumpai

• Perdavimo priėmimo kriterijus yra vienas: naujoji komanda savarankiškai išleidžia nedidelį pakeitimą į veikiančią svetainę.
• Prieigos turi būti perduotos kaip inventorius su savininkais, ne kaip slaptažodžių sąrašas laiške.
• Svarbiau už kodą yra galimybė jį paleisti: aplinkos kintamieji, duomenų bazės struktūra ir išleidimo eiga.
• Perduokite kodo istoriją, ne tik paskutinę versiją – be istorijos neįmanoma suprasti, kodėl kažkas padaryta.
• Slaptažodžius ir raktus po perdavimo reikia pakeisti. Perdavimas be rotacijos reiškia, kad prieigą turi ir senoji komanda.

Prieigų inventorius

Pirmas dalykas, kurio dažniausiai pasigendama, nėra kodas – tai prieigos prie paskyrų, kurių niekas neįtraukė į sąrašą, nes jomis naudojosi vienas žmogus. Naudinga sudaryti lentelę: paskyra, kam ji priklauso, kas turi prieigą dabar ir kas turės po perdavimo.

• Domeno registratorius ir DNS valdymas – dažniausiai pamirštama ir svarbiausia pozicija.
• Priegloba arba diegimo platforma, įskaitant aplinkos kintamųjų nustatymus.
• Kodo saugykla ir teisė kurti naujas versijas.
• Duomenų bazė: prieiga, atsarginių kopijų vieta ir jų atkūrimo tvarka.
• El. pašto siuntimo paslauga ir domeno patvirtinimo įrašai.
• Analitika, paieškos konsolė ir bet kokie stebėjimo įrankiai.
• Turinio valdymo sistemos administratoriaus paskyros.
• Mokėjimų ar kitų išorinių paslaugų paskyros, jei jos naudojamos.
• Sertifikatai ir raktai, jei jie nėra išduodami automatiškai.
• Trečiųjų šalių licencijos: šriftai, nuotraukos, komponentai.

Kodas ir jo istorija

Sukompiliuotas ar suarchyvuotas rezultatas nėra perdavimas. Naujajai komandai reikia kodo su versijų istorija, nes istorija yra vienintelė vieta, kur užrašyta, kodėl kažkas padaryta būtent taip. Be jos kiekvienas neįprastas sprendimas atrodys kaip klaida, ir kažkas bandys jį „sutvarkyti“ – dažniausiai sulaužydamas tai, ką tas sprendimas saugojo.

• Visa kodo saugykla su istorija ir šakomis, ne archyvas su paskutine versija.
• Sąrašas, kurios dalys nėra jūsų kodas: bibliotekos, šablonai, išoriniai komponentai.
• Duomenų bazės struktūros aprašas ir jos pakeitimų istorija.
• Aplinkos kintamųjų sąrašas su paaiškinimu, ką kiekvienas daro – be reikšmių.
• Automatiniai testai, jei jie yra, ir nurodymas, kaip juos paleisti.

Ar tai apskritai paleidžiama

Šis patikrinimas atsako į svarbiausią klausimą ir dažnai praleidžiamas. Naudinga, kad naujoji komanda paleistų svetainę savo aplinkoje nuo nulio, pagal perduotą dokumentaciją, be senosios komandos pagalbos. Jei tai neveikia, dokumentacija yra nepilna – ir tai geriau išsiaiškinti perdavimo metu, o ne per pirmą incidentą.

• Paleidimas vietoje pagal dokumentaciją, be papildomų paaiškinimų žodžiu.
• Bandomoji aplinka, kuri nėra veikianti svetainė – kad pakeitimus būtų kur patikrinti.
• Išleidimo eiga: kaip pakeitimas patenka į veikiančią svetainę ir kas tai gali padaryti.
• Atstatymo eiga: kaip grąžinama ankstesnė versija, jei išleidimas nepavyko.
• Atsarginės kopijos atkūrimo bandymas – kopija, kurios niekas neatkūrė, yra prielaida.

Dokumentacija, kuri realiai naudinga

Ilgas dokumentas dažniausiai neperskaitomas. Naudingiau trumpas tekstas, atsakantis į kelis konkrečius klausimus, kuriuos naujoji komanda užduos pirmą savaitę: kur kas yra, kas neakivaizdu ir ko nedaryti.

• Trumpas aprašas, kokios dalys sudaro sistemą ir kaip jos susijusios.
• Sprendimai, kurie atrodo neįprastai, ir priežastis, kodėl taip padaryta.
• Vietos, kurios yra trapios: kur pakeitimas gali netikėtai paveikti kitą dalį.
• Įprastos priežiūros užduotys ir jų ritmas.
• Žinomos problemos ir atidėti darbai – sąžiningas sąrašas naudingesnis už tylą.
• Kontaktai išorinėms paslaugoms, kurios nėra jūsų valdomos.

Priėmimo įrodymas

Perdavimą verta laikyti priimtu tik tada, kai yra įrodymas, o ne patvirtinimas žodžiu. Paprasčiausias ir stipriausias įrodymas yra nedidelis realus pakeitimas: naujoji komanda pakeičia vieną tekstą arba pataiso smulkmeną ir išleidžia tai į veikiančią svetainę pati. Tai vienu veiksmu patikrina prieigas, aplinką, išleidimo eigą ir dokumentaciją.

Iliustracinis pavyzdys

Iliustracinis scenarijus, ne kliento projekto aprašymas. Įsivaizduokime, kad perdavimas laikomas atliktu: kodas atsiųstas, slaptažodžiai perduoti, sąskaita apmokėta. Po mėnesio reikia pakeisti telefono numerį svetainės apačioje. Tada išaiškėja, kad numeris yra ne turinio sistemoje, o kode; kad išleidimui reikia aplinkos kintamojo, kurio niekas neperdavė; ir kad DNS valdymas tebėra senosios komandos paskyroje. Techniškai tai maži dalykai – bet skubus penkių minučių pakeitimas užtrunka savaitę. Jei perdavimo priėmimo kriterijus būtų buvęs „naujoji komanda pati išleidžia nedidelį pakeitimą“, visos trys skylės būtų išaiškėjusios perdavimo dieną.

Slaptažodžių rotacija po perdavimo

Perdavimas nėra baigtas, kol prieigos nepakeistos. Kol slaptažodžiai ir raktai tie patys, prieigą turi ir senoji komanda – dažniausiai be jokios piktos valios, tiesiog istoriškai. Rotacija taip pat yra praktinis patikrinimas: jei pakeitus raktą kažkas nustoja veikti, vadinasi, buvo priklausomybė, apie kurią niekas nežinojo.

• Pakeiskite administratorių slaptažodžius ir išorinių paslaugų raktus.
• Peržiūrėkite, kas turi prieigą kiekvienoje paskyroje, ir pašalinkite nebeaktualius žmones.
• Patikrinkite, ar nieko nesulaužė rotacija – tai geriausias momentas tai pastebėti.
• Užrašykite, kas dabar yra kiekvienos paskyros savininkas.

Ko šis vadovas nepasako

Jame nėra sumų, terminų ir sutarties formuluočių. Perdavimo apimtis priklauso nuo sistemos, todėl bet kuris čia įrašytas laikas ar skaičius būtų prielaida. Taip pat tai nėra teisinė konsultacija dėl intelektinės nuosavybės ar sutarties nutraukimo – šiuos klausimus verta patikrinti su savo teisininku. Vadovo tikslas kitas: kad perdavimas turėtų patikrinamą priėmimo kriterijų, o ne tik pažymėtą langelį.

Jei iš viso sąrašo pasirinksite tik vieną dalyką, pasirinkite šį: nelaikykite perdavimo priimtu, kol naujoji komanda pati neišleido nedidelio pakeitimo į veikiančią svetainę.