Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Les cibles hébergées vous permettent d'exécuter des applications Node.js dans un environnement d'exécution natif hébergé par Apigee. L'objectif des cibles hébergées est simple: vous permettre de déployer des 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 le montre la figure suivante, un proxy d'API Edge appelle une application Node.js qui est déployée dans l'environnement de cibles hébergées. Notez que l'environnement de cibles hébergées s'applique à un environnement Apigee (organization:environment).
Pour qu'un proxy d'API Edge communique avec une application de cibles hébergées correctement créée et déployée, le point de terminaison cible du proxy nécessite une configuration simple. Pour commencer, accédez aux tutoriels sur les cibles hébergées.
Quels sont les environnements d'exécution d'application compatibles avec les cibles hébergées ?
Actuellement, vous ne pouvez déployer des applications Node.js que 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 utiliser les cibles hébergées.
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 pour votre organisation, obtenez des informations sur votre organisation et assurez-vous que la propriété features.isEdgeFunctionsEnabled est définie sur "true". L'établissement 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 qu'il faut 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 localement avant de la déployer. Vous avez ainsi la certitude que la version déployée fonctionnera exactement comme elle le fait localement. Au moment du déploiement, vous pouvez choisir n'importe quelle version d'exécution de l'application pour l'exécuter 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.
Étapes de base à suivre
Si vous êtes familiarisé avec le développement de proxys Edge, il vous suffit de suivre quelques étapes simples pour utiliser correctement les cibles hébergées. En gros, vous créez, déployez et gérez des proxys Edge pour les cibles hébergées, comme vous le faites pour tout autre proxy Apigee Edge.
Pour utiliser les cibles hébergées, vous devez effectuer les tâches suivantes. Les tutoriels présentent 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 fichier manifeste est un fichier YAML qui spécifie les informations nécessaires à la création et au déploiement de 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 un tag
<HostedTarget/>vide. Ce tag indique à Edge de déployer l'application Node.js dans l'environnement de cibles hébergées. Par 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 cibles hébergées
Les applications Cibles hébergées sont limitées à un environnement d'organisation Edge. Ce champ d'application est le même que pour tout proxy de périphérie.
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 aux variables de flux, aux caches et à d'autres entités directement à partir des applications de cibles hébergées.
Avec l'intégration de Node.js (la compatibilité traditionnelle de 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.
Voir également Est-il possible de contourner le manque d'accès Apigee ?
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 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 la section Migrer un proxy Node.js existant vers un proxy de cibles hébergées.