Tentang planet, region, pod, organisasi, lingkungan, dan host virtual

Edge untuk Private Cloud v4.18.05

Penginstalan Edge Private Cloud lokal, atau instance Edge, terdiri dari beberapa komponen Edge yang diinstal pada satu set node server. Gambar berikut menunjukkan hubungan antara planet, region, pod, organisasi, lingkungan, dan host virtual yang membentuk instance Edge:

Tabel berikut menjelaskan hubungan ini:

Komponen Berisi Dikaitkan dengan Default
Planet Satu atau beberapa region t/a
Region Satu atau beberapa pod "dc-1"
Pod Satu atau beberapa komponen Edge "central"
"gateway"
"analytics"
Organisasi Satu atau beberapa lingkungan Satu atau beberapa pod yang berisi Pemroses Pesan, dan pengguna bertindak sebagai admin org tidak ada
Lingkungan Satu atau beberapa {i>host<i} virtual Satu atau beberapa Pemroses Pesan di pod yang terkait dengan organisasi induk tidak ada
Host Virtual Satu atau beberapa alias host tidak ada

Tentang Planets

Sebuah planet mewakili seluruh lingkungan hardware dan software Edge serta dapat berisi satu atau beberapa region. Di Edge, planet adalah pengelompokan wilayah yang logis: Anda tidak membuat atau mengonfigurasi planet secara eksplisit sebagai bagian dari penginstalan Edge.

Tentang Wilayah

Region adalah pengelompokan dari satu atau beberapa pod. Secara default, saat Anda menginstal Edge, penginstal membuat satu region bernama "dc-1" yang berisi tiga pod, seperti yang ditunjukkan dalam tabel berikut:

Region Pod di wilayah
"dc-1" "gateway", "central", "analytics"

Gambar berikut menampilkan wilayah default:

Gambar ini menampilkan load balancer yang mengarahkan traffic ke pod "gateway". Pod "gateway" berisi komponen Router Edge dan Pemroses Pesan yang menangani permintaan API. Kecuali Anda menentukan beberapa pusat data, Anda tidak perlu membuat region tambahan.

Dalam penginstalan yang lebih kompleks, Anda dapat membuat dua region atau lebih. Salah satu alasan untuk membuat beberapa region adalah untuk mengatur mesin secara geografis, yang meminimalkan waktu transit jaringan. Dalam skenario ini, Anda menghosting endpoint API sehingga secara geografis dekat dengan konsumen API tersebut.

Di Edge, setiap region disebut sebagai pusat data. Pusat data di AS Bagian Timur kemudian dapat menangani permintaan yang tiba dari Boston, Massachusetts, sedangkan pusat data di Singapura dapat menangani permintaan yang berasal dari perangkat atau komputer di Asia.

Misalnya, gambar berikut menampilkan dua region, yang sesuai dengan dua pusat data:

Tentang Pod

Pod adalah pengelompokan satu atau beberapa komponen Edge dan datastore Cassandra. Komponen Edge dapat diinstal pada node yang sama, tetapi lebih sering diinstal pada node yang berbeda. Datastore Cassandra adalah repositori data yang digunakan oleh komponen Edge di pod.

Secara default, saat Anda menginstal Edge, penginstal akan membuat tiga pod dan mengaitkan komponen Edge dan datastore Cassandra berikut dengan setiap pod:

Pod Komponen Edge

Datastore Casssandra
"gateway" Router, Pemroses Pesan cache-datastore
counter-datastore
dc-datastore 		keyvaluemap-datastore
kms-datastore
"central" Server Pengelolaan, Zookeeper, LDAP, UI, Qpid application-datastore
apimodel-datastore
audit-datastore
auth-datastore		 identityzone-datastore
edgenotification-datastore
pengelolaan-server
scheduler-datastore
user-settings-datastore
"analytics" Postgres analytics-datastore reportcrud-datastore

Komponen Edge dan datastore Cassandra di pod "gateway" diperlukan untuk pemrosesan API. Komponen dan datastore ini harus aktif dan berjalan untuk memproses permintaan API. Komponen dan datastore di pod "pusat" dan "analisis" tidak diperlukan untuk memproses API, tetapi menambahkan fungsi tambahan ke Edge.

Gambar berikut menampilkan komponen di setiap pod:

Anda dapat menambahkan pod Message Processor dan Router tambahan ke tiga pod yang dibuat secara default. Atau, Anda dapat menambahkan komponen Edge tambahan ke pod yang ada. Misalnya, Anda dapat menambahkan Router dan Prosesor Pesan ke pod "gateway" untuk menangani peningkatan beban traffic.

Perhatikan bahwa pod "gateway" berisi komponen Router Edge dan Prosesor Pesan. Router hanya mengirim permintaan ke Message Processors dalam pod yang sama, dan bukan ke Message Processors dalam pod lainnya.

Anda dapat menggunakan panggilan API berikut untuk melihat detail pendaftaran server di akhir penginstalan untuk setiap pod. Ini adalah alat pemantauan yang berguna.

curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=podName

Dengan ms_IP adalah alamat IP atau nama DNS Server Pengelolaan, dan podName adalah salah satu dari berikut ini:

  • gateway
  • central
  • analytics

Misalnya, untuk pod "gateway":

curl -u adminEmail:pword http://ms_IP:8080/v1/servers?pod=gateway

Apigee menampilkan output yang mirip dengan berikut ini:

[ {
  "externalHostName" : "localhost",
  "externalIP" : "192.168.1.11",
  "internalHostName" : "localhost",
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ {
      "name" : "jmx.rmi.port",
      "value" : "1101"
    }, ... ]
  },
  "type" : [ "message-processor" ],
  "uUID" : "276bc250-7dd0-46a5-a583-fd11eba786f8"
}, 
{
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "dc-datastore", "management-server", "cache-datastore", "keyvaluemap-datastore", "counter-datastore", "kms-datastore" ],
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
},
{
  "externalHostName" : "localhost",
  "externalIP" : "192.168.1.11",
  "internalHostName" : "localhost",
  "internalIP" : "192.168.1.11",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "dc-1",
  "tags" : {
    "property" : [ {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    }, ... ]
  },
  "type" : [ "router" ],
  "uUID" : "de8a0200-e405-43a3-a5f9-eabafdd990e2"
} ]

Atribut type mencantumkan jenis komponen. Perhatikan bahwa perintah ini mencantumkan datastore Cassandra yang terdaftar di pod. Saat node Cassandra diinstal di pod "gateway", Anda akan melihat datastore Cassandra terdaftar dengan semua pod.

Tentang Organisasi

Organisasi adalah penampung untuk semua objek di akun Apigee, termasuk API, produk API, aplikasi, dan developer. Sebuah organisasi dikaitkan dengan satu atau beberapa pod, di mana setiap pod harus berisi satu atau beberapa Message Processors.

Dalam penginstalan Edge Private Cloud lokal, tidak ada organisasi secara default. Saat membuat organisasi, Anda menentukan dua informasi:

  1. Pengguna yang berfungsi sebagai administrator organisasi. Pengguna tersebut kemudian dapat menambahkan pengguna lainnya ke organisasi, dan menetapkan peran setiap pengguna.
  2. Pod "gateway", pod yang berisi Prosesor Pesan.

Organisasi dapat berisi satu atau beberapa lingkungan. Prosedur penginstalan Edge default akan meminta Anda membuat dua lingkungan: "test" dan "prod". Namun, Anda dapat membuat lingkungan lainnya sesuai kebutuhan, seperti "staging", "eksperimen", dll.

Organisasi menyediakan cakupan untuk beberapa kemampuan Apigee. Misalnya, data peta nilai kunci (KVM) tersedia di tingkat organisasi, yang berarti dari semua lingkungan. Kemampuan lain, seperti caching, dicakup dalam lingkungan tertentu. Data analisis Apigee dipartisi berdasarkan kombinasi organisasi dan lingkungan.

Di bawah ini adalah objek utama organisasi, termasuk yang didefinisikan secara global dalam organisasi, dan objek yang ditentukan secara khusus untuk lingkungan:

Tentang Lingkungan

Lingkungan adalah konteks eksekusi runtime untuk proxy API dalam organisasi. Anda harus men-deploy proxy API ke lingkungan sebelum dapat diakses. Anda dapat men-deploy proxy API ke satu lingkungan atau beberapa lingkungan.

Sebuah organisasi dapat berisi beberapa lingkungan. Misalnya, Anda dapat menentukan lingkungan "dev", "test", dan "prod" dalam organisasi.

Saat membuat lingkungan, Anda akan mengaitkannya dengan satu atau beberapa Pemroses Pesan. Anda dapat menganggap lingkungan sebagai sekumpulan Prosesor Pesan bernama tempat proxy API dijalankan. Setiap lingkungan dapat dikaitkan dengan Pemroses Pesan yang sama, atau dengan pemroses yang berbeda.

Untuk membuat lingkungan, tentukan dua informasi:

  1. Organisasi yang berisi lingkungan.
  2. Pemroses Pesan yang menangani permintaan proxy API ke lingkungan. Pemroses Pesan ini harus berada dalam pod yang terkait dengan organisasi induk lingkungan.
    Secara default, saat Anda membuat lingkungan, Edge mengaitkan semua Prosesor Pesan yang tersedia di pod "gateway" dengan lingkungan. Atau, Anda dapat menentukan subset dari Pemroses Pesan yang tersedia sehingga Pemroses Pesan yang berbeda akan menangani permintaan ke lingkungan yang berbeda.

Pemroses Pesan dapat dikaitkan dengan beberapa lingkungan. Misalnya, penginstalan Edge berisi dua Prosesor Pesan: A dan B. Anda kemudian membuat tiga lingkungan di organisasi: "dev", "test", dan "prod":

  • Untuk lingkungan "dev", Anda mengaitkan Message Processor A karena tidak mengharapkan volume traffic yang besar.
  • Untuk lingkungan "pengujian", Anda mengaitkan Message Processor B karena tidak mengharapkan volume traffic yang besar.
  • Untuk lingkungan "prod", Anda harus mengaitkan pemroses Pesan A dan B untuk menangani volume level produksi.

Pemroses Pesan yang ditetapkan ke suatu lingkungan, semuanya dapat berasal dari pod yang sama, atau dapat berasal dari beberapa pod, yang mencakup beberapa region dan pusat data. Misalnya, Anda menentukan lingkungan "global" di organisasi Anda yang mencakup Pemroses Pesan dari tiga region, yang berarti tiga pusat data yang berbeda: AS, Jepang, dan Jerman.

Men-deploy proxy API ke lingkungan "global" menyebabkan proxy API berjalan pada Pemroses Pesan di ketiga pusat data. Traffic API yang tiba di Router di salah satu pusat data tersebut akan diarahkan hanya ke Message Processors di pusat data tersebut karena Router hanya mengarahkan traffic ke Message Processors di pod yang sama.

Tentang host virtual

Host virtual menentukan port pada Router Edge tempat proxy API terekspos, dan, dengan demikian, URL yang digunakan aplikasi untuk mengakses proxy API. Setiap lingkungan harus menentukan setidaknya satu host virtual.

Pastikan nomor port yang ditentukan oleh host virtual terbuka pada node Router. Anda kemudian dapat mengakses proxy API dengan membuat permintaan ke URL berikut:

http://routerIP:port/proxy-base-path/resource-name
https://routerIP:port/proxy-base-path/resource-name

Dengan keterangan:

  • http atau https: Jika host virtual dikonfigurasi untuk mendukung TLS/SSL, gunakan HTTPS. Jika host virtual tidak mendukung TLS/SSL, gunakan HTTP.
  • routerIP:port adalah alamat IP dan nomor port host virtual.
  • proxy-base-path dan resource-name ditetapkan saat Anda membuat proxy API.

Biasanya, Anda tidak memublikasikan API kepada pelanggan dengan alamat IP dan nomor port. Sebagai gantinya, Anda menentukan entri DNS untuk {i>Router<i} dan porta. Contoh:

http://myAPI.myCo.com/proxy-base-path/resource-name
https://myAPI.myCo.com/proxy-base-path/resource-name

Anda juga harus membuat alias host untuk host virtual yang cocok dengan nama domain entri DNS. Dari contoh di atas, Anda akan menentukan alias host dari myAPI.myCo.com. Jika Anda tidak memiliki entri DNS, tetapkan alias host ke alamat IP Router dan port host virtual, sebagai routerIP:port.

Untuk mengetahui informasi selengkapnya, lihat Tentang host virtual.

Menciptakan organisasi, lingkungan, dan host virtual pertama Anda

Setelah menyelesaikan proses penginstalan Edge, tindakan pertama Anda biasanya adalah membuat organisasi, lingkungan, dan host virtual melalui proses "onboarding". Untuk melakukan orientasi, jalankan perintah berikut pada node Edge Management Server:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Perintah ini menggunakan file konfigurasi sebagai input yang menentukan pengguna, organisasi, lingkungan, dan host virtual.

Misalnya, Anda membuat:

  • Pengguna yang Anda pilih untuk berfungsi sebagai administrator organisasi
  • Organisasi bernama example
  • Lingkungan dalam organisasi bernama prod yang terkait dengan semua Prosesor Pesan di pod "gateway"
  • Host virtual di lingkungan bernama default yang mengizinkan akses HTTP pada port 9001
  • Alias host untuk host virtual

Setelah menjalankan skrip tersebut, Anda dapat mengakses API menggunakan URL dalam bentuk:

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

Kemudian, Anda dapat menambahkan sejumlah organisasi, lingkungan, dan host virtual.

Untuk informasi selengkapnya, lihat Melakukan aktivasi organisasi.