Deployment dei proxy dalla riga di comando

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Questo argomento spiega come eseguire il deployment di un proxy dalla riga di comando. Apigee Edge offre due opzioni per il deployment dalla riga di comando. La prima è utilizzare uno strumento di deployment di Apigee Edge scritto in Python. L'altra è configurare ed eseguire uno script shell.

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

Se lavori principalmente nell'interfaccia utente di gestione, consulta Eseguire il deployment dei proxy nell'interfaccia utente.

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Eseguire lo strumento di deployment Python di Apigee Edge

Lo strumento di deployment Python di Apigee Edge funziona con l'API di gestione di Edge per importare ed eseguire il deployment dei proxy API. Lo strumento è disponibile come parte della distribuzione degli esempi della piattaforma API su GitHub. Consulta Utilizzare i proxy API di esempio.

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

Lo strumento di deployment deve essere eseguito dalla directory di base nella distribuzione degli esempi della piattaforma API, dove la directory di base è la directory principale delle directory setup e tools.

Nel seguente comando, 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, li invia alla tua organizzazione su Apigee Edge ed 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 incrementale del proxy API.

In caso di esito positivo, viene visualizzato un 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 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 -h flag:

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 di Edge. 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 è il seguente:

  • -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 del proxy API. I file del proxy API devono essere archiviati in una directory denominata "apiproxy". Questo valore è il percorso della directory che contiene la directory "apiproxy" e non il percorso della directory "apiproxy" stessa.
  • -p: il percorso URI utilizzato come corrispondenza di 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 in il file di configurazione ProxyEndpoint del proxy API.
  • -h: l'URL di Edge. 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 di Edge e la porta 8080, come in: 
    https://ms_URL:8080

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

Configurare ed eseguire 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 wrapping dello strumento di deployment Python di Apigee Edge.

Dalla directory /simplyProxy esegui:

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

In caso di esito positivo, lo strumento di deployment comprime i file in /apiproxy, importa il pacchetto nella tua organizzazione su Apigee Edge e poi esegue il deployment del proxy API nell'ambiente "test" .

Il proxy API è pronto per essere richiamato.