Gezegenler, bölgeler, kapsüller, kuruluşlar, ortamlar ve sanal ana makineler hakkında

Private Cloud için Edge v4.18.05

Edge Private Cloud'ın şirket içi kurulumu veya Edge örneği, bir dizi sunucu düğümüne yüklenen birden fazla Edge bileşeninden oluşur. Aşağıdaki resimde, bir Edge örneğini oluşturan gezegen, bölgeler, kapsüller, kuruluşlar, ortamlar ve sanal ana makineler arasındaki ilişki gösterilmektedir:

Aşağıdaki tabloda bu ilişkiler açıklanmaktadır:

Bileşen Şunu içerir: Şununla ilişkilendiriliyor: Varsayılan
Planet Bir veya daha fazla bölge Yok
Bölge Bir veya daha fazla kapsül "dc-1"
Kapsül Bir veya daha fazla Edge bileşeni "central"
"gateway"
"analytics"
Kuruluş Bir veya daha fazla ortam Mesaj işleyiciler ve kuruluş yöneticisi olarak çalışan bir kullanıcı içeren bir veya daha fazla kapsül yok
Ortam Bir veya daha fazla sanal ana makine Üst kuruluşla ilişkili bir kapsülün içinde bir veya daha fazla Mesaj İşleyen yok
Sanal ana makine Bir veya daha fazla ana makine takma adı yok

Gezegenler hakkında

Gezegen, Edge donanım ve yazılım ortamının tamamını temsil eder ve bir veya daha fazla bölge içerebilir. Edge'de gezegen, bölgelerin mantıksal bir gruplandırılmasıdır: Edge'i yükleme kapsamında açıkça bir gezegen oluşturmaz veya yapılandırmazsınız.

Bölgeler hakkında

Bölge, bir veya daha fazla kapsülün gruplandırılmasıdır. Edge'i yüklediğinizde yükleyici varsayılan olarak aşağıdaki tabloda gösterildiği gibi üç kapsül içeren "dc-1" adlı tek bir bölge oluşturur:

Bölge Bölgedeki kapsüller
"dc-1" "gateway", "central", "analytics"

Aşağıdaki resimde varsayılan bölgeler gösterilmektedir:

Bu resimde, trafiği "geçiş noktası" kapsülüne yönlendiren yük dengeleyici gösterilmektedir. "Gateway" kapsülü, API isteklerini işleyen Edge Router ve Mesaj İşleyici bileşenlerini içerir. Birden fazla veri merkezi tanımlamadığınız sürece ek bölge oluşturmanız gerekmez.

Daha karmaşık bir kurulumda iki veya daha fazla bölge oluşturabilirsiniz. Birden fazla bölge oluşturmanın bir nedeni, makineleri coğrafi olarak düzenlemektir. Bu sayede ağ aktarma süresi en aza indirilir. Bu senaryoda, API uç noktalarını bu API'lerin tüketicilerine coğrafi olarak yakın olacak şekilde barındırırsınız.

Edge'de her bölgeye veri merkezi adı verilir. Bu sayede, ABD'nin doğusundaki bir veri merkezi, Massachusetts, Boston'dan gelen istekleri işleyebilirken Singapur'daki bir veri merkezi, Asya'daki cihazlardan veya bilgisayarlardan gelen istekleri işleyebilir.

Örneğin, aşağıdaki resimde iki veri merkezine karşılık gelen iki bölge gösterilmektedir:

Kapsüller hakkında

pod, bir veya daha fazla Edge bileşeni ve Cassandra veri deposunun gruplandırılmasıdır. Edge bileşenleri aynı düğüme yüklenebilir ancak daha yaygın olarak farklı düğümlere yüklenir. Cassandra veri deposu, kapsülün içindeki Edge bileşenleri tarafından kullanılan bir veri deposudur.

Edge'i yüklediğinizde yükleyici varsayılan olarak üç kapsül oluşturur ve aşağıdaki Edge bileşenlerini ve Cassandra veri depolarını her kapsülle ilişkilendirir:

Kapsül Edge bileşenleri

Cassandra veri depoları
"gateway" Yönlendirici, Mesaj İşleyici cache-datastore
counter-datastore
dc-datastore 		keyvaluemap-datastore
kms-datastore
"central" Yönetim sunucusu, Zookeeper, LDAP, kullanıcı arayüzü, Qpid application-datastore
apimodel-datastore
audit-datastore
auth-datastore		 identityzone-datastore
edgenotification-datastore
management-server
scheduler-datastore
user-settings-datastore
"analytics" Postgres analytics-datastore reportcrud-datastore

API işleme için "gateway" kapsülündeki Edge bileşenleri ve Cassandra veri depoları gereklidir. API isteklerinin işlenmesi için bu bileşenlerin ve veri depolarının çalışır durumda olması gerekir. "Merkezi" ve "analiz" kapsüllerindeki bileşenler ve veri depoları, API'leri işlemek için gerekli değildir ancak Edge'e ek işlevler ekler.

Aşağıdaki resimde her kapsülün bileşenleri gösterilmektedir:

Varsayılan olarak oluşturulan üçe ek olarak daha fazla İleti İşleyen ve Yönlendirici kapsülü ekleyebilirsiniz. Alternatif olarak, mevcut bir kapsüle başka Edge bileşenleri de ekleyebilirsiniz. Örneğin, artan trafik yüklerini yönetmek için "ağ geçidi" kapsülüne ek yönlendiriciler ve ileti işleyiciler ekleyebilirsiniz.

"Gateway" kapsülündeki Edge Router ve Message Processor bileşenlerine dikkat edin. Yönlendiriciler, yalnızca aynı kapsülün içindeki Mesaj İşleyicilere istek gönderir, diğer kapsüllerdeki Mesaj İşleyicilere istek göndermez.

Her kapsülün yükleme işleminin sonunda sunucu kaydı ayrıntılarını görüntülemek için aşağıdaki API çağrısını kullanabilirsiniz. Bu, faydalı bir izleme aracıdır.

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

Burada ms_IP, yönetim sunucusunun IP adresi veya DNS adıdır ve podName aşağıdakilerden biridir:

  • gateway
  • central
  • analytics

Örneğin, "gateway" kapsülü için:

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

Apigee, aşağıdakine benzer bir çıkış döndürür:

[ {
  "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"
} ]

type özelliği, bileşen türünü listeler. Bu komutun, pod'a kaydedilen Cassandra veri depolarını listelediğini unutmayın. Cassandra düğümleri "geçiş noktası" kapsülüne yüklenirken Cassandra veri depolama alanlarının tüm kapsüllere kaydedildiğini görürsünüz.

Kuruluşlar Hakkında

Kuruluş; API'ler, API ürünleri, uygulamalar ve geliştiriciler dahil olmak üzere bir Apigee hesabındaki tüm nesneleri içeren bir kapsayıcıdır. Bir kuruluş, bir veya daha fazla kapsülle ilişkilendirilir. Her kapsülde bir veya daha fazla Mesaj İşleyen bulunmalıdır.

Edge Private Cloud'un şirket içi kurulumunda varsayılan olarak kuruluş yoktur. Kuruluş oluştururken iki bilgi belirtirsiniz:

  1. Kuruluş yöneticisi olarak görev yapan bir kullanıcı. Bu kullanıcı daha sonra kuruluşa başka kullanıcılar ekleyebilir ve her kullanıcının rolünü ayarlayabilir.
  2. "Ağ geçidi" kapsülü, ileti işleyicileri içeren kapsüldür.

Bir kuruluşta bir veya daha fazla ortam bulunabilir. Varsayılan Edge yükleme prosedürü, iki ortam oluşturmanızı ister: "test" ve "prod". Ancak, gerektiğinde "hazırlama", "denemeler" vb. daha fazla ortam oluşturabilirsiniz.

Kuruluş, bazı Apigee özellikleri için kapsam sağlar. Örneğin, anahtar/değer eşleme (KVM) verileri kuruluş düzeyinde kullanılabilir. Yani tüm ortamlardan kullanılabilir. Önbelleğe alma gibi diğer özellikler belirli bir ortamla sınırlıdır. Apigee analiz verileri, kuruluş ve ortam kombinasyonuna göre bölümlenir.

Aşağıda, kuruluşta global olarak tanımlananlar ve belirli bir ortam için tanımlananlar da dahil olmak üzere bir kuruluşun ana nesneleri gösterilmektedir:

Ortamlar hakkında

Ortam, bir kuruluştaki API proxy'leri için çalışma zamanı yürütme bağlamıdır. Bir ortama erişebilmek için ortama bir API proxy dağıtmanız gerekir. API proxy'sini tek bir ortama veya birden fazla ortama dağıtabilirsiniz.

Bir kuruluş birden fazla ortam içerebilir. Örneğin, bir kuruluşta "dev", "test" ve "prod" ortamları tanımlayabilirsiniz.

Bir ortam oluşturduğunuzda bu ortamı bir veya daha fazla Mesaj İşleyici ile ilişkilendirirsiniz. Bir ortamı, API proxy'lerinin çalıştığı adlandırılmış bir Mesaj İşleyiciler grubu olarak düşünebilirsiniz. Her ortam, aynı Mesaj İşleyicilerle veya farklı Mesaj İşleyicilerle ilişkilendirilebilir.

Ortam oluşturmak için iki bilgi belirtin:

  1. Ortamı içeren kuruluş.
  2. Ortamdaki API proxy isteklerini işleyen Mesaj İşleyiciler. Bu Mesaj İşleyicileri, ortamın üst kuruluşuyla ilişkili bir kapsülün içinde olmalıdır.
    Varsayılan olarak, bir ortam oluşturduğunuzda Edge, "ağ geçidi" kapsülündeki tüm mevcut Mesaj İşleyicileri ortamla ilişkilendirir. Alternatif olarak, farklı Mesaj İşleyenlerin farklı ortamlara yönelik istekleri işleyeceği şekilde, mevcut Mesaj İşleyenlerin bir alt kümesini belirtebilirsiniz.

Mesaj işleyiciler birden fazla ortamla ilişkilendirilebilir. Örneğin, Edge kurulumunuzda A ve B olmak üzere iki Mesaj İşleyen bulunur. Ardından kuruluşunuzda "dev", "test" ve "prod" olmak üzere üç ortam oluşturursunuz:

  • "dev" ortamı için çok fazla trafik beklemediğinizden Mesaj İşleyen A'yı ilişkilendirirsiniz.
  • "Test" ortamı için, çok fazla trafik beklemediğiniz için B mesaj işleyicisini ilişkilendirirsiniz.
  • "prod" ortamı için üretim düzeyindeki hacmi işlemek üzere hem A hem de B Mesaj İşleyicilerini ilişkilendirirsiniz.

Bir ortama atanan Mesaj İşleyenlerin tümü aynı kapsülün içinden veya birden fazla bölgeyi ve veri merkezini kapsayan birden fazla kapsülün içinden olabilir. Örneğin, kuruluşunuzda üç bölgeden (ABD, Japonya ve Almanya) Mesaj İşleyici içeren "global" bir ortam tanımlarsınız. Bu, üç farklı veri merkezi anlamına gelir.

"Küresel" ortama API proxy'si dağıtmak, API proxy'sinin üç veri merkezinin tamamındaki Mesaj İşleyiciler'de çalışmasına neden olur. Bu veri merkezlerinden herhangi birinde bir Yönlendirici'ye gelen API trafiği, yalnızca aynı kapsülün Mesaj İşleyicileri'ne yönlendirildiği için yalnızca söz konusu veri merkezindeki Mesaj İşleyicileri'ne yönlendirilir.

Sanal ana makineler hakkında

Sanal ana makine, Edge Yönlendirici'de API proxy'nin gösterildiği bağlantı noktasını ve buna bağlı olarak uygulamaların API proxy'ye erişmek için kullandığı URL'yi tanımlar. Her ortamda en az bir sanal ana makine tanımlanmalıdır.

Sanal ana makine tarafından belirtilen bağlantı noktası numarasının Yönlendirici düğümünde açık olduğundan emin olun. Ardından aşağıdaki URL'lere istek göndererek API proxy'sine erişebilirsiniz:

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

Burada:

  • http veya https: Sanal ana makine, TLS/SSL'yi destekleyecek şekilde yapılandırılmışsa HTTPS'yi kullanın. Sanal ana makine TLS/SSL'yi desteklemiyorsa HTTP kullanın.
  • routerIP:port, sanal ana makinenin IP adresi ve bağlantı noktası numarasıdır.
  • proxy-base-path ve resource-name, API proxy'sini oluşturduğunuzda tanımlanır.

API'lerinizi genellikle IP adresi ve bağlantı noktası numarasıyla müşterilere yayınlamazsınız. Bunun yerine, yönlendirici ve bağlantı noktası için bir DNS girişi tanımlarsınız. Örneğin:

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

Ayrıca, sanal ana makine için DNS girişinin alan adıyla eşleşen bir ana makine takma adı da oluşturmanız gerekir. Yukarıdaki örnekte, myAPI.myCo.com ana makine takma adını belirtirsiniz. DNS girişiniz yoksa ana makine takma adını, yönlendiricinin IP adresine ve sanal ana makinenin bağlantı noktasına (routerIP:port olarak) ayarlayın.

Daha fazla bilgi için Sanal ana makineler hakkında başlıklı makaleyi inceleyin.

İlk kuruluşunuzu, ortamınızı ve sanal ana makinenizi oluşturma

Edge yükleme sürecini tamamladıktan sonra ilk işleminiz genellikle "ilk katılım" sürecini kullanarak bir kuruluş, ortam ve sanal ana makine oluşturmaktır. İlk katılım işlemini gerçekleştirmek için Edge Management Server düğümünde aşağıdaki komutu çalıştırın:

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

Bu komut, kullanıcıyı, kuruluşu, ortamı ve sanal ana makineyi tanımlayan bir yapılandırma dosyası alır.

Örneğin, aşağıdakileri oluşturabilirsiniz:

  • Kuruluş yöneticisi olarak görev yapacak kullanıcıyı seçin.
  • example adlı bir kuruluş
  • prod adlı kuruluştaki ve "gateway" kapsülündeki tüm Mesaj İşleyicilerle ilişkili bir ortam
  • Ortamda default adlı ve 9001 bağlantı noktasında HTTP erişimine izin veren bir sanal ana makine
  • Sanal ana makinenin takma adı

Bu komut dosyasını çalıştırdıktan sonra, aşağıdaki biçimde bir URL kullanarak API'lerinize erişebilirsiniz:

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

Daha sonra istediğiniz sayıda kuruluş, ortam ve sanal ana makine ekleyebilirsiniz.

Daha fazla bilgi için Kuruluşları ilk katılıma dahil etme başlıklı makaleyi inceleyin.