Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
Dopo aver completato lo sviluppo e i test locali con Apigee in VS Code, puoi eseguire il deployment della tua API come archivio in un ambiente Apigee. In questo passaggio, creerai un ambiente Apigee che supporta il deployment degli archivi ed eseguirai il deployment di un archivio della configurazione del proxy API nell'ambiente Apigee.
- Segui i passaggi descritti in Creare un ambiente per eseguire le seguenti operazioni:
- Crea un nuovo ambiente dev nella tua organizzazione Apigee, attivando Archivio come tipo di deployment. Utilizza l'interfaccia utente o l'API.
- Collega l'ambiente a un'istanza di runtime utilizzando l'API Instances attachment.
Questo comando attiva un'operazione a lunga esecuzione. Prima di continuare, assicurati che l'ambiente sia stato collegato al runtime.
- Crea un gruppo di ambienti se non ne hai già uno utilizzando l'API Create environment groups.
Assicurati che il gruppo di ambienti sia stato creato prima di continuare. Puoi controllare lo stato del nuovo gruppo utilizzando una richiesta come la seguente:
curl -i -H "$AUTH" -H "Content-Type:application/json" \ "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/environments/ENVIRONMENT_NAME"
- Collega il nuovo ambiente al gruppo di ambienti utilizzando l'API di collegamento del gruppo di ambienti.
Il collegamento di un ambiente al gruppo rende i proxy in quell'ambiente instradabili tramite i nomi host nel gruppo. Viene attivata un'operazione a lunga esecuzione che può richiedere diversi minuti. Ti consigliamo di attendere un minuto o due prima di procedere con il passaggio successivo. Nel frattempo, puoi controllare lo stato dell'operazione come prima.
- Esegui il deployment di un archivio della configurazione del proxy API nell'ambiente Apigee.
- Nella scheda Terminale di Apigee VS Code, vai alla directory myapigeeworkspace.
cd myapigeeworkspace
Quando esegui
ls
, la directory deve contenere la cartellasrc
. - Esegui questo comando:
gcloud beta apigee archives deploy --environment=dev --labels=release=052021
Di seguito è riportato un esempio di risposta:
Using Apigee organization dev Waiting for operation [b64c2665-b5ac-43cc-9e2d-232e8895c2ed] to complete...done
- Nella scheda Terminale di Apigee VS Code, vai alla directory myapigeeworkspace.
- Esegui questo comando nella scheda Terminale per testare l'API:
curl https://INTERNAL_LOAD_BALANCER_IP/helloworld / -H "Host: ENV_GROUP_HOSTNAME"
Per saperne di più sulle variabili in questo esempio e su come configurare l'accesso API, vedi Deploy di un proxy di esempio.
Viene visualizzato il seguente messaggio di errore:
{"fault":{"faultstring":"Failed to resolve API Key variable request.queryparam.apikey", "detail":{"errorcode":"steps.oauth.v2.FailedToResolveAPIKey"}}}
Devi creare un prodotto API che includa l'API
helloworld
, quindi creare e registrare uno sviluppatore con il prodotto API per ottenere una chiave API. - Ottieni una chiave API.
- Crea un prodotto API utilizzando la UI di Apigee:
- Vai alla pagina dei prodotti API:
- Fai clic su + Crea.
- Inserisci i dettagli del prodotto per il tuo prodotto API.
- Compila i campi seguenti con le informazioni indicate:
Campo Impostazione Name:
myproduct Display name:
myproduct Environment:
dev Access:
Pubblica Quota:
Lascia vuoto Allowed OAuth scope:
Lascia vuoto - Nella sezione Operazioni, fai clic su + Aggiungi un'operazione.
- Nella sezione Origine, seleziona helloworld dal menu a discesa Proxy API.
- In Operazione, nel campo Percorso, inserisci
/
.Lascia invariati i valori predefiniti degli altri campi.
- Fai clic su Salva per salvare l'operazione.
- Fai clic su Salva per salvare il prodotto API.
Apigee nella console Cloud
Nella console Google Cloud , vai alla pagina Distribuzione > Prodotti API.
UI Apigee classica
Seleziona Pubblica > Prodotti API.
- Crea uno sviluppatore nella tua organizzazione:
Apigee nella console Cloud
-
Nella console Google Cloud , vai alla pagina Distribuzione > Sviluppatori.
- Fai clic su + Crea.
- Compila i campi seguenti con le informazioni indicate:
Campo Impostazione First Name:
Alex Last Name:
Hamilton Username:
ahamilton Email:
ahamilton@example.com - Fai clic su Aggiungi.
UI Apigee classica
- Nel menu di navigazione, seleziona Pubblica > Sviluppatori.
- Fai clic su + Sviluppatore.
- Compila i campi seguenti con le informazioni indicate:
Campo Impostazione First Name:
Alex Last Name:
Hamilton Username:
ahamilton Email:
ahamilton@example.com - Fai clic su Crea.
-
- Registra un'app:
- Apri l'editor app.
-
Nella console Google Cloud , vai alla pagina Distribuzione > App.
- Fai clic su + Crea.
- Seleziona Pubblica > App.
- Fai clic su + App.
- Compila i campi seguenti con le informazioni indicate:
Campo Impostazione Name:
myapp Display name:
myapp Developer:
ahamilton@example.com Callback URL:
Lascia vuoto Notes:
Lascia vuoto Expiry:
Mai Product:
- Fai clic su Aggiungi prodotto.
- Seleziona myproduct.
- Fai clic su Aggiungi.
Custom attributes:
Lascia vuoto - Fai clic su Crea.
Apigee nella console Cloud
UI Apigee classica
- Copia la chiave API.
-
Nella console Google Cloud , vai alla pagina Distribuzione > App.
- Fai clic su myapp.
- Nella sezione Credenziali, accanto a Chiave, fai clic su Mostra.
- Fai clic su Copia.
-
Nella pagina App (Pubblica > App), fai clic su myapp.
- Nella pagina myapp, fai clic su Mostra accanto a Chiave nella sezione
Credenziali. Tieni presente che la chiave API è associata al prodotto API che hai creato.
- Seleziona e copia la chiave API.
Apigee nella console Cloud
UI Apigee classica
-
- Esegui di nuovo la chiamata curl passando la chiave API utilizzando il parametro di query
apikey
, come segue:curl -v https://$PUBLIC_FACING_IP/helloworld?apikey=ZQA5euYtNeJ7ZCGCJMpvd6F2BZOmxOzY
Viene restituita la seguente risposta:
{ "root": { "city": "San Jose", "firstName": "John", "lastName": "Doe", "state": "CA" } }
Complimenti! Hai eseguito correttamente il deployment dell'archivio API in un ambiente Apigee.
Nel passaggio successivo, promuoverai l'archivio API in un ambiente di produzione Apigee.
1 2 3 4 5 6 7 (NEXT) Step 8: Promote an archive to production