{"id":53442,"date":"2019-12-02T00:00:00","date_gmt":"2019-12-01T21:00:00","guid":{"rendered":"https:\/\/prohoster.info\/blog\/blog_prohoster\/legacy-servisy-v-vashej-infrastrukture"},"modified":"2020-02-18T14:01:20","modified_gmt":"2020-02-18T11:01:20","slug":"legacy-servisy-v-vashej-infrastrukture","status":"publish","type":"post","link":"https:\/\/prohoster.info\/pl\/blog\/administrirovanie\/legacy-servisy-v-vashej-infrastrukture","title":{"rendered":"Legacy us\u0142ugi w twojej infrastrukturze","gt_translate_keys":[{"key":"rendered","format":"text"}]},"content":{"rendered":"

Cze\u015b\u0107! Mam na imi\u0119 Pawe\u0142 Czerniak, jestem g\u0142\u00f3wnym programist\u0105 w QIWI i dzi\u015b chc\u0119 porozmawia\u0107 o nieuniknionym. O Legacy.<\/p>\n

Zacznijmy od pytania: czym jest us\u0142uga Legacy? Us\u0142uga Legacy to taka, kt\u00f3rej programista nie dotyka\u0142 przez tydzie\u0144\/miesi\u0105c\/rok? A mo\u017ce to us\u0142uga napisana przez mniej do\u015bwiadczonego programist\u0119, na przyk\u0142ad przez Ciebie, ale rok temu? A teraz jeste\u015b lepszy i bardziej do\u015bwiadczony. Czy mo\u017ce jednak us\u0142uga Legacy to taka, kt\u00f3r\u0105 postanowi\u0142e\u015b nigdy wi\u0119cej nie rozwija\u0107 i powoli przygotowujesz jej zast\u0119pstwo? W ka\u017cdym razie zostawienie takiej us\u0142ugi bez opieki i nieaktualizowanie jej to bomba z op\u00f3\u017anionym zap\u0142onem, kt\u00f3ra mo\u017ce eksplodowa\u0107 p\u00f3\u017aniej.<\/p>\n

\"Legacy<\/a><\/noindex><\/p>\n

Zanim przejdziemy do tego, jak w QIWI zajmujemy si\u0119 naszymi us\u0142ugami Legacy, opowiem, jak uporz\u0105dkowali\u015bmy us\u0142ugi w Portfelu. Od dw\u00f3ch lat odpowiadam za jego dzia\u0142anie. Je\u015bli wyst\u0105pi jaki\u015b problem, to zawsze w pierwszej kolejno\u015bci dzwoni\u0105 do mnie. Zwykle brakuje mi odwagi, aby o 23:00 dzwoni\u0107 do kogo\u015b innego, dlatego musia\u0142em usi\u0105\u015b\u0107 i zaj\u0105\u0107 si\u0119 wszystkimi us\u0142ugami naszego domeny. <\/p>\n

Ale ja, jak ka\u017cdy cz\u0142owiek, lubi\u0119 spa\u0107 w nocy, wi\u0119c stara\u0142em si\u0119 zrozumie\u0107 eksploatacj\u0119: \"Ludzie, dlaczego do mnie dzwonicie?\". Na co otrzyma\u0142em do\u015b\u0107 lakoniczn\u0105 odpowied\u017a: \"A do kogo innego?\". Poniewa\u017c naprawiam us\u0142ugi, a ponadto ludzie po prostu nie wiedz\u0105, do kogo dzwoni\u0107.<\/p>\n

Dlatego na jednym z retrospektyw zespo\u0142u backendowego Portfela postanowili\u015bmy stworzy\u0107 tabel\u0119, na kt\u00f3rej napisano list\u0119 naszych us\u0142ug, mikrous\u0142ug i monolit\u00f3w portfela oraz odpowiedzialnych za nie. Tabele s\u0105 w og\u00f3le przydatne, w rozs\u0105dnych granicach.
\n<\/a><\/noindex>
\nOpr\u00f3cz informacji o tym, kto za co odpowiada, znajdowa\u0142y si\u0119 tam odpowiedzi na pytania: kto jest w\u0142a\u015bcicielem us\u0142ugi, kto odpowiada za jej rozw\u00f3j, architektur\u0119 i cykl \u017cycia. Osoby odpowiedzialne za t\u0119 us\u0142ug\u0119 to osoby, kt\u00f3re mog\u0105 w razie potrzeby j\u0105 naprawi\u0107. W\u0142a\u015bciciel us\u0142ugi ma prawo doda\u0107 +2 w commitach, a odpowiedzialni r\u00f3wnie\u017c musz\u0105 by\u0107 obecni na przegl\u0105dzie, zanim ta us\u0142uga przyjmie nowy commit.<\/p>\n

Czas mija\u0142, zacz\u0119to stosowa\u0107 nowe praktyki, takie jak migracja do Kubernetes, r\u00f3\u017cne checkstyle, spotbugs, ktlint, obecno\u015b\u0107 log\u00f3w w Kibanie, autodiscovery us\u0142ug zamiast bezpo\u015bredniego wskazywania adres\u00f3w oraz inne przydatne rzeczy. Nasza tabela pozwala\u0142a utrzymywa\u0107 aktualno\u015b\u0107 naszych us\u0142ug. Dla nas to co\u015b w rodzaju checklisty, kt\u00f3ra wskazuje, co dana us\u0142uga potrafi robi\u0107, a czego jeszcze nie. Ale posuwali\u015bmy si\u0119 dalej, zdaj\u0105c sobie spraw\u0119, \u017ce brakuje nam informacji o naszych us\u0142ugach, kt\u00f3rymi si\u0119 opiekujemy, gdzie znajduj\u0105 si\u0119 \u017ar\u00f3d\u0142a us\u0142ugi, gdzie uruchamiane s\u0105 zadania kompilacji w TeamCity, jak s\u0105 wdra\u017cane, gdzie przechowywane s\u0105 \u017ar\u00f3d\u0142a test\u00f3w end2end, zdj\u0119cia architektury, dotycz\u0105ce podj\u0119tych decyzji. Idealnie by\u0142oby, gdyby te wszystkie informacje by\u0142y gdzie\u015b zgromadzone i dost\u0119pne w razie potrzeby. Dlatego nasza tabela sta\u0142a si\u0119 punktem wyj\u015bcia do poszukiwania informacji.<\/p>\n

Jednak QIWI, cho\u0107 zachowuje ducha startupu, jest du\u017c\u0105 firm\u0105. Mamy ju\u017c 12 lat, a zespo\u0142y si\u0119 zmieniaj\u0105: ludzie odchodz\u0105, przychodz\u0105 nowi, formuj\u0105 si\u0119 nowe zespo\u0142y. Odkryli\u015bmy na naszej domenie kilka us\u0142ug, kt\u00f3re odziedziczyli\u015bmy. Niekt\u00f3re przysz\u0142y od deweloper\u00f3w z innych zespo\u0142\u00f3w, inne po prostu w jaki\u015b spos\u00f3b by\u0142y zwi\u0105zane z Portfelem, dlatego teraz mamy je na swoim bilansie. Po co si\u0119 zastanawia\u0107, co i jak dzia\u0142a? Us\u0142uga dzia\u0142a, a my mamy funkcje produktowe, kt\u00f3re musimy koniecznie wdro\u017cy\u0107.<\/p>\n

Tak bywa.<\/h2>\n

\nJednak w pewnym momencie odkrywamy, \u017ce us\u0142uga przestaje pe\u0142ni\u0107 swoj\u0105 funkcj\u0119, co\u015b si\u0119 zepsu\u0142o \u2014 co robi\u0107 w takiej sytuacji? Us\u0142uga po prostu przesta\u0142a dzia\u0142a\u0107. Ca\u0142kowicie. A dowiedzieli\u015bmy si\u0119 o tym, po pierwsze, przypadkowo, a po drugie, po sze\u015bciu miesi\u0105cach. Tak bywa. Jedyn\u0105 rzecz\u0105, kt\u00f3r\u0105 wiedzieli\u015bmy, by\u0142o to, na jakich wirtualnych maszynach uruchomiona jest us\u0142uga, gdzie znajduj\u0105 si\u0119 jej \u017ar\u00f3d\u0142a i tyle. Robimy git clone i zag\u0142\u0119biamy si\u0119 w my\u015bli osoby, kt\u00f3ra pisa\u0142a to kilka lat temu, ale co widzimy? \u017badnego znajomego dla nas Spring Boot, chocia\u017c do tego si\u0119 przyzwyczaili\u015bmy, mamy przecie\u017c full stack i tym podobne. Mo\u017ce jest tam Spring Framework? A gdzie tam.<\/p>\n

Facet, kt\u00f3ry to wszystko napisa\u0142, by\u0142 surowy i wszystko pisa\u0142 w czystym Javie. Nie ma znanych narz\u0119dzi dla programisty, i pojawia si\u0119 pomys\u0142 \u2014 trzeba to wszystko przepisa\u0107. Mamy mikroserwisy, a z ka\u017cdego tostera dociera znane \u201eLudzie, mikroserwisy to to, czego potrzebujecie!\u201d. Je\u015bli co\u015b p\u00f3jdzie nie tak, spokojnie we\u017amiecie dowolny j\u0119zyk, a wszystko b\u0119dzie w porz\u0105dku.<\/p>\n

Sprawa w tym, \u017ce teraz nie mamy klienta, kt\u00f3ry odpowiada za t\u0119 us\u0142ug\u0119. Jakie by\u0142y jego wymagania biznesowe, co w og\u00f3le ta us\u0142uga powinna robi\u0107? A us\u0142uga jest mocno zintegrowana z waszymi procesami biznesowymi. <\/p>\n

A teraz powiedzcie, jak \u0142atwo przepisa\u0107 us\u0142ug\u0119, nie znaj\u0105c jej wymaga\u0144 biznesowych? Nie wiadomo, jak us\u0142uga jest logowana, czy s\u0105 jakie\u015b metryki \u2014 nie wiadomo. Jakie one s\u0105, je\u015bli w og\u00f3le istniej\u0105 \u2014 tym bardziej nie wiadomo. A w samej us\u0142udze znajduje si\u0119 ogromna liczba klas niezrozumia\u0142ej logiki biznesowej. Co\u015b trafia do jakiej\u015b bazy danych, o kt\u00f3rej te\u017c na razie nic nie wiemy. <\/p>\n

Od czego zacz\u0105\u0107?<\/h2>\n

\nOd najbardziej logicznej rzeczy \u2014 od obecno\u015bci test\u00f3w. Tam zazwyczaj jest napisana jaka\u015b logika i mo\u017cna wyci\u0105gn\u0105\u0107 wnioski o tym, co si\u0119 dzieje. Obecnie modne jest TDD, ale widzimy, \u017ce te same 5 lat temu wszystko wygl\u0105da\u0142o praktycznie tak samo jak teraz: prawie nie ma test\u00f3w jednostkowych, a one tak naprawd\u0119 nie powiedz\u0105 nam nic. No, mo\u017ce poza jak\u0105\u015b kontrol\u0105, jak podpisuje si\u0119 jaki\u015b xml z jakim\u015b niestandardowym certyfikatem.<\/p>\n

Nie uda\u0142o si\u0119 nic zrozumie\u0107 z kodu, wi\u0119c poszli\u015bmy sprawdzi\u0107, co tam na wirtualce. Otworzyli\u015bmy logi us\u0142ugi i znale\u017ali\u015bmy w nich b\u0142\u0105d klienta http \u2014 samopodpisany certyfikat, kt\u00f3ry zosta\u0142 wbudowany w zasoby aplikacji, ca\u0142kowicie wygas\u0142. Skontaktowali\u015bmy si\u0119 z naszymi analitykami, poprosili o nowy certyfikat, kt\u00f3ry nam wystawiono, i us\u0142uga znowu dzia\u0142a. Mo\u017cna by pomy\u015ble\u0107, \u017ce na tym koniec. A jednak? Us\u0142uga dzia\u0142a, wykonuje jak\u0105\u015b funkcj\u0119, kt\u00f3ra jest potrzebna naszemu biznesowi. Mamy pewne standardy dotycz\u0105ce rozwoju aplikacji, kt\u00f3re najprawdopodobniej macie i wy. Na przyk\u0142ad, nie przechowywa\u0107 log\u00f3w na w\u0119\u017ale w folderze, tylko w jakim\u015b magazynie, np. w Elasticsearch, i przegl\u0105da\u0107 je w Kibanie. Mo\u017cna te\u017c wspomnie\u0107 o z\u0142otych metrykach. Czyli obci\u0105\u017cenie us\u0142ugi, liczba zapyta\u0144 do us\u0142ugi, czy dzia\u0142a, czy nie, jak przechodzi HealthCheck. Przynajmniej te metryki pomog\u0105 ustali\u0107, kiedy mo\u017cna go spokojnie wycofa\u0107 z eksploatacji i zapomnie\u0107 jak z\u0142y sen.<\/p>\n

Co robi\u0107<\/h2>\n

\nDlatego dodajemy t\u0119 star\u0105 us\u0142ug\u0119 do tabeli, a potem idziemy szuka\u0107 w\u015br\u00f3d programist\u00f3w ochotnik\u00f3w, kt\u00f3rzy zajm\u0105 si\u0119 t\u0105 us\u0142ug\u0105 i doprowadz\u0105 j\u0105 do porz\u0105dku: napisz\u0105 jak\u0105\u015b informacj\u0119 o us\u0142udze, dodadz\u0105 linki do dashboard\u00f3w w Grafanie, do zada\u0144 budowy, zrozumiej\u0105, jak uruchamia\u0107 aplikacj\u0119, nie rzucajmy plik\u00f3w za pomoc\u0105 FTP. <\/p>\n

Najwa\u017cniejsze \u2014 ile czasu zajmie ta ca\u0142a u\u017cyteczna aktywno\u015b\u0107 ochotnicza? Jeden sprint dla bardziej lub mniej do\u015bwiadczonego programisty, na przyk\u0142ad, w czasie 20% d\u0142ugu technicznego. A ile czasu zajmie zrozumienie ca\u0142ej zakorzenionej logiki komunikacji z jakim\u015b systemem rz\u0105dowym, przekszta\u0142cenie jej w nowocze\u015bniejsze technologie? Nie gwarantuj\u0119 tego, mo\u017ce miesi\u0105c, a mo\u017ce dwa pr Ace zespo\u0142u. M\u00f3wi\u0119 to z do\u015bwiadczenia integracji w obecnym czasie z jak\u0105\u015b now\u0105 us\u0142ug\u0105.<\/p>\n

Przy tym nie ma \u017cadnej warto\u015bci biznesowej \u2014 zupe\u0142nie. Wzi\u0119cie us\u0142ugi pod wsparcie i po\u015bwi\u0119cenie na to troch\u0119 czasu \u2014 to normalne. Ale po naszych standardowych ta\u0144cach z us\u0142ug\u0105 dodali\u015bmy j\u0105 do tabeli, dodali\u015bmy informacje o niej, a mo\u017ce kiedy\u015b j\u0105 przepiszemy. Ale teraz odpowiada naszym standardom pracy z us\u0142ugami.<\/p>\n

W rezultacie chcia\u0142bym podsumowa\u0107 plan, co robi\u0107 z us\u0142ugami Legacy. <\/p>\n

Przepisywanie legacy od zera \u2014 to z\u0142y pomys\u0142<\/b>
\nNa serio, nie ma co o tym my\u015ble\u0107. Jasne, \u017ce by\u0142yby jakie\u015b korzy\u015bci, ale zazwyczaj nikt tego nie potrzebuje, w tym wy sami.<\/p>\n

Wska\u017anik<\/b>
\nOdkopcie \u017ar\u00f3d\u0142owe kody swoich aplikacji, zr\u00f3bcie wska\u017anik, w kt\u00f3rym b\u0119dzie wskazane, co i gdzie le\u017cy oraz jak dzia\u0142a, dodajcie opis projektu (analogiczne do readme.md), aby szybko zrozumie\u0107, gdzie znajduj\u0105 si\u0119 logi i metryki. Programista, kt\u00f3ry b\u0119dzie si\u0119 tym zajmowa\u0142 po was, tylko podzi\u0119kuje.<\/p>\n

Rozumiejcie domen\u0119<\/b>
\nJe\u015bli posiadacie jak\u0105\u015b domen\u0119, starajcie si\u0119 mie\u0107 oko na sytuacj\u0119. Brzmi banalnie, prawda, ale nie wszyscy pilnuj\u0105, aby us\u0142ugi by\u0142y w jednolitym stylu. A praca w jednym standardzie jest naprawd\u0119 znacznie prostsza.<\/p>\n

Tylko zarejestrowani u\u017cytkownicy mog\u0105 bra\u0107 udzia\u0142 w ankiecie. Zaloguj si\u0119<\/a><\/noindex>, prosz\u0119.<\/p>\n

Co robicie ze swoim legacy?<\/h2>\n