Organisation einrichten

Um eine Organisation einzubinden, müssen Sie eine Konfigurationsdatei für die Einbindung erstellen und sie dann an den setup-org Befehl übergeben. Jeder dieser Schritte wird in den folgenden Abschnitten beschrieben,

Informationen zur Verwendung der Management API zum Einbinden einer Organisation finden Sie unter Organisation, Umgebung und virtuellen Host erstellen.

Konfigurationsdatei für die Einbindung erstellen

Dieser Abschnitt enthält eine Beispielkonfigurationsdatei für die Einbindung einer Organisation mit setup-org.

Kopieren Sie das folgende Beispiel und bearbeiten Sie es nach Bedarf für Ihre Organisation:

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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.

Beachten Sie Folgendes:

  • Geben Sie für VHOST_ALIAS den Hostalias und optional den Port an, wenn Sie bereits einen DNS-Eintrag haben, mit dem Sie auf den virtuellen Host zugreifen. Beispiel: „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.

  • Informationen zur TLS/SSL-Konfiguration finden Sie unter Keystores und Truststores und Configuring TLS access to an API for the Private Cloud. Dort finden Sie auch weitere Informationen zum Erstellen der JAR-Datei, und zu anderen Aspekten der TLS/SSL-Konfiguration.
  • Weitere Informationen zum Konfigurieren virtueller 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.

`setup-org` ausführen

Nachdem Sie die Konfigurationsdatei für die Einbindung erstellt haben, übergeben Sie sie an das setup-org Skript, um den Einbindungsprozess auszuführen. Sie müssen das Skript auf dem Management Server Knoten ausführen.

Beim Einbinden einer Organisation führt das Skript setup-org folgende Schritte aus:

  • Erstellt eine neue Organisation.
  • Erstellt eine Umgebung.
  • Erstellt einen virtuellen Host für die Umgebung.
  • Legt den angegebenen Nutzer als Organisationsadministrator fest. Hinweis:
    • Sie können einen vorhandenen Nutzer verwenden oder einen neuen für den Organisationsadministrator erstellen.
    • Der Organisationsadministrator darf nicht mit dem Systemadministrator identisch sein.
  • Verknüpft die Organisation mit dem Pod „gateway“. Dies ist die Standardeinstellung und kann nicht geändert werden.
  • Verknüpft die Umgebung mit allen Message Processors.
  • Aktiviert Analytics.

So führen Sie setup-org aus

  1. Installieren Sie apigee-provision auf dem Management Server-Knoten: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Führen Sie das Skript setup-org auf dem Management Server-Knoten aus und verweisen Sie es auf die Konfigurationsdatei, die Sie unter Konfigurationsdatei für die Einbindung erstellen erstellt haben: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Die Konfigurationsdatei muss für den Nutzer „apigee“ lesbar sein.

  3. Prüfen Sie, ob Sie eine Organisation erfolgreich eingebunden haben. Eine Möglichkeit dazu ist, sich in der neuen Edge-UI anzumelden, indem Sie die folgende URL in einem Browser aufrufen: 
    http://IP_address:3001

    Dabei ist IP_address die IP-Adresse des Servers, auf dem Sie die neue Edge- UI installiert haben.

    Weitere Schritte zur Überprüfung finden Sie unter Einbindung prüfen.

  4. Erstellen Sie Ihren ersten Proxy.

Einbindung prüfen

Nach Abschluss der Einbindung prüfen Sie den Status des Systems, indem Sie die folgenden curl Befehle auf dem Management Server-Knoten ausführen:

  1. Prüfen Sie den Nutzer- und Organisationsstatus auf dem Management Server, indem Sie die folgenden Befehle ausführen: 
    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
  2. Prüfen Sie Analytics, indem Sie den folgenden Befehl ausführen: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Prüfen Sie den Status der PostgreSQL-Datenbank, indem Sie die folgenden Befehle auf Knoten 2 ausführen (wie in den Installationstopologien gezeigt): 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Geben Sie bei der Eingabeaufforderung den folgenden Befehl ein, um die Analysetabelle für Ihre Organisation aufzurufen:

    \d analytics."org_name.env_name.fact"

    Verwenden Sie den folgenden Befehl, um psql zu beenden:

    \q
  4. Greifen Sie über einen Webbrowser auf die neue Edge-UI zu. Die URL der Management Console haben Sie bereits am Ende der Installation notiert.
    1. Starten Sie Ihren bevorzugten Browser und geben Sie die URL der neuen Edge-UI ein. Sie sieht in etwa so aus, wobei die IP-Adresse für Knoten 1 steht (wie in den Installationstopologien gezeigt) oder für den Knoten, auf dem Sie die neue Edge-UI für alternative Konfigurationen installiert haben: 
      http://192.168.56.111:3001

      3001 ist die Standardportnummer, die von der neuen Edge-UI verwendet wird.

      Wenn Sie den Browser direkt auf dem Server starten, auf dem die neue Edge-UI gehostet wird, dann können Sie eine URL im folgenden Format verwenden: 

      http://localhost:3001
    2. Geben Sie auf der Anmeldeseite der Console den Nutzernamen und das Passwort des Apigee-Systemadministrators an.
  5. Registrieren Sie sich für ein neues Apigee-Nutzerkonto und melden Sie sich mit den neuen Nutzeranmeldedaten an. Klicken Sie auf der Anmeldeseite der Console auf die Schaltfläche Anmelden.

    Der Browser leitet Sie zu http://192.168.56.111:3001/edge weiter und öffnet ein Dashboard, mit dem Sie die erstellte Organisation konfigurieren können (wenn Sie sich mit den Anmeldedaten des Apigee-Administrators angemeldet haben).

Ersten Proxy erstellen

Nachdem Sie eine neue Organisation eingebunden und geprüft haben, ob der Einbindungsprozess erfolgreich war , können Sie jetzt Ihren ersten Proxy erstellen. Weitere Informationen finden Sie unter Ersten API-Proxy erstellen.

Weitere hilfreiche Ressourcen: