Vous consultez la documentation Apigee Edge.
Accédez à la
documentation Apigee X. info
Les cibles hébergées vous permettent d'exécuter des applications Node.js dans un environnement d'exécution natif environnement hébergé par Apigee. L'objectif des cibles hébergées est simple : vous permettre de déployer applications dans un environnement natif, sécurisé, évolutif et isolé où les proxys d'API Edge peuvent les appeler en tant que services cibles.
Comme l'illustre la figure suivante, un proxy d'API Edge appelle une application Node.js qui est déployée dans l'environnement des cibles hébergées. Notez que l'environnement des cibles hébergées est limité à une organisation Apigee : environnement.
Pour qu'un proxy d'API Edge communique avec une application de cibles hébergées correctement créée et déployée , une configuration simple est nécessaire dans le point de terminaison cible du proxy. Pour commencer, consultez les tutoriels sur les cibles hébergées.
Quels environnements d'exécution d'application sont compatibles avec les cibles hébergées ?
Actuellement, vous ne pouvez déployer que des applications Node.js sur des cibles hébergées.
Installer des cibles hébergées
Les cibles hébergées sont disponibles dans toutes les organisations Edge Public Cloud. Vous n'avez rien à installer pour les utiliser.
Vérifier que les cibles hébergées sont activées
Si vous souhaitez vérifier que les cibles hébergées sont activées dans votre organisation, obtenez
les détails de votre organisation et assurez-vous que la propriété features.isEdgeFunctionsEnabled
est définie sur "true". La propriété est en lecture seule.
Exemple :
https://api.enterprise.apigee.com/v1/organizations/myorg
{ "createdAt":1507572884047, "createdBy":"jdoe@apigee.com", "displayName":"myorg", "environments":[ "prod", "dev", "test", "portal" ], "lastModifiedAt":1507578673194, "lastModifiedBy":"jdoe@apigee.com", "name":"jdoe", "properties":{ "property":[ { "name":"features.isSmbOrganization", "value":"false" }, { "name":"self.service.virtual.host.enabled", "value":"true" }, { "name":"features.isCpsEnabled", "value":"true" }, { "name":"features.isEdgeFunctionsEnabled", "value":"true" } ] }, "type":"paid" }
Ce que vous devez savoir sur les cibles hébergées
Les cibles hébergées permettent aux applications Node.js de s'exécuter dans un environnement natif qui ne dépend d'aucune technologie d'exécution spécifique à Apigee. Vous pouvez déboguer et tester votre application en local avant de la déployer, et être assuré que la version déployée fonctionnera exactement comme en local. Au moment du déploiement, vous pouvez choisir n'importe quelle version d'environnement d'exécution d'application pour exécuter votre application dans des cibles hébergées. Par exemple, vous pouvez choisir spécifiquement d'exécuter une application Node.js dans un environnement v8.10.0.
Limites
Pour connaître les limites d'utilisation des cibles hébergées, consultez la page Limites du produit Apigee limites.
Étapes de base à suivre
Si vous êtes familiarisé avec le développement de proxys Edge, vous n'avez besoin que de quelques étapes simples pour utiliser les cibles hébergées. En fait, vous créez, déployez et gérez des proxys Edge pour les cibles hébergées comme vous le faites pour n'importe quel autre proxy Apigee Edge.
Pour utiliser les cibles hébergées, vous devez effectuer les tâches suivantes. Les tutoriels expliquent chacune de ces tâches en détail.
- Développez et testez votre application Node.js en local.
- Créez un fichier manifeste dans le répertoire racine de votre projet d'application. Le manifeste est un fichier YAML qui spécifie les informations nécessaires pour créer et déployer l'application.
- Ajoutez votre application au proxy Edge en tant que type de ressource hébergée.
- Dans le point de terminaison cible du proxy, ajoutez une balise
<HostedTarget/>vide. Cette balise indique à Edge de déployer l'application Node.js dans l'environnement des cibles hébergées. Exemple :
<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
<PreFlow name="PreFlow">
<Request />
<Response />
</PreFlow>
<PostFlow name="PostFlow">
<Request />
<Response />
</PostFlow>
<Flows />
<HostedTarget />
</TargetEndpoint>Champ d'application des applications de cibles hébergées
Les applications de cibles hébergées sont limitées à une organisation-environnement Edge. Cette limitation est la même que pour n'importe quel proxy Edge.
Les applications de cibles hébergées peuvent-elles accéder aux données de proxy ?
Les applications de cibles hébergées n'ont actuellement pas accès à l'environnement d'exécution du proxy. Cela signifie que vous ne pouvez pas accéder directement aux variables de flux , aux caches et à d'autres entités à partir des applications de cibles hébergées.
Avec Node.js intégré (la compatibilité traditionnelle avec Node.js basée sur Trireme dans Edge), vous pouvez utiliser
apigee-access pour
accéder aux variables de flux et à d'autres entités dans Edge. Toutefois, les cibles hébergées ne sont pas
compatibles avec le module apigee-access pour les déploiements Node.js.
Consultez également la section
Est-il possible de contourner l'absence d'apigee-access ?
Migrer le code d'application existant vers des cibles hébergées
Il n'existe actuellement aucun chemin de migration automatisé d'une application Node.js intégrée traditionnelle basée sur Trireme vers des cibles hébergées. Toutefois, vous pouvez convertir manuellement le code d'application existant en cibles hébergées. Pour obtenir un exemple, consultez Migrer un proxy Node.js existant vers un proxy de cibles hébergées.