Konserwacja organizacji i środowiska

W tej sekcji omawiamy różne operacje administracyjne, takie jak tworzenie i usuwanie organizacji, środowisk i hostów wirtualnych Apigee w instalacji Apigee Edge dla chmury prywatnej oraz zarządzanie nimi.

Wprowadzenie do organizacji, środowisk i hostów wirtualnych znajdziesz w artykule Informacje o planetach, regionach, podach, organizacjach, środowiskach i hostach wirtualnych.

Sprawdzanie stanu użytkowników, organizacji i środowiska

Serwer zarządzania odgrywa kluczową rolę w łączeniu wszystkich innych komponentów w lokalnej instalacji Edge Private Cloud. Stan użytkownika, organizacji i wdrożenia możesz sprawdzić na serwerze zarządzania, uruchamiają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

W przypadku wszystkich wywołań system powinien wyświetlać stan HTTP 200. Jeśli to się nie uda, wykonaj te czynności:

  1. Sprawdź, czy w logach serwera zarządzania pod adresem /opt/apigee/var/log/apigee/management-server nie ma błędów.
  2. Wyślij wywołanie do serwera zarządzania, aby sprawdzić, czy działa on prawidłowo.
  3. Usuń serwer z ELB, a następnie ponownie uruchom serwer zarządzania: 
    /opt/apigee/bin/apigee-service management-server restart

Informacje o korzystaniu z plików konfiguracji

Polecenia widoczne poniżej pobierają plik konfiguracyjny jako dane wejściowe. Na przykład przekazujesz plik konfiguracyjny do polecenia setup-org, aby zdefiniować wszystkie właściwości organizacji, w tym środowisko i host wirtualny.

Kompletny plik konfiguracji i informacje o właściwościach, które można ustawić w pliku konfiguracji, znajdziesz w artykule Rejestrowanie organizacji.

Informacje o konfigurowaniu hosta wirtualnego

Host wirtualny na Edge określa domeny i porty routera Edge, na których jest dostępny serwer proxy interfejsu API, a także URL, którego aplikacje używają, aby uzyskać dostęp do serwera proxy interfejsu API. Host wirtualny określa też, czy dostęp do serwera proxy interfejsu API jest możliwy przez protokół HTTP czy zaszyfrowany protokół HTTPS.

Za pomocą poniższych skryptów i wywołań interfejsu API utwórz hosta wirtualnego. Podczas tworzenia hosta wirtualnego musisz podać te informacje:

  • Nazwa hosta wirtualnego, którego używasz, aby się do niego odwoływać w serwerach proxy interfejsu API.
  • Port routera dla hosta wirtualnego. Zwykle te porty zaczynają się od 9001 i zwiększają się o 1 dla każdego nowego hosta wirtualnego.
  • Alias hosta hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.

    Aby określić serwer proxy interfejsu API, który obsługuje żądanie, router brzegowy porównuje nagłówek hosta przychodzącego żądania z listą aliasów hosta. Wysyłając żądanie do hosta wirtualnego, podaj nazwę domeny pasującą do aliasu hosta wirtualnego lub adres IP routera i nagłówek hosta zawierający alias hosta.

Jeśli na przykład utworzysz hosta wirtualny z aliasem myapis.apigee.net na porcie 9001, a potem wykonaj żądanie curl do interfejsu API za pośrednictwem tego hosta, może to być użycie jednej z tych postaci:

  • Jeśli masz wpis DNS dla domeny myapis.apigee.net: 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Jeśli nie masz wpisu DNS dla domeny myapis.apigee.net: 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    W drugiej formie podajesz adres IP routera i przekazujesz alias hosta w nagłówku Host.

Opcje dostępne, gdy nie ma wpisu DNS dla hosta wirtualnego

Jeśli nie masz wpisu DNS, możesz ustawić alias hosta na adres IP routera i port hosta wirtualnego jako routerIP:port. Na przykład:

192.168.1.31:9001

Następnie utwórz polecenie curl w formularzu poniżej:

curl http://routerIP:9001/proxy-base-path/resource-path

Ta opcja jest preferowana, ponieważ dobrze działa z interfejsem Edge.

Jeśli masz kilka routerów, dodaj alias hosta dla każdego routera, który określa adres IP każdego routera i port hosta wirtualnego.

Alias hosta możesz też ustawić jako wartość, na przykład temp.hostalias.com. Następnie w każdym żądaniu musisz przekazywać nagłówek Host:

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 był wpis DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path