Apollo Docker¶
Przewodnik po tym projekcie: https://youtrack.logintegra.com/articles/A-A-26/Przewodnik-po-projekcie-apollo-docker
Instalacja¶
-
Zainstaluj Docker'a
-
Sklonuje te repo:
git clone [email protected]:logintegraspzoo/apollo-docker.git -
Opcjonalnie stwórz i uzupełnij plik
.env.localw katalogu głównym
Uwaga: Do lokalnego uruchomienia Apollo, .env.local nie powinien być potrzebny.
-
Opcjonalnie dodaj pliki konfiguracyjne do aplikacji w folderze
/config/app/** -
Opcjonalnie zapisz zanonimizowaną kopię bazy w folderze
/config/dump -
Uruchom serwisy
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 |
Google Storage¶
Konfiguracja w pliku .env¶
GOOGLE_STORAGE_KEY_LOCAL_PATH: lokalizacja kluczaGoogle Storagena serwerze; domyślnie przechowujemy je w tym repozytorium jakoconfig/files/google-storage-test-key.p12,
Klucz¶
Klucz możemy pobrać z Vault: [email protected] :: 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 (`[email protected] :: 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:
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 |
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:
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 onwłącza automatyczne generowanie listy plików, jeśli nie ma pliku indeksowego - Cache: Pliki są cache'owane na 1 godzinę (
expires 1h) z nagłówkiemCache-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:
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/-/Javaapplication.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.
Ostatnia zmiana: 2026-11-13 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e