Wartung von Organisationen und Umgebungen

Edge for Private Cloud Version 4.17.05

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 Informationen zu 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 mit den folgenden CURL-Befehlen:

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. Überprüfen Sie die Verwaltungsserverprotokolle unter /opt/apigee/var/log/apigee/management-server auf Fehler.
  2. Verwaltungsserver aufrufen, um zu prüfen, ob er funktioniert ordnungsgemäß funktioniert.
  3. Entfernen Sie den Server vom ELB und starten Sie dann den Verwaltungsserver neu:
    /opt/apigee/bin/apigee-service Neustart des Verwaltungsservers

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, dann eine cURL-Anfrage an eine API über diesen virtuellen Host eine der folgenden Formen 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://&lt;routerIP&gt;:9001/{proxy-base-path}/{resource-path} -H &#39;Host: myapis.apigee.net '

    Im zweiten Formular geben Sie die IP-Adresse des Routers an und übergeben den Host-Alias im Feld Host-Header.

    Hinweis: Der Befehl „curl“, die meisten Browser und viele andere Dienstprogramme werden automatisch den Host-Header mit der Domain als Teil der Anfrage anhängen, sodass Sie tatsächlich einen curl-Befehl verwenden können, im Format
    . curl http://&lt;routerIP&gt;: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 Host-Alias auf die IP-Adresse des Router und Port des virtuellen Hosts als &lt;routerIP&gt;: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 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 Host-Alias in die Datei /etc/hosts einfügen. Fügen Sie beispielsweise diese Zeile an /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}