Organisations- und Umgebungswartung

In diesem Abschnitt werden verschiedene Verwaltungsvorgänge behandelt, z. B. Erstellung, Verwaltung und Entfernen von Apigee-Organisationen, -Umgebungen und -virtuellen Hosts in einem Apigee Edge for Private Cloud-Installation.

Eine Einführung in Organisationen, Umgebungen und virtuelle Hosts finden Sie unter Über Planeten, Regionen, Pods, Organisationen, Umgebungen und virtuelle Hosts

Status von Nutzern und Organisation überprüfen und Umwelt

Management Server spielt eine wichtige Rolle dabei, alle anderen Komponenten lokale Installation von Edge Private Cloud. Sie können nach Nutzer, Organisation und Bereitstellungsstatus auf dem Verwaltungsserver durch Ausgabe des folgenden curl-Objekts: Befehle:

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:

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

Konfigurationsdateien verwenden

Bei den unten gezeigten Befehlen wird eine Konfigurationsdatei als Eingabe verwendet. Beispiel: Sie übergeben eine Konfigurationsdatei an Den Befehl „setup-org“ verwenden, um alle Attribute der Organisation zu definieren, einschließlich der Umgebung und virtueller Host.

Eine vollständige Konfigurationsdatei und Informationen zu den Attributen, die Sie in der Konfiguration festlegen können finden Sie in diesem Hilfeartikel.

Informationen zum Einrichten eines virtuellen Hosts

Ein virtueller Host in Edge definiert die Domains und Edge Router-Ports, an denen ein API-Proxy ausgeführt wird , und somit auch die URL, über die Apps auf einen API-Proxy zugreifen. Ein virtueller Host definiert, ob auf den API-Proxy über das HTTP-Protokoll oder das verschlüsselte HTTPS zugegriffen wird Protokoll.

Verwenden Sie die unten aufgeführten Skripts und API-Aufrufe, um einen virtuellen Host zu erstellen. Wenn Sie die virtuellen Hosts haben, müssen Sie die folgenden Informationen angeben:

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

    Der Edge Router vergleicht den Host-Header der eingehenden Anfrage mit der Liste der Host-Aliasse Teil der Bestimmung des API-Proxys, der die Anfrage verarbeitet. Wenn Sie eine Anfrage über ein virtueller Host: 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 Host-Alias myapis.apigee.net an Port 9001 und führen Sie dann einen curl-Anfrage an eine API über diesen virtuellen Host könnte Folgendes verwenden: Formulare:

  • 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 Feld 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 Router und Port des virtuellen Hosts, als routerIP:port. Beispiel:

192.168.1.31:9001

Dann erstellen Sie einen curl-Befehl im folgenden Format:

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 einen Host-Alias hinzu. Geben Sie dabei die IP-Adresse jeden Router und Port des virtuellen Hosts.

Alternativ können Sie den Hostalias auf einen Wert festlegen, z. B. temp.hostalias.com. 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 Hostalias zu Ihrer /etc/hosts-Datei hinzufügen. Fügen Sie diese Zeile beispielsweise /etc/hosts:

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