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, um alle anderen Komponenten in einer lokalen Installation von Edge Private Cloud zusammenzuhalten. Sie können den Nutzer-, Organisations- und Bereitstellungsstatus auf dem Management Server mit den folgenden curl-Befehlen prüfen:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
Das System sollte für alle Aufrufe den HTTP-Status 200 anzeigen. Wenn diese fehlschlagen, gehen Sie so vor:
- Prüfen Sie die Management Server-Logs unter
/opt/apigee/var/log/apigee/management-serverauf Fehler. - Führen Sie einen Aufruf an den Management Server aus, um zu prüfen, ob er ordnungsgemäß funktioniert.
- Entfernen Sie den Server aus dem ELB und starten Sie dann den Management Server neu:
/opt/apigee/bin/apigee-service management-server restart
Konfigurationsdateien verwenden
Die unten aufgeführten Befehle verwenden eine Konfigurationsdatei als Eingabe. Sie übergeben beispielsweise eine Konfigurationsdatei an den Befehl „setup-org“, um alle Attribute der Organisation zu definieren, einschließlich der Umgebung und des virtuellen Hosts.
Eine vollständige Konfigurationsdatei und Informationen zu den Attributen, die Sie in der Konfigurationsdatei festlegen können, finden Sie unter Organisation einbinden.
Virtuellen Host einrichten
Ein virtueller Host in Edge definiert die Domains und Edge-Router-Ports, über die ein API-Proxy bereitgestellt wird, und damit auch die URL, über die Anwendungen auf einen API-Proxy zugreifen. 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 Skripts 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, den Sie in Ihren API-Proxys verwenden, um darauf zu verweisen.
- Der Port auf dem Router für den virtuellen Host. In der Regel beginnen diese Ports bei 9001 und werden für jeden neuen virtuellen Host um eins erhöht.
- Der Hostalias 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 bestimmen, der die Anfrage verarbeitet. Wenn Sie eine Anfrage über einen virtuellen Host stellen, geben Sie entweder einen Domainnamen an, der mit dem Host-Alias eines virtuellen Hosts übereinstimmt, oder die IP-Adresse des Routers und den Host-Header, der den Host-Alias enthält.
Wenn Sie beispielsweise einen virtuellen Host mit dem Host-Alias myapis.apigee.net auf Port 9001 erstellt haben, führen Sie eine curl-Anfrage an eine API über diesen virtuellen Host aus. Dabei können Sie 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'
Im zweiten Formular geben Sie die IP-Adresse des Routers an und übergeben den Host-Alias im Host-Header.
Optionen, wenn Sie keinen DNS-Eintrag für den virtuellen Host haben
Wenn Sie keinen DNS-Eintrag haben, können Sie den Host-Alias 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 führen Sie einen curl-Befehl im folgenden Format aus:
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 Host-Alias 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 den Header Host 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 der Datei /etc/hosts hinzufü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 hätten Sie einen DNS-Eintrag:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path