Private Cloud için Edge v. 4.17.01
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:
|
Şunu içerir: |
İlişkili |
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" |
|
|
Kuruluş |
Bir veya daha fazla ortam |
Mesaj İşleyicileri ve kuruluş yöneticisi rolünü üstlenen 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 İleti İş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 mantıksal bir bölgeler grubudur. açıkça gezegen oluşturma veya yapılandırma adımlarını uygulamayı unutmayın.
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" |
"ağ geçidi", "merkezi", "analiz" |
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. İzin vermediğiniz sürece birden çok veri merkezi tanımlarsanız, ek bölgeler oluşturmanız gerekmez.
Daha karmaşık bir yüklemede iki veya daha fazla bölge oluşturabilirsiniz. İçerik üretmeye devam etmek için makinelerin coğrafi olarak düzenlenmesi ve böylece ağın geçiş süresini en aza indirme. İçinde Bu senaryoda, API uç noktalarını barındırır ve bunların coğrafi olarak ilgili API'lerin tüketicilerinden bahsedeceğiz.
Edge'de her bölge veri merkezi olarak adlandırılır. ABD'de bulunan Bu durumda Doğu ABD, Massachusetts'in Boston şehrinden gelen talepleri karşılayabilir. ABD'deki bir veri merkezi ise Singapur, Asya'daki cihazlardan veya bilgisayarlardan gelen istekleri işleme alabilir.
Örneğin, aşağıdaki resimde iki veri merkezine karşılık gelen iki bölge gösterilmektedir:
Kapsüller hakkında
Kapsül, bir veya daha fazla Edge bileşeni ve Cassandra veri deposundan oluşan bir gruptur. 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.
Varsayılan olarak, Edge'i yüklediğinizde, yükleyici üç kapsül oluşturur ve aşağıdaki Edge bileşenlerini ve Cassandra veri depolarını içerir:
|
Kapsül |
Edge bileşenleri |
Cassandra veri depoları |
|
|---|---|---|---|
|
"gateway" |
Yönlendirici, Mesaj İşleyici |
cache-datastore |
keyvaluemap-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 isteklerini işlemek 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üldeki bileşenler 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, "ağ geçidine" ilave Yönlendiriciler ve İleti İşlemcileri ekleyebilirsiniz işlenecek kapsül artırıldı yardımcı olabilir.
"Gateway" kapsülündeki Edge Router ve Message Processor bileşenlerine dikkat edin. Yönlendiriciler yalnızca aynı kapsüldeki Mesaj İşleyenlere istek gönderir, gösterir.
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 şu değerlerden biri olabilir:
- ağ geçidi
- central
- analiz
Örneğin, "gateway" kapsülü için:
> curl -u adminEmail:pword http://<ms_IP>:8080/v1/servers?pod=gateway
Çıktı şu şekilde görünü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 yüklemesinde varsayılan olarak herhangi bir kuruluş yoktur. Kuruluş oluşturduğunuzda iki bilgi belirtirsiniz:
- Kuruluş yöneticisi olarak çalışan 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.
- "Ağ geçidi" kapsülü, ileti işleyicileri içeren kapsüldür.
Bir kuruluş, bir veya daha fazla ortam içerebilir. Varsayılan Edge yükleme prosedürü, "test" ve "prod" olmak üzere iki ortam oluşturmanızı ister. Ancak isterseniz "hazırlık", "denemeler" vb. gibi gerekli ortamlardan oluşur.
Kuruluş, bazı Apigee özellikleri için kapsam sağlar. Örneğin, anahtar/değer eşlemesi (KVM) tüm ortamlardan, yani tüm ortamlardan ulaşılabilir olduğu anlamına gelir. Diğer özellikler gibi önbellek uygulamaları belirli bir ortama ayarlanır. Apigee analiz verileri, kuruluş ve ortam kombinasyonuna göre bölümlenir.
Aşağıda, bir ortama özel olarak tanımlanmış olanları kapsar:
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 "dev", "test" ve "prod" nasıl değer kattığından bahsetmiştik.
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. Hepsini ortamın aynı Mesaj İşleyenleriyle veya farklılarla ilişkilendirilebileceğini unutmayın.
Bir ortam oluşturmak için iki bilgiyi belirtin:
- Ortamı içeren kuruluş.
- Ortama yönelik API proxy isteklerini işleyen Mesaj İşleyicileridir. 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, mevcut tüm İleti İşlemcilerini "ağ geçidi" kapsülünü ortamla birleştiriyorsunuz. Alternatif olarak, farklı Mesaj İşleyicilerin farklı e-postalara ilişkin istekleri işlemesini sağlamak için ortam olarak da bilinir.
Mesaj işleyiciler birden fazla ortamla ilişkilendirilebilir. Örneğin, Edge yüklemesinde iki Mesaj İşlemcisi bulunmaktadır: A ve B. Daha sonra Organization: "dev", "test" ve "prod":
- “Dev” için bir mesaj almadığınız veya bir mesaj elde etmenize yardımcı olur.
- "Test" ortamı için, çok fazla trafik beklemediğiniz için Mesaj İşleyen B'yi ilişkilendirirsiniz.
- "Üretim" için hem A hem B İleti İşlemcilerini ilişkilendirirseniz seviyesidir.
Bir ortama atanan Mesaj İşleyenlerin tümü aynı kapsülün içinden veya birden fazla bölge 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 bir API proxy'si dağıtmak, API proxy'sinin üç veri merkezinin tamamındaki Mesaj İşleyiciler'de çalışmasına neden olur. Bunlardan herhangi birinde bir Yönlendirici'ye gelen API trafiği Veri merkezleri yalnızca bu veri merkezindeki Mesaj İşleyenlere yönlendirilir, çünkü Yönlendiriciler trafiği yalnızca aynı kapsüldeki Mesaj İşleyicilere yönlendirir.
Sanal ana makineler hakkında
Sanal ana makine, bir API proxy'sinin açığa çıktığı Uç Yönlendirici'de bulunan bağlantı noktasını tanımlar. ve uygulamaların API proxy'sine erişmek için kullandığı URL. Her ortam tanımlamalıdır en az bir sanal ana makineniz olmalı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'ye istek göndererek API proxy'sine erişebilirsiniz:
http://<routerIP>:<port>/{proxy-base-path}/{resource-name}
https://<routerIP>:<port>/{proxy-base-path}/{resource-name}
Bu örnekte:
- 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.
- <yönlendiriciIP>:<bağlantı noktası>, 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 için bir ana makine takma adı belirtirsiniz. DNS girişiniz yoksa ana makine takma adını, Yönlendiricinin IP adresi ve sanal ana makineyi <routerIP>:port olarak adlandırabilirsiniz.
Daha fazla bilgi için http://apigee.com/docs/api-services/content/virtual-hosts adresine bakın.
İ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 makine.
Örneğin, şunları oluşturursunuz:
- Kuruluş yöneticisi olarak görev yapacak kullanıcıyı seçin.
- example adlı bir kuruluş
- Kuruluştaki prod adlı 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 makine için ana makine takma adı
Bu komut dosyasını çalıştırdıktan sonra, aşağıdaki biçimde bir URL kullanarak API'lerinize erişebilirsiniz:
http://<router-ip>:9001/{proxy-base-path}/{resource-name}
Daha sonra istediğiniz sayıda kuruluş, ortam ve sanal ana makine ekleyebilirsiniz.
İlk katılım hakkında daha fazla bilgi için kuruluş.