Struktura oraz podział używanych serwisów

Minimalne wymagania systemowe oraz przygotowanie środowisk

Aby system działał poprawnie należy przygotować środowiska wg poniższych informacji.

1. Stworzyć serwery wg powyższych tabeli.

2. Na obu serwerach stworzyć użytkownika z uprawnieniami root, lub posiadać dostęp do użytkownika systemowego root.

3. Udrożnić połączenie między serwerami tak aby można było swobodnie przesyłać dane między serwerami.

4. Utworzyć rekord DNS (lokalny np. pask.domena.local lub globalny np. pask.domena.pl) i skierować go na adres ip serwera “main”.

5. Upewnić się że serwery mogą pobrać dane z sieci WAN.

6. Stworzyć certyfikat SSL (w postaci certificate.crt oraz privkey.key) tożsame z nadaną nazwą domenową.

7. Jeśli istnieje potrzeba integracji z AD stworzyć użytkownika w domenie z uprawnieniami read-only.

8. Zainstalować wymagane zależności na obu serwerach (kod poniżej) oraz utworzyć wymagane foldery:

   1. Wymagane zależności,

      • docker engine,

      • docker compose,

      • apt-transport-https,

      • ca-certificates,

      • curl,

      • software-properties-common,

      • python3-pip,

      • virtualenv,

      • python3-setuptools,

      • cloud-guest-utils,

      • jq,
        Kod do instalujący wymagane zależności i tworzący foldery z odpowiednimi uprawnieniami (zalecane uruchomienie z uprawnieniami root):

        apt-get update && apt-get upgrade -y
        apt-get install -y docker.io apt-transport-https ca-certificates curl software-properties-common python3-pip virtualenv python3-setuptools cloud-guest-utils jq
        systemctl start docker
        systemctl enable docker
        docker --version
        curl -L "https://github.com/docker/compose/releases/download/1.29.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
        chmod +x /usr/local/bin/docker-compose
        docker-compose -version
        cd /opt
        mkdir pask pask/data
        chmod 777 pask/data
        mkdir composer
        cd composer
        

   2. Układ folderów:

      /opt/
      ├── composer
      ├── lost+found
      └── pask
          └── data
      

9. Pozostając w folderze /opt/composer na obu serwerach pobieramy kod aplikacji z repozytorium (dostęp do repozytorium lub jego zawartość przesłane zostaną inną formą komunikacji):

• W przypadku gdy chcemy pobrać najnowszą wersję wpisujemy:
  git clone git@bitbucket.org:uniteampl/iamu-composer.git

• W przypadku potrzeby pobrania specyficznej wersji wpisujemy:
  git clone -b <nazwa_brancha> git@bitbucket.org:uniteampl/iamu-composer.git
  np. git clone -b release/1.4.0 git@bitbucket.org:uniteampl/iamu-composer.git

Po sklonowaniu gdy wejdziemy w pobrany folder iamu-composer zobaczymy zawartość  w postaci : 

Konfiguracja

Konfiguracja polega na edycji dwóch plików, jeden ze zmiennymi systemowymi drugi z konfiguracją serwera proxy.

UWAGA! Poniższe kroki należy wykonać na obu serwerach w dokładnym odwzorowaniu, tak aby po skończonej konfiguracji na obu serwerach znajdowały się dokładnie takie same konfiguracje .env oraz nginx.conf.

1. Edycja pliku ze zmiennymi systemowymi “.env”

Plik “.env” znajdziemy w głównym folderze repozytorium. Zawiera on wiele istotnych zmiennych potrzebnych do poprawnego skonfigurowania i uruchomienia systemu. Z racji na ilość danych zmienne zostały zawarte w tabeli poniżej wraz z opisami i danymi. Plik należy dopasować do swoich potrzeb i środowiska.

Plik zawiera konfigurowalne elementy zawarte poniżej, pozostałe elementy należy zostawić niezmienione:

2. Edycja pliku z konfiguracją serwera proxy

W folderze /opt/composer/iamu-composer/proxy w pliku nginix.conf zawarta jest konfiguracja proxy.

Należy podmienić na adres IP serwera “utils” wszystkie adresy odwołujące się do utils w definicji proxy_pass w poniższych klamrach location:

• location /graylog,

• location /db,

• location /kafka,

• location /ldap/,

• location /ssp/.

Uruchomienie

Aby uruchomić PASK potrzebujemy najpierw wejść na maszynę z “utils”, wchodzimy do folderu gdzie umieściliśmy folder z sklonowanym systemem PASK i wykonujemy komendę:

docker-compose -f utils-compose.yml -f prod-utils.yml --env-file .env  up -d

by zweryfikować poprawność działania serwisów możemy wykonać komendę:

docker-compose -f utils-compose.yml -f prod-utils.yml ps

UWAGA! Poprawne działanie oznacza że kontenery posiadają status healthy a nie starting.

Następnie wchodzimy na maszynę “main”, wchodzimy do folderu gdzie umieściliśmy folder z sklonowanym systemem PASK i wykonujemy komendę :

docker-compose -f main-compose.yml -f prod-main.yml --env-file .env  up -d

by zweryfikować poprawność działania serwisów możemy wykonać komendę:

docker-compose -f main-compose.yml -f prod-main.yml ps

UWAGA! Poprawne działanie oznacza że kontenery posiadają status healthy a nie starting.

Ostatnim krokiem jest wykonanie dwóch metod z ciałem:

1. Należy podmienić pask.domena.pl na nazwę domenową z przygotowania środowiska.
   Metodę skierować na adres poniżej.

   1. adres:

      http://pask.domena.pl:8301/init-auth-server

       

   2. metoda:

      {
      
      "redirectUrl" : "https://pask.domena.pl/login"
      
      }
      

   3. Następnie należy poczekać na poprawną odpowiedź zwrotną

2. Należy podmienić pask.domena.pl na nazwę domenową z przygotowania środowiska, wartości email oraz login pozostawić bez zmian natomiast password zastąpić silnym hasłem.
   Metodę skierować na adres poniżej.

   1. adres:

      http://pask.domena.pl:8301/init-on-premise

   2. metoda:

      {
      
      "email": "admin@uniteam.pl",
      
      "login": "Admin",
      
      "password": "hasło",
      
      }
      

   3. Następnie należy poczekać na poprawną odpowiedź zwrotną.

Logowanie

Po poprawnej instalacji wchodzimy na wybrany przez nas przy konfiguracji adres dla PASK i zostajemy przekierowani automatycznie do panelu logowania. 
Gratulacje instalacja została zakończona sukcesem.

Porady:

Sugerujemy aby katalog który podpinamy do bazy danych był osobna macierzą albo by posiadał wysoka dostępność.