# Apollo Docker

Przewodnik po tym projekcie: [https://youtrack.logintegra.com/articles/A-A-26/Przewodnik-po-projekcie-apollo-docker](<https://youtrack.logintegra.com/articles/A-A-26/Przewodnik-po-projekcie-apollo-docker>)

# Instalacja

1. Zainstaluj Docker'a
2. Sklonuje te repo:

   ```
   git clone git@bitbucket.org:logintegraspzoo/apollo-docker.git
   ```
3. Opcjonalnie stwórz i uzupełnij plik `.env.local` w katalogu głównym

Uwaga: Do lokalnego uruchomienia Apollo, `.env.local` nie powinien być potrzebny.

4. Opcjonalnie dodaj pliki konfiguracyjne do aplikacji w folderze `/config/app/**`
5. Opcjonalnie zapisz zanonimizowaną kopię bazy w folderze `/config/dump`
6. Uruchom serwisy

   ```
   cd apollo-docker
   ./apollo-docker start
   ```

# Porty

| Nazwa aplikacji | Port |
| --- | --- |
| apollo-backend | 8080 |
| microservice-courier | 8081 |
| microservice-sms | 8082 |
| microservice-parser | 8083 |
| apollo-admin | 8084 |
| infokiosk | 8086 |
| dashboard | 8087 |
| weight-gateway (TCP, MOXA) | 14002 |
| weight-gateway-admin | 8089 |
| rabbitmq-admin-panel | 15672 |
| rabbitmq-amqp | 5672 |
| euroglas-ftp (msp) | 6565 |
| semmelrock-ftp (msp) | 6667 |
| portainer | 9000 |

[https://youtrack.logintegra.com/articles/A-A-28/Dokumentacja-port%C3%B3w-wystawionych-na-zewn%C4%85trz](<https://youtrack.logintegra.com/articles/A-A-28/Dokumentacja-portów-wystawionych-na-zewnątrz>)

## Google Storage

### Konfiguracja w pliku .env

- `GOOGLE_STORAGE_KEY_LOCAL_PATH`: lokalizacja klucza `Google Storage` na serwerze; domyślnie przechowujemy je w tym repozytorium jako `config/files/google-storage-test-key.p12`,

### Klucz

Klucz możemy pobrać z Vault: `dev.logintegra@gmail.com :: klucz google storage` i zapisać w dowolnym miejscu na dysku. Musimy tylko tę ścieżkę podać w `GOOGLE_STORAGE_KEY_LOCAL_PATH`.

Nazwa klucza dla `Google Storage` ma chyba znaczenie, więc proponuję ustawienie takich danych w pliku `application.external.yml`:

```
google:
  storage:
    projectName: "apollo-storage"
    bucketName: "atlas-automaty-oposy-docs" # Tu ustaw odpowiednią nazwę
    p12KeyPath: "/global-standard-431909-a4-02be14da03ea.p12"
    serviceAccountEmail: "secret" # `serviceAccountEmail` z Vault (`dev.logintegra@gmail.com :: klucz google storage`)
```

## Portainer

W pliku `.env` przechowujemy hash hasła administratora. Nowy hash możemy wygenerować w taki sposób:

Używając Docker:

```
docker run --rm httpd:2.4-alpine htpasswd -nbB admin "your_password" | cut -d ":" -f 2
```

Używając Python:

```
python3 -c 'import bcrypt; print(bcrypt.hashpw("your_password".encode("utf-8"), bcrypt.gensalt()).decode("utf-8"))'
```

Uwaga: Mamy zainstalowany Python na serwerze `build-server-dev`.

## Zmienne

(Pracujemy nad tym)

| Zmienna | Dotyczy projektu | Opis |
| --- | --- | --- |
| `GUS_KEY` | apollo-backend | Klucz do serwisu GUS (Vault: `GUS - Test / GUS - Prod`) |
| `DASHBOARD_URL` | apollo-backend | Adres dashboardu, PROD: [https://dashboard.logintegra.com](<https://dashboard.logintegra.com>) |
| `DASHBOARD_SECRET` | apollo-backend | Klucz dostępu do dashboardu, PROD: `Dashboard JWT Secret PROD` |
| `TRANSLATIONS` | apollo-frontend | Wartość `remote` (domyślna) włącza zewnętrzne tłumaczenia |
| `TRANSLATIONS_URL` | apollo-frontend | Link do tłumaczeń; pusty spowoduje użycie kontenera Nginx |
| `PORTAINER_ADMIN_PASSWORD` | portainer | Hasło (hash bcrypt) do Portainer |
| `SEMMELROCK_ENABLED` | microservice-parser | Włącza obsługę Semmelrock w MSP |
| `SEMMELROCK_HOST` | microservice-parser | Serwer FTP Semmelrock dla MSC (domyślnie `semmelrock-sftp`) |
| `SEMMELROCK_USERNAME` | microservice-parser | Użytkownik FTP Semmelrock |
| `SEMMELROCK_PASSWORD` | microservice-parser | Hasło FTP Semmelrock |
| `SEMMELROCK_PORT` | microservice-parser | Port FTP Semmelrock |
| `SEMMELROCK_REMOTE_BASE_DIR` | microservice-parser | Ścieżka do plików FTP dla Semmelrock |
| `SEMMELROCK_PICKUP_DIR` | microservice-parser | Ścieżka do odbioru plików (Semmelrock -\> Logintegra) |
| `SEMMELROCK_DELIVERY_DIR` | microservice-parser | Ścieżka do wysyłki plików (Logintegra -\> Semmelrock) |
| `INFOKIOSK_LOGO_HOST_PATH` | infokiosk | Ścieżka do katalogu z logo na hoście |
| `INFOKIOSK_LOGO_CONTAINER_PATH` | infokiosk | Ścieżka do katalogu z logo w kontenerze (mount) |
| `INFOKIOSK_LOGO_URL` | infokiosk | Publiczny URL logo używany w aplikacji |
| `APOLLO_WEIGHT_URL` | weight-gateway | Adres odczytu wagi wpisywany do ustawienia `WEIGHT_URL`; pusty zostawia atrapę z backendu |

### Semmelrock i konfiguracja SFTP

Domyślnie używamy FTP w Dockerze (`semmelrock-sftp`), więc nie musimy konfigurować połączenia.

Jeśli jednak chcemy skorzystać, np. z produkcyjnego FTP (służy także do testów), możemy podać odpowiednie dane dostępowe w pliku `.env.local`:

```
## MS-PARSER -> SEMMELROCK
SEMMELROCK_ENABLED=true
SEMMELROCK_HOST=94.23.218.126
SEMMELROCK_USERNAME=sap
SEMMELROCK_PASSWORD="<Vault: FTP Semmelrock>"
SEMMELROCK_REMOTE_BASE_DIR=/sap/test
SEMMELROCK_PORT=22
SEMMELROCK_PICKUP_DIR=test/sap_to_lp
SEMMELROCK_DELIVERY_DIR=test/lp_to_sap
```

## Tłumaczenia

### Mechanizm serwowania plików translations

#### 1\. Montowanie woluminu w kontenerze Nginx

W pliku `docker-compose.yml` kontener `nginx` ma skonfigurowany wolumen:

```
volumes
  - ./repos/translations:/usr/share/nginx/html/translations:ro
```

Ten wpis montuje lokalny katalog `repos/translations` do kontenera pod ścieżką `/usr/share/nginx/html/translations` w trybie tylko do odczytu (`ro`).

#### 2\. Konfiguracja lokalizacji w Nginx

W pliku `nginx.conf` znajduje się blok lokalizacji:

`nginx configuration location /remote-translations/ {     alias /usr/share/nginx/html/translations/;     autoindex on;     expires 1h;     add_header Cache-Control "public, immutable"; }`

#### Jak to działa:

- **Mapowanie ścieżek**: Gdy klient wykonuje żądanie do URL-a zawierającego `/remote-translations/`, Nginx mapuje tę ścieżkę na katalog `/usr/share/nginx/html/translations/` wewnątrz kontenera
- **Autoindeks**: `autoindex on` włącza automatyczne generowanie listy plików, jeśli nie ma pliku indeksowego
- **Cache**: Pliki są cache'owane na 1 godzinę (`expires 1h`) z nagłówkiem `Cache-Control "public, immutable"`
- **Statyczne pliki**: Nginx serwuje pliki bezpośrednio z systemu plików, bez przekazywania żądań do innych usług

#### Przykład użycia:

Jeśli w katalogu `repos/translations` znajduje się plik `en.json`, będzie on dostępny pod adresem:

> [http://your-domain/remote-translations/en.json](<http://your-domain/remote-translations/en.json>)

Ten mechanizm pozwala na efektywne serwowanie statycznych plików tłumaczeń bezpośrednio przez Nginx, co jest znacznie szybsze niż proxy do aplikacji backendowej.

## Site24x7

Aktualnie konfiguracja monitora APM Site24x7 odbywa się pół-ręcznie, czyli część prac musimy wykonać na serwerze.

### Konfiguracja agenta Site24x7 na serwerze

Skrypt `prepare-apm-agent.sh` wystarczy wykonać (z `sudo`!) na serwerze, żeby przygotować odpowiednie pliki.

Dodatkowo musimy tylko ustawić dwie wartości w pliku `/opt/apm/apminsight.conf`:

- `license.key` -- najważniejsze, klucz Site24x7, który możemy znaleźć na naszym koncie -\> [https://www.site24x7.eu/app/client\#/admin/inventory/monitors-configure/APM-Insight-Application/-/Java](<https://www.site24x7.eu/app/client#/admin/inventory/monitors-configure/APM-Insight-Application/-/Java>)
- `application.name` -- nazwa własna, żeby ułatwić nam rozpoznanie aplikacji w Site24x7

### Konfiguracja w `.env.local`

Żeby `apollo-backend` uruchomiło się w trybie z monitorem Site24x7, musimy ustawić zmienną środowiskową `APM_ENABLED=true` w pliku `.env.local`.

UWAGA: Żeby wyłączyć monitor, musimy usunąć zmienną `APM_ENABLED`, ustawienie jej na `false` nie jest wystarczające.
