Cette section couvre diverses opérations administratives, par exemple la création, la gestion et la suppression d'organisations, d'environnements et d'hôtes virtuels Apigee dans une installation Apigee Edge pour Private Cloud.
Pour en savoir plus sur les organisations, les environnements et les hôtes virtuels, consultez À propos des planètes, des régions, des pods, des organisations, des environnements et des hôtes virtuels.
Vérifier l'état des utilisateurs, de l'organisation et de l'environnement
Le serveur de gestion joue un rôle essentiel en rassemblant tous les autres composants dans une installation sur site d'Edge pour le cloud privé. Vous pouvez vérifier l'état des utilisateurs, des organisations et des déploiements sur le serveur de gestion en exécutant les commandes curl suivantes :
curl -u adminEmail:admin_passwd http://localhost:8080/v1/userscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments
Le système doit afficher un état HTTP 200 pour tous les appels. Si ces étapes échouent, procédez comme suit :
- Recherchez d'éventuelles erreurs dans les journaux du serveur de gestion à l'adresse
/opt/apigee/var/log/apigee/management-server. - Appelez le serveur de gestion pour vérifier qu'il fonctionne correctement.
- 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 prennent un fichier de configuration en entrée. Par exemple, vous transmettez 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 Intégrer une organisation.
À propos de la configuration d'un hôte virtuel
Sur Edge, un hôte virtuel définit les domaines et les ports EdgeRouter 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 le proxy d'API est accessible à 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 :
- Nom de l'hôte virtuel que vous utilisez pour le référencer dans vos proxys d'API.
- Port sur le routeur pour l'hôte virtuel. En général, ces ports commencent à 9001 et sont incrémentés de un pour chaque nouvel hôte virtuel.
- 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 Host de la requête entrante à la liste des alias d'hôte pour 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 qui correspond à 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.
Si vous disposez d'une entrée DNS pour l'hôte virtuel
Par exemple, si vous avez créé un hôte virtuel avec un alias d'hôte myapis.apigee.net sur le port 9001, une requête curl envoyée à une API via cet hôte virtuel peut se présenter comme suit :
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
Options lorsque vous n'avez pas d'entrée DNS pour l'hôte virtuel
Si vous ne disposez pas d'entrée DNS, vous pouvez définir l'alias d'hôte sur l'adresse IP du routeur et le port de l'hôte virtuel, comme routerIP:port. Exemple :
192.168.1.31:9001
Vous créez ensuite une commande curl sous la forme ci-dessous :
curl http://routerIP:9001/proxy-base-path/resource-path
Cette option est préférable, car elle fonctionne bien avec l'interface utilisateur Edge.
Si vous avez 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 cette ligne à /etc/hosts :
192.168.1.31 temp.hostalias.com
Vous pouvez ensuite effectuer une requête comme si vous disposiez d'une entrée DNS :
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path