Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Le destinazioni ospitate consentono di eseguire applicazioni Node.js in un ambiente di runtime nativo ospitato da Apigee. L'obiettivo delle destinazioni ospitate è semplice: consentirti di eseguire il deployment delle applicazioni in un ambiente nativo, sicuro, scalabile e isolato in cui i proxy dell'API Edge possono chiamarli 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 destinazioni ospitate. Tieni presente che l'ambito dell'ambiente Destinazioni ospitate è all'interno di un ambiente Organization-environment di Apigee.
Ottenere un proxy API Edge per comunicare con un'applicazione Destinazioni ospitate correttamente creata e di cui è stato eseguito il deployment richiede una semplice configurazione nell'endpoint di destinazione del proxy. Per iniziare, consulta i tutorial sui target ospitati.
Quali tempi di esecuzione delle applicazioni sono supportati dalle destinazioni ospitate?
Al momento puoi eseguire il deployment delle app Node.js solo nelle destinazioni ospitate.
Installazione di destinazioni ospitate
Le destinazioni ospitate sono disponibili in tutte le organizzazioni Edge Public Cloud. Non è necessario installare nulla per utilizzare le destinazioni ospitate.
Verifica dell'attivazione delle destinazioni ospitate
Se vuoi verificare che le destinazioni ospitate siano abilitate nella tua organizzazione, recupera 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 l'esecuzione delle applicazioni Node.js in un ambiente nativo che non dipende da alcuna tecnologia di runtime specifica per 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 avviene localmente. Al momento del deployment, puoi scegliere qualsiasi versione del runtime dell'applicazione per l'esecuzione dell'applicazione nelle destinazioni ospitate. Ad esempio, potresti scegliere specificamente di eseguire un'app Node.js in un ambiente v8.10.0.
Limiti
Per i limiti di utilizzo sulle destinazioni ospitate, consulta i limiti dei prodotti Apigee.
Passaggi di base da seguire
Se hai dimestichezza con lo sviluppo di proxy Edge, devi solo apprendere alcuni semplici passaggi per utilizzare correttamente le destinazioni ospitate. Essenzialmente, crei, esegui il deployment e gestisci i proxy Edge per destinazioni in hosting proprio come per qualsiasi altro proxy Apigee Edge.
Per utilizzare destinazioni ospitate, devi eseguire le seguenti operazioni. I tutorial esaminano in dettaglio ognuna di queste attività.
- Sviluppa e testa la tua applicazione Node.js localmente.
- Crea un file manifest nella directory principale del progetto dell'applicazione. Il manifest è un file YAML che specifica le informazioni necessarie per creare l'applicazione ed eseguirne il deployment.
- Aggiungi la tua applicazione al proxy Edge come tipo di risorsa ospitato.
- 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 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 di target in hosting
Le applicazioni di destinazioni ospitate hanno come ambito un ambiente organizzazione perimetrale. Questa definizione dell'ambito è uguale a quella di qualsiasi proxy Edge.
Le applicazioni di destinazione in hosting possono accedere ai dati proxy?
Le app di destinazione ospitate non hanno attualmente accesso all'ambiente di runtime del proxy. Ciò significa che non puoi accedere a variabili di flusso, cache e altre entità direttamente dalle applicazioni di destinazioni ospitate.
Con Node.js incorporato (il supporto tradizionale 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 Node.js.
Vedi anche
È possibile ovviare all'assenza 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 tradizionale alle destinazioni ospitate. Tuttavia, puoi convertire manualmente il codice dell'applicazione esistente in destinazioni ospitate. Per un esempio, consulta Migrazione di un proxy Node.js esistente a un proxy di destinazioni in hosting.