Présentation des cibles hébergées

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur 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 l'illustre la figure suivante, un proxy d'API Edge appelle une application Node.js qui est déployé dans l'environnement Hosted Cibles. Notez que le champ d'application de l'environnement de cibles hébergées au sein d'un environnement "organisation:environnement" Apigee.

Obtenir un proxy d'API Edge pour communiquer avec une application de cibles hébergées correctement créée et déployée nécessite une configuration simple dans le point de terminaison cible du proxy. Pour commencer, accédez aux 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 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 pas besoin d'installer pour utiliser des cibles hébergées.

Vérifier que les cibles hébergées sont activées

Si vous souhaitez vérifier que votre organisation a Cibles hébergées activées, get les informations concernant votre organisation et assurez-vous que 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 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 l'application en local avant de la déployer, et soyez assuré que la version déployée fonctionnera exactement que localement. Au moment du déploiement, vous pouvez choisir n'importe quelle version d'exécution de l'application votre application dans des cibles hébergées. Par exemple, vous pouvez choisir de exécuter une application Node.js dans un environnement v8.10.0.

Limites

Pour connaître les limites d'utilisation sur les cibles hébergées, consultez la page Produit Apigee limites.

Procédure de base

Si vous connaissez bien le développement de proxys Edge, il vous suffit de suivre quelques étapes simples pour utiliser correctement les cibles hébergées. En bref, vous créez, déployez et gérez des proxys Edge pour les cibles hébergées comme vous le feriez pour tout autre proxy Apigee Edge.

Pour utiliser des cibles hébergées, vous devez effectuer les tâches suivantes. Tutoriels de chacune de ces tâches en détail.

• Développez et testez votre application Node.js en local.
• créer un fichier manifeste ; dans le répertoire racine de votre projet d'application. Le fichier manifeste est un fichier YAML nécessaires pour créer et déployer l'application.
• Ajoutez votre application au proxy Edge en tant que Une ressource hébergée de mots clés.
• 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 applications Cibles hébergées

Les applications de cibles hébergées sont limitées à un environnement d'organisation Edge. Ce champ d'application comme pour tout proxy Edge.

Les applications cibles hébergées peuvent-elles accéder aux données du proxy ?

Les applications utilisant des cibles hébergées ne ont actuellement accès à l'environnement d'exécution du proxy. Cela signifie que vous ne pouvez pas accéder au flux des variables, des caches et d'autres entités directement à partir d'applications de cibles hébergées.

Avec Node.js intégré (la prise en charge traditionnelle de Node.js basée sur Trireme dans Edge), vous pouvez utiliser apigee-access sur accéder aux variables de flux et à d'autres entités dans Edge. Toutefois, les cibles hébergées Compatibilité avec le module apigee-access pour les déploiements Node.js. Voir aussi 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 processus de migration automatisé à partir d'une méthode traditionnelle 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. Par exemple, consultez la page Migration un proxy Node.js existant vers un proxy de cibles hébergées.