Instalacja i konfiguracja Comarch Data Editor Linux

W celu rozpoczęcia instalacji należy uruchomić skrypt instalacyjny w folderze z obrazem instalatora za pomocą komendy:

sudo ./run
Uwaga
Jeśli plik „run” nie posiada uprawnień do uruchamiania, należy je nadać, wykonując polecenie „chmod +x ./run” w terminalu.

W pierwszym kroku należy wybrać język instalacji. Następnie należy zaakceptować umowę licencyjną. Po zaakceptowaniu licencji, wyświetlą się informację odnośnie procesu instalacji. Aby rozpocząć, należy nacisnąć „Enter„. Aby przerwać instalację trzeba wcisnąć „Ctrl+C„.

Wskazówka
Instalację można przerwać na dowolnym etapie. W takim przypadku plik „compose.yaml” zostanie automatycznie usunięty.

W kolejnym kroku rozpocznie się instalacja wymaganych narzędzi. Aby kontynuować, należy potwierdzić działanie, naciskając klawisz „Enter„.

Jeśli któreś z narzędzi jest już zainstalowane w systemie, zostanie wyświetlona stosowna informacja i instalacja tego komponentu zostanie pominięta.

Następnym etapem instalacji jest konfiguracja portów.

  • Port hosta – port, na którym działa aplikacja w środku kontenera.
  • Port kontenera – port, przez który system łączy się z aplikacją z zewnątrz.

Kolejny krok to konfiguracja Keycloak. Należy skonfigurować połączenie aplikacji z usługą Keycloak, odpowiedzialną za uwierzytelnianie użytkowników.

Dane konfiguracyjne:

  • Adres instancji Keycloak – pełny adres URL serwera Keycloak (np. https://auth.twoja-domena.pl). To adres, z którym aplikacja będzie się łączyć, aby przekierować użytkownika do logowania.
  • Nazwa realm – identyfikator przestrzeni (realm), w której zarejestrowany jest klient aplikacji. Realm grupuje użytkowników, role i klientów. Przykład: DataEditorRealm.
  • Nazwa clienta – identyfikator klienta zdefiniowanego w Keycloak (musi dokładnie odpowiadać nazwie wpisanej w konfiguracji aplikacji). Przykład: DataEditor. Aplikacja łączy się z tym klientem, aby uzyskać tokeny logowania.
  • Signing Key – klucz publiczny używany do weryfikacji podpisów tokenów JWT generowanych przez Keycloak.
Wskazówka
Signing Key należy skopiować z zakładki Realm Settings → Keys w panelu Keycloak.

Następnie użytkownik proszony jest o skonfigurowanie licencji.

Wybór licencji, wciskając przypisany klawisz numeryczny.

Następnie należy uzupełnić poniższe dane:

  • Nazwa serwera – adres serwera na którym znajduje się menadżer kluczy,
  • Port menedżera kluczy – numer portu wykorzystywany do komunikacji z menadżerem kluczy,
  • Klucz licencyjny – numer klucza dla którego przypisana jest odpowiednia licencja.

Ostatnim etapem instalacji jest konfiguracja połączenia szyfrowanego (SSL):

Należy podać porty, na których aplikacja będzie dostępna:

  • dla protokołu HTTP (np. 80),
  • dla protokołu HTTPS (np. 443).

Proszę wskazać katalog, w którym znajduje się certyfikat SSL. W przypadku naciśnięcia klawisza „Enter„, zostaną użyte domyślne, wyświetlone wartości.

Następnie należy:

  • Podać nazwę pliku certyfikatu (np. cert.pem).
  • Wybrać jedną z dwóch metod dostarczenia klucza prywatnego:
    • Plik i klucz – należy podać osobno nazwę pliku z certyfikatem oraz nazwę pliku z kluczem prywatnym.

    • Plik z hasłem – należy wskazać jeden plik zawierający certyfikat i klucz oraz wprowadzić hasło.

Aby uruchomić kontenery aplikacji, należy wykonać poniższą komendę:

sudo docker compose up -d

Czy ten artykuł był pomocny?

Wyślij opnie