Edge for Private Cloud w wersji 4.17.09
W tej sekcji omawiamy różne operacje administracyjne, takie jak tworzenie i usuwanie organizacji Apigee, środowisk i hostów wirtualnych oraz zarządzania nimi w instalacji Apigee Edge for Private Cloud.
Więcej informacji o organizacjach, środowiskach i hostach wirtualnych znajdziesz w artykule Planety, regiony, kontenery, organizacje, środowiska i hosty wirtualne.
Sprawdzanie stanu użytkowników, organizacji i środowiska
Serwer zarządzania odgrywa kluczową rolę w utrzymywaniu wszystkich innych komponentów w ramach instalacji Edge Private Cloud w dzielnicy. Stan użytkownika, organizacji i wdrożenia możesz sprawdzić na serwerze zarządzania, wykonując te polecenia CURL:
curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments
System powinien wyświetlać stan HTTP 200 dla wszystkich wywołań. Jeśli te metody zawiodą, wykonaj te czynności:
- Sprawdź dzienniki serwera zarządzania w folderze /opt/apigee/var/log/apigee/management-server pod kątem błędów.
- Wykonaj wywołanie serwera zarządzania, aby sprawdzić, czy działa on prawidłowo.
- Usuń serwer z ELB, a następnie uruchom ponownie serwer zarządzania:
/opt/apigee/bin/apigee-service management-server restart
Informacje o używaniu plików konfiguracji
Polecenia pokazane poniżej przyjmują jako dane wejściowe plik konfiguracji. Na przykład możesz przekazać plik konfiguracji do polecenia setup-org, aby zdefiniować wszystkie właściwości organizacji, w tym środowisko i hosta wirtualnego.
Pełny plik konfiguracji i informacje o właściwościach, które można ustawić w pliku konfiguracji, znajdziesz w artykule Rejestrowanie organizacji.
Konfigurowanie hosta wirtualnego
Host wirtualny na Edge określa domeny i porty routera brzegowego, na których jest dostępny serwer proxy interfejsu API, a także adres URL, za pomocą którego aplikacje uzyskują dostęp do serwera proxy interfejsu API. Host wirtualny określa też, czy dostęp do serwera proxy API jest uzyskiwany za pomocą protokołu HTTP, czy szyfrowanego protokołu HTTPS.
Użyj widocznych poniżej skryptów i wywołań interfejsu API, aby utworzyć hosta wirtualnego. Podczas tworzenia hosta wirtualnego musisz podać te informacje:
- Nazwa hosta wirtualnego, którego używasz do odwoływania się do niego w proksy API.
- Port w routerze dla hosta wirtualnego. Zwykle liczba portów zaczyna się od 9001 i zwiększa się o 1 dla każdego nowego hosta wirtualnego.
- Alias hosta wirtualnego hosta. Zwykle jest to nazwa DNS wirtualnego hosta.
Podczas określania serwera proxy interfejsu API, który obsługuje żądanie, router brzegowy porównuje nagłówek hosta żądania przychodzącego z listą aliasów hostów. Gdy wysyłasz żądanie za pomocą hosta wirtualnego, podaj nazwę domeny odpowiadającą aliasowi hosta lub adres IP routera i nagłówek Host zawierający alias hosta.
Jeśli na przykład utworzysz hosta wirtualnego z aliasem hosta myapis.apigee.net na porcie 9001, żądanie cURL do interfejsu API wysłane przez tego hosta wirtualnego może mieć jedną z tych form:
- Jeśli masz wpis DNS dla myapis.apigee.net:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - Jeśli nie masz wpisu DNS dla adresu myapis.apigee.net:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
Druga forma wymaga podania adresu IP routera i przekazania aliasu hosta w nagłówku Host.
Uwaga: polecenie curl, większość przeglądarek i wiele innych narzędzi automatycznie dołącza nagłówek Host do domeny jako część żądania, więc możesz użyć polecenia curl w formie:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Opcje jeśli nie masz wpisu DNS dla hosta wirtualnego
Jeśli nie masz wpisu DNS, możesz ustawić alias hosta na adres IP routera i port hosta wirtualnego, na przykład <routerIP>:port. Na przykład:
192.168.1.31:9001
Gdy utworzysz polecenie curl w postaci:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Ta opcja jest preferowana, ponieważ dobrze współpracuje z interfejsem Edge.
Jeśli masz kilka routerów, dodaj alias hosta dla każdego z nich, podając adres IP każdego routera i port hosta wirtualnego.
Możesz też ustawić alias hosta na wartość, np. temp.hostalias.com. Następnie musisz przekazać nagłówek host w każdym żądaniu:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: temp.hostalias.com'
Możesz też dodać alias hosta do pliku /etc/hosts. Na przykład dodaj ten wiersz do pliku /etc/hosts:
192.168.1.31 temp.hostalias.com
Następnie możesz wysłać żądanie tak, jakbyś miał wpis DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}