Edge for Private Cloud Version 4.17.09
In diesem Abschnitt werden verschiedene administrative Vorgänge beschrieben, 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 Verwaltungsserver spielt eine wichtige Rolle bei der Zusammenführung aller anderen Komponenten in einer On-Premises-Installation von Edge Private Cloud. 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-Status 200 anzeigen. Wenn das nicht funktioniert, gehen Sie so vor:
- Prüfen Sie die Managementserverprotokolle unter /opt/apigee/var/log/apigee/management-server auf Fehler.
- Rufen Sie den Verwaltungsserver auf, um zu prüfen, ob er ordnungsgemäß funktioniert.
- Entfernen Sie den Server aus dem ELB und starten Sie dann den Verwaltungsserver neu:
/opt/apigee/bin/apigee-service management-server restart
Konfigurationsdateien verwenden
Die folgenden Befehle nehmen eine Konfigurationsdatei als Eingabe an. 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 Organisationen einrichten.
Virtuellen Host einrichten
Ein virtueller Host auf Edge definiert die Domains und Edge-Router-Ports, über die ein API-Proxy verfügbar gemacht wird, und danach die URL, die Anwendungen zum Zugriff auf einen API-Proxy verwenden. Ein virtueller Host definiert auch, ob über das HTTP-Protokoll oder das verschlüsselte HTTPS-Protokoll auf den API-Proxy zugegriffen wird.
Verwenden Sie die unten aufgeführten Scripts und API-Aufrufe, um einen virtuellen Host zu erstellen. Beim Erstellen des virtuellen Hosts müssen Sie die folgenden Informationen angeben:
- Der Name des virtuellen Hosts, auf den Sie in Ihren API-Proxys verweisen.
- Der Port am Router für den virtuellen Host. Normalerweise beginnen diese Ports bei 9001 und werden für jeden neuen virtuellen Host um eins erhöht.
- Host-Alias des virtuellen Hosts. In der Regel der DNS-Name des virtuellen Hosts.
Der Edge Router vergleicht bei der Bestimmung des API-Proxys, der die Anfrage verarbeitet, den Host-Header der eingehenden Anfrage mit der Liste der Host-Aliasse. Wenn Sie eine Anfrage über einen virtuellen Host senden, geben Sie entweder einen Domainnamen an, der mit dem Host-Alias eines virtuellen Hosts übereinstimmt, oder geben Sie die IP-Adresse des Routers und den Host-Header mit dem Host-Alias an.
Wenn Sie beispielsweise einen virtuellen Host mit dem Hostalias myapis.apigee.net auf Port 9001 erstellt haben, kann eine cURL-Anfrage an eine API über diesen virtuellen Host eines der folgenden Formate verwenden:
- Wenn Sie einen DNS-Eintrag für myapis.apigee.net haben:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - Wenn Sie keinen DNS-Eintrag für myapis.apigee.net haben:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
Geben Sie in der zweiten Form die IP-Adresse des Routers an und übergeben Sie den Host-Alias im Host-Header.
Hinweis: Der curl-Befehl, die meisten Browser und viele andere Dienstprogramme fügen den Host-Header automatisch mit der Domain als Teil der Anfrage an. Sie können also einen curl-Befehl in der folgenden Form verwenden:
curl http://<routerIP>: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
Wenn Sie einen curl-Befehl im folgenden Format erstellen:
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 jedes Routers und den Port des virtuellen Hosts an.
Alternativ können Sie den Host-Alias auf einen Wert wie temp.hostalias.com festlegen. Dann müssen Sie bei jeder Anfrage den Header host übergeben:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: temp.hostalias.com'
Alternativ können Sie den Host-Alias der Datei /etc/hosts hinzufügen. Fügen Sie beispielsweise diese Zeile zu /etc/hosts hinzu:
192.168.1.31 temp.hostalias.com
Dann 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}