Organisation einrichten

Um eine Organisation einzurichten, müssen Sie eine Onboarding-Konfigurationsdatei erstellen und diese dann übergeben zum Befehl setup-org hinzu. Jeder dieser Schritte wird in den Abschnitten beschrieben, folgen.

Informationen zur Verwendung der Verwaltungs-API zum Onboarding einer Organisation finden Sie unter Wenn Sie eine Organisation erstellen, Umgebung und virtueller Host.

Onboarding-Konfigurationsdatei erstellen

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

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

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.

Hinweis:

Setup-Organisation ausführen

Nachdem Sie die Onboarding-Konfigurationsdatei erstellt haben, übergeben Sie sie an die setup-org um den Onboardingprozess durchzuführen. Sie müssen das Skript auf dem Verwaltungsserver ausführen Knoten.

Beim Onboarding einer Organisation führt das Skript setup-org die folgenden Schritte aus:

  • Erstellt eine neue Organisation.
  • Erstellt eine Umgebung.
  • Erstellt einen virtuellen Host für die Umgebung.
  • Legt den angegebenen Nutzer als Organisationsadministrator fest. Beachten Sie Folgendes: <ph type="x-smartling-placeholder">
      </ph>
    • 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 "Gateway" Pod. (Dies ist die Standardeinstellung und kann nicht changed.)
  • Verbindet die Umgebung mit allen Message Processor(s).
  • Ermöglicht Analysen.

So führen Sie setup-org aus:

  1. Installieren Sie apigee-provision auf dem Knoten des Verwaltungsservers:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Führen Sie das Skript setup-org auf dem Knoten des Verwaltungsservers aus und verweisen Sie auf den Konfigurationsdatei, die Sie unter Onboarding-Konfiguration erstellen Datei:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Die Konfigurationsdatei muss vom „Apigee“ gelesen werden können Nutzer.

  3. Prüfen Sie, ob Sie eine Organisation erfolgreich eingerichtet haben. Eine Möglichkeit, dies zu tun, in der Benutzeroberfläche, indem Sie die folgende URL in einem Browser anfordern:
    http://IP_address:9000/login

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

    Weitere Bestätigungsschritte finden Sie unter Onboarding bestätigen.

  4. Erstellen Sie Ihren ersten Proxy.

Onboarding prüfen

Überprüfen Sie nach Abschluss des Onboardings den Status des Systems, indem Sie Folgendes ausgeben: curl-Befehle auf dem Knoten des Verwaltungsservers:

  1. Prüfen Sie den Nutzer- und Organisationsstatus auf dem Verwaltungsserver, indem Sie Folgendes ausführen: 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/org_name/deployments
  2. Führen Sie den folgenden Befehl aus, um Analysen zu prüfen:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Prüfen Sie den PostgreSQL-Datenbankstatus, 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 in der Eingabeaufforderung den folgenden Befehl ein, um die Analysetabelle für Ihr Organisation:

    \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 Apigee Edge-Benutzeroberfläche zu. Denken Sie daran, dass Sie die die URL der Verwaltungskonsole am Ende der Installation.
    1. Starten Sie Ihren bevorzugten Browser und geben Sie die URL der Edge-Benutzeroberfläche ein. Sie sieht ähnlich aus wie die wobei die IP-Adresse für Node 1 steht (wie in den Installationstopologien) oder Knoten, auf dem Sie die Benutzeroberfläche für alternative Konfigurationen installiert:
      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-Benutzeroberfläche gehostet wird, kann eine URL im folgenden Format verwendet werden:

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

    Der Browser leitet zu http://192.168.56.111:9000/platform/#/org_name/ weiter und öffnet ein Dashboard, mit dem Sie die von Ihnen erstellte Organisation (falls Sie Apigee-Administratoranmeldedaten verwenden.

Ersten Proxy erstellen

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

Weitere hilfreiche Ressourcen: