Intégrer une organisation

Edge pour Private Cloud version 4.16.05

Utilisez la commande setup-org pour effectuer le processus d'intégration. Vous devez exécuter la commande sur le nœud du serveur de gestion.

Dans le cadre du processus d'intégration, le script:

(Facultatif) crée un utilisateur pour en faire l'administrateur de l'organisation.

  • Crée l'organisation.
  • Ajoute l'utilisateur spécifié en tant qu'administrateur de l'organisation. L'utilisateur doit déjà exister. sinon le script génère une erreur.
  • Associe l'organisation à un pod. Par défaut, elle est associée à la "passerelle". pod.
  • Veuillez créer un environnement.
  • Créez un hôte virtuel pour l'environnement.
  • Associez l'environnement à tous les processeurs de messages.
  • Active les analyses.

Fichier de configuration silencieuse pour l'intégration

Transmettez un fichier de configuration à la commande setup-org. Appelez la commande "setup-org" et spécifiez l'option -f, y compris le chemin d'accès au fichier de configuration silencieuse:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f /tmp/configFile

La seule condition requise pour les installations silencieuses est que le fichier de configuration doit être accessible ou lisibles par le « apigee » utilisateur. Par exemple, placez-le dans le répertoire /tmp d'un nœud.

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse. Modifiez-le si nécessaire configuration requise:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com

# 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

# 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.

Remarques :

  • Pour VHOST_ALIAS, si vous déjà un enregistrement DNS que vous utiliserez pour accéder à l'hôte virtuel, spécifiez l'hôte et éventuellement le port, par exemple "myapi.example.com".

    Si vous ne disposez pas encore d'un enregistrement DNS, consultez la section Configuration d'un hôte virtuel pour plus d'informations.
  • Pour la configuration TLS/SSL, consultez la section Keystores et Truststores et Configuration de TLS/SSL pour Edge On Premises pour en savoir plus sur la création du fichier JAR et sur les autres aspects configuration TLS/SSL.

Intégration

  1. Installez apigee-provision sur le nœud du serveur de gestion:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision installer
  2. Exécutez la commande sur le nœud du serveur de gestion:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Le fichier de configuration doit être accessible ou lisibles par le « apigee » utilisateur. Par exemple, placez-le dans le répertoire /tmp .

Validation de l'intégration

À la fin de l'intégration, vérifiez l'état du système en émettant la CURL suivante : sur le nœud du serveur de gestion.

  1. Vérifiez l'état des utilisateurs et des organisations sur le serveur de gestion à l'aide de la commande suivante : Commandes CURL:
    &gt; curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    &gt; curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
    &gt; curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/&lt;orgname&gt;/deployments
  2. Si vous avez activé Analytics, utilisez cette commande:
    &gt; curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/&lt;orgname&gt;/environments/&lt;envname&gt;/provisioning/axstatus
  3. Vous pouvez également vérifier l'état de la base de données PostgreSQL en exécutant la commande suivante sur Machine 2 pour démarrer psql:
    &gt; psql -h /opt/apigee/var/run/apigee-postgresql - U Apigee apigee

    Dans l'invite de commande, saisissez la commande suivante pour afficher la table d'analyse de votre organisation:
    apigee=# : \d analytics."<nom de l'organisation>.prod.fact"

    Exécutez la commande suivante pour quitter psql:
    apigee=# \q
  4. Accédez à l'interface utilisateur d'Apigee Edge à l'aide d'un navigateur Web. N'oubliez pas que vous avez déjà noté l'URL de la console de gestion à la fin de l'installation.
    1. Lancez votre navigateur préféré et saisissez l'URL de l'interface utilisateur Edge. Il se présente comme ci-dessous, où l'adresse IP correspond à la machine 1 ou à toute machine que vous avez installée UI activée pour les autres configurations:
      http://192.168.56.111:9000/login

      9000 est le numéro de port utilisé par l'interface utilisateur. Si vous démarrez le navigateur directement hébergeant l'interface utilisateur Edge, vous pouvez utiliser une URL au format suivant:
      http://localhost:9000/login

      Remarque: Assurez-vous que le port 9000 est ouvert.
    2. Sur la page de connexion de la console, spécifiez le nom d'utilisateur et le mot de passe de l'administrateur système Apigee.
      Remarque: Il s'agit du mot de passe d'administrateur système global que vous avez défini pendant l'installation. Vous pouvez également procéder comme suit:
  5. Créez un compte utilisateur Apigee et connectez-vous à l'aide des identifiants du nouvel utilisateur.
    1. Cliquez sur "Connexion". Vous êtes redirigé vers la page suivante:
      http://192.168.56.111:9000/platform/#/<nom de l'organisation>/

      et ouvre un tableau de bord qui vous permet de configurer l'organisation créée auparavant (si connecté à l'aide des identifiants d'administrateur Apigee).
    2. Si vous débutez avec Edge, vous pouvez maintenant créer votre premier proxy d'API. Pour plus d'informations, consultez Créer votre premier proxy d'API.