Cette page s'applique à Apigee et à Apigee hybrid.
Consultez la documentation d'Apigee Edge.
L'émulateur Apigee est une image Docker personnalisée fournie publiquement aux développeurs afin qu'ils puissent déployer et tester des proxys d'API dans un environnement de développement local. Les images Docker sont publiées régulièrement en gcr.
Lorsque vous êtes prêt à déployer et à tester votre premier proxy d'API, vous devez utiliser la section des émulateurs pour afficher et gérer les versions de votre émulateur et le cycle de vie des émulateurs configurés.
Cette section vous permet d'effectuer les opérations suivantes :
Afficher les différentes versions des émulateurs installées et les conteneurs créés pour chaque version de l'émulateur, y compris ses informations d'exécution et Docker, ainsi que les ports de contrôle et de trafic
Ajoutez, supprimez, démarrez, arrêtez, réinitialisez, mettez à jour et actualisez l'affichage des conteneurs de l'émulateur Apigee, comme décrit dans la section Gérer l'émulateur Apigee
Affichez les applications actuellement déployées (consultez la section Déployer des environnements).
Consultez les ressources de test actives (consultez la page Exporter des ressources de test vers l'émulateur Apigee).
Gérer l'émulateur Apigee
Gérez l'émulateur Apigee comme décrit dans les sections suivantes. Voir aussi Explorer l'émulateur Apigee.
Choisir la version de l'émulateur
Par défaut, la vue de l'émulateur affiche une version stable. Cependant, il est facile de choisir une autre version en fonction de vos besoins.
Affichez une liste des versions de l'émulateur Apigee à l'aide de l'une des méthodes suivantes et notez la valeur de Tag :
- Utilisez Google Container Registry à l'adresse suivante : https://gcr.io/apigee-release/hybrid/apigee-emulator.
- Utilisez Docker Hub à l'adresse suivante : https://registry.hub.docker.com/r/google/apigee-emulator/tags.
Pour ajouter une version de l'émulateur Apigee à l'extension Cloud Code, cliquez sur
Gérer > Paramètres puis recherchezapigee emulators
.Cliquez sur Ajouter un élément.
Saisissez la valeur du Tag obtenue à l'étape 1. Par exemple,
1.10.0
ougoogle/apigee-emulator:1.10.0
.Cliquez sur OK.
Le nouvel émulateur s'affiche alors dans sa vue.
Installer l'émulateur Apigee
Pour installer l'émulateur Apigee, procédez comme suit :
Développez l'élément émulateurs sous Développement local pour afficher les émulateurs répertoriés ici.
Placez le curseur sur la version de l'émulateur Apigee que vous souhaitez installer.
Cliquez sur .
Vous êtes invité à configurer le conteneur de l'émulateur Apigee.
Saisissez un nom unique pour le conteneur de l'émulateur Apigee et appuyez sur Entrée. Saisissez des caractères alphanumériques, des tirets (-) ou des traits de soulignement (_).
Saisissez une valeur numérique unique à utiliser comme port de contrôle pour le conteneur de l'émulateur Apigee, puis appuyez sur Entrée. Le port de contrôle est défini par défaut sur
8080
.Saisissez une valeur numérique unique à utiliser comme port de trafic pour le conteneur de l'émulateur Apigee, puis appuyez sur Entrée. Le port de trafic par défaut est
8998
.
La dernière image de la version de l'émulateur Apigee sélectionnée est installée. Une fois l'installation terminée, le message suivant s'affiche, Emulator installed successfully
, et l'état du conteneur de l'émulateur Apigee devient Ready (Prêt).
Ajouter un conteneur pour l'émulateur Apigee
Pour ajouter un conteneur pour l'émulateur Apigee à l'aide de l'interface utilisateur, procédez comme suit :
Développez la section émulateurs sous Développement local.
Placez le curseur sur l'émulateur Apigee pour lequel vous souhaitez ajouter un conteneur.
Cliquez sur +. Vous êtes invité à configurer le conteneur.
Saisissez la valeur numérique à utiliser comme port de contrôle pour le conteneur de l'émulateur Apigee, puis appuyez sur Entrée. Le port de contrôle doit être unique pour tous les conteneurs. Sa valeur par défaut est
8080
.Saisissez la valeur numérique à utiliser comme port de trafic pour le conteneur de l'émulateur Apigee, puis appuyez sur Entrée. Le port de trafic doit être unique pour tous les conteneurs. Sa valeur par défaut est
8998
.Saisissez un nom unique pour le conteneur de l'émulateur Apigee et appuyez sur Entrée. Saisissez des caractères alphanumériques, des tirets (-) ou des traits de soulignement (_).
Le conteneur est ajouté.
Afficher les informations d'état pour l'émulateur Apigee
Affichez les informations d'état de l'émulateur Apigee comme décrit dans les sections suivantes.
Utiliser l'UI
Pour afficher les informations d'état de l'émulateur Apigee, y compris ses informations Docker et d'exécution, développez le conteneur dans la section Émulateurs Apigee. Les informations que vous voyez correspondent à la version de l'émulateur Apigee utilisée.
Utiliser la CLI Docker
Pour afficher les informations sur l'état du conteneur pour l'émulateur Apigee et ses ports configurés, exécutez docker ps
dans l'onglet Terminal. Voici un exemple de réponse. La réponse réelle dépend de la version de l'émulateur Apigee utilisée :
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 33756b8c5c5b ...apigee-emulator:1.11.0 "/usr/bin…" 10 hours ago Up 10 hours 7000-7001/tcp, 0.0.0.0:8080->8080/tcp... apigee-emulator
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Démarrer l'émulateur Apigee
Gérez l'émulateur Apigee comme décrit dans les sections suivantes.
Utiliser l'UI
Pour démarrer l'émulateur Apigee, placez votre curseur sur le conteneur de l'émulateur Apigee que vous souhaitez démarrer et cliquez sur .
Utiliser la CLI Docker
Pour démarrer l'émulateur Apigee, exécutez docker start apigee-emulator
dans l'onglet Terminal.
L'état est Ready
:
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Réinitialiser l'émulateur Apigee
Réinitialisez l'émulateur Apigee pour supprimer tous les déploiements et les ressources de test exportées, comme décrit dans les sections suivantes.
Utiliser l'UI
Pour réinitialiser l'émulateur Apigee, placez votre curseur sur le conteneur d'émulateur Apigee dans la section Émulateurs Apigee et cliquez sur .
L'émulateur Apigee est réinitialisé et l'état est défini sur Ready
:
L'onglet Résultat affiche les informations suivantes :
Resetting the Apigee Emulator Reset completed
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Redémarrer l'émulateur Apigee
Pour redémarrer l'émulateur Apigee, exécutez docker restart container-name
dans l'onglet Terminal.
Par exemple : docker restart MyContainer
.
Voici un exemple de réponse :MyContainer
Mettre à jour l'émulateur Apigee
Si l'émulateur Apigee n'est pas synchronisé avec la dernière version, vous pouvez mettre à jour votre version installée à l'aide de l'interface utilisateur ou de la CLI Docker, comme décrit dans les sections suivantes.
Utiliser l'UI
Pour mettre à jour l'émulateur Apigee, placez votre curseur sur l'émulateur Apigee dans la section Émulateurs Apigee et cliquez sur .
Utiliser la CLI Docker
Pour mettre à jour l'émulateur Apigee, exécutez les commandes Docker suivantes dans l'onglet Terminal en utilisant la dernière version appropriée :
Exécutez
docker ps
pour obtenir le nom de l'image. Exemple :gcr.io/apigee-release/hybrid/apigee-emulator:Emulator version
Exécutez
docker pull imagename
pour mettre à jour l'image d'installation de l'émulateur Apigee. Exemple :docker pull gcr.io/apigee-release/hybrid/apigee-emulator:Emulator version
L'émulateur Apigee est mis à jour et le message suivant s'affiche : Emulator version is up to date
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Arrêter l'émulateur Apigee
Arrêtez l'émulateur Apigee à l'aide de l'interface utilisateur ou de la CLI Docker, comme décrit dans les sections suivantes.
Utiliser l'UI
Pour arrêter l'émulateur Apigee, placez votre curseur sur le conteneur de l'émulateur Apigee dans la section Émulateurs Apigee, puis cliquez sur .
Utiliser la CLI Docker
Pour arrêter l'émulateur Apigee, exécutez docker stop apigee-emulator
dans l'onglet Terminal.
L'émulateur Apigee est arrêté et l'état passe à Not running
:
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Supprimer un conteneur pour l'émulateur Apigee
Supprimez un conteneur pour l'émulateur Apigee à l'aide de l'interface utilisateur ou de la CL Docker, comme décrit dans les sections suivantes.
Utiliser l'UI
Pour supprimer l'émulateur Apigee, placez votre curseur sur le conteneur de l'émulateur Apigee dans la section Émulateurs Apigee et cliquez sur .
Utiliser la CLI Docker
Pour supprimer un conteneur de l'émulateur Apigee, exécutez les commandes Docker suivantes dans l'onglet Terminal :
Exécutez
docker stop container
pour arrêter l'image d'installation de l'émulateur Apigee (si elle n'est pas déjà arrêtée). Par exemple :docker stop MyContainer
Exécutez
docker rm container
pour arrêter l'image d'installation de l'émulateur Apigee. Par exemple :docker rm MyContainer
Le conteneur est supprimé.
Consultez également la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Personnaliser le conteneur Docker de l'environnement d'exécution Apigee
Vous pouvez personnaliser la ligne de commande Docker utilisée pour contrôler les instances de l'émulateur Apigee à l'aide des options suivantes.
Option | Description |
---|---|
additionalArguments |
Ajoute un ou plusieurs arguments. Les arguments sont ajoutés à la commande docker run exactement tels qu'ils sont fournis. La valeur par défaut est "" (aucun). |
detached |
Détermine si l'option --detached est utilisée lors de l'exécution du conteneur. La valeur par défaut est true . |
dns |
Détermine l'option -dns du service DNS, comme décrit dans la section Services DNS. La valeur par défaut est 8.8.8.8 . |
environmentVariables |
Ajoute des variables d'environnement à la commande docker run , comme décrit dans la section Options. Les valeurs, si elles sont fournies, sont ajoutées à la commande docker run à l'aide de -e . La liste par défaut inclut "XTERM": "xterm-256color" .
|
labels |
Ajoute un ou plusieurs libellés à associer au conteneur. Les libellés sont ajoutés à la commande docker run à l'aide de -l . La valeur par défaut est none . |
privileged |
Détermine si l'option --privileged est utilisée lors de l'exécution du conteneur. La valeur par défaut est true . |
volumes |
Ajoute un ou plusieurs volumes à installer sur le conteneur. Les volumes sont ajoutés à la commande docker run à l'aide de -v . La valeur par défaut est none . |
Pour personnaliser le conteneur Docker de l'environnement d'exécution Apigee, procédez comme suit :
Cette fonctionnalité est disponible dans la version Insiders (v1.21.0 et versions ultérieures). Installez la version Insiders, comme décrit dans la section Installer des versions Insiders.
Cliquez sur
Gérer > Paramètres, puis recherchezapigee docker
.Sous Cloudcode > Apigee : Options Docker, cliquez sur Modifier dans settings.json. Les options personnalisables sont affichées dans le fichier
settings.json
, comme indiqué ci-dessous :"cloudcode.apigee.dockerOptions": { "environmentVariables": { "XTERM": "xterm-256-color" }, "dns": "8.8.8.8", "detached": true "privileged": true, "labels": {}, "volumes": {}, "additionalArguments":"" }
Modifiez les options si nécessaire, puis enregistrez le fichier.
Personnaliser l'émulateur Apigee pour prendre en charge l'authentification basée sur un compte de service
Lors du test des proxys qui dépendent de l'authentification basée sur le compte de service Google Cloud, l'émulateur Apigee doit accéder à la clé de compte de service Google. Suivez les étapes pour configurer votre émulateur Apigee pour qu'il soit compatible avec l'authentification basée sur un compte de service.
Créer et télécharger la clé du compte de service
Créez un compte de service Google Cloud avec le rôle Créateur de jetons du compte de service, qui est la condition de l'émulateur Apigee pour accepter les comptes de service. Créez une clé pour le compte de service, comme décrit dans la section Créer une clé de compte de service.
Téléchargez la clé sur le système de fichiers local afin qu'elle puisse être fournie à l'émulateur Apigee.
Configurer l'émulateur Apigee
Pour configurer les paramètres de l'émulateur Apigee, procédez comme suit :
Ouvrez les options Docker, comme décrit dans la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Dans la section
volumes
des options Docker, ajoutez un volume afin que le chemin d'accès de la clé du compte de service téléchargé puisse être mis à disposition dans le conteneur. En supposant que la clé a été téléchargée dans le chemin d'accès/opt/apigee/keys/apigee-sa-key.json
, le paramètre suivant permet d'installer le contenu de/opt/apigee/keys
dans le chemin d'accès/emulator/keys
au sein du conteneur :"volumes": { "/opt/apigee/keys":"/emulator/keys" }
Dans la section
environmentVariables
des options Docker, ajoutez la variableGOOGLE_APPLICATION_CREDENTIALS
qui pointe vers le fichier dans le chemin installé :"environmentVariables": { "GOOGLE_APPLICATION_CREDENTIALS":"/emulator/keys/apigee-sa-key.json" }
Enregistrez les paramètres et créez une instance de conteneur que vous pourrez utiliser pour les tests.
L'exemple suivant montre comment associer une clé de compte de service Google à l'émulateur Apigee.
"cloudcode.apigee.dockerOptions": {
"environmentVariables": {
"XTERM": "xterm-256-color",
"GOOGLE_APPLICATION_CREDENTIALS":"/emulator/keys/apigee-sa-key.json"
},
"dns": "8.8.8.8",
"detached": true
"privileged": true,
"labels": {},
"volumes": {
"/opt/apigee/keys":"/emulator/keys"
},
"additionalArguments":""
}
Configurer l'émulateur Apigee pour prendre en charge le proxy de transfert HTTP
Souvent, les cibles de backend associées à un proxy ne sont accessibles qu'à l'aide d'un proxy de transfert HTTP. L'émulateur Apigee peut être configuré pour utiliser le proxy de transfert tout en se connectant à des cibles à l'aide d'une variable d'environnement nommée FORWARD_PROXY
.
Pour configurer les paramètres de l'émulateur Apigee, procédez comme suit :
Ouvrez les options Docker, comme décrit dans la section Personnaliser le conteneur Docker de l'environnement d'exécution Apigee.
Dans la section
environmentVariables
des options Docker, ajoutez la variableFORWARD_PROXY
qui pointe vers l'adresse du proxy de transfert en tant qu'URL HTTP."environmentVariables": { "FORWARD_PROXY":"http://proxy_host:proxy_port" }
Enregistrez les paramètres et créez une instance de conteneur à des fins de test.