Intégrer une organisation

Pour intégrer une organisation, vous devez créer un fichier de configuration d'intégration, puis le transmettre à la commande setup-org. Chacune de ces étapes est décrite dans les sections suivre.

Pour en savoir plus sur l'utilisation de l'API de gestion pour intégrer une organisation, consultez Créer une organisation et l'hôte virtuel.

Créer un fichier de configuration d'intégration

Cette section inclut un exemple de fichier de configuration permettant d'intégrer une organisation setup-org

Copiez l'exemple suivant et modifiez-le si nécessaire pour votre 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.

Remarque:

  • 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 n'avez pas encore de DNS vous pouvez utiliser l'adresse IP du routeur.

    Pour plus d'informations sur la configuration de l'hôte virtuel, voir Paramètre configurer un hôte virtuel.

  • Pour la configuration TLS/SSL, consultez la section Keystores et Truststores et Configurer Accès TLS à une API pour le cloud privé pour en savoir plus sur la création du fichier JAR et d'autres aspects de la configuration de TLS/SSL.
  • Pour plus d'informations sur la configuration d'hôtes virtuels, consultez la section Configuration de l'accès TLS à un pour le cloud privé.
  • Vous ne pouvez pas créer deux organisations portant le même nom. Dans ce cas, la deuxième création échouer.

Exécuter setup-org

Après avoir créé le fichier de configuration d'intégration, transmettez-le à setup-org pour effectuer le processus d'intégration. Vous devez exécuter le script sur le serveur de gestion. d'un nœud.

Lors de l'intégration d'une organisation, le script setup-org effectue les opérations suivantes:

  • Crée une organisation.
  • Crée un environnement.
  • Crée un hôte virtuel pour l'environnement.
  • Définit l'utilisateur spécifié en tant qu'administrateur de l'organisation. Remarques: <ph type="x-smartling-placeholder">
      </ph>
    • Vous pouvez utiliser un compte utilisateur existant ou en créer un pour l'administrateur de l'organisation.
    • L'administrateur de l'organisation ne doit pas être l'administrateur système.
  • Associe l'organisation à la "passerelle" pod. Il s'agit du paramètre par défaut changed.)
  • Associe l'environnement à tous les processeurs de messages.
  • Active les analyses.

Pour exécuter setup-org:

  1. Installez apigee-provision sur le nœud du serveur de gestion: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Exécutez le script setup-org sur le nœud du serveur de gestion et faites-le pointer vers le que vous avez créé à l'étape Créer une configuration d'intégration fichier: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Le fichier de configuration doit être lisible par "apigee" utilisateur.

  3. Vérifiez que vous avez bien intégré une organisation. Une façon de le faire consiste à consigner à l'interface utilisateur en demandant l'URL suivante dans un navigateur: 
    http://IP_address:9000/login

    Où IP_address est l'adresse IP du serveur sur lequel vous avez installé Edge. UI.

    Pour connaître les étapes de validation supplémentaires, consultez Valider l'intégration.

  4. Créez votre premier proxy !

Vérifier l'intégration

À l'issue de l'intégration, vérifiez l'état du système en envoyant le code suivant : Commandes curl sur le nœud du serveur de gestion:

  1. Vérifiez l'état des utilisateurs et des organisations sur le serveur de gestion en exécutant la commande suivante : commandes: 
    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. Vérifiez les données analytiques en exécutant la commande suivante: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Vérifiez l'état de la base de données PostgreSQL en exécutant les commandes suivantes sur le nœud 2 (comme indiqué dans les topologies d'installation): 
    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:

    \d analytics."org_name.env_name.fact"

    Exécutez la commande suivante pour quitter psql:

    \q
  4. Accédez à l'interface utilisateur d'Apigee Edge à l'aide d'un navigateur Web. Rappelez-vous que vous avez déjà noté de la console de gestion Google Cloud à 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 au nœud 1 (comme indiqué dans topologies d'installation), ou quel que soit le nœud sur lequel installé l'interface utilisateur 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 peut utiliser une URL au format suivant: 

      http://localhost:9000/login
    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.
  5. Créez un compte utilisateur Apigee et connectez-vous à l'aide des identifiants du nouvel utilisateur. Le de la console Google Cloud, cliquez sur le bouton Connexion.

    Le navigateur redirige vers http://192.168.56.111:9000/platform/#/org_name/ et ouvre un tableau de bord qui vous permet de configurer l'organisation que vous avez créée (si vous avez enregistré à l'aide des identifiants d'administrateur Apigee).

Créer votre premier proxy

Après avoir intégré une nouvelle organisation et vérifié que le processus d'intégration était vous pouvez créer votre premier proxy. Pour en savoir plus, consultez Créer votre premier proxy d'API.

Voici d'autres ressources qui pourraient vous être utiles: