Zanim zaczniesz<\/h3>\n\n\n\n
Ide\u0105 tego artyku\u0142u jest pokazanie w jaki spos\u00f3b budowa\u0107 mikroserwis w \u015brodowisku SAP Cloud Foundry, a nast\u0119pnie udost\u0119pni\u0107 go poprzez API Management. Mikroserwisem w naszym przypadku b\u0119dzie prosta aplikacja, kt\u00f3ra z bazy danych HANA poprzez serwis Node.js wystawi dane pracownika jako interfejs (patrz Rysunek 1).<\/p>\n\n\n\n
![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/1-1.png\")
<\/a>Architektura takiego rozwi\u0105zania, podyktowana jest ch\u0119ci\u0105 pokazania, \u017ce z\u0142o\u017con\u0105 logik\u0119 backendu mo\u017cna zatomizowa\u0107, co cz\u0119sto jest problemem programist\u00f3w, kt\u00f3rzy nie mog\u0105 r\u00f3wnolegle rozwija\u0107 swoich aplikacji. W tym celu wykorzystywany jest SCP API Management, aby zapewni\u0107 dost\u0119p do APIs z jednego wsp\u00f3lnego miejsca, dla zewn\u0119trznych \u017ar\u00f3de\u0142. Bez potrzeby uzewn\u0119trzniania logiki biznesowej.<\/p>\n\n\n\n
Jak zacz\u0105\u0107?<\/h3>\n\n\n\n
SAP, dla os\u00f3b chc\u0105cych odkrywa\u0107 mo\u017cliwo\u015bci ich produkt\u00f3w, oferuje swoje \u015brodowisko i us\u0142ugi w darmowej wersji trial. Wystarczy jedynie zarejestrowa\u0107 si\u0119 w SAP Cloud Platform trial<\/a>. W SCP b\u0119dziemy korzysta\u0107 z nast\u0119puj\u0105cych us\u0142ug SAP:<\/p>\n\n\n\n Z perspektywy SAP Cloud Platform korzysta\u0107 b\u0119dziemy z dw\u00f3ch \u015brodowisk: Cloud Foundry oraz Neo. Cloud Foundry pos\u0142u\u017cy nam do zbudowania aplikacji eksponowanej jako mikrous\u0142uga, natomiast Neo pozwoli nam wystawi\u0107 API do mikroserwisu dla zewn\u0119trznych aplikacji\/system\u00f3w.<\/p>\n\n\n\n Po uruchomieniu Neo, z menu aplikacji nale\u017cy wybra\u0107 Services. Na wy\u015bwietlonej li\u015bcie nale\u017cy odszuka\u0107 API Management i zadba\u0107 o to, aby serwis by\u0142 dost\u0119pny (zgodnie z Rysunek 2).<\/p>\n\n\n\n W szczeg\u00f3\u0142ach serwisu (patrz Rysunek 3) nale\u017cy uruchomi\u0107 API Portal i tam zarejestrowa\u0107 swojego u\u017cytkownika w us\u0142ugach SAP. Pozwoli to nam w p\u00f3\u017aniejszych krokach na za\u0142o\u017cenie API do naszego mikroserwisu.<\/p>\n\n\n\n Przedostatnim krokiem jest konfiguracja SAP Cloud Foundry. Je\u015bli w zak\u0142adce Subaccounts, nie mamy jeszcze podpi\u0119tego \u017cadnego systemu to nale\u017cy go doda\u0107 np. w spos\u00f3b jak na Rysunku 4.<\/p>\n\n\n\n Ponadto nale\u017cy doda\u0107 Space, czyli przestrze\u0144 robocz\u0105 dla developmentu. G\u0142\u00f3wn\u0105 ide\u0105 Space jest to, \u017ce tworzy ona rodzaj strefy zaufania, co w zasadzie oznacza, \u017ce wszystkie aplikacje wdro\u017cone w tej samej przestrzeni mog\u0105 mie\u0107 wsp\u00f3lne zasoby, takie jak przechowywanie danych, autoryzacje u\u017cytkownik\u00f3w i has\u0142a. Przestrze\u0144 jest przeznaczona do wsp\u00f3\u0142dzielenia przez kilku programist\u00f3w, ale programi\u015bci mog\u0105 r\u00f3wnie\u017c mie\u0107 swoj\u0105 prywatn\u0105 przestrze\u0144. Aby doda\u0107 przestrze\u0144 nale\u017cy otworzy\u0107 szczeg\u00f3\u0142y naszego systemu, kt\u00f3ry za\u0142o\u017cyli\u015bmy w poprzednim kroku i doda\u0107 Space tak jak na Rysunku 5.<\/p>\n\n\n\n Ostatnim krokiem przed rozpocz\u0119ciem developmentu jest konfiguracja WebIDE. Link do naszego \u015brodowiska developerskiego znajduje si\u0119 w SAP Cloud Platform Cockpit. W tym kroku nale\u017cy zgodnie z Rysunkiem 6 otworzy\u0107 ustawienia i w zak\u0142adce Cloud Foundry zdefiniowa\u0107 nasz Space, API Endpoint i poda\u0107 Organizacje (jest nim nasz S-User z suffixem trial). Je\u015bli si\u0119 zgubili\u015bcie, to API Endpoint zosta\u0142 wygenerowany w trakcie zak\u0142adania systemu w Cloud Foundry i jest widoczny w jego szczeg\u00f3\u0142ach.<\/p>\n\n\n\n W celu u\u0142atwienia sobie pracy, nale\u017cy jeszcze w\u0142\u0105czy\u0107 dwa rozszerzenia w Web IDE, kt\u00f3re pozwol\u0105 nam na prac\u0119 z baz\u0105 danych SAP HANA. Z zak\u0142adki ustawienia, nale\u017cy wybra\u0107 opcj\u0119 \u201eExtensions\u201d, a nast\u0119pnie skonfigurowa\u0107 aplikacj\u0119 tak, jak na Rysunku 7.<\/p>\n\n\n\n Nareszcie mo\u017cemy przej\u015b\u0107 do etapu na kt\u00f3ry czekali\u015bmy, czyli development. W tym kroku za\u0142o\u017cymy aplikacj\u0119, kt\u00f3ra b\u0119dzie sk\u0142ada\u0142a si\u0119 z Core Data Services (CDS) i serwisu Node.js. CDS umo\u017cliwiaj\u0105 modelowanie danych i definicji us\u0142ug na poziomie koncepcyjnym. Na ich podstawie tworzone s\u0105 natywne artefakty (np. SQL database schema). Rola CDS nie ogranicza si\u0119 jedynie do strukturyzowania danych. Przy wykorzystaniu odpowiednich annotacji i sk\u0142adowych j\u0119zyka, mo\u017cliwe jest definiowanie relacji danych, co mo\u017ce finalnie pom\u00f3c w definiowaniu poziomu UI.<\/p>\n\n\n\n Na pocz\u0105tku zaczniemy jednak od czego\u015b prostszego, a mianowicie za\u0142o\u017cymy now\u0105 aplikacj\u0119 ?. Do tego pos\u0142u\u017cy nam \u015brodowisko Web IDE. Z g\u00f3rnego menu wybierzmy \u201eCreate project from Template\u201d, a nast\u0119pnie wybierzmy \u201eSAP Cloud Platform Business Application\u201d. Opcja ta umo\u017cliwia nam budowanie full-stackowych aplikacji, gdy\u017c SAP zapewnia \u015brodowisko end-to-end. W kolejnym kroku podajemy nazw\u0119 projektu i nawigujemy dalej, a\u017c dojdziemy do momentu, w kt\u00f3rym b\u0119dziemy musieli poda\u0107 szczeg\u00f3\u0142y projektu, takie jak: j\u0119zyk serwis\u00f3w (u nas Node.js), wersja protoko\u0142u oData, czy te\u017c informacj\u0119 o tym, czy ma zosta\u0107 automatycznie podpi\u0119ta baza danych HANA. Nasza konfiguracja powinna by\u0107 zgodna z Rysunkiem 8.<\/p>\n\n\n\n Po naci\u015bni\u0119ciu \u201eFinish\u201d aplikacja zostanie za\u0142o\u017cona w Workspace. Po rozwini\u0119ciu drzewka aplikacji widzimy szereg folder\u00f3w i gotowego kodu. Ich znaczenie jest nast\u0119puj\u0105ce:<\/p>\n\n\n\n Nasz\u0105 prac\u0119 zaczniemy od modelowania danych. W tym celu otw\u00f3rzmy plik data-model.cds. W przypadku testowym zbudowa\u0142em encje, kt\u00f3ra b\u0119dzie przechowywa\u0142a pracownik\u00f3w z przypisanymi do nich miejscowo\u015bciami i pa\u0144stwem. Wykorzysta\u0142em tutaj typ danych kt\u00f3ry zdefiniowany jest w sap\/cds\/common. Je\u015bli chodzi o namespace, to jest on dowolny (w przypadkach nieprodukcyjnych). Zbudowany CDS wygl\u0105da jak w Listing kodu 1.<\/p>\n\n\n\n Warto zauwa\u017cy\u0107, \u017ce w momencie gdy klikn\u0119li\u015bmy \u201ebuild\u201d na module bazy danych, utworzone zosta\u0142y automatycznie nowe artefakty. W tym wypadku widoki CDS i tabele odpowiedzialne za przechowywanie danych pracownika i pa\u0144stw (tabelka tekstowa). Ca\u0142o\u015b\u0107 wygl\u0105da tak jak na Rysunku 9.<\/p>\n\n\n\n W tym momencie mo\u017cemy wype\u0142ni\u0107 nasze tabelki danymi. Aby przej\u015b\u0107 do widoku bazy danych, kliknij na module \u201edb\u201d prawym przyciskiem myszy i wybierz \u201eOpen HDI Container\u201d. Je\u015bli w nowo otwartym oknie nie pojawi\u0142a Ci si\u0119 \u017cadna bazy danych, mo\u017cesz j\u0105 \u0142atwo podpi\u0105\u0107 klikaj\u0105c znak \u201e+\u201d. Wybierz domy\u015bln\u0105 baz\u0119 danych, jaka zosta\u0142a stworzona, dla za\u0142o\u017conego przez Ciebie Space. W dodanej bazie nawiguj na zak\u0142adk\u0119 \u201eTables\u201d. W oknie poni\u017cej powinny Ci si\u0119 wy\u015bwietli\u0107 tabele. W moim przypadku ich nazwy to:<\/p>\n\n\n\n W tym momencie mamy dwie mo\u017cliwo\u015bci, aby doda\u0107 zawarto\u015b\u0107 tabeli:<\/p>\n\n\n\n Zak\u0142adam, i\u017c podstawy SQL zna ka\u017cdy, wi\u0119c szybko opisz\u0119 w jaki spos\u00f3b korzysta\u0107 z edytora graficznego. Po wklikaniu si\u0119 w nazw\u0119 tabeli, wy\u015bwietli nam si\u0119 okno zawieraj\u0105ce szczeg\u00f3\u0142y techniczne tabeli. W prawym g\u00f3rnym rogu znajduje si\u0119 przycisk \u201eOpen Data\u201d, kt\u00f3rego naci\u015bni\u0119cie otwiera bardzo intuicyjne narz\u0119dzie, w kt\u00f3rym mo\u017cemy manualnie doda\u0107 dane, do wybranej tabeli.<\/p>\n\n\n\n Gdy tabele wype\u0142nione s\u0105 danymi, mo\u017cemy si\u0119 skupi\u0107 na budowie serwisu, kt\u00f3ry b\u0119dzie propagowa\u0142 dane. W tym celu nale\u017cy zmieni\u0107 perspektyw\u0119 na \u201eDevelopment\u201d i z folderu \u201esrv\u201d nale\u017cy otworzy\u0107 plik cat-service.cds.<\/p>\n\n\n\n Serwis, kt\u00f3ry stworzy\u0142em jest bardzo prosty. W linii pierwszej podaj\u0119 namespace zasob\u00f3w, z kt\u00f3rych b\u0119d\u0119 korzysta\u0142. Nast\u0119pnie definiuje serwis, a w nim encj\u0119, kt\u00f3ra b\u0119dzie \u201ewystawiona na zewn\u0105trz\u201d. Dodatkowo nale\u017cy powiadomi\u0107 encj\u0119 z jakiego \u017ar\u00f3d\u0142a danych b\u0119dzie ona korzysta\u0107 (<namespace>.<nazwa_cds>). Kod w tym momencie jest gotowy, teraz pozostaje nam zbudowa\u0107 serwis i zweryfikowa\u0107 czy wszystko dzia\u0142a. Klikamy prawym przyciskiem myszy na katalog \u201esrv\u201d i ka\u017cemy go zbudowa\u0107. Gdy to jest gotowe, wtedy klikamy prawym przyciskiem na cat-service.cds i dajemy \u201eRun as -> Node.js Application\u201d.<\/p>\n\n\n\n System b\u0119dzie potrzebowa\u0142 chwili na zbudowanie ca\u0142ego mikroserwisu. Jednak w konsoli na bie\u017c\u0105co mo\u017cemy monitorowa\u0107 jaki jest progres budowania serwisu (Rysunek 10). Gdy zostanie on zbudowany, wy\u015bwietlony zostanie link. Wejd\u017amy w niego i zweryfikujmy, czy nasz serwis eksponuje dane.<\/p>\n\n\n\n Po otwarciu strony widzimy, \u017ce mamy mo\u017cliwo\u015b\u0107 podejrzenia metadanych oraz dost\u0119pnych encji naszego serwisu. U mnie s\u0105 to:<\/p>\n\n\n\n Po wej\u015bciu w jedn\u0105 z encji, powinny zosta\u0107 wy\u015bwietlone nam dane z bazy danych. Je\u015bli do tego momentu wszystko Ci dzia\u0142a to super, bo oznacza to, \u017ce zbudowa\u0142e\u015b mikroserwis ?. Teraz pozostaje jedynie zarejestrowa\u0107 go w API Management, aby m\u00f3g\u0142 by\u0107 konsumowany przez zewn\u0119trznych partner\u00f3w.<\/p>\n\n\n\n API Management to proces publikowania, promowania i nadzorowania interfejs\u00f3w API w bezpieczny i skalowalny spos\u00f3b. SAP API Management zapewnia bezpieczne zarz\u0105dzanie interfejsami API w oparciu o otwarte standardy, takie jak SOAP, REST czy te\u017c oData. Upraszcza to spos\u00f3b, w jaki programi\u015bci integruj\u0105 si\u0119 z aplikacjami SAP (i innymi ni\u017c SAP), obni\u017caj\u0105c koszty i wspieraj\u0105c innowacje.<\/p>\n\n\n\n Aby, uruchomi\u0107 API Management nale\u017cy cofn\u0105\u0107 si\u0119 do SAP Cloud Platform Cockpit (Neo). Tam z zak\u0142adki \u201eServices\u201d nale\u017cy wybra\u0107 odpowiedni\u0105 us\u0142ug\u0119. Nast\u0119pni klikamy \u201eAccess API Portal\u201d. Po chwili uruchomiona zostanie nowa aplikacja, w kt\u00f3rej mo\u017cemy budowa\u0107 i zarz\u0105dza\u0107 naszymi API.<\/p>\n\n\n\n Naszym pierwszym zadaniem b\u0119dzie stworzenie API. W menu z lewej strony nale\u017cy wybra\u0107 opcj\u0119 \u201eDevelop\u201d. W nowo otwartym oknie nale\u017cy wype\u0142ni\u0107 dane w spos\u00f3b zgodny z Rysunkiem 12.<\/p>\n\n\n\n Select<\/strong>: URL<\/p>\n\n\n\n URL<\/strong>: link naszego serwisu + \/catalog. Link mo\u017cna podejrze\u0107 w konsoli Web IDE po uruchomieniu serwisu<\/p>\n\n\n\n Name<\/strong>: dowolny<\/p>\n\n\n\n Title<\/strong>: dowolny<\/p>\n\n\n\n Host Alias<\/strong>: Podpowiada si\u0119 automatycznie, je\u015bli systemy zosta\u0142y skonfigurowane zgodnie z tutorialem.<\/p>\n\n\n\n API Base Path<\/strong>: \/<namespace_cds>\/<nazwa_aplikacji> W tym przypadku \/siiblog\/siitest<\/p>\n\n\n\n Gdy API zosta\u0142o stworzone, wtedy nale\u017cy zrobi\u0107 deployment. W tym celu nale\u017cy skorzysta\u0107 z opcji \u201eDeploy\u201d w prawym g\u00f3rnym rogu. Nast\u0119pnie nale\u017cy klikn\u0105\u0107 \u201eedit\u201d przej\u015b\u0107 do zak\u0142adki \u201eResources\u201d i doda\u0107 nawigacje do naszej encji (Patrz Rysunek 13). W moim przypadku dodaje \u201e\/Workers\u201d, gdy\u017c tak nazywa\u0142a si\u0119 moja encja. Je\u015bli zdecydowa\u0142e\u015b si\u0119 na inn\u0105 nazw\u0119, to nale\u017cy sprawdzi\u0107 jej nazw\u0119 najlepiej w modelowanym CDS.<\/p>\n\n\n\n Ostatnim etapem jest przetestowanie naszego API. Gdy ju\u017c dodali\u015bmy \u201eResource\u201d, mo\u017cemy skorzysta\u0107 z opcji \u201eTry out\u201d. Nasze API nie pobiera \u017cadnych parametr\u00f3w, wi\u0119c mo\u017cemy uruchomi\u0107 test naciskaj\u0105c przycisk \u201eExecute\u201d. Jako rezultat powinni\u015bmy otrzyma\u0107 kod 200 i dane pracownika, kt\u00f3re zapisane zosta\u0142y w bazie.<\/p>\n\n\n\n Gratulacje! Teraz ju\u017c wiesz w jaki spos\u00f3b mo\u017cna budowa\u0107 proste mikroserwisy oraz jak je zg\u0142asza\u0107 w API Management. Nale\u017cy pami\u0119ta\u0107, \u017ce to jest jedynie pocz\u0105tek drogi. Przyk\u0142ady produkcyjne z regu\u0142y maj\u0105 znacznie bardziej skomplikowany backend, natomiast API Management zawiera szereg dodatkowej konfiguracji, jak chocia\u017cby poziom autoryzacji, by dane mog\u0142y odczytywa\u0107 jedynie uprawnione osoby. Tutorial ten daje Ci jednak baz\u0119 do rozpocz\u0119cia przygody z Cloud Foundry jak i z mikroserwisami. Powodzenia!<\/p>\n\n\n\nKonfigurowanie \u015brodowiska<\/h3>\n\n\n\n
![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/2-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/3-1024x732-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/4-1024x549-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/5-1024x617-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/6-1024x543-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/7-1024x376-1.png\")
<\/a>Budowanie aplikacji<\/h3>\n\n\n\n
![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/8-1024x683-1.png\")
<\/a>![\"Listing](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/9-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/10-1.png\")
<\/a>![\"Listing](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/11-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/12-1024x195-1.png\")
<\/a>Rejestrowanie API<\/h3>\n\n\n\n
![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/13-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/14-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/15-1024x536-1.png\")
<\/a>![\"Rysunek](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2020\/05\/16-1024x821-1.png\")
<\/a>
\n\n\n\n\u0179r\u00f3d\u0142a<\/h3>\n\n\n\n