Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
I target ospitati ti consentono di eseguire applicazioni Node.js in un ambiente di runtime nativo ambiente ospitato da Apigee. L'obiettivo dei target ospitati è semplice: consentirti di eseguire il deployment applicazioni in un ambiente nativo, sicuro, scalabile e isolato in cui i proxy API Edge possono chiamarli 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 dei target ospitati. Tieni presente che l'ambiente dei target ospitati è limitato all'interno di un'organizzazione:ambiente Apigee.
Per fare in modo che un proxy API Edge comunichi con un'applicazione dei target ospitati creata e di cui è stato eseguito il deployment correttamente, richiede una semplice configurazione nell'endpoint di destinazione del proxy. Per iniziare, consulta i tutorial sui target ospitati.
Quali runtime delle applicazioni sono supportati dai target ospitati?
Al momento, puoi eseguire il deployment delle app Node.js solo nei target ospitati.
Installazione dei target ospitati
I target ospitati sono disponibili in tutte le organizzazioni Edge Public Cloud. Non devi installare nulla per utilizzare i target ospitati.
Verifica che i target ospitati siano abilitati
Se vuoi verificare che i target ospitati siano abilitati per la tua organizzazione, recupera
i dettagli dell'organizzazione e assicurati che la features.isEdgeFunctionsEnabled
proprietà 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" }
Informazioni importanti sui target ospitati
I target ospitati consentono alle applicazioni Node.js di essere eseguite in un ambiente nativo che non dipende da alcuna tecnologia di runtime specifica di Apigee. Puoi eseguire il debug e testare la tua app localmente prima di eseguirne il deployment e avere la certezza che la versione di cui è stato eseguito il deployment funzionerà esattamente come quella locale. Al momento del deployment, puoi scegliere qualsiasi versione del runtime dell'applicazione per eseguire l'applicazione nei target ospitati. Ad esempio, potresti scegliere in modo specifico di eseguire un'app Node.js in un ambiente v8.10.0.
Limiti
Per i limiti di utilizzo dei target ospitati, consulta Limiti dei prodotti 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 sostanza, crei, esegui il deployment e gestisci i proxy Edge per i target ospitati come faresti per qualsiasi altro proxy Apigee Edge.
Per utilizzare i target ospitati, devi completare le seguenti attività. I tutorial illustrano in dettaglio ciascuna di queste attività.
- Sviluppa e testa l'applicazione Node.js localmente.
- Crea un file manifest nella directory root del progetto dell'applicazione. Il manifest è un file YAML che specifica informazioni necessarie per creare ed eseguire il deployment dell'applicazione.
- Aggiungi l'applicazione al proxy Edge come un tipo di risorsa ospitata.
- 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 dei target ospitati. Ad 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 dei target ospitati
L'ambito delle applicazioni dei target ospitati è limitato a un'organizzazione-ambiente Edge. Questo ambito è lo stesso di qualsiasi proxy Edge.
Le applicazioni dei target ospitati possono accedere ai dati del proxy?
Al momento, le app dei target ospitati non hanno accesso all'ambiente di runtime del proxy. Ciò significa che non puoi accedere direttamente alle variabili di flusso , alle cache e ad altre entità dalle applicazioni dei 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 supportano il apigee-access modulo per i deployment Node.js.
Vedi anche
È possibile aggirare la mancanza di apigee-access?
Migrazione del codice dell'applicazione esistente ai target ospitati
Al momento non esiste un percorso di migrazione automatizzato da un'applicazione Node.js incorporata tradizionale basata su Trireme ai target ospitati. Tuttavia, puoi convertire manualmente il codice dell'applicazione esistente ai target ospitati. Per un esempio, consulta Migrazione di un proxy Node.js esistente a un proxy dei target ospitati.