Memecahkan masalah penginstalan Apigee

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Dokumen ini mencantumkan error umum dan menjelaskan kemungkinan penyelesaiannya saat Anda menginstal dan mengonfigurasi Apigee.

Membuat instance baru

Bagian ini menjelaskan error umum dan kemungkinan penyelesaiannya setelah mengirim permintaan ke Apigee untuk membuat instance baru:

  • 401 (UNAUTHENTICATED) menunjukkan bahwa kredensial Anda mungkin telah habis masa berlakunya. Coba perbarui token otorisasi Anda, seperti yang ditunjukkan dalam contoh berikut: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED menunjukkan bahwa rentang alamat IP yang awalnya Anda minta tidak dapat dipenuhi dan Anda harus meminta rentang baru. Anda awalnya membuat permintaan rentang di Langkah 2: Siapkan jaringan.
    1. Buat variabel lingkungan ini 
      2. RANGE_NAME_1=YOUR_RANGE_NAME_1
  RANGE_NAME_2=YOUR_RANGE_NAME_2
  NETWORK_NAME=YOUR_NETWORK_NAME
    2. Verifikasi detail rentang alamat yang ada dan pastikan tidak akan tumpang-tindih dengan rentang baru. 
      3.  gcloud compute addresses list --global --project=$PROJECT_ID
       
       gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID
    3. Untuk meminta rentang baru yang digunakan Apigee untuk memilih alamat IP bagi koneksi layanan pribadi, jalankan perintah gcloud berikut: 
      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

      Perintah ini akan membuat rentang baru bernama $RANGE_NAME_2.

    4. Verifikasi detail rentang alamat lama dan baru 
      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. Verifikasi detail peering VPC yang ada: 
      6.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID
    6. Jalankan perintah berikut untuk memperbarui permintaan koneksi Anda: 
      7.  gcloud services vpc-peerings update
            --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
            --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID
    7. Verifikasi detail peering VPC yang ada: 
      8.  gcloud services vpc-peerings list \
            --network=$NETWORK_NAME \
            --service=servicenetworking.googleapis.com \
            --project=$PROJECT_ID

Membuat organisasi Apigee

Contoh berikut menunjukkan error umum yang mungkin ditampilkan Apigee saat Anda pertama kali mencoba membuat organisasi:

  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.

Artinya, satu atau beberapa API yang diperlukan tidak diaktifkan. Tinjau API yang tercantum di Langkah 1: Aktifkan API yang diperlukan dan pastikan semua API diaktifkan sebelum Anda melanjutkan.

Selain itu, Anda mungkin mendapatkan salah satu error HTTP berikut:

  • 401 (UNAUTHENTICATED) menunjukkan bahwa kredensial Anda mungkin telah habis masa berlakunya. Coba perbarui token otorisasi Anda, seperti yang ditunjukkan dalam contoh berikut: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) dapat menjadi hasil dari berikut ini:
    • Anda memasukkan URL endpoint/permintaan yang salah. Pastikan Anda menentukan apigee.googleapis.com untuk domain panggilan API.
    • Project Anda mungkin belum disediakan. Hubungi Tim Penjualan Apigee.
  • 409 (Conflict) biasanya menunjukkan bahwa nama organisasi yang diberikan sudah ada. Nama organisasi harus unik secara global. Pilih nama lain untuk organisasi dan terbitkan kembali perintah. (Anda menentukan nama di payload permintaan jika membuat organisasi di command line. Perlu diingat bahwa Anda harus membuat organisasi yang memiliki nama yang sama dengan project Anda, jadi hal ini seharusnya tidak terjadi kecuali ada kesalahan ketik.)

Berikut adalah kemungkinan error yang mungkin ditampilkan Apigee saat Anda memeriksa status permintaan organisasi baru:

  • 403 (Permission Denied) dapat menunjukkan bahwa organisasi belum dibuat. Tunggu satu menit lagi dan coba lagi. Jika Apigee menampilkan 403 saat Anda pertama kali mencoba membuat organisasi baru, hal ini dapat berarti bahwa satu atau beberapa API Anda belum diaktifkan. Pastikan Anda mengaktifkan semua API seperti yang dijelaskan di Langkah 1: Aktifkan API yang diperlukan .

Men-deploy contoh

Load balancer tidak responsif

Saat men-deploy proxy contoh, Apigee mungkin menampilkan error HTTP 502 (Bad Gateway). Dalam hal ini, coba langkah berikut:

  1. Periksa kondisi Load Balancer. Tab Load balancer menampilkan semua load balancer untuk project dan statusnya. Segitiga kuning menunjukkan bahwa layanan backend load balancer tidak responsif.

    Di Google Cloud konsol, buka halaman Network services > Load balancing.

    Buka Load balancing

  2. Setelah mengonfirmasi masalah pada load balancer, periksa VM di instance runtime Anda untuk memastikan VM tersebut aktif dan responsif.
  3. Lihat file log untuk melihat apakah Anda dapat menemukan error atau jenis masalah lain yang mungkin menyebabkan masalah. Untuk mengetahui informasi selengkapnya tentang cara mengaktifkan dan melihat log, lihat Melihat log.
  4. Coba lakukan rolling restart pada grup instance di konsol Cloud:

    1. Di konsol Google Cloud , buka halaman Compute Engine > Instance groups.

      Buka Instance groups

    2. Dari daftar grup instance, klik grup yang tidak merespons di kolom Name.
    3. Klik Rolling Restart/Replace.
    4. Di layar berikutnya, klik Mulai ulang.

      Tindakan ini akan memulai ulang instance Envoy.

IP instance salah

Jika Anda menghapus dan membuat ulang instance Apigee kapan saja, IP instance Apigee akan berubah dan dapat menjadi tidak sinkron dengan IP endpoint template grup instance terkelola (MIG). Misalnya, template MIG akan tetap memiliki IP lama dari instance yang dihapus. Template MIG dibuat selama proses penyediaan Apigee. Dalam situasi ini, coba langkah-langkah berikut untuk memperbarui template MIG dengan IP Apigee yang benar:

  1. Di konsol Google Cloud , buka halaman Apigee > Admin > Instances.

    Buka Instance

  2. Catat Alamat IP instance. Anda akan memerlukan IP ini di langkah selanjutnya. Misalnya: 10.117.200.2.

  3. Di konsol Google Cloud , buka halaman Instance templates.

    Buka Instance templates

  4. Buka template instance. Anda perlu membuka template instance yang digunakan oleh backend yang dipetakan ke load balancer Anda.
  5. Scroll ke bawah untuk menemukan ENDPOINT IP di bagian Metadata kustom.
  6. Jika IP endpoint berbeda dengan yang Anda catat di UI Apigee, Anda harus mengubah IP template Instance agar cocok dengan IP instance Apigee. Lihat Mengubah IP instance.