Intégrer une organisation

Edge pour Private Cloud version 4.16.05

Exécutez le processus d'intégration à l'aide de la commande setup-org. 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) Il crée un utilisateur qui jouera le rôle d'administrateur de l'organisation.

  • Crée l'organisation.
  • Ajoute l'utilisateur spécifié en tant qu'administrateur de l'organisation. Si l'utilisateur existe déjà, le script génère une erreur.
  • Associe l'organisation à un pod. Par défaut, elle l'associe au pod de la "passerelle".
  • Veuillez créer un environnement.
  • Créez un hôte virtuel pour l'environnement.
  • Associer l'environnement à tous les processeurs de messages
  • Active l'analyse.

Fichier de configuration silencieux pour l'intégration

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

> /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 soit accessible ou lisible par l'utilisateur "apigee". Par exemple, placez le fichier dans le répertoire /tmp du nœud.

Vous trouverez ci-dessous un exemple de fichier de configuration silencieuse. Modifiez-le selon vos besoins:

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 disposez déjà d'un enregistrement DNS que vous utiliserez pour accéder à l'hôte virtuel, spécifiez l'alias d'hôte et éventuellement le port, par exemple "myapi.example.com".

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

Intégration

  1. Installez apigee-provision sur le nœud Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  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 lisible par l'utilisateur "apigee". Par exemple, placez le fichier dans le répertoire /tmp du nœud.

Validation de l'intégration

Une fois l'intégration terminée, vérifiez l'état du système en exécutant les commandes CURL suivantes 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 des commandes CURL suivantes :
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://organization:8080/v1/organizations> http://organization:8080/v1/organizations>http://organization:8080/v1/organizations>http://organization:8080/v1/organizations>
    < curl/localhost/adminEmails<wd:
  2. Si vous avez activé Analytics, utilisez la commande suivante:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provision/axstatus
  3. Vous pouvez également vérifier l'état de la base de données PostgreSQL en exécutant la commande suivante sur la machine 2 pour démarrer psql :
    > 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=# : \factd" analytics.


  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. Elle se présente comme suit, où l'adresse IP correspond à la machine 1 ou à celle sur laquelle vous avez installé l'UI pour d'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 sur le serveur 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 à la console, indiquez le nom d'utilisateur/mot de passe de l'administrateur système Apigee.
      Remarque: Il s'agit du mot de passe de l'administrateur système global que vous avez défini lors de l'installation. Vous pouvez également:
  5. Créez un compte utilisateur Apigee et utilisez les nouveaux identifiants pour vous connecter.
    1. Cliquez sur "Se connecter", le navigateur redirige vers:
      http://192.168.56.111:9000/platform/#/<orgname>/

      et ouvre un tableau de bord qui vous permet de configurer l'organisation créée auparavant (si vous êtes 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 en savoir plus, consultez Créer votre premier proxy d'API.