Risoluzione dei problemi di installazione di Apigee

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

Visualizza la documentazione di Apigee Edge.

Questo documento elenca gli errori comuni e descrive le possibili soluzioni per quando installi e configuri Apigee.

Creazione di una nuova istanza

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

  • 401 (UNAUTHENTICATED) indica che le tue credenziali potrebbero essere scadute. Prova a rinnovare il token di autorizzazione, come mostrato nell'esempio seguente: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED indica che l'intervallo di indirizzi IP che hai richiesto inizialmente non può essere soddisfatto e che devi richiedere un nuovo intervallo. Inizialmente hai creato una richiesta di intervallo nel passaggio 2: configura il networking.
    1. Crea queste variabili di ambiente 
      2. RANGE_NAME_1=YOUR_RANGE_NAME_1
  RANGE_NAME_2=YOUR_RANGE_NAME_2
  NETWORK_NAME=YOUR_NETWORK_NAME
    2. Verifica i dettagli degli intervalli di indirizzi esistenti e assicurati che non si sovrappongano al nuovo intervallo. 
      3.  gcloud compute addresses list --global --project=$PROJECT_ID
       
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
    3. Per richiedere un nuovo intervallo da cui Apigee sceglie un indirizzo IP per le connessioni di servizio privato, esegui il seguente comando gcloud: 
      4.  gcloud compute addresses create $RANGE_NAME_2
            --project=$PROJECT_ID --global --prefix-length=16
            --description="additional peering range for Google services" --network=$NETWORK_NAME
            --purpose=VPC_PEERING

      Questo comando crea un nuovo intervallo denominato $RANGE_NAME_2.

    4. Verifica i dettagli dell'intervallo di indirizzi precedente e di quello nuovo. 
      5.  gcloud compute addresses list --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 
       gcloud compute addresses describe $RANGE_NAME_2 --global --project=$PROJECT_ID
    5. Verifica i dettagli del peering VPC esistente: 
      6.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID
    6. Esegui questo comando per aggiornare la richiesta di connessione: 
      7.  gcloud services vpc-peerings update
            --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
            --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
    7. Verifica i dettagli del peering VPC esistente: 
      8.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID

Creazione di un'organizzazione Apigee

L'esempio seguente mostra un errore comune che Apigee potrebbe visualizzare quando provi a creare un'organizzazione per la prima volta:

  Apigee API (staging) has not been used in project 59387731598 before or it is disabled. 
  Enable it by visiting https://console.developers.google.com/apis/api/staging-apigee.sandbox.googleapis.com/overview?project=59387731598 then retry. 
  If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.

Ciò significa che una o più API richieste non sono abilitate. Esamina le API elencate nel passaggio 1: abilita le API richieste e assicurati che tutte le API siano abilitate prima di continuare.

Inoltre, potresti ricevere uno dei seguenti errori HTTP:

  • 401 (UNAUTHENTICATED) indica che le tue credenziali potrebbero essere scadute. Prova a rinnovare il token di autorizzazione, come mostrato nell'esempio seguente: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) può essere il risultato di quanto segue:
    • Hai inserito l'URL di richiesta/endpoint errato. Controlla di aver specificato apigee.googleapis.com per il dominio della chiamata API.
    • Il tuo progetto potrebbe non essere ancora stato sottoposto a provisioning. Contatta il team di vendita di 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 e riemetti il comando. (Specifichi il nome nel payload della richiesta se stai creando un'organizzazione dalla riga di comando. Tieni presente che devi creare un'organizzazione con lo stesso nome del tuo progetto, quindi questo non dovrebbe succedere 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 è ancora stata creata. Attendi un altro minuto e riprova. Se Apigee restituisce un 403 quando provi a creare la nuova organizzazione, è possibile che una o più API non siano state abilitate. Assicurati di aver abilitato tutte le API come descritto nel passaggio 1: abilita le API richieste .

Deployment di esempi

Bilanciatore del carico non integro

Quando viene eseguito il deployment di un proxy di esempio, Apigee potrebbe restituire un errore HTTP 502 (Bad Gateway). In questo caso, prova a svolgere i seguenti passaggi:

  1. Controlla l'integrità del bilanciatore 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.

    Nella console Google Cloud , vai alla pagina Servizi di rete > Bilanciamento del carico.

    Vai a Bilanciamento del carico

  2. Dopo aver confermato un problema con il bilanciatore del carico, controlla le VM nell'istanza di runtime per assicurarti che siano attive e integre.
  3. Esamina i file di log per verificare se riesci a trovare un errore o un altro tipo di problema che potrebbe aver causato il problema. Per saperne di più sull'attivazione e la visualizzazione dei log, consulta Visualizzazione dei log.
  4. Prova a eseguire un riavvio in sequenza del gruppo di istanze in Cloud Console:

    1. Nella console Google Cloud , vai alla pagina Compute Engine > Gruppi di istanze.

      Vai a Gruppi di istanze

    2. Nell'elenco dei gruppi di istanze, fai clic su quello che non risponde nella colonna Nome.
    3. Fai clic su Riavvio/sostituzione progressivo.
    4. Nella schermata successiva, fai clic su Riavvia.

      L'istanza di Envoy viene riavviata.

IP istanza errato

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

  1. Nella console Google Cloud , vai alla pagina Apigee > Amministrazione > Istanze.

    Vai a Istanze

  2. Prendi nota dell'indirizzo IP dell'istanza. Avrai bisogno di questo IP in un passaggio successivo. Ad esempio: 10.117.200.2.

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

    Vai a Modelli di istanza

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