Przejdź do głównej zawartości

Instalacja

Postępuj zgodnie z poniższymi krokami, aby pomyślnie zainstalować i uruchomić projekt.

Wymagania:

  • Docker, Docker Compose
  • Zalecany system operacyjny: Ubuntu / dowolna dystrybucja Linuksa
  • Na Windowsie: uruchom skrypt za pomocą Git Bash

Pakiet instalacyjny​

.env​

Ten plik zawiera zmienne środowiskowe używane przez Dockera i aplikację. Przykładowa zawartość:

GRAFANA_PORT=3000
BACKEND_PORT=9983
FRONTEND_PORT=8080

docker-compose.yml​

Ten plik definiuje usługi Dockera, porty, wolumeny i zmienne środowiskowe. Wartości z pliku .env są używane w konfiguracji.

install.sh​

To skrypt bash, który automatyzuje proces instalacji i konfiguracji. Prosi o niezbędne dane i uruchamia kontenery Dockera.

Przewodnik instalacji​

1. Przyznaj uprawnienia do pliku skryptu​

Upewnij się, że plik skryptu ma uprawnienia do wykonania:

chmod +777 install.sh

2. Uruchom skrypt​

Po ustawieniu uprawnień uruchom skrypt:

./install.sh

Przegląd działania skryptu instalacyjnego​

1. Sprawdzenie połączenia z internetem​

Podczas instalacji skrypt zapyta, czy masz połączenie z internetem:

  • Jeśli tak:

    • Zostaniesz poproszony o logowanie do Azure Registry (wymagane do pobrania obrazów).
    • Skrypt użyje docker login, a następnie pobierze wymagane obrazy.

  • Jeśli nie:

    • Zostaniesz poproszony o podanie ścieżki do lokalnych plików obrazów Dockera .tar.
    • Skrypt użyje docker load -input, aby załadować obrazy z podanej ścieżki.

2. Podanie konfiguracji w terminalu​

Skrypt poprosi o wprowadzenie kluczowych wartości konfiguracyjnych. Jeśli pozostawisz któreś pole puste, zostanie użyta domyślna wartość.

  • Port frontend

    Enter frontend port [default: 8080]:

    Port wykorzystywany do dostępu do interfejsu aplikacji.

  • Port backend

 Enter backend port [default: 9983]:

Port, przez który frontend komunikuje się z usługami backend (API, przetwarzanie danych).

  • Port Grafana

    Enter Grafana port [default: 3000]:

    Port służący do dostępu do pulpitu Grafana (metryki i wizualizacja).

  • Adres hosta (nazwa hosta/IP)

    Enter hostname/IP [default: 10.100.22.27]

    IP lub nazwa hosta, pod którym aplikacja będzie dostępna. Istotne szczególnie przy dostępie zdalnym.

  • Ścieżka do katalogu konfiguracyjnego

    Install directory [default: current]:

    Katalog, w którym będą przechowywane pliki konfiguracyjne i wolumeny Dockera. Użyteczny, jeśli chcesz zachować dane lub uporządkować wdrożenie.

notatka

Jeśli pozostawisz któreś z pól puste, automatycznie zostanie użyta wartość domyślna podana w nawiasach.

Po wykonaniu powyższych kroków proces instalacji zostanie w pełni zautomatyzowany. System skonfiguruje wymagane kontenery, zastosuje ustawienia środowiska i uruchomi wszystkie usługi w tle.

Ręczne uruchomienie​

Jeśli wolisz nie używać skryptu:

  1. Skonfiguruj plik .env.
  2. Uruchom Docker Compose bezpośrednio:
docker-compose up -d

Twoja aplikacja powinna być teraz uruchomiona i dostępna pod zdefiniowanym hostem i portem.