Deployment dei proxy dalla riga di comando

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

In questo argomento viene spiegato come eseguire il deployment di un proxy dalla riga di comando. Apigee Edge offre due opzioni per il deployment dalla riga di comando. Il primo consiste nell'utilizzare uno strumento di deployment Apigee Edge scritto in Python. L'altro consiste nel configurare ed eseguire uno script shell.

Utilizza le tecniche di deployment a riga di comando quando operi direttamente con i file di origine del proxy sul tuo sistema. Ci sono molti motivi per cui potresti lavorare offline. Potresti voler utilizzare il tuo editor XML preferito o potresti dover sviluppare criteri che richiedono la codifica Java e lavori principalmente in un IDE. Le tecniche descritte in questa sezione consentono di caricare ed eseguire il deployment dei file di origine nell'ambiente dei servizi API che scegli.

Se utilizzi principalmente l'interfaccia utente di gestione, vedi Eseguire il 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 Edge di Apigee

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

Utilizza lo strumento Python Edge di Apigee per importare (caricare) ed eseguire il deployment della tua API in un'unica semplice procedura.

Lo strumento di deployment deve essere eseguito dalla directory di base nella distribuzione della distribuzione Esempi di API Platform, dove la directory di base è la directory padre delle directory setup e tools.

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

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 tua organizzazione su Apigee Edge e ne esegue il deployment nell'ambiente specificato.

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

Se l'operazione va a buon fine, l'output viene visualizzato nel seguente 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 su https://api.enterprise.apigee.com, corrispondente a Edge nel cloud. Puoi anche utilizzare questo strumento per caricare il proxy API in una 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

Di seguito è riportato l'elenco completo dei flag per il comando:

  • -n: il nome del proxy API.
  • -u: il nome utente e la password del tuo account in un'organizzazione in Apigee Edge.
  • -o: il nome dell'organizzazione in cui hai 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 proxy API. I file proxy API devono essere archiviati in una directory denominata "apiproxy". Questo valore è il percorso della directory che contiene la directory "apiproxy" e non del percorso della directory "apiproxy".
  • -p: il percorso URI utilizzato come corrispondenza del pattern per instradare i messaggi in arrivo a questo deployment del proxy API. Nella maggior parte dei casi, puoi impostare questo valore su "/", a meno che tu non abbia requisiti avanzati di deployment e routing. Il percorso principale utilizzato per il routing del proxy API è definito nel file di configurazione ProxyEndpoint del proxy API.
  • -h: l'URL perimetrale. Per impostazione predefinita, l'URL è https://api.enterprise.apigee.com, corrispondente a Edge nel cloud. Per un deployment on-premise, utilizza l'URL del server di gestione perimetrale e della porta 8080, ad 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 uno script shell di deployment

L'approccio più semplice è eseguire lo script di deployment fornito con il proxy API di esempio. Gli script shell eseguono il deployment dello strumento di deployment Python di Apigee Edge.

Dall'esecuzione della directory /simplyProxy:

$ sh deploy.sh

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 poi vedere:

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

Se visualizzi 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 nella distribuzione degli esempi di piattaforma. Per le istruzioni, consulta il file README o le API Apigee Edge.

Se l'operazione ha esito positivo, lo strumento di deployment comprime i file in /apiproxy, importa il pacchetto nella tua organizzazione su Apigee Edge, quindi esegue il deployment del proxy API nell'ambiente "di test".

Il tuo proxy API è pronto per essere richiamato.