Organisations- und Umgebungswartung

In diesem Abschnitt werden verschiedene administrative Vorgänge behandelt, z. B. das Erstellen, Verwalten und Entfernen von Apigee-Organisationen, -Umgebungen und -virtuellen Hosts in einer Apigee Edge for Private Cloud-Installation.

Eine Einführung in Organisationen, Umgebungen und virtuelle Hosts finden Sie unter Informationen zu Planeten, Regionen, Pods, Organisationen, Umgebungen und virtuellen Hosts.

Status von Nutzern, Organisation und Umgebung prüfen

Der Management Server spielt eine wichtige Rolle, da er alle anderen Komponenten in einer lokalen Installation von Edge Private Cloud zusammenhält. Sie können den Status von Nutzern, Organisationen und Bereitstellungen auf dem Verwaltungsserver mit den folgenden curl-Befehlen prüfen:

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

Das System sollte für alle Aufrufe den HTTP-Statuscode 200 anzeigen. Wenn diese fehlschlagen, gehen Sie so vor:

  1. Prüfen Sie die Management Server-Logs unter /opt/apigee/var/log/apigee/management-server auf Fehler.
  2. Rufen Sie den Management Server auf, um zu prüfen, ob er ordnungsgemäß funktioniert.
  3. Entfernen Sie den Server aus dem ELB und starten Sie den Management Server neu:
    /opt/apigee/bin/apigee-service management-server restart

Konfigurationsdateien verwenden

Die unten gezeigten Befehle verwenden eine Konfigurationsdatei als Eingabe. Sie übergeben beispielsweise eine Konfigurationsdatei an den Befehl „setup-org“, um alle Eigenschaften der Organisation zu definieren, einschließlich der Umgebung und des virtuellen Hosts.

Eine vollständige Konfigurationsdatei und Informationen zu den Eigenschaften, die Sie in der Konfigurationsdatei festlegen können, finden Sie unter Organisation einrichten.

Virtuellen Host einrichten

Ein virtueller Host in Edge definiert die Domains und Edge Router-Ports, über die ein API-Proxy verfügbar gemacht wird, und danach die URL, die Anwendungen zum Aufrufen eines API-Proxys verwenden. Ein virtueller Host definiert auch, ob auf den API-Proxy über das HTTP-Protokoll oder über das verschlüsselte HTTPS-Protokoll zugegriffen wird.

Verwenden Sie die unten gezeigten Scripts und API-Aufrufe, um einen virtuellen Host zu erstellen. Wenn Sie den virtuellen Host erstellen, müssen Sie die folgenden Informationen angeben:

  • Der Name des virtuellen Hosts, mit dem Sie in Ihren API-Proxys darauf verweisen.
  • Der Port auf dem Router für den virtuellen Host. Normalerweise beginnen diese Ports bei 9001 und werden für jeden neuen virtuellen Host um eins erhöht.
  • Der Host-Alias des virtuellen Hosts. In der Regel der DNS-Name des virtuellen Hosts.

    Der Edge-Router vergleicht den Host-Header der eingehenden Anfrage mit der Liste der Host-Aliase, um den API-Proxy zu ermitteln, der die Anfrage verarbeitet. Wenn Sie eine Anfrage über einen virtuellen Host stellen, geben Sie entweder einen Domainnamen an, der mit dem Hostalias eines virtuellen Hosts übereinstimmt, oder die IP-Adresse des Routers und den Hostheader mit dem Hostalias.

Wenn Sie einen DNS-Eintrag für den virtuellen Host haben

Wenn Sie beispielsweise einen virtuellen Host mit dem Hostalias myapis.apigee.net auf Port 9001 erstellt haben, könnte eine curl-Anfrage an eine API über diesen virtuellen Host so aussehen:

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

Optionen, wenn Sie keinen DNS-Eintrag für den virtuellen Host haben

Wenn Sie keinen DNS-Eintrag haben, können Sie den Hostalias auf die IP-Adresse des Routers und den Port des virtuellen Hosts festlegen, z. B. routerIP:port. Beispiel:

192.168.1.31:9001

Anschließend erstellen Sie einen curl-Befehl in der folgenden Form:

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

Diese Option wird bevorzugt, da sie gut mit der Edge-Benutzeroberfläche funktioniert.

Wenn Sie mehrere Router haben, fügen Sie für jeden Router einen Hostalias hinzu und geben Sie die IP-Adresse des jeweiligen Routers und den Port des virtuellen Hosts an.

Alternativ können Sie den Host-Alias auf einen Wert wie temp.hostalias.com festlegen. Anschließend müssen Sie den Host-Header bei jeder Anfrage übergeben:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

Alternativ können Sie den Host-Alias in die Datei /etc/hosts einfügen. Fügen Sie beispielsweise diese Zeile zu /etc/hosts hinzu:

192.168.1.31   temp.hostalias.com

Anschließend können Sie eine Anfrage stellen, als ob Sie einen DNS-Eintrag hätten:

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