Questa pagina si applica a Apigee e Apigee ibridi.
Visualizza documentazione di Apigee Edge.
Non puoi richiamare un proxy API finché non è stato eseguito il deployment. Dopo aver creato un nuovo proxy API modificare una esistente, puoi eseguirne il deployment in un cluster Kubernetes.
Quando crei una nuova revisione di un il proxy API senza modificare il percorso di base, quindi eseguirne il deployment in un ambiente in cui ne è già stato eseguito il deployment. è stato annullato il deployment della revisione precedente e viene eseguito il deployment della nuova revisione.
Esegui il deployment di un proxy API
Esegui il deployment di una revisione del proxy API come descritto nelle sezioni seguenti.
Nuovo editor proxy
Per eseguire il deployment di un proxy API nella UI di Apigee:
Se utilizzi la UI di Apigee nella console Cloud: seleziona Sviluppo proxy > Proxy API.
Se utilizzi la UI di Apigee classica: seleziona Sviluppa > Proxy API e, nel riquadro Proxy, seleziona l'ambiente per il proxy.
Fai clic sul proxy API di cui vuoi eseguire il deployment. Nella UI viene visualizzata la Panoramica. pagina:
- Per eseguire il deployment delle modifiche, Fai clic su Esegui il deployment per visualizzare la finestra di dialogo Esegui il deployment:
- Inserisci quanto segue:
- Revisione: il numero di revisione del proxy di cui vuoi eseguire il deployment.
- Ambiente: l'ambiente in cui vuoi eseguire il deployment del proxy.
- (Facoltativo) Account di servizio: un account di servizio per il proxy.
- Fai clic su Esegui il deployment.
La UI avvia il processo di deployment della revisione selezionata.
Una volta eseguito il deployment del proxy, viene visualizzata la colonna Stato nella sezione Deployment. un'icona verde per indicare che è stato eseguito il deployment della revisione 1 del proxy.
Editor proxy classico
Per eseguire il deployment di un proxy API nella UI di Apigee:
- Accedi all'UI di Apigee.
- Seleziona Sviluppo > Proxy API.
La UI mostra un elenco di proxy API e il relativo stato di deployment:
- Dall'elenco a discesa Ambiente, seleziona l'ambiente in cui vuoi per eseguire il deployment del proxy API.
Fai clic sul proxy API di cui vuoi eseguire il deployment.
Nell'interfaccia utente viene visualizzata la scheda Panoramica dei proxy API. Questa vista include Deployment, Endpoint del proxy e Destinazione Sezioni Endpoint:
Se si tratta di un nuovo proxy API di cui non hai eseguito il deployment in precedenza (o di un proxy API di cui è stato eseguito il deployment), nella colonna Revisione viene indicato Deployment non eseguito.
- Nella colonna Revisione, espandi il selettore del menu a discesa.
Se si tratta di un nuovo proxy API di cui non è mai stato eseguito il deployment prima, l'elenco a discesa viene visualizzato solo 1 e Annulla deployment:
Per i proxy API con più revisioni, l'elenco a discesa mostra tutte le revisioni e Annulla deployment.
- Seleziona dall'elenco a discesa la revisione di cui vuoi eseguire il deployment.
La UI ti chiede di confermare il deployment:
- Fai clic su Esegui il deployment.
La UI avvia il processo di deployment della revisione selezionata.
Posiziona il cursore sul link Dettagli nella Stato per visualizzare lo stato del deployment. Se è già stato eseguito il deployment di una o più revisioni, puoi monitorare lo stato dell'annullamento del deployment, come mostrato nella figura seguente. Per saperne di più, consulta Deployment senza tempi di inattività.
Al termine del deployment, i dettagli dello Stato indicano che il deployment della revisione è stato completato:
Tieni presente che il deployment non è un processo istantaneo. La piattaforma con coerenza finale consente di eseguire l'implementazione di un nuovo deployment nel cluster in un breve di tempo e non immediatamente. Per ulteriori informazioni, vedi Informazioni sul deployment.
Per informazioni sul significato degli indicatori di stato e su come controllarli, vedi consulta la sezione Visualizzare lo stato del deployment.
In alternativa, puoi eseguire il deployment della revisione corrente che stai modificando nel Scheda Sviluppo. Quando esegui questa operazione, Apigee crea una nuova revisione per te.
- Fai clic sull'elenco a discesa Esegui il deployment in: env_name.
La UI mostra un elenco di ambienti. Nella colonna Revisione, l'interfaccia utente elenca la revisione attualmente di cui è stato eseguito il deployment (o "‐‐" se nessuna).
- Fai clic su Esegui il deployment di revision per eseguire il deployment della revisione
modificato di recente.
La UI ti chiede di confermare il deployment.
- Fai clic su Esegui il deployment.
La UI avvia il processo di deployment della revisione selezionata.
API Apigee
Le sezioni seguenti forniscono esempi di utilizzo dell'API Apigee per eseguire il deployment delle revisioni del proxy API ed elencare i deployment per l'organizzazione.
- Creare un report sulle modifiche al deployment prima di eseguire il deployment
- Deployment di una revisione del proxy API utilizzando l'API
- Elenco dei deployment di un proxy API utilizzando l'API
Vedi anche Visualizzare lo stato del deployment.
Crea un report sulle modifiche del deployment prima di eseguire il deployment
Deployment di un proxy in più ambienti
nello stesso gruppo di ambienti possono
portare a comportamenti indefinito. Per determinare se questo
puoi generare un report utilizzando
generateDeployChangeReport
come segue:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/deployments:generateDeployChangeReport" \ -X POST \ -H "Authorization: Bearer $TOKEN"
Viene restituito un report sulle modifiche al deployment che ti avvisa se un percorso di base nel proxy di cui vuoi eseguire il deployment non riceverà traffico a causa di un deployment esistente che sta già utilizzando quel percorso di base.
Deployment di una revisione del proxy API utilizzando l'API
Per eseguire il deployment di una revisione del proxy API, utilizza la seguente chiamata API:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/environments/$ENV/apis/$API/revisions/$REV/deployments" \ -X POST \ -H "Authorization: Bearer $TOKEN"
Dove $TOKEN
è impostato sul tuo token di accesso OAuth 2.0, come descritto in
Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl
utilizzate in questo esempio, vedi
Con curl. Per una descrizione delle variabili di ambiente utilizzate,
consulta Impostare le variabili di ambiente per le richieste API Apigee.
Di seguito è riportato un esempio dell'output di risposta. In questo esempio, la revisione 1
del proxy API helloworld
il deployment è stato eseguito correttamente nell'ambiente test
:
{ "environment": "test", "apiProxy": "helloworld", "revision": "1", "deployStartTime": "1559149080457" }
Per ulteriori informazioni, consulta Deployment dell'API di revisione del proxy API.
Elenco dei deployment utilizzando l'API
Per elencare tutti i deployment di proxy API e flussi condivisi per la tua organizzazione, inserisci la seguente chiamata API:
curl "https://apigee.googleapis.com/v1/organizations/$ORG/deployments" \ -X GET \ -H "Authorization: Bearer $TOKEN"
Dove $TOKEN
è impostato sul tuo token di accesso OAuth 2.0, come descritto in
Ottenere un token di accesso OAuth 2.0. Per informazioni sulle opzioni curl
utilizzate in questo esempio, vedi
Con curl. Per una descrizione delle variabili di ambiente utilizzate,
consulta Impostare le variabili di ambiente per le richieste API Apigee.
Di seguito viene fornito un esempio della risposta. In questo esempio, sono presenti tre proxy API
di cui è stato eseguito il deployment di helloworld
, di cui è stato eseguito il deployment nella sezione precedente.
{ "deployments": [ { "environment": "test", "apiProxy": "helloworld", "revision": "1", "deployStartTime": "1559149080457" }, { "environment": "test", "apiProxy": "weather", "revision": "1", "deployStartTime": "1558620435217" }, { "environment": "test", "apiProxy": "testproxy", "revision": "2", "deployStartTime": "1558635113086" } ] }
gcloud
Le sezioni seguenti forniscono esempi di utilizzo dei comandi dell'interfaccia a riga di comando gcloud apigee
per
eseguire il deployment delle revisioni
del proxy API ed elencare i deployment per l'organizzazione.
- Deployment di una revisione del proxy API utilizzando gcloud CLI
- Elenco dei deployment di un proxy API utilizzando gcloud CLI
Vedi anche Visualizzare lo stato del deployment.
Per ulteriori informazioni e per una descrizione delle variabili di ambiente utilizzate negli esempi, consulta Introduzione a gcloud con Apigee.
Deployment di una revisione del proxy API utilizzando gcloud CLI
Per eseguire il deployment di una revisione del proxy API, usa questo comando gcloud
:
gcloud apigee apis deploy $REV --api=$API --environment=$ENV
Di seguito è riportato un esempio dell'output di risposta. In questo esempio, la revisione 1
del proxy API helloworld
il deployment è stato eseguito correttamente nell'ambiente test
:
Using Apigee organization 'my-org' apiProxy: helloworld deployStartTime: '1598032332802' environment: test revision: '1'
Per maggiori informazioni, consulta Eseguire il deployment dell'interfaccia a riga di comando della revisione del proxy API.
Elenco dei deployment con gcloud CLI
Per elencare tutti i deployment di proxy API e flussi condivisi per la tua organizzazione, usa il seguente comando gcloud
:
gcloud apigee deployments list
Di seguito viene fornito un esempio della risposta. In questo esempio, sono presenti tre proxy API
di cui è stato eseguito il deployment di helloworld
, di cui è stato eseguito il deployment nella sezione precedente.
Using Apigee organization `my-org` - apiProxy: helloworld deployStartTime: 1598032332802 environment: test revision: 1 - apiProxy: weather deployStartTime: 1558620435217 environment: test revision: 1 - apiProxy: testproxy deployStartTime: 1558635113086 environment: test revision: 2
Per maggiori informazioni, consulta Elenco dei deployment dell'interfaccia a riga di comando.
Risoluzione dei problemi
Se non riesci a eseguire il deployment del proxy API, verifica se si applica uno dei seguenti scenari comuni.
Limitazioni di denominazione per i gruppi di ambienti
Se il nome del tuo gruppo di ambienti non è conforme alle limitazioni di denominazione, il deployment del proxy non verrà eseguito. In alcuni casi, è possibile creare un gruppo di ambienti a cui aggiungere ambienti senza dover rispettare queste restrizioni. Tuttavia, questo impedirà il deployment del proxy.
Consulta Creazione di gruppi di ambienti per una descrizione delle linee guida e delle limitazioni per l'assegnazione dei nomi.
Ambiente creato con un nome ambiente utilizzato in precedenza
Se crei un ambiente con lo stesso nome di un ambiente eliminato in precedenza,
del proxy non verrà eseguito. Ad esempio, se hai creato un ambiente denominato prod-1
dopo
in precedenza creava ed eliminava un ambiente prod-1
,
dovrai rimuoverlo. Per risolvere il problema, puoi procedere nel seguente modo:
- Scollega l'ambiente
prod-1
dal tuo gruppo di ambienti utilizzando il API. - Elimina l'ambiente
prod-1
utilizzando l'API. - Crea un nuovo ambiente. Ad esempio,
prod-2
. - Collega il nuovo ambiente
prod-2
al gruppo di ambienti utilizzando tramite Google Cloud.