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 risoluzioni per quando installi e configuri 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 il tempo di accesso alle tue credenziali potrebbe essere scaduto. Prova a rinnovare il token di autorizzazione, come mostrato nell'esempio seguente: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED indica che non è stato possibile soddisfare l'intervallo di indirizzi IP inizialmente richiesto e che devi richiederne uno nuovo. 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 ai servizi privati, 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 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 il seguente 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 mostrare la prima volta che provi a creare un'organizzazione:

Errore durante la creazione dell'organizzazione

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

Inoltre, è possibile che venga visualizzato uno dei seguenti errori HTTP:

  • 401 (UNAUTHENTICATED) indica che le tue credenziali potrebbero essere scadute fuori. 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 di quanto segue:
    • Hai inserito l'URL dell'endpoint/richiesta errato. Verifica di aver specificato apigee.googleapis.com per il dominio della chiamata API.
    • Il provisioning del progetto potrebbe non essere ancora stato eseguito. Contatta il team di vendita Apigee.
  • 409 (Conflict) di solito indica che il nome dell'organizzazione fornito esiste già. I nomi delle organizzazioni devono essere univoci a livello globale. Scegli un altro nome per l'organizzazione e emetti nuovamente il comando. Se crei un'organizzazione sulla riga di comando, specifica il nome nel payload della richiesta. Tieni presente che devi creare un'organizzazione con lo stesso nome del progetto, quindi questo non dovrebbe accadere a meno che non ci sia un errore ortografico.

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 è stato creato. Attendi un altro minuto e riprova. Se Apigee restituisce un 403 la prima volta che a creare la nuova organizzazione, è possibile che una o più API non siano state in un bucket in cui è abilitato il controllo delle versioni. Assicurati di aver abilitato tutte le API come descritto in Passaggio 1: abilita le API richieste di Google.

Deployment degli esempi in corso

Bilanciatore del carico non in stato di integrità

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. Controlla l'integrità del bilanciatore del carico. In Cloud Console, seleziona Servizi di rete > Bilanciamento del carico. Il bilanciatore del carico mostra tutti i bilanciatori del carico del 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 le VM nell'istanza di runtime per assicurarti che siano attive e in buono stato.
  4. Controlla i file di log per verificare se riesci a trovare un errore o un altro tipo di problema che potrebbe a causare un problema. Per ulteriori informazioni sull'attivazione e la visualizzazione dei log, consulta Visualizzazione dei log.
  5. Prova a eseguire un riavvio graduale del gruppo di istanze nella console Cloud:
    1. Seleziona Compute Engine > 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 in sequenza, come illustrato nell'esempio seguente:

      Riavvio in sequenza di Compute Engine

    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, cambia l'IP dell'istanza Apigee e può non essere sincronizzato con il gruppo di istanze gestite l'IP endpoint del modello. Ad esempio, il modello MIG avrà ancora il vecchio IP del eliminata. Il modello MIG è stato creato durante la procedura di provisioning di Apigee. In questo caso, prova a seguire questi passaggi per aggiornare il modello MIG con l'IP Apigee corretto:

  1. Apri l'interfaccia utente di Apigee.

    Vai alla UI di Apigee

  2. Vai ad Amministrazione > Istanze.
  3. Prendi nota dell'indirizzo IP dell'istanza. Dovrai conoscere questo indirizzo 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 di backend mappato al tuo bilanciatore del carico.
  6. Scorri verso il basso fino a individuare l'IP di ENDPOINT nella sezione Metadati personalizzati.
  7. Se l'IP dell'endpoint è diverso da quello annotato nell'interfaccia utente di Apigee, devi modificare l'IP del modello di istanza in modo che corrisponda all'IP dell'istanza Apigee. Consulta Modificare gli IP delle istanze.