Przejdź do treści

Apollo Docker

Przewodnik po tym projekcie: https://youtrack.logintegra.com/articles/A-A-26/Przewodnik-po-projekcie-apollo-docker

Instalacja

  1. Zainstaluj Docker'a

  2. Sklonuje te repo:

    git clone [email protected]: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.

  1. Opcjonalnie dodaj pliki konfiguracyjne do aplikacji w folderze /config/app/**

  2. Opcjonalnie zapisz zanonimizowaną kopię bazy w folderze /config/dump

  3. 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

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: [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:

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
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

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:

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