Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
I target ospitati ti consentono di eseguire applicazioni Node.js in un ambiente di runtime nativo ospitato da Apigee. L'obiettivo dei target ospitati è semplice: consentire il deployment delle applicazioni 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 viene eseguito il deployment nell'ambiente target ospitati. Tieni presente che l'ambiente delle destinazioni in hosting è limitato all'ambito di un ambiente Organization:environment di Apigee.
Per fare in modo che un proxy API Edge comunichi con un'applicazione di destinazione ospitata costruita e di cui è stato eseguito il deployment correttamente, è necessaria una semplice configurazione nell'endpoint target del proxy. Per iniziare, vai ai tutorial sui target ospitati.
Quali runtime delle applicazioni 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 per utilizzare gli obiettivi ospitati.
Attivazione della verifica dei target ospitati
Per verificare che i target ospitati siano attivati nell'organizzazione, richiedi i dettagli dell'organizzazione e assicurati che la proprietà 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"
}
Informazioni importanti sui target ospitati
Le destinazioni ospitate 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 il test della tua app in locale prima di eseguirne il deployment e avere la certezza che la versione di cui è stato eseguito il deployment funzionerà esattamente come funziona localmente. Al momento del deployment, puoi scegliere qualsiasi versione di 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 per gli obiettivi ospitati, consulta i limiti dei prodotti Apigee.
Passaggi di base da seguire
Se hai dimestichezza con lo sviluppo di proxy Edge, devi solo seguire 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 Edge Apigee.
Per utilizzare i target ospitati, devi svolgere le seguenti attività. I tutorial illustrano 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 le informazioni necessarie per creare l'applicazione ed eseguirne il deployment.
- Aggiungi l'applicazione al proxy Edge come tipo di risorsa in hosting.
- 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 Destinazioni ospitate. 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 di Target ospitati
Le applicazioni delle destinazioni ospitate hanno come ambito un ambiente organizzazione perimetrale. Questa definizione dell'ambito è la stessa utilizzata per qualsiasi proxy Edge.
Le applicazioni per i target in hosting possono accedere ai dati proxy?
Le app dei target ospitati non hanno attualmente accesso all'ambiente di runtime del proxy. Ciò significa che non puoi accedere alle variabili, alle cache e ad altre entità del flusso direttamente dalle applicazioni di destinazione ospitate.
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, le destinazioni ospitate non supportano il modulo apigee-access per i deployment di 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 automatico da un'applicazione Node.js incorporata basata su Trireme alle destinazioni ospitate. Tuttavia, puoi convertire manualmente il codice dell'applicazione esistente in target ospitati. Per un esempio, consulta la pagina relativa alla migrazione di un proxy Node.js esistente a un proxy di destinazioni ospitate.