Memecahkan masalah penginstalan Apigee

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

Lihat dokumentasi Apigee Edge.

Dokumen ini berisi daftar error umum dan menjelaskan kemungkinan resolusi saat Anda menginstal dan mengonfigurasi Apigee.

Membuat instance baru

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

  • 401 (UNAUTHENTICATED) menunjukkan bahwa waktu tunggu kredensial Anda mungkin habis. Coba perpanjang token otorisasi Anda, seperti yang ditunjukkan pada contoh berikut: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • RANGES_EXHAUSTED menunjukkan bahwa rentang alamat IP yang awalnya Anda minta tidak dapat diakomodasi dan Anda harus meminta rentang baru. Anda awalnya membuat permintaan rentang di Langkah 4: Konfigurasi jaringan layanan.

    Untuk meminta rentang baru tempat Apigee memilih alamat IP untuk koneksi layanan pribadi:

    1. Jalankan perintah gcloud berikut: 
      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

      Perintah ini akan membuat rentang baru bernama google-svcs-2.

    2. Jalankan perintah berikut untuk memperbarui permintaan koneksi Anda: 
      gcloud services vpc-peerings update
  --service=servicenetworking.googleapis.com --network=default
  --ranges=google-svcs,google-svcs-2 --project=$PROJECT_ID

      Catatan: Anda harus menentukan nama rentang pertama (dalam hal ini, google-svcs) dan nama untuk rentang yang baru diminta (dalam hal ini, google-svcs-2). Untuk mengetahui informasi selengkapnya, lihat update vpc-peerings layanan gcloud.

Membuat organisasi Apigee

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

Error organisasi dibuat

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

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

  • 401 (UNAUTHENTICATED) menunjukkan bahwa waktu tunggu kredensial Anda mungkin habis. Coba perpanjang token otorisasi Anda, seperti yang ditunjukkan pada contoh berikut: 
    AUTH="Authorization: Bearer $(gcloud auth print-access-token)"
  • 404 (Not Found) dapat berupa hasil dari hal berikut:
    • Anda memasukkan URL permintaan/endpoint yang salah. Pastikan Anda telah menentukan apigee.googleapis.com untuk domain panggilan API.
    • Project Anda mungkin belum tersedia. Hubungi Bagian 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 keluarkan ulang perintah. (Anda dapat menentukan nama dalam payload permintaan jika membuat organisasi pada command line. Perlu diingat bahwa Anda harus membuat organisasi dengan nama yang sama dengan project Anda, jadi hal ini tidak akan terjadi kecuali jika 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 sebentar dan coba lagi. Jika Apigee menampilkan 403 saat Anda pertama kali mencoba membuat organisasi baru, ini bisa berarti satu atau beberapa API Anda belum diaktifkan. Pastikan Anda mengaktifkan semua API seperti yang dijelaskan di Langkah 2: Aktifkan Apigee API.

Men-deploy contoh

Load balancer tidak responsif

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

  1. Buka Cloud Console.
  2. Memeriksa kondisi Load Balancer. Di Cloud Console, pilih Network services > Load balancing. Tab Load balancer menampilkan semua load balancer untuk project dan statusnya. Segitiga kuning menunjukkan bahwa layanan backend load balancer tidak responsif.
  3. Setelah mengonfirmasi masalah dengan load balancer, periksa VM di instance runtime untuk memastikan bahwa VM tersebut aktif dan responsif.
  4. Lihat file log untuk melihat apakah Anda dapat menemukan error atau jenis masalah lain yang mungkin menimbulkan masalah. Untuk informasi selengkapnya tentang cara mengaktifkan dan melihat log, lihat Melihat log.
  5. Coba lakukan mulai ulang berkelanjutan pada grup instance di Cloud Console:
    1. Pilih Compute Engine > Instance Groups.
    2. Dari daftar grup instance, klik grup yang tidak merespons di kolom Name.
    3. Klik Rolling Restart/Replace, seperti yang ditunjukkan contoh berikut:

      Mulai ulang berkelanjutan Compute Engine

    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, IP instance Apigee dapat berubah dan dapat tidak sinkron dengan IP endpoint template grup instance terkelola (MIG). Misalnya, template MIG akan masih memiliki IP lama dari instance yang dihapus. Template MIG dibuat selama proses penyediaan Apigee. Dalam situasi ini, coba langkah-langkah berikut untuk mengupdate template MIG dengan IP Apigee yang benar:

  1. Buka UI Apigee.

    Buka UI Apigee

  2. Buka Admin > Instance.
  3. Catat Alamat IP instance. Anda perlu mengetahui IP ini di langkah selanjutnya. Misalnya: 10.117.200.2.

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

    Buka Instance templates

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