Panoramica dei target ospitati

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

Le destinazioni ospitate ti consentono di eseguire applicazioni Node.js in un runtime nativo ospitato da Apigee. L'obiettivo degli Hosted Destinazioni è semplice: consentirti di implementare in un ambiente nativo, sicuro, scalabile e isolato in cui i proxy API Edge possono chiamarle come servizi di destinazione.

Come illustrato nella figura seguente, un proxy API Edge chiama un'applicazione Node.js, di cui è stato eseguito il deployment nell'ambiente Destinazioni ospitate. Tieni presente che l'ambito dell'ambiente Destinazioni ospitate all'interno di un ambiente Apigee.

Ottieni un proxy API Edge per comunicare con un'applicazione target ospitati sia stata creata e di cui è stato eseguito il deployment richiede una semplice configurazione nell'endpoint di destinazione del proxy. Per iniziare, vai ai tutorial sui target ospitati.

Quali runtime dell'applicazione sono supportati dagli target ospitati?

Al momento, puoi eseguire il deployment di app Node.js solo per le destinazioni ospitate.

Installazione di target ospitati

I target ospitati sono disponibili in tutte le organizzazioni Edge Public Cloud. Non è necessario installare nulla al fine di utilizzare i target ospitati.

Attivazione della verifica dei target ospitati

Per verificare che la tua organizzazione abbia Obiettivi ospitati attivati, gettua i dettagli dell'organizzazione e assicurati che features.isEdgeFunctionsEnabled sia impostata su true. La proprietà è di sola lettura.

Ad esempio:

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"
  }
  

Cosa devi sapere sugli target ospitati

Hosted Destinazioni consente l'esecuzione delle applicazioni Node.js in un ambiente nativo che non dipende da alcuna tecnologia di runtime specifica di Apigee. Puoi eseguire il debug e il test in locale prima di eseguirne il deployment. Avrai la certezza che la versione di cui è stato eseguito il deployment funzionerà esattamente rispetto a quella locale. Al momento del deployment, puoi scegliere qualsiasi versione del runtime dell'applicazione che eseguono l'applicazione in Destinazioni ospitate. Ad esempio, potresti decidere di eseguire un'app Node.js in un ambiente v8.10.0.

Limiti

Per i limiti di utilizzo per gli obiettivi ospitati, consulta il prodotto Apigee limiti.

Passaggi di base da seguire

Se hai familiarità con lo sviluppo di proxy Edge, devi solo imparare alcuni semplici passaggi per utilizzare correttamente i target ospitati. In pratica, crei, esegui il deployment e gestisci i proxy Edge per i target ospitati come fai per qualsiasi altro proxy Apigee Edge.

Per utilizzare i target ospitati, devi eseguire le attività indicate di seguito. I tutorial analizzeremo nel dettaglio ciascuna di queste attività.

  • Sviluppa e testa la tua applicazione Node.js in locale.
  • Crea un file manifest nella directory radice del progetto dell'applicazione. Il manifest è un file YAML che specifica e le informazioni necessarie per la creazione e il deployment dell'applicazione.
  • Aggiungi la tua applicazione al proxy Edge come una risorsa ospitata di testo.
  • Nell'endpoint di destinazione del proxy, aggiungi un tag <HostedTarget/> vuoto. Questo tag indica a Edge di eseguire il deployment dell'applicazione Node.js nell'ambiente delle destinazioni ospitate. Per esempio:
  • <?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>

Ambito delle applicazioni per i target ospitati

Le applicazioni delle destinazioni ospitate hanno come ambito un ambiente organizzazione perimetrale. Questa definizione dell'ambito come per qualsiasi proxy Edge.

Le applicazioni per i target ospitati possono accedere ai dati proxy?

Le app con target ospitati non hanno attualmente accesso all'ambiente di runtime del proxy. Ciò significa che non puoi accedere al flusso le variabili, le cache e altre entità direttamente dalle applicazioni per i target ospitati.

Con Node.js incorporato (il supporto tradizionale di Node.js basato su Trireme in Edge), puoi utilizzare apigee-access per accedere alle variabili di flusso e ad altre entità in Edge. Tuttavia, i target ospitati non e supportare il modulo apigee-access per i deployment Node.js. Vedi anche È possibile aggirare la mancanza di apigee-access?

Migrazione del codice dell'applicazione esistente alle destinazioni ospitate

Al momento non esiste un percorso di migrazione automatizzato da un Applicazione Node.js incorporata basata su Trireme nei target ospitati. Tuttavia, è possibile convertire manualmente il codice dell'applicazione esistente in target ospitati. Ad esempio, consulta la sezione Migrazione un proxy Node.js esistente a un proxy di destinazioni ospitate.