Konserwacja organizacji i środowiska

Edge dla chmury prywatnej w wersji 4.17.09

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 Planety, regiony, pody, organizacje, środowiska i hosty wirtualne.

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. Możesz sprawdzić stan użytkownika, organizacji i wdrożenia na serwerze zarządzania, wysyłają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 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 zwiększają się o 1 dla każdego nowego hosta wirtualnego.
  • Alias hosta hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.

    Router Edge porównuje nagłówek Host żądania przychodzącego z listą aliasów hosta, aby określić, który serwer proxy interfejsu API 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.

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

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

Gdy użyjesz polecenia curl w tej postaci:

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}