Pemeliharaan organisasi dan lingkungan

Bagian ini membahas berbagai operasi administratif, misalnya, pembuatan, pengelolaan, dan penghapusan organisasi, lingkungan, dan host virtual Apigee dalam penginstalan Apigee Edge untuk Private Cloud.

Untuk pengantar tentang organisasi, lingkungan, dan host virtual, lihat Tentang planet, region, pod, organisasi, lingkungan, dan host virtual.

Memeriksa Status Pengguna, Organisasi, dan Lingkungan

Management Server berperan penting dalam menyatukan semua komponen lain dalam penginstalan lokal Edge Private Cloud. Anda dapat memeriksa status pengguna, organisasi, dan deployment di Server Pengelolaan dengan mengeluarkan perintah curl berikut:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

Sistem akan menampilkan status HTTP 200 untuk semua panggilan. Jika langkah-langkah ini gagal, lakukan hal berikut:

  1. Periksa log Server Pengelolaan di /opt/apigee/var/log/apigee/management-server untuk menemukan error.
  2. Lakukan panggilan terhadap Server Pengelolaan untuk memeriksa apakah server berfungsi dengan benar.
  3. Hapus server dari ELB, lalu mulai ulang Server Pengelolaan: 
    /opt/apigee/bin/apigee-service management-server restart

Tentang penggunaan file konfigurasi

Perintah yang ditampilkan di bawah menggunakan file konfigurasi sebagai input. Misalnya, Anda meneruskan file konfigurasi ke perintah setup-org untuk menentukan semua properti organisasi, termasuk lingkungan dan host virtual.

Untuk file konfigurasi lengkap, dan informasi tentang properti yang dapat Anda tetapkan dalam file konfigurasi, lihat Melakukan aktivasi organisasi.

Tentang menyiapkan host virtual

Host virtual di Edge menentukan domain dan port Router Edge tempat proxy API diekspos, dan, dengan ekstensi, URL yang digunakan aplikasi untuk mengakses proxy API. Host virtual juga menentukan apakah proxy API diakses menggunakan protokol HTTP, atau protokol HTTPS terenkripsi.

Gunakan skrip dan panggilan API yang ditampilkan di bawah untuk membuat host virtual. Saat membuat host virtual, Anda harus menentukan informasi berikut:

  • Nama host virtual yang Anda gunakan untuk mereferensikannya di proxy API.
  • Port di Router untuk host virtual. Biasanya, port ini dimulai dari 9001 dan bertambah satu untuk setiap host virtual baru.
  • Alias host dari host virtual. Biasanya nama DNS host virtual.

    Router Edge membandingkan header Host dari permintaan masuk dengan daftar alias host sebagai bagian dari penentuan proxy API yang menangani permintaan tersebut. Saat membuat permintaan melalui host virtual, tentukan nama domain yang cocok dengan alias host dari host virtual, atau tentukan alamat IP Router dan header Host yang berisi alias host.

Misalnya, jika Anda membuat host virtual dengan alias host myapis.apigee.net di port 9001, maka eksekusi permintaan curl ke API melalui host virtual tersebut dapat menggunakan salah satu bentuk berikut:

  • Jika Anda memiliki entri DNS untuk myapis.apigee.net: 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Jika Anda tidak memiliki entri DNS untuk myapis.apigee.net: 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    Dalam bentuk kedua, Anda menentukan alamat IP Router, dan meneruskan alias host di header Host.

Opsi jika Anda tidak memiliki entri DNS untuk host virtual

Salah satu opsi jika Anda tidak memiliki entri DNS adalah menetapkan alias host ke alamat IP Router dan port host virtual, sebagai routerIP:port. Contoh:

192.168.1.31:9001

Kemudian, buat perintah curl dalam formulir di bawah:

curl http://routerIP:9001/proxy-base-path/resource-path

Opsi ini lebih disukai karena berfungsi dengan baik dengan UI Edge.

Jika Anda memiliki beberapa Router, tambahkan alias host untuk setiap Router, dengan menentukan alamat IP setiap Router dan port host virtual.

Atau, Anda dapat menetapkan alias host ke nilai, seperti temp.hostalias.com. Kemudian, Anda harus meneruskan header Host pada setiap permintaan:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

Atau, tambahkan alias host ke file /etc/hosts Anda. Misalnya, tambahkan baris ini ke /etc/hosts:

192.168.1.31   temp.hostalias.com

Kemudian, Anda dapat membuat permintaan seolah-olah Anda memiliki entri DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path