Deployment dei proxy dalla riga di comando

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

Questo argomento spiega come eseguire il deployment di un proxy dalla riga di comando. Apigee Edge offre due per il deployment dalla riga di comando. Il primo è usare uno strumento di deployment Apigee Edge scritte in Python. L'altro è configurare ed eseguire uno script shell.

Utilizza le tecniche di deployment a riga di comando quando lavori direttamente con l'origine proxy file sul tuo sistema. Esistono molti motivi per cui potresti lavorare offline. Potresti voler utilizzare l'editor XML che preferisci oppure potresti stare sviluppando criteri che richiedono la programmazione Java che funzionano principalmente in un IDE. Le tecniche descritte in questa sezione ti consentono di caricare e eseguire il deployment dei file di origine nell'ambiente dei servizi API che scegli.

Se lavori principalmente nell'interfaccia utente di gestione, vedi Deployment dei proxy nell'interfaccia utente.

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Esecuzione dello strumento di deployment Python di Apigee Edge

Lo strumento di deployment Python di Apigee Edge funziona con l'API di gestione Edge per importare ed eseguire il deployment dell'API proxy. Lo strumento è disponibile come parte della distribuzione di API Platform Samples su GitHub. Consulta Utilizzo dei proxy API di esempio.

Usa lo strumento Python di Apigee Edge per importare (caricare) ed eseguire il deployment dell'API in una semplice e il processo di sviluppo.

Lo strumento di deployment deve essere eseguito dalla directory di base nella distribuzione della piattaforma API Distribuzione di esempi, in cui la directory di base è la directory padre di setup e tools.

Nel comando seguente, sostituisci il nome del proxy, il nome utente e la password di Edge, dell'ambiente e dell'organizzazione e il percorso della directory che contiene "Directory apiproxy":

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Ad esempio:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Questo comando comprime i file, ne esegue il push nella organizzazione su Apigee Edge all'ambiente specificato.

Lo strumento di deployment rileva automaticamente la revisione corrente dell'API il proxy, annulla il deployment della revisione esistente ed esegue il deployment di una revisione incrementata dell'API proxy.

Se l'esito è positivo, vedrai l'output nel formato:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

Per impostazione predefinita, lo strumento carica il proxy API in https://api.enterprise.apigee.com, corrispondenti a Edge nel cloud. Puoi utilizzare questo strumento anche per caricare il proxy API in un versione on-premise di Edge specificando il flag -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

In questo esempio, specifichi l'indirizzo IP del server di gestione perimetrale. Se hai creato un record DNS per il server di gestione, puoi specificare un URL nel seguente formato:

https://ms_URL:8080

L'elenco completo dei flag per il comando è:

• -n: il nome del tuo proxy API.
• -u: il nome utente e la password del tuo account in un'organizzazione in Apigee perimetrali.
• -o: il nome dell'organizzazione in cui disponi di un account.
• -e: l'ambiente in cui deve essere eseguito il deployment del proxy API (test o prod).
• -d: il percorso della directory contenente i file del proxy API. Il tuo proxy API questi file devono essere archiviati in una directory denominata "apiproxy". Questo valore è il percorso che contiene "apiproxy" alla directory attuale e non al percorso "apiproxy" della directory stessa.
• -p: il percorso dell'URI utilizzato come corrispondenza di pattern per instradare i messaggi in arrivo a questa API del proxy. Nella maggior parte dei casi, puoi impostare questo valore su "/", a meno che tu non abbia di deployment e routing. Il percorso principale utilizzato per il routing del proxy API è definito in il file di configurazione ProxyEndpoint del proxy API.
• -h: l'URL perimetrale. Per impostazione predefinita, l'URL è https://api.enterprise.apigee.com, corrispondenti a Edge nel cloud. Per un deployment on-premise, utilizza l'URL della piattaforma e la porta 8080, come in questo esempio:

  https://ms_URL:8080

  In alternativa, utilizza l'indirizzo IP del server di gestione, ad esempio https://192.168.11.111:8080.

Configurazione ed esecuzione di una shell di deployment copione

L'approccio più semplice consiste nell'eseguire lo script di deployment fornito con il proxy API di esempio. Conchiglia che racchiudono lo strumento di deployment di Apigee Edge Python.

Dalla directory /simplyProxy esegui:

Dovresti vedere:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]: 

Inserisci la password e premi Invio.

Dovresti vedere:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Se vedi quanto segue:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]: 

significa che devi modificare il file /setup/setenv.sh la distribuzione dei campioni sulla piattaforma. Per istruzioni, consulta il documento README o le API Apigee Edge.

Se l'operazione riesce, lo strumento di deployment comprimi i file in /apiproxy, importazioni il pacchetto nella tua organizzazione su Apigee Edge, quindi esegue il deployment del proxy API completamente gestito di Google Cloud.

Il tuo proxy API è pronto per essere richiamato.