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 penyelesaian 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 waktunya. Coba perbarui 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 2: Menyiapkan jaringan.
  1. Buat variabel lingkungan ini

  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 rentang tersebut tidak akan tumpang-tindih dengan rentang baru.

   gcloud compute addresses list --global --project=$PROJECT_ID

   gcloud compute addresses describe $RANGE_NAME_1 --global --project=$PROJECT_ID 

  3. Untuk meminta rentang baru tempat Apigee memilih alamat IP untuk koneksi layanan pribadi, jalankan perintah gcloud berikut:

   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

   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:

   gcloud services vpc-peerings list \
              --network=$NETWORK_NAME \
              --service=servicenetworking.googleapis.com \
              --project=$PROJECT_ID 

  6. Jalankan perintah berikut untuk memperbarui permintaan koneksi Anda:

   gcloud services vpc-peerings update
              --service=servicenetworking.googleapis.com --network=$NETWORK_NAME
              --ranges=$RANGE_NAME_1,$RANGE_NAME_2 --project=$PROJECT_ID 

  Catatan: Anda harus menentukan nama rentang pertama (dalam hal ini, RANGE_NAME_1) dan nama untuk rentang yang baru diminta (dalam hal ini, RANGE_NAME_2). Untuk informasi selengkapnya, lihat pembaruan vpc-peerings layanan gcloud.
  7. Verifikasi detail peering VPC yang ada:

   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:

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 waktunya. Coba perbarui 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 endpoint/permintaan yang salah. Pastikan Anda menentukan apigee.googleapis.com untuk domain panggilan API.
  • Project Anda mungkin belum disediakan. Hubungi 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 ulang perintah. (Anda menentukan nama dalam 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 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 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 telah mengaktifkan semua API seperti yang dijelaskan di Langkah 1: Mengaktifkan 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. Buka Cloud Console.
2. Periksa 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 pada load balancer, periksa VM di instance runtime Anda untuk memastikan VM tersebut aktif dan responsif.
4. Lihat file log untuk melihat apakah Anda dapat menemukan error atau jenis masalah lainnya yang mungkin menyebabkan masalah. Untuk informasi selengkapnya tentang cara mengaktifkan dan melihat log, lihat Melihat log.
5. Coba lakukan mulai ulang secara bertahap pada grup instance di konsol Cloud:
   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 pada contoh berikut:

      

   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. Buka UI Apigee.

   Buka UI Apigee

2. Buka Admin > Instances.
3. Catat Alamat IP instance. Anda perlu mengetahui IP ini di langkah berikutnya. 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.
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. Lihat Mengubah IP instance.