Maintenance de l'organisation et de l'environnement

Cette section couvre diverses opérations d'administration, telles que la création, la gestion et la suppression d'organisations, d'environnements et d'hôtes virtuels Apigee dans une installation Apigee Edge for Private Cloud.

Pour une présentation des organisations, des environnements et des hôtes virtuels, consultez la section À propos des planètes, des régions, des pods, des organisations, des environnements et des hôtes virtuels.

Vérification de l'état des utilisateurs, de l'organisation et de l'environnement

Management Server joue un rôle essentiel pour réunir tous les autres composants dans une installation sur site d'un cloud privé périphérique. Vous pouvez vérifier l'état de l'utilisateur, de l'organisation et du déploiement 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://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

Le système doit afficher l'état HTTP 200 pour tous les appels. Si elles échouent, procédez comme suit:

  1. Recherchez d'éventuelles erreurs dans les journaux du serveur de gestion à l'adresse /opt/apigee/var/log/apigee/management-server.
  2. Appelez le serveur de gestion pour vérifier s'il fonctionne correctement.
  3. Supprimez le serveur de l'ELB, puis redémarrez le serveur de gestion : 
    /opt/apigee/bin/apigee-service management-server restart

À propos de l'utilisation des fichiers de configuration

Les commandes ci-dessous utilisent un fichier de configuration en entrée. Par exemple, vous pouvez transmettre un fichier de configuration à la commande setup-org pour définir toutes les propriétés de l'organisation, y compris l'environnement et l'hôte virtuel.

Pour obtenir un fichier de configuration complet et des informations sur les propriétés que vous pouvez définir dans le fichier de configuration, consultez la section Intégrer une organisation.

À propos de la configuration d'un hôte virtuel

Un hôte virtuel sur Edge définit les domaines et les ports du routeur Edge sur lesquels un proxy d'API est exposé et, par extension, l'URL que les applications utilisent pour accéder à un proxy d'API. Un hôte virtuel définit également si l'accès au proxy d'API est effectué à l'aide du protocole HTTP ou du protocole HTTPS chiffré.

Utilisez les scripts et les appels d'API ci-dessous pour créer un hôte virtuel. Lorsque vous créez l'hôte virtuel, vous devez spécifier les informations suivantes:

  • Le nom de l'hôte virtuel que vous utilisez pour le référencer dans vos proxys d'API.
  • Port sur le routeur de l'hôte virtuel. En règle générale, ces ports commencent à 9 001 et sont incrémentés d'une unité pour chaque nouvel hôte virtuel.
  • L'alias d'hôte de l'hôte virtuel. Il s'agit généralement du nom DNS de l'hôte virtuel.

    Le routeur Edge compare l'en-tête "Hôte" de la requête entrante à la liste des alias d'hôte afin de déterminer le proxy d'API qui gère la requête. Lorsque vous effectuez une requête via un hôte virtuel, spécifiez un nom de domaine correspondant à l'alias d'hôte d'un hôte virtuel, ou spécifiez l'adresse IP du routeur et l'en-tête d'hôte contenant l'alias d'hôte.

Par exemple, si vous avez créé un hôte virtuel avec un alias d'hôte de myapis.apigee.net sur le port 9001, exécutez une requête curl vers une API par l'intermédiaire de cet hôte virtuel peut utiliser l'une des formes suivantes:

  • Si vous avez une entrée DNS pour myapis.apigee.net : 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Si vous n'avez pas d'entrée DNS pour myapis.apigee.net : 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    Dans la deuxième forme, vous spécifiez l'adresse IP du routeur et transmettez l'alias d'hôte dans l'en-tête "Host".

Options disponibles lorsque vous ne disposez pas d'entrée DNS pour l'hôte virtuel

En l'absence d'entrée DNS, une option consiste à définir l'alias d'hôte sur l'adresse IP du routeur et le port de l'hôte virtuel, en tant que routerIP:port. Exemple :

192.168.1.31:9001

Exécutez ensuite une commande curl au format suivant:

curl http://routerIP:9001/proxy-base-path/resource-path

Cette option est à privilégier car elle fonctionne bien avec l'interface utilisateur Edge.

Si vous disposez de plusieurs routeurs, ajoutez un alias d'hôte pour chacun d'eux, en spécifiant l'adresse IP de chaque routeur et le port de l'hôte virtuel.

Vous pouvez également définir l'alias d'hôte sur une valeur, telle que temp.hostalias.com. Vous devez ensuite transmettre l'en-tête Host à chaque requête:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

Vous pouvez également ajouter l'alias d'hôte à votre fichier /etc/hosts. Par exemple, ajoutez la ligne suivante à /etc/hosts:

192.168.1.31   temp.hostalias.com

Vous pouvez ensuite effectuer une requête comme si vous aviez une entrée DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path