Pemeliharaan organisasi dan lingkungan

Bagian ini membahas berbagai operasi administratif, misalnya, pembuatan, pengelolaan, dan penghapusan organisasi, lingkungan, dan host virtual Apigee di Apigee Edge untuk penginstalan 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

Server Pengelolaan memainkan peran penting dalam menyatukan semua komponen lain dalam penginstalan Edge Private Cloud lokal. Anda dapat memeriksa status pengguna, organisasi, dan deployment di Server Pengelolaan dengan menjalankan 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 harus menampilkan 200 status HTTP untuk semua panggilan. Jika 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 menggunakan 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 ditetapkan 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 demikian, 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 ini untuk membuat host virtual. Saat membuat host virtual, Anda harus menentukan informasi berikut:

  • Nama host virtual yang Anda gunakan untuk mereferensikannya dalam proxy API.
  • Port pada 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 dari host virtual.

    Router Edge membandingkan header Host permintaan masuk dengan daftar alias host sebagai bagian dari penentuan proxy API yang menangani permintaan. 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 pada port 9001, maka jalankan 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'

    Di formulir kedua, tentukan alamat IP Router, dan teruskan alias host di header Host.

Opsi saat 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

Lalu, buat perintah curl dalam formulir di bawah:

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

Opsi ini lebih disukai karena berfungsi 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 sebuah 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