Cette page a été traduite par l'API Cloud Translation.

Intégrer une organisation

Edge pour Private Cloud version 4.17.01

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:

Crée l'organisation.
Définit l'utilisateur spécifié en tant qu'administrateur de l'organisation.
- Cet utilisateur doit être différent de l'administrateur système. Autrement dit, n'utilisez pas la commande en tant qu'administrateur de l'entreprise.
- Vous pouvez spécifier un utilisateur existant pour l'administrateur de l'organisation ou configurer le script pour créer un utilisateur.
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 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 silencieuse:

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

La seule condition requise pour les installations silencieuses est que le fichier de configuration doit être accessible ou lisibles par le « apigee » utilisateur.

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 sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # 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
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

# 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 mais que vous avez un enregistrement DNS, vous pouvez utiliser l'adresse IP du routeur.

Pour en savoir plus sur la configuration de l'hôte virtuel, consultez les exigences d'installation de la démo Edge.
Pour la configuration TLS/SSL, consultez la section Keystores et Truststores et Configurer l'accès TLS à pour le cloud privé pour en savoir plus sur la création du fichier JAR et sur d'autres aspects de configuration TLS/SSL.

Procédure d'intégration

Installez apigee-provision sur le nœud du serveur de gestion:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision installer
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.

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.

Vérifiez l'état des utilisateurs et des organisations sur le serveur de gestion à l'aide de la commande suivante : Commandes CURL:
> 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/<orgname>/deployments
Si vous avez activé Analytics, utilisez cette commande:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
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:
> 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
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:
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.
  
  Consultez également les sections sur les exemples, y compris la liste d'exemples et la cible fictive. API RESTful que vous pouvez utiliser dans vos propres tests de création d'API dans l'API cible fictive.