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ę
  1. Wchodzimy na stronę https://azure.microsoft.com/pl-pl/ i klikamy na "Bezpłatne konto": 01
  2. Następnie klikamy w "Rozpocznij teraz" 02
  3. Wybieramy „Utwórz konto teraz” 03

4. Wypełniamy poniższe pola podając adres e-mail oraz hasło, i klikamy w przycisk "Dalej": 04  
5. Pojawi się poniższy komunikat: 05  
6. Teraz sprawdzamy skrzynkę mailową. Otrzymaliśmy wiadomość z Microsoft, w którym jest link do aktywacji konta na Azure: 06  
7. Po otworzeniu wiadomości klikamy w przycisk do weryfikacji: 07  
8. Klikamy w OK: 08  
9. Teraz chwilkę czekamy na utworzenie konta: 09  
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). 10  
11. Przechodzimy do konfigurowania usługi na Azure. Wybieramy odpowiednio: Nowy -> Sieci Web i mobilność -> Aplikacja sieci Web: 11  
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"
12  
13. Klikamy w Utwórz nowe: 13  
14. Wpisujemy nazwę planu (wpisałem "planuslugi"), a następnie klikamy w plan "S1 Standard" by go zmienić: 14  
15. W prawym, górnym rogu widać odnośnik o treści WYŚWIETL WSZYSTKO – klikamy: 15  
16. Schodzimy suwakiem na sam dół strony, wybieramy plan "F1 FREE" i wciskamy "Wybierz": 16  
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: 17_a  
18. I na sam koniec zaznaczamy, by system przypiął tą usługę do pulpitu nawigacyjnego, a następnie wciskamy UTWÓRZ: 18  
19. Pojawi się komunikat: 19  
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. 20  
21. A następnie całe okno działającej aplikacji  🙂 Gratuluję – połowa drogi za Tobą 🙂 21  
22. Wybieramy Ustawienia aplikacji: 21_a  
23. Pojawi się poniższe okno – zjeżdżamy suwakiem na dół do sekcji Ustawienia aplikacji: 22  
24. Tak zaczyna się sekcja, która nas interesuje: 22_a  
25. Przystępujemy do konfiguracji usługi. UWAGA - proszę dokładnie wprowadzać dane zgodnie ze wskazówkami!! Zagwarantuje to poprawne uruchomienie usługi. AKTUALIZACJA 17.10.2017  Od jakiegoś czasu dostępna jest nowa wersja strony. Dla poprawnej instalacji wymagana jest zmiana WEBSITE_NODE_DEFAULT_VERSION na 8.5.0   (UWAGA - stosujemy KROPKI, nie przecinki!). 2  
26a. W linijce PONIŻEJ wartości "WEBSITE_NODE_DEFAULT_VERSION" wprowadzamy dane (BEZ CUDZYSŁOWÓW):
  • lewa komórka - "ENABLE"
  • prawa komórka - "careportal rawbg iob maker bridge cob bwp cage sage iage basal pushover treatmentnotify pump"
Finalnie powinno wyglądać to tak: 3
26b. W linijce PONIŻEJ wartości "ENABLE" wprowadzamy dane (BEZ CUDZYSŁOWÓW):
  • lewa komórka - "AUTH_DEFAULT_ROLES"
  • prawa komórka - "readable devicestatus-upload"

26c W linijce PONIŻEJ wartości "AUTH_DEFAULT_ROLES" wprowadzamy dane (BEZ CUDZYSŁOWÓW):
  • lewa komórka: "BASAL_RENDER"
  • prawa komórka: "default"
Finalnie powinno wyglądać to tak: 5
27.  Schodzimy odrobinkę niżej do sekcji "Parametry połączeń": 25  
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 "Niestandardowe" 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 "Niestandardowe" 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 "Niestandardowe" 26  
29. Finalnie treść ustawień ma wyglądać tak jak na poniższym zdjęciu (pomijając kolory, bo to tylko informacja, że edytowałem wpisy i jeszcze nie są zapisane). Jeśli już wprowadziliście odpowiednio dane (Waszą bazę danych, Waszą kolekcję danych, Wasze hasło do usługi) to klikamy w przycisk "Zapisz".   6
30. Kolejnym krokiem jest ustawienie wdrożenia usługi. Wybieramy "Opcje wdrożenia": 28  
31. Klikamy w "Skonfiguruj wymagane ustawienia": 29  
32. Następnie wybieramy GitHub: 30  
33. Następnie klikamy w "Autoryzacja", a później w "Zmień konto": 31  
34. Przed chwilą zakładałem konto na Github, więc widać na obrazku, że jestem zalogowany. Klikam na "Authorize application": 32  
35. Teraz zapisujemy ustawienia, klikając OK: 33  
36. Kolejny krok, to wybranie "Skonfiguruj wymagane ustawienia", a następnie wybieramy "cgm-remote-monitor": 34  
37. Resztę zostawiamy bez zmian i klikamy "OK": 35  
38. Pojawiła się po chwili informacja: 36  
39. Ten proces chwilę zajmuje, więc cierpliwości 🙂 37  
40. Po skończonym procesie tworzenia zdarzenia pojawi się taki oto monit: 38  
41. Klikając w przycisk "Przeglądaj", powinna się już uruchomić przeglądarka internetowa z naszą stroną: 39  
42. Jeśli poprawnie przejdziemy przez wszystkie, wyżej wymienione kroki, powinna pojawić się nam w oknie przeglądarki taka oto strona: 40  
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