Risoluzione dei problemi di installazione di Apigee

Questa pagina si applica ad Apigee, ma non ad Apigee ibrido.

Visualizza la documentazione di Apigee Edge.

Questo documento elenca gli errori comuni e descrive le possibili risoluzioni per l'installazione e la configurazione di Apigee.

Creazione di una nuova istanza

Questa sezione descrive gli errori comuni e le possibili risoluzioni dopo l'invio di una richiesta ad Apigee per creare una nuova istanza:

• 401 (UNAUTHENTICATED) indica che le credenziali potrebbero essere scadute. Prova a rinnovare il token di autorizzazione, come illustrato nell'esempio seguente:

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• RANGES_EXHAUSTED indica che l'intervallo di indirizzi IP richiesto inizialmente non è stato consentito e che devi richiedere un nuovo intervallo. Inizialmente hai creato una richiesta di intervallo nel Passaggio 4: configura il networking dei servizi.

  Per richiedere un nuovo intervallo da cui Apigee sceglie un indirizzo IP per le connessioni private ai servizi:

  1. Esegui questo comando gcloud:

     gcloud compute addresses create google-svcs-2
       --project=$PROJECT_ID --global --prefix-length=16
       --description="additional peering range for Google services" --network=default
       --purpose=VPC_PEERING

     Questo comando crea un nuovo intervallo denominato google-svcs-2.

  2. Esegui questo comando per aggiornare la richiesta di connessione:

     gcloud services vpc-peerings update
       --service=servicenetworking.googleapis.com --network=default
       --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

     Nota: devi specificare il nome del tuo primo intervallo (in questo caso, google-svcs) e un nome per l'intervallo appena richiesto (in questo caso, google-svcs-2). Per maggiori informazioni, consulta gcloud services vpc-peerings update.

Creazione di un'organizzazione Apigee in corso...

L'esempio seguente mostra un errore comune che Apigee potrebbe visualizzare al primo tentativo di creare un'organizzazione:

Ciò significa che una o più delle API richieste non sono abilitate. Controlla le API elencate in Passaggio 2: abilita le API Apigee e assicurati che tutte le API siano abilitate prima di continuare.

Inoltre, potresti visualizzare uno dei seguenti errori HTTP:

• 401 (UNAUTHENTICATED) indica che le credenziali potrebbero essere scadute. Prova a rinnovare il token di autorizzazione, come illustrato nell'esempio seguente:

  AUTH="Authorization: Bearer $(gcloud auth print-access-token)"

• 404 (Not Found) può essere il risultato dei seguenti:
  • Hai inserito l'URL dell'endpoint/della richiesta errato. Verifica di aver specificato apigee.googleapis.com per il dominio della chiamata API.
  • Potrebbe non essere ancora stato eseguito il provisioning del progetto. Contatta il team di vendita Apigee.
• 409 (Conflict) indica in genere che il nome dell'organizzazione specificato esiste già. I nomi delle organizzazioni devono essere univoci a livello globale. Scegli un altro nome per l'organizzazione ed emetti di nuovo il comando. Devi specificare il nome nel payload della richiesta se crei un'organizzazione dalla riga di comando. Tieni presente che devi creare un'organizzazione che ha lo stesso nome del tuo progetto, quindi questo non dovrebbe avvenire a meno che non ci sia un errore di battitura.)

Di seguito è riportato un possibile errore che Apigee potrebbe restituire quando controlli lo stato di una nuova richiesta di organizzazione:

• 403 (Permission Denied) potrebbe indicare che l'organizzazione non è stata ancora creata. Attendi un altro minuto e riprova. Se Apigee restituisce un 403 quando provi per la prima volta a creare la nuova organizzazione, potrebbe significare che una o più delle tue API non sono state abilitate. Assicurati di aver abilitato tutte le API come descritto nel Passaggio 2: abilita le API Apigee.

Deployment degli esempi

Bilanciatore del carico non integro

Durante il deployment di un proxy di esempio, Apigee potrebbe restituire un errore HTTP 502 (Bad Gateway). In questo caso, prova quanto segue:

1. Apri la console Cloud.
2. Verifica l'integrità del bilanciatore del carico. Nella console Cloud, seleziona Servizi di rete > Bilanciamento del carico. La scheda Bilanciatore del carico mostra tutti i bilanciatori del carico per il progetto e i relativi stati. Un triangolo giallo indica che il servizio di backend del bilanciatore del carico non è integro.
3. Dopo aver confermato un problema con il bilanciatore del carico, controlla che le VM nell'istanza di runtime siano attive e integri.
4. Esamina i file di log per vedere se hai riscontrato un errore o un altro tipo di problema che potrebbe aver causato un problema. Per maggiori informazioni sull'abilitazione e la visualizzazione dei log, consulta Visualizzazione dei log.
5. Prova a eseguire un riavvio in sequenza sul gruppo di istanze nella console Cloud:
   1. Seleziona Compute Engine > Gruppi di istanze.
   2. Dall'elenco dei gruppi di istanze, fai clic su quello che non risponde nella colonna Nome.
   3. Fai clic su Rolling Riavvia/Sostituisci, come illustrato nell'esempio seguente:

      

   4. Nella schermata successiva, fai clic su Riavvia.

      Questa operazione riavvia l'istanza Envoy.

IP dell'istanza errato

Se in qualsiasi momento elimini e ricrei l'istanza Apigee, l'IP dell'istanza Apigee cambia e può non essere sincronizzato con l'IP dell'endpoint del modello del gruppo di istanze gestite. Ad esempio, il modello di gruppo di istanze gestite avrà ancora il vecchio IP dell'istanza eliminata. Il modello di gruppo di istanze gestite è stato creato durante il processo di provisioning di Apigee. In questo caso, prova a seguire questi passaggi per aggiornare il modello di gruppo di istanze gestite con l'IP Apigee corretto:

1. Apri l'interfaccia utente di Apigee.

   Vai all'interfaccia utente di Apigee

2. Vai ad Amministrazione > Istanze.
3. Prendi nota dell'indirizzo IP dell'istanza. Dovrai conoscere questo IP in un passaggio successivo. Ad esempio: 10.117.200.2.

4. Nella console Google Cloud, vai alla pagina Modelli di istanza.

   Vai a Modelli di istanza

5. Apri il modello di istanza. Devi aprire il modello di istanza utilizzato dal backend mappato al bilanciatore del carico.
6. Scorri verso il basso fino a trovare l'IP ENDPOINT nella sezione Metadati personalizzati.
7. Se l'IP dell'endpoint è diverso da quello indicato nella UI di Apigee, devi modificare l'IP del modello di istanza in modo che corrisponda all'IP dell'istanza Apigee. Vedi Modifica degli IP delle istanze.