Azure (Microsoft Azure) – jest to platforma chmurowa firmy Microsoft stworzona w modelu PaaS (Platform as a Service). Platforma ta umożliwia nam wygenerowanie strony, która łączy ze sobą repozytoria (kod źródłowy) Nightscout oraz naszą bazę danych utworzoną w mlab. Wyświetla dane w formie graficznej, a co najważniejsze – jest miejscem, z którego można te dane udostępnić na wszelkie peryferia takie jak przeglądarki internetowe, smartfony, smartwatche, tablety i inne urządzenia.
Mimo, iż instrukcja instalacji i konfiguracji jest napisana dość prosto – spotykamy się z wieloma pytaniami, które dotyczą problemów z uruchomieniem platformy. Zdarzają się błędy, które wynikają z mało dokładnego czytania opisu znajdującego się przy każdym zdjęciu. Wychodząc na przeciw oczekiwaniom, przygotowaliśmy instrukcję uruchomienia platformy NIGHTSCOUT w formie filmu. Mam nadzieję, że taka forma znacznie ułatwi Wam pierwsze kroki z systemem i unikniecie podstawowych błędów podczas instalacji, a przede wszystkim pokaże, że jest to dziecinnie proste 🙂 Oczywiście jeśli ktoś czegoś nie będzie wiedział z filmu, to zapraszamy do standardowej (opisanej poniżej) wersji opisującej sposób instalacji krok po kroku platformy NIGHTSCOUT. Zapewne mając zarówno film i standardowy opis, na pewno sobie już każdy bez problemu poradzi z instalacją.
Link do filmu z instrukcją znajduje się tutaj <<Link do Youtube>>
Instalacja krok po kroku, wersja pisana:
Postaram się w prosty sposób przekazać informację w jaki sposób uruchomić taką stronę
- Wchodzimy na stronę https://azure.microsoft.com/pl-pl/ i klikamy na „Bezpłatne konto”:
- Następnie klikamy w „Rozpocznij teraz”
- Wybieramy „Utwórz konto teraz”
4. Wypełniamy poniższe pola podając adres e-mail oraz hasło, i klikamy w przycisk „Dalej”:
5. Pojawi się poniższy komunikat:
6. Teraz sprawdzamy skrzynkę mailową. Otrzymaliśmy wiadomość z Microsoft, w którym jest link do aktywacji konta na Azure:
7. Po otworzeniu wiadomości klikamy w przycisk do weryfikacji:
8. Klikamy w OK:
9. Teraz chwilkę czekamy na utworzenie konta:
10. W celu uruchomienia wymaganych funkcjonalności, należy poprawnie wypełnić formularz. Z racji tego, że platforma jest PaaS (Platform as a Service), to musimy zrobić weryfikację za pomocą karty kredytowej. Ale spokojnie – skonfigurowane konta, będą korzystały z darmowego planu.
Należy poprawnie wypełnić wszystkie pola i przeprowadzić pełną autoryzację.
Punkt 1 – dane osobowe użytkownika konta.
Punkt 2 – weryfikacja przez telefon – podajemy np. nr komórki, otrzymujemy sms’em kod, który wpisujemy na stronie (krok niezbędny).
Punkt 3 – weryfikacja przy użyciu karty – niestety należy również autoryzować kartę. Konto, które będziemy zakładać jest darmowe jak zobaczycie, ale niezbędna jest autoryzacja w tym miejscu, by móc w ogóle korzystać z konta na Azure. Konto FREE jest chyba na 30 dni. Po tym czasie otrzymamy maila z przypomnieniem, że kończy się darmowa subskrypcja. Trzeba będzie się wtedy zalogować na Azure i wybrać „plan zgodny z użyciem” (pay-as-you-go). Bez względu na tą zmianę – plan usługi będzie w dalszym ciągu „free”, więc nie będziemy płacić za usługę.
Punkt 4 – to akceptacja warunków
Na koniec wciskamy Utwórz konto. To tyle 🙂 Przechodzimy do konfiguracji konta na Azure. (Niestety nie mogę przejść tego kroku dalej, bo mam tylko jedną kartę visa, na którą autoryzowałem konto, ale wierzę, że sobie spokojnie dacie radę z założeniem konta).
11. Przechodzimy do konfigurowania usługi na Azure. Wybieramy odpowiednio: Nowy -> Sieci Web i mobilność -> Aplikacja sieci Web:
12. Wypełniamy odpowiednio pola.
- Nazwa aplikacji – jest to nazwa strony w domenie „azurewebsites.net”, pod którą będzie można obserwować wykres. Należy wymyślić nazwę, która będzie unikalna i zarazem łatwa do zapamiętania przez Was. Dla potrzeb tego przewodnika wpisałem: unikalnanazwakonfiguracji.
- Subskrypcja – zostawiamy Bezpłatna wersja próbna. Później będzie zmieniona na Pay-As-You-Go, czyli zgodna z wykorzystaniem.
- Grupa zasobów – zostawiamy „+ Nowy”
- Nazwa nowej grupy zasobów: dla przykładu nazwałem ta grupę „ns_konf”
- Następnie musimy wybrać plan – klikamy na „Plan/Lokalizacja Usługi aplikacji”
13. Klikamy w Utwórz nowe:
14. Wpisujemy nazwę planu (wpisałem „planuslugi”), a następnie klikamy w plan „S1 Standard” by go zmienić:
15. W prawym, górnym rogu widać odnośnik o treści WYŚWIETL WSZYSTKO – klikamy:
16. Schodzimy suwakiem na sam dół strony, wybieramy plan „F1 FREE” i wciskamy „Wybierz”:
17. Ze względu na problemy z lokalizacją „South Central US” zalecam zmienić lokalizację na „North Central US”, a następnie klikamy w przycisk OK:
18. I na sam koniec zaznaczamy, by system przypiął tą usługę do pulpitu nawigacyjnego, a następnie wciskamy UTWÓRZ:
19. Pojawi się komunikat:
20. Na stronie głównej Azure pojawi się poniższy kwadracik. Jest to skrót do naszej usługi. Jak się skończy wdrażanie, to klikamy na nowo utworzony kwadrat.
21. A następnie całe okno działającej aplikacji 🙂 Gratuluję – połowa drogi za Tobą 🙂
22. Wybieramy Ustawienia aplikacji:
23. Pojawi się poniższe okno – zjeżdżamy suwakiem na dół do sekcji Ustawienia aplikacji:
24. Tak zaczyna się sekcja, która nas interesuje:
25. Przystępujemy do konfiguracji usługi. UWAGA – proszę dokładnie wprowadzać dane zgodnie ze wskazówkami!! Zagwarantuje to poprawne uruchomienie usługi.
UWAGA !!! Wersja WEBSITE_NODE_DEFAULT_VERSION jest uzależniona od aktualnej wersji pliku na Github. W celu sprawdzenia jak powinna być aktualnie wpisana zaloguj się na swoje konto github i przeczytaj w opisie sposobu instalacji. Na dzień 11.09.2018 wersją obowiązująca jest 8.11.1 (UWAGA – stosujemy KROPKI, nie przecinki!).
Przepisujemy dokładnie wszystkie wartości.
WEBSITE_NODE_DEFAULT_VERSION 8.11.1
ENABLE careportal cob cage sage basal pump iob bwp rawbg maker bridge iage pushover treatmentnotify
AUTH_DEFAULT_ROLES:readable devicestatus-upload
BASAL_RENDER default
DEVICESTATUS_ADVANCED true
PUMP_FIELDS clock reservoir battery status
SHOW_PLUGINS careportal cob cage sage basal pump iob bwp
SCM_COMMAND_IDLE_TIMEOUT 300
Kolejne linijki dopisujemy klikając „+ Dodaj nowe ustawienie „
Finalnie powinno wyglądać to tak:
27. Schodzimy odrobinkę niżej do sekcji „Parametry połączeń”:
28. Musimy teraz UWAŻNIE wprowadzić odpowiednie dane:
Linijka 1)
– komórka 1: „mongo„- komórka 2: „mongodb://testuser:testpassword@ds032319.mlab.com:32319/bazatestowa”
(jest to link, który powstał podczas konfiguracji konta na mlab – należy w tym miejscu wkleić swój indywidualny, wygenerowany link, który został zmodyfikowany o waszego użytkownika i hasło bazy danych)
– komórka 3: zmieniamy rozwijalną listę na „Custom„
Linijka 2)
– komórka 1: „mongo_collection„
– komórka 2: „CGM” (nawiązuje to do „Collection”, które stworzyliśmy podczas konfigurowania bazy danych na Mlab)
– komórka 3: zmieniamy rozwijalną listę na „Custom„
Linijka 3)
– komórka 1: „API_SECRET„
– komórka 2: w tym miejscu podajemy swoje hasło, które będziemy wykorzystywać później do podłączenia naszego urządzenia z Azure. Hasło musi mieć minimum 12 znaków, bez Polskich liter. Dla przykładu wpisałem „hasloktorepamietam”
– komórka 3: zmieniamy rozwijalną listę na „Custom„
29. Finalnie treść ustawień ma wyglądać tak jak na poniższym zdjęciu (kolejność nie ma znaczenia). Jeśli już wprowadziliście odpowiednio dane (Waszą bazę danych, Waszą kolekcję danych, Wasze hasło do usługi) to klikamy w przycisk „Zapisz”.
30. Kolejnym krokiem jest ustawienie wdrożenia usługi. Wybieramy „Opcje wdrożenia”:
31. Przed tym krokiem trzeba być zalogowanym na serwisie Github w drugim oknie przeglądarki. Utrzymanie zalogowanej sesji jest wymagane do autoryzacji. Następnie wracamy do okna konfiguracji azure i klikamy w „Skonfiguruj wymagane ustawienia”:
32. Następnie wybieramy GitHub:
33. Następnie klikamy w „Autoryzacja”, a później w „Zmień konto”:
34. Przed chwilą zakładałem konto na Github, więc widać na obrazku, że jestem zalogowany. Klikam na „Authorize application”:
35. Teraz zapisujemy ustawienia, klikając OK:
36. Kolejny krok, to wybranie „Skonfiguruj wymagane ustawienia”, a następnie wybieramy „cgm-remote-monitor”:
37. Resztę zostawiamy bez zmian i klikamy „OK”:
38. Pojawiła się po chwili informacja:
39. Ten proces chwilę zajmuje, więc cierpliwości 🙂
40. Po skończonym procesie tworzenia zdarzenia pojawi się taki oto monit:
41. Klikając w przycisk „Przeglądaj”, powinna się już uruchomić przeglądarka internetowa z naszą stroną:
42. Jeśli poprawnie przejdziemy przez wszystkie, wyżej wymienione kroki, powinna pojawić się nam w oknie przeglądarki taka oto strona:
Pojawi się też informacja o nie ustawionym profilu. Należy zatwierdzić komunikat, przejść do edytora profilu , wykonać autoryzację za pomocą swojego API_SECRET i zatwierdzić domyślny profil.
43. GRATULACJE!! Konto zostało założone, a strona poprawnie działa 🙂
WAŻNE!! Z powyższej instrukcji musimy zapamiętać przede wszystkim dwie wartości:
- adres strony – w tym przypadku https://unikalnanazwakonfiguracji.azurewebsites.net
- hasło (API_SECRET) – w tym przypadku „hasloktorepamietam”.
Te dane będą nam potrzebne do skonfigurowania urządzenia, które będzie korzystało z zasobów Nightscout.
autor: Paweł Babańczyk
FB: #Pablo Ńczyk