Edge pour Private Cloud version 4.17.09
Cette section couvre diverses opérations d'administration, telles que la création, la gestion et Suppression des organisations, des environnements et des hôtes virtuels Apigee dans un environnement Apigee Edge for Private l'installation dans le cloud.
Pour une introduction aux organisations, aux environnements et aux hôtes virtuels, voir À propos des planètes, Régions, pods, organisations, environnements et hôtes virtuels.
Vérifier l'état des utilisateurs, de l'organisation et environnement
Le serveur de gestion joue un rôle essentiel dans la centralisation de tous les autres composants au sein d'une l'installation sur site du cloud privé Edge. Vous pouvez vérifier les comptes utilisateur, organisation le statut du déploiement sur le serveur de gestion en émettant les 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. En cas d'échec, procédez comme suit:
- Consultez les journaux du serveur de gestion sur /opt/apigee/var/log/apigee/management-server pour en cas d'erreur.
- Effectuer un appel au serveur de gestion pour vérifier s'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 présentées ci-dessous utilisent un fichier de configuration en entrée. Par exemple, vous transmettez un fichier de configuration Utiliser 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 l'API , consultez 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 de routeur Edge sur lesquels un proxy d'API est exposées et, par extension, l'URL que les applications utilisent pour accéder à un proxy d'API. Un hôte virtuel permet également Définit si l'accès au proxy d'API est effectué à l'aide du protocole HTTP ou par le protocole HTTPS standard.
Utilisez les scripts et les appels d'API présentés ci-dessous pour créer un hôte virtuel. Lorsque vous créez le 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 votre API proxys.
- Port sur le routeur pour l'hôte virtuel. Généralement, ces ports démarrent à 9001 et incrémenter 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'instance
hôte.
Le routeur Edge compare l'en-tête Host de la requête entrante à la liste des alias d'hôte comme de la détermination du proxy d'API qui gère la requête. Lorsque vous envoyez une demande via un l'hôte virtuel, vous pouvez soit spécifier un nom de domaine correspondant à l'alias d'hôte d'un hôte virtuel, soit spécifier 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 l'alias d'hôte myapis.apigee.net sur le port 9001, puis une requête cURL adressée à une API via cet hôte virtuel peuvent utiliser l'une des formes suivantes:
- Si vous disposez d'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 au En-tête "Host".
Remarque : La commande curl, la plupart des navigateurs et de nombreux autres utilitaires ajoutent automatiquement l'en-tête "Host" avec le domaine dans la requête. Vous pouvez donc utiliser une commande curl sous la forme :
curl http://<routerIP>: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, sous la forme <routerIP>:port. Exemple :
192.168.1.31:9001
Lorsque vous créez une commande curl au format ci-dessous:
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 avez plusieurs routeurs, ajoutez un alias d'hôte pour chacun d'eux, en spécifiant l'adresse IP de chaque routeur et chaque 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 envoyer une requête comme si vous aviez une entrée DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}