Jak skonfigurować Edge

Edge dla chmury prywatnej w wersji 4.18.05

Aby skonfigurować Edge po instalacji, użyj kombinacji plików .properties i narzędzi Edge. Aby na przykład skonfigurować TLS/SSL w interfejsie Edge, musisz zmodyfikować pliki .properties, aby ustawić niezbędne właściwości. Zmiany w plikach .properties wymagają ponownego uruchomienia odpowiedniego komponentu Edge.

Apigee określa technikę edytowania plików .properties jako kod z konfiguracją. Zasadniczo kod z konfiguracją to narzędzie do wyszukiwania kluczy i wartości na podstawie ustawień w plikach .properties. W kodzie z konfiguracją klucze są nazywane tokenami. Dlatego, aby skonfigurować Edge, ustawiasz tokeny w plikach .properties.

Kod z konfiguracją umożliwia komponentom Edge ustawianie wartości domyślnych dostarczanych z usługą, pozwala zespołowi instalacyjnemu zastępować te ustawienia na podstawie topologii instalacji, a następnie umożliwia klientom zastępowanie wybranych właściwości.

Jeśli wyobrazisz sobie hierarchię, ustawienia są uporządkowane w następujący sposób, przy czym ustawienia klienta mają najwyższy priorytet i zastępują wszelkie ustawienia zespołu instalatorów lub Apigee:

1. Klient
2. Instalator
3. Apigee

Jak używać plików .properties

Jako klient możesz modyfikować tylko pliki .properties w katalogu /opt/apigee/customer/application. Każdy komponent ma w tym katalogu własny plik .properties. Na przykład: router.properties i management-server.properties.

Aby na przykład utworzyć plik .properties:

1. Utwórz plik w edytorze jako dowolny użytkownik.
2. Użyj polecenia chown, aby zmienić właściciela pliku na „apigee:apigee” lub, jeśli użytkownik, który uruchamia usługę Edge, został zmieniony z „apigee”, zmień właściciela pliku na użytkownika, który uruchamia usługę Edge.

Aby ustawić właściwość komponentu, zmodyfikuj odpowiedni plik .properties, aby ustawić token, a następnie uruchom ponownie komponent:

/opt/apigee/apigee-service/bin/apigee-service component restart

Na przykład po edycji pliku router.properties uruchom ponownie router:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Podczas uaktualniania Edge odczytywane są pliki .properties w katalogu /opt/apigee/customer/application. Oznacza to, że uaktualnienie zachowa wszystkie właściwości ustawione w komponencie.

Lokalizacja plików .properties

Dla plików .properties komponentów Edge istnieją 3 katalogi najwyższego poziomu: instalacja, właściciel i klienci. Domyślne lokalizacje są podane w tej tabeli:

/opt/apigee/component_name/conf

/opt/apigee/token

/opt/apigee/customer

Określanie bieżącej wartości tokena

Zanim ustawisz token w pliku .properties komponentu, możesz określić jego bieżącą wartość za pomocą tego polecenia:

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

Gdzie component_name to nazwa komponentu, a token to token, który chcesz sprawdzić.

To polecenie przeszukuje hierarchię plików .properties, aby określić bieżącą wartość tokena.

Aby na przykład sprawdzić bieżącą wartość tokena conf_http_HTTPRequest.line.limit dla routera:

/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Powinny pojawić się dane wyjściowe w takiej postaci:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

Ustawianie tokenów w plikach .properties

Aby zastąpić wartość tokena:

1. Aby ustawić wartość tokena, zmodyfikuj plik .properties komponentu. Jeśli plik nie istnieje, utwórz go.
2. Uruchom ponownie komponent.
3. Sprawdź wartość tokena.

Aby na przykład ustawić limit wiersza żądania dla routera Edge:

1. Zmodyfikuj plik /opt/apigee/customer/application/router.properties, aby ustawić token conf_http_HTTPRequest.line.limit:

   conf_http_HTTPRequest.line.limit=8k

2. Uruchom ponownie router brzegowy:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

3. Sprawdź wartość tokena:

   /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Ustawianie tokena, który przyjmuje wiele wartości

Niektóre tokeny przyjmują listę wartości rozdzielonych przecinkami. Na przykład token conf_security_rbac.restricted.resources przyjmuje listę identyfikatorów URI, które są ograniczone, dzięki czemu tylko administrator systemu może je wywoływać. Aby zobaczyć wartość conf_security_rbac.restricted.resources:

cd /opt/apigee/edge-management-server
grep -ri "conf_security_rbac.restricted.resources" *

Dane wyjściowe zawierają te informacje:

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

Aby ustawić token, który przyjmuje listę wartości, dołącz nowe wartości do bieżącej wartości tokena w pliku .properties. Aby dodać identyfikator URI /myuri/* do conf_security_rbac.restricted.resources, zmodyfikuj plik /opt/apigee/customer/application/management-server.properties w ten sposób:

conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

Znajdowanie tokena

W większości przypadków tokeny, które musisz ustawić, są określone w tym przewodniku. Jeśli jednak musisz określić token używany do zastąpienia właściwości, wykonaj grep w folderze source komponentu.

Jeśli na przykład wiesz, że we wcześniejszej wersji Edge została ustawiona właściwość session.maxAge i chcesz poznać wartość tokena, która została użyta do jej ustawienia, grep dla tej właściwości w katalogu /opt/apigee/edge-ui/source:

grep -ri "session.maxAge" /opt/apigee/edge-ui/source

Powinien pojawić się wynik w takiej postaci:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

Ciąg znaków między tagami {T}{/T} to token ustawiony w pliku .properties.

Ustawianie tokena, który jest obecnie zmieniony w komentarz

Niektóre tokeny są zmienione w komentarz w plikach konfiguracji Edge. Jeśli spróbujesz ustawić token, który jest zmieniony w komentarz, ustawienie zostanie zignorowane.

Aby ustawić token, który jest zmieniony w komentarz, użyj specjalnej składni w formacie:

conf/file.extension+propertyName=propertyValue

Załóżmy na przykład, że chcesz ustawić właściwość o nazwie HTTPClient.proxy.host w procesorze komunikatów. Następnie grep dla właściwości, aby określić jej token:

cd /opt/apigee/edge-message-processor
grep -ri "HTTPClient.proxy.host" *

Polecenie grep zwraca wyniki w postaci zawierającej wartość tokena. Zwróć uwagę, że nazwa właściwości jest zmieniona w komentarz, co wskazuje prefiks # w nazwie właściwości:

source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=

Aby ustawić właściwość, zmodyfikuj /opt/apigee/customer/application/message-processor.properties, aby ustawić właściwość jako:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

Zauważ, że nazwa właściwości jest poprzedzona prefiksem conf/http.properties+, lokalizacją i nazwą pliku konfiguracji zawierającego właściwość, po których następuje „+”.

Po ponownym uruchomieniu procesora komunikatów sprawdź plik /opt/apigee/edge-message-processor/conf/http.properties:

cat /opt/apigee/edge-message-processor/conf/http.properties

Na końcu pliku zobaczysz zestaw właściwości w formie:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com