Konserwacja organizacji i środowiska

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

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 pozostałych komponentów w lokalnej instalacji Edge chmury prywatnej. Aby sprawdzić stan użytkownika, organizacji i wdrożenia na serwerze zarządzania, uruchom 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 to nie pomoże, wykonaj te czynności:

  1. Sprawdź, czy w logach serwera zarządzania w /opt/apigee/var/log/apigee/management-server nie ma błędów.
  2. Wykonaj wywołanie do serwera zarządzania, aby sprawdzić, czy działa prawidłowo.
  3. 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ą plik konfiguracji jako dane wejściowe. Na przykład przekazujesz plik konfiguracji do polecenia setup-org, aby zdefiniować wszystkie właściwości organizacji, w tym środowisko i host wirtualny.

Pełny plik konfiguracji i informacje o właściwościach, które można w nim ustawić, znajdziesz w artykule Wprowadzenie organizacji.

Konfigurowanie hosta wirtualnego

Host wirtualny w Edge definiuje domeny i porty routera Edge, na których jest udostępniany serwer proxy interfejsu API, a także adres URL, którego aplikacje używają do uzyskiwania dostępu do serwera proxy interfejsu API. Host wirtualny określa też, czy dostęp do serwera proxy interfejsu API jest uzyskiwany za pomocą protokołu HTTP czy zaszyfrowanego protokołu HTTPS.

Aby utworzyć hosta wirtualnego, użyj skryptów i wywołań interfejsu API pokazanych poniżej. Podczas tworzenia hosta wirtualnego musisz podać te informacje:

  • Nazwa hosta wirtualnego, której używasz do odwoływania się do niego w serwerach proxy interfejsów API.
  • Port na routerze dla hosta wirtualnego. Zwykle te porty zaczynają się od 9001 i są zwiększane o 1 dla każdego nowego hosta wirtualnego.
  • Alias hosta hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.

    Router brzegowy porównuje nagłówek Host żądania przychodzącego z listą aliasów hosta, aby określić serwer proxy interfejsu API, który obsługuje żądanie. Podczas wysyłania żądania przez hosta wirtualnego podaj nazwę domeny, która pasuje do aliasu hosta wirtualnego, lub podaj 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 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 myapis.apigee.net: 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

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

Opcje, gdy 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, np. routerIP:port. Na przykład:

192.168.1.31:9001

Następnie utwórz polecenie curl w poniższym formacie:

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

Ta opcja jest preferowana, ponieważ dobrze współpracuje z interfejsem Edge.

Jeśli masz wiele 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 wpis DNS istniał:

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