Edge for Private Cloud v4.18.05
Verwenden Sie das Skript setup-org
, um den Onboardingprozess durchzuführen. Sie müssen das Skript auf dem Knoten des Verwaltungsservers ausführen.
So nehmen Sie eine Organisation in das Programm auf:
- Installieren Sie
apigee-provision
auf dem Verwaltungsserver-Knoten:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Führen Sie das Skript
setup-org
auf dem Verwaltungsserver-Knoten aus:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Die Konfigurationsdatei muss für den Benutzer „apigee“ gelesen werden. Ein Beispiel für eine Konfigurationsdatei finden Sie unter Konfigurationsdatei für Onboarding.
- Überprüfen Sie, ob Sie eine Organisation erfolgreich eingerichtet haben. Eine Möglichkeit besteht darin, sich bei der Benutzeroberfläche anzumelden. Dazu fordern Sie die folgende URL in einem Browser an:
http://IP_address:9000/login
Dabei ist IP_address die IP-Adresse des Servers, auf dem Sie die Edge-UI installiert haben.
Weitere Schritte zur Bestätigung finden Sie unter Onboarding bestätigen.
- Erstellen Sie Ihren ersten Proxy.
Konfigurationsdatei für Onboarding
Für eine im Hintergrund ausgeführte Konfiguration mit dem Skript setup-org
übergeben Sie eine Konfigurationsdatei mit der Option -f
wie im folgenden Beispiel gezeigt:
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Dieser Abschnitt enthält eine beispielhafte Konfigurationsdatei für das Onboarding einer Organisation mit setup-org
.
Beim Onboarding einer Organisation führt das Skript setup-org
Folgendes aus:
- Erstellt eine neue Organisation.
- Erstellt eine Umgebung.
- Erstellt einen virtuellen Host für die Umgebung.
- Legt den angegebenen Nutzer als Organisationsadministrator fest. Hinweise:
- Sie können einen vorhandenen Nutzer verwenden oder einen neuen für den Organisationsadministrator erstellen.
- Der Administrator der Organisation darf nicht mit dem Systemadministrator identisch sein.
- Ordnet die Organisation dem Pod "gateway" zu. (Dies ist die Standardeinstellung und kann nicht geändert werden.)
- Ordnet die Umgebung allen Message Processor(en) zu.
- Aktiviert Analytics.
Kopieren Sie das folgende Beispiel und nehmen Sie die erforderlichen Änderungen vor, um Ihre Organisation einzurichten:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Hinweise:
- Wenn Sie für
VHOST_ALIAS
bereits einen DNS-Eintrag haben, mit dem Sie auf den virtuellen Host zugreifen, geben Sie den Hostalias und optional den Port an, z. B. „myapi.example.com“. Wenn Sie noch keinen DNS-Eintrag haben, können Sie die IP-Adresse des Routers verwenden.
Weitere Informationen zum Konfigurieren des virtuellen Hosts finden Sie unter Virtuellen Host einrichten.
- Weitere Informationen zum Erstellen der JAR-Datei und zu anderen Aspekten zum Konfigurieren von TLS/SSL finden Sie unter Schlüsselspeicher und Truststores und TLS-Zugriff auf eine API für die Private Cloud konfigurieren.
- Weitere Informationen zum Konfigurieren von virtuellen Hosts finden Sie unter TLS-Zugriff auf eine API für die Private Cloud konfigurieren.
- Sie können nicht zwei Organisationen mit demselben Namen erstellen. In diesem Fall schlägt die zweite Erstellung fehl.
Weitere Informationen zur Verwendung der Management API zum Onboarding einer Organisation finden Sie unter Organisation, Umgebung und virtuellen Host erstellen.
Onboarding prüfen
Prüfen Sie nach Abschluss des Onboardings den Status des Systems, indem Sie die folgenden CURL-Befehle auf dem Knoten des Verwaltungsservers ausführen:
- Prüfen Sie den Nutzer- und Organisationsstatus auf dem Management Server mit den folgenden 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/org_name/deployments
- Prüfen Sie Analysen, indem Sie den folgenden Befehl ausführen:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Prüfen Sie den PostgreSQL-Datenbankstatus. Führen Sie dazu die folgenden Befehle auf Knoten 2 aus (wie in den Installationstopologien gezeigt):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
Geben Sie an der Eingabeaufforderung den folgenden Befehl ein, um die Analysetabelle für Ihre Organisation anzusehen:
\d analytics."org_name.env_name.fact"
Verwenden Sie folgenden Befehl, um psql zu beenden:
\q
- Greifen Sie über einen Webbrowser auf die Apigee Edge-UI zu. Am Ende der Installation haben Sie die URL der Verwaltungskonsole bereits notiert.
- Starten Sie Ihren bevorzugten Browser und geben Sie die URL der Edge-Benutzeroberfläche ein. Sie sieht in etwa so aus, wobei die IP-Adresse für Knoten 1 gilt (wie in den Installationstopologien dargestellt) oder für den Knoten, auf dem Sie die UI für alternative Konfigurationen installiert haben:
http://192.168.56.111:9000/login
9000 ist die von der UI verwendete Portnummer.
Wenn Sie den Browser direkt auf dem Server starten, auf dem die Edge-UI gehostet wird, können Sie eine URL im folgenden Format verwenden:
http://localhost:9000/login
- Geben Sie auf der Anmeldeseite der Console den Nutzernamen/das Passwort des Apigee-Systemadministrators an.
- Starten Sie Ihren bevorzugten Browser und geben Sie die URL der Edge-Benutzeroberfläche ein. Sie sieht in etwa so aus, wobei die IP-Adresse für Knoten 1 gilt (wie in den Installationstopologien dargestellt) oder für den Knoten, auf dem Sie die UI für alternative Konfigurationen installiert haben:
- Registrieren Sie sich für ein neues Apigee-Nutzerkonto und verwenden Sie die neuen Nutzeranmeldedaten zur Anmeldung. Klicken Sie auf der Anmeldeseite der Console auf die Schaltfläche Anmelden.
Der Browser leitet zu
http://192.168.56.111:9000/platform/#/org_name/
weiter und öffnet ein Dashboard, in dem Sie die von Ihnen erstellte Organisation konfigurieren können (wenn Sie sich mit Apigee-Administratoranmeldedaten angemeldet haben).
Ersten Proxy erstellen
Nachdem Sie eine neue Organisation aufgenommen und bestätigt haben, dass der Onboardingprozess erfolgreich war, können Sie jetzt Ihren ersten Proxy erstellen. Weitere Informationen finden Sie unter Ersten API-Proxy erstellen.
Weitere hilfreiche Ressourcen: