Konserwacja organizacji i środowiska

Edge for Private Cloud wer. 4.17.05

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. Możesz sprawdzić stan użytkownika, organizacji i wdrożenia 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 na stronie /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.

    Router brzegowy porównuje nagłówek hosta przychodzącego żądania z listą aliasów hostów, aby określić serwer proxy interfejsu API, który obsługuje żądanie. 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 host wirtualny z aliasem myapis.apigee.net na porcie 9001, wtedy żądanie cURL do interfejsu API za pośrednictwem tego hosta wirtualnego będzie miało jedną z tych postaci:

  • Jeśli masz wpis DNS dla domeny myapis.apigee.net:
    curl http://myapis.apigee.net:9001/{proxy-base-path}/{ścieżka-zasobu}
  • 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 podaj adres IP hosta routera i przekazujesz alias hosta w polu

    Uwaga: polecenie curl, większość przeglądarek i wiele innych narzędzi automatycznie dołącza nagłówek Host do domeny jako część żądania, dzięki czemu możesz użyć polecenia curl w formacie:
    curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

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

Gdy utworzysz 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 /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}