Stawianie środowiska lokalnego

1. Pobrać repozytorium backendowe do folderu C:\UniQuanda
2. Dodać plik .env na podstawie wzoru .env.sample
3. Do głównego folderu dodać plik certificate.pem oraz private.pem.
4. Wybrać środowisko (local lub developmentserver) w pliku .env oraz ustawić wartości zmiennych BACKEND_HTTP_PORT na 80 i BACKEND_HTTPS_PORT na 443 w przypadku środowiska local lub BACKEND_HTTP_PORT na 2001 i BACKEND_HTTPS_PORT na 2002 w przypadku środowiska developmentserver.
5. W przypadku środowiska developerskiego - stworzyć plik developmentserver.sh w folderze backend na podstawie \backend\developmentserver.sample.sh i wypełnić hasła, secretsy oraz connection string
6. Za 1 razem wykonać docker compose up --build, za każdym kolejnym docker compose up
7. Wejść na localhost:12001 i zalogować się za pomocą loginu admin@uniquanda.pl i hasła uniquanda.
8. W rozwijanej liście serwerów wybrać serwer > PPM > Connect. Hasło to uniquanda (Można sobie zapamiętać)

Należy zwrócić uwagę, czy źródła pakietów NuGet w Visual Studio są ustawione na https://api.nuget.org/v3/index.json

Porty usług

Backend 1

• http: 3001
• https: 3002

Backend 2

• http: 3011
• https: 3012

Load balancer:

• http: 80 (local) 2001 (dev+)
• https: 443 (local) 2002 (dev+)

Frontend

• http: 4200 (local) 80 (dev+)
• https: 443 (dev+)

Baza danych dla aplikacji

• Postgres 9001

Redis (Do przetestowania)

• Redis: 6001

Baza danych dla autoryzacji

• Postgres: 10001

PGAdmin4

• http: 12001

Stawianie poczty

Wymagania wstępne

• plik certyfikatu key.pem (prywatny klucz)
• plik certyfikatu cert.pem (certyfikat wraz z ścieżką certyfikacji)
• serwer z publicznym adresem IP
• domena

Instalacja Dockera

Więcej informacji

• apt-get update
• curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
• echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
• apt-get update
• apt-get install docker-ce docker-ce-cli containerd.io

Instalacja Docker-Compose

Więcej informacji

• curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
• chmod +x /usr/local/bin/docker-compose

Instalacja Poczty

Więcej informacji

1. Wejść do folderu docker-compose.yml i ustawić adres IP zgodny z adresem IP serwera na którym ma stać poczta dla kontenera front w sekcji ports.
2. Stworzyć folder /home/mailing na serwerze do którego wrzucić zawartość folderu mailing.
3. Za pomocą SSH wykonać docker-compose build po czym docker-compose up

Instalacja Certyfikatu SSL

Więcej informacji

1. Do folderu mailing przesłać plik key.pem i cert.pem
2. W SSH wykonać docker ps by wyświetlić listę kontenerów
3. W SSH będąc w folderze home/mailing/ wykonać docker cp key.pem <Hash kontenera którego nazwa to front>:/
4. W SSH będąc w folderze home/mailing/ wykonać docker cp cert.pem <Hash kontenera którego nazwa to front>:/
5. W SSH będąc w folderze home/mailing/ wykonać docker exec -it <Hash kontenera którego nazwa to front> /bin/bash
6. W SSH wykonać cp key.pem /certs/key.pem
7. W SSH wykonać cp cert.pem /certs/cert.pem
8. W SSH wykonać nginx -s reload

Logowanie się na konto administratora

Dane logowania na konto administratora znajdują się w pliku mailu.env w zmiennych

• INITIAL_ADMIN_ACCOUNT=my_username
• INITIAL_ADMIN_PW=my_password
• INITIAL_ADMIN_DOMAIN=abc.def.pl

Debugowanie w Visual Studio backendu (kontenerów)

1. W Visual Studio kliknij (Ctrl+Alt+P) lub Debug -> Attach to process
2. W Connection Type wybierz Docker (Linux Conteiner)
3. W Connection Target wybierz proces o nazwie UniQuanda.Presentation.API i kliknij Dołącz
4. Wybierz tryb Managed
5. By debugować backend wejdź na link http://localhost:3001/swagger/index.html