Przejdź do treści

Serwer reverse proxy

Podręcznik Mint Service Desk 3.4.2: instalacja, administracja oraz praca agentów i klientów.

Konfiguracja przekierowań

Konfiguracja przekierowań znajduje się w bloku server pliku nginx.conf. Wbudowany serwer reverse proxy zawiera cztery bloki location:

location /api/ {
  proxy_pass http://gateway/api/;
  include common_location.conf;
}

location /livereloadHub {
  proxy_pass http://gateway/livereloadHub;
  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "Upgrade";
}

location ~* ^/(idp|connect|\.well-known|Account|external) {
  proxy_pass http://auth;
  include common_location.conf;
}

location / {
  proxy_pass http://frontend;
  include common_location.conf;
}

Pierwszy blok kieruje wszystkie żądania o adresach w postaci https://domain.name/api/ do usługi Gateway.

Drugi blok kieruje ruch z https://domain.name/livereloadHub do usługi Gateway i dodatkowo umożliwia komunikację za pomocą protokołu WebSocket.

Trzeci blok określa przekierowania do usługi Auth, obejmujące m.in. stronę logowania, OpenID Connect i zasoby statyczne używane na stronie logowania.

Ostatni blok kieruje wszystkie pozostałe żądania do usługi Frontend.

Plik common_location.conf definiuje nagłówki niezbędne do prawidłowego działania proxy, takie jak X-Forwarded-For, X-Forwarded-Proto, X-Forwarded-Host i X-Forwarded-Port.

Konfiguracja SSL

W pliku ssl.conf ustaw obsługiwane protokoły, opcje szyfrowania i ścieżki certyfikatów. Domyślny katalog certyfikatów to /etc/ssl/private/:

ssl_certificate             /etc/ssl/private/fullchain.pem;
ssl_certificate_key         /etc/ssl/private/privkey.key;

Zmiany w pliku services.yml

Aby prawidłowo uruchomić usługi, wprowadź poniższe zmiany w ich definicjach w pliku services.yml.

  1. Udostępnij bezpośrednio porty usług Frontend, Gateway i Auth. Przykład dla jednej z usług:
gateway:
   image: mint/gateway:latest
   ...
   ports:
     - port_on_which_we_want_to_start_service:80
  1. Usuń definicję usługi Reverse Proxy z pliku services.yml.

Uwaga: Porty zdefiniowane w tym pliku będą potrzebne podczas konfiguracji odwrotnego serwera proxy. Po uruchomieniu stosu usługi będą dostępne bezpośrednio na hoście.

Definicja odwrotnego serwera proxy

Serwer reverse proxy HTTP można skonfigurować przy użyciu różnych serwerów HTTP. W tym przykładzie użyto nginx. Początkowa konfiguracja odpowiada konfiguracji domyślnej usługi Reverse Proxy.

W Docker Swarm używany jest sterownik sieci typu overlay. Oznacza to, że usługi NIE będą dostępne pod adresem localhost. Adres dostępu do stosu można sprawdzić poleceniem ip addr.

Wynik powinien wyglądać następująco:

...
5: docker_gwbridge: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc noqueue state UP group default
    link/ether 02:42:98:4e:fe:bc brd ff:ff:ff:ff:ff:ff
    inet 172.21.0.1/16 brd 172.21.255.255 scope global docker_gwbridge
       valid_lft forever preferred_lft forever
    inet6 fe80::42:98ff:fe4e:febc/64 scope link
       valid_lft forever preferred_lft forever
...

Do konfiguracji odwrotnego serwera proxy użyj adresu przypisanego interfejsowi docker_gwbridge. W tym przykładzie jest to 127.21.0.1.

W porównaniu z konfiguracją wbudowanej usługi Reverse Proxy w pliku nginx.conf należy zmienić jedynie adresy docelowe przekierowań. Zamiast http://gateway użyj http://ip_address_docker_gwbridge:the_port_where_the_service_was_exposed. Analogiczne zmiany wprowadź w pozostałych blokach location.