Yükleme Koşulları

Edge for Private Cloud sürüm 4.17.05

Donanım Gereksinimleri

Üretim düzeyindeki bir ortamda yüksek kullanılabilirlikli bir altyapı için aşağıdaki minimum donanım gereksinimlerini karşılamanız gerekir. Aşağıdaki tablolarda, Yükleme Topolojileri bölümünde açıklanan tüm yükleme senaryoları için yükleme bileşenlerinin minimum donanım gereksinimleri listelenmiştir.

Bu tablolardaki sabit disk gereksinimleri, işletim sisteminin gerektirdiği sabit disk alanına ek olarak belirtilmiştir. Uygulamalarınıza ve ağ trafiğinize bağlı olarak, kurulumunuz için aşağıda listelenenlerden daha fazla veya daha az kaynak gerekebilir.

Yükleme Bileşeni

RAM

CPU

Minimum sabit disk

Cassandra

16 GB

8 çekirdekli

2.000 IOPS'yi destekleyen SSD veya hızlı HDD ile 250 GB yerel depolama alanı

Aynı makinede Mesaj İşleyici/Yönlendirici

16 GB

8 çekirdekli

100GB

Analytics - Postgres/Qpid aynı sunucuda (üretim için önerilmez)

16GB*

8 çekirdekli*

500 GB - 1 TB** ağ depolama alanı***, tercihen SSD arka ucuyla, 1.000 IOPS veya daha yüksek hızı destekleyen*.

Analytics - Postgres bağımsız

16GB*

8 çekirdekli*

500 GB - 1 TB** ağ depolama alanı***, tercihen SSD arka ucuyla, 1.000 IOPS veya daha yüksek hızı destekleyen*.

Analytics - Qpid bağımsız

8 GB

4 çekirdekli

SSD veya hızlı HDD ile 30 GB - 50 GB yerel depolama alanı

250 TPS'den büyük kurulumlar için 1.000 IOPS'yi destekleyen yerel depolama alanına sahip HDD önerilir.

Varsayılan Qpid sıra boyutu 20 GB'tır. Daha fazla kapasite eklemeniz gerekiyorsa ek Qpid düğümleri ekleyin.

Diğer (OpenLDAP, kullanıcı arayüzü, yönetim sunucusu)

4 GB

2 çekirdekli

60 GB

*Postgres sistem gereksinimlerini işleme hızına göre ayarlayın:

  • 250 TPS'den az: 1.000 IOPS veya daha yüksek değerleri destekleyen yönetilen ağ depolama alanı*** ile 8 GB, 4 çekirdekli kullanılabilir.
  • 250 TPS'den fazla: 16 GB, 8 çekirdek, 1.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 1.000 TPS'den fazla: 16 GB, 8 çekirdekli, 2.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 2.000 TPS'den fazla: 32 GB, 16 çekirdek, 2.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***
  • 4.000 TPS'den fazla: 64 GB, 32 çekirdek, 4.000 IOPS veya daha fazlasını destekleyen yönetilen ağ depolama alanı***

**Postgres sabit disk değeri, Edge tarafından yakalanan kullanıma hazır analizlere dayanır. Analytics verilerine özel değerler eklerseniz bu değerler de buna göre artırılmalıdır. Gerekli depolama alanını tahmin etmek için aşağıdaki formülü kullanın:

(bayt sayısı/istek) * (saniye başına istek sayısı) * (saat başına saniye sayısı) * (günlük yoğun kullanım saati sayısı) * (ay başına gün sayısı) * (veri saklama süresi ay sayısı) = gereken depolama alanı bayt sayısı

Örneğin:

(İstek başına 2 bin bayt analiz verisi) * 100 istek/sn * 3600 sn/sa * günlük 18 saat yoğun kullanım * 30 gün/ay * 3 ay saklama süresi = 1.194.393.600.000 bayt veya 1194,4 GB.

*** PostgreSQL veritabanı için ağ depolama alanı önerilir. Bunun nedeni:

  • Gerektiğinde depolama alanı boyutunu dinamik olarak ölçeklendirme olanağı sunar.
  • Ağ IOPS'si, günümüzdeki ortam/depolama/ağ alt sistemlerinin çoğunda anında ayarlanabilir.
  • Depolama düzeyinde anlık görüntüler, yedekleme ve kurtarma çözümlerinin bir parçası olarak etkinleştirilebilir.

Ayrıca, Para Kazanma Hizmetleri'ni yüklemek istiyorsanız aşağıdaki donanım gereksinimleri de geçerlidir:

Para kazanma özelliği olan bileşen

RAM

CPU

Sabit disk

Yönetim Sunucusu (Para Kazanma Hizmetleri ile)

8 GB

4 çekirdekli

60 GB

Analytics - Postgres/Qpid on same server

16 GB

8 çekirdekli

500 GB - 1 TB ağ depolama alanı (tercihen SSD arka uçlu, 1.000 IOPS veya daha yüksek değerleri destekleyen) ya da yukarıdaki tablodaki kuralı kullanın.

Analytics - Postgres bağımsız

16 GB

8 çekirdekli

500 GB - 1 TB ağ depolama alanı (tercihen SSD arka uçlu, 1.000 IOPS veya daha yüksek değerleri destekleyen) ya da yukarıdaki tablodaki kuralı kullanın.

Analytics - Qpid bağımsız

8 GB

4 çekirdekli

SSD veya hızlı HDD ile 40 GB - 500 GB yerel depolama alanı

250 TPS'den büyük kurulumlar için 1.000 IOPS'yi destekleyen yerel depolama alanına sahip HDD önerilir.

API BaaS'yi yüklemek istiyorsanız aşağıdaki donanım gereksinimlerini karşılamanız gerekir:

API BaaS Bileşeni

RAM

CPU

Sabit disk

ElasticSearch*

8 GB

4 çekirdekli

60 - 80GB

API BaaS Stack *

8 GB

4 çekirdekli

60 - 80GB

API BaaS Portal

1 GB

2 çekirdekli

20GB

Cassandra (İsteğe bağlı: Genellikle hem Edge hem de API BaaS Hizmetleri için aynı Cassandra kümesini kullanırsınız)

16 GB

8 çekirdekli

2.000 IOPS'yi destekleyen SSD veya hızlı HDD ile 250 GB yerel depolama alanı

* ElasticSearch ve API BaaS Stack'i aynı düğüme yükleyebilirsiniz. Kullanıyorsanız ElasticSearch'ü 4 GB bellek (varsayılan) kullanacak şekilde yapılandırın. ElasticSearch kendi düğümüne yüklüyse 6 GB bellek kullanacak şekilde yapılandırın.

Not:

  • Kök dosya sistemi yükleme için yeterince büyük değilse verilerin daha büyük bir diske yerleştirilmesi önerilir.
  • Makinede Apigee Edge for Private Cloud'un eski bir sürümü yüklüyse yeni bir yükleme yapmadan önce /tmp/java klasörünü sildiğinizden emin olun.
  • Cassandra'yı başlatmak için sistem genelindeki geçici klasör /tmp için yürütme izinleri gerekir.
  • Yüklemeden önce "apigee" kullanıcısı oluşturulduysa "/home/apigee"nin ana dizin olarak mevcut olduğundan ve "apigee:apigee"ye ait olduğundan emin olun.

İşletim sistemi ve üçüncü taraf yazılım gereksinimleri

Bu yükleme talimatları ve sağlanan yükleme dosyaları, şu adreste listelenen işletim sistemleri ve üçüncü taraf yazılımlarında test edilmiştir: https://apigee.com/docs/api-services/reference/supported-software.

Apigee kullanıcısını oluşturma

Yükleme prosedürü, "apigee" adlı bir Unix sistem kullanıcısı oluşturur. Edge dizinleri ve dosyaları, Edge işlemleri gibi "apigee"ye aittir. Bu, Edge bileşenlerinin "apigee" kullanıcısı olarak çalıştığı anlamına gelir. Gerekirse bileşenleri farklı bir kullanıcı olarak çalıştırabilirsiniz. Örnek için Edge bileşenlerini bir düğüme yükleme başlıklı makaledeki "Yönlendiriciyi korumalı bir bağlantı noktasına bağlama" bölümüne bakın.

Yükleme dizini

Yükleyici, varsayılan olarak tüm dosyaları /opt/apigee dizinine yazar. Bu dizin konumunu değiştiremezsiniz. Bu dizini değiştiremezsiniz ancak /opt/apigee'yi aşağıda açıklandığı gibi başka bir konuma eşlemek için sembolik bağlantı oluşturabilirsiniz.

Bu kılavuzdaki talimatlarda, yükleme dizini /<inst_root>/apigee olarak belirtilmiştir. Burada /<inst_root> varsayılan olarak /opt'tur.

/opt/apigee dizininden sembolik bağlantı oluşturuluyor.

Sembolik bağlantıyı oluşturmadan önce "apigee" adlı bir kullanıcı ve grup oluşturmanız gerekir. Bu, Edge yükleyicisi tarafından oluşturulan grup ve kullanıcıyla aynıdır.

Sembolik bağlantıyı oluşturmak için bootstrap_4.17.01.sh dosyasını indirmeden önce aşağıdaki adımları uygulayın. Bu adımların tümünü root olarak gerçekleştirmeniz gerekir:

  1. "apigee" kullanıcısını ve grubunu oluşturun:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. /opt/apigee dizininden istediğiniz yükleme köküne bir sembolik bağlantı oluşturun:
    > ln -Ts /srv/myInstallDir /opt/apigee
    Burada /srv/myInstallDir, Edge dosyalarının bulunmasını istediğiniz konumdur.
  3. Yükleme kökünün ve sembolik bağlantının sahipliğini "apigee" kullanıcısına değiştirin:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

Yükleme işleminden önce her makinede Java 1.8'in desteklenen bir sürümünün yüklü olması gerekir. Desteklenen JDK'lar şunlardır:

https://apigee.com/docs/api-services/reference/supported-software

Yüklemeyi gerçekleştiren kullanıcı için JAVA_HOME'un JDK'nin kök dizinine işaret ettiğinden emin olun.

SELinux

SELinux ayarlarınıza bağlı olarak Edge, Edge bileşenlerini yükleme ve başlatma konusunda sorunlarla karşılaşabilir. Gerekirse yükleme sırasında SELinux'u devre dışı bırakabilir veya izin verme moduna ayarlayabilir, ardından yükleme işleminden sonra yeniden etkinleştirebilirsiniz. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.

Ağ Ayarı

Yüklemeden önce ağ ayarlarını kontrol etmeniz önerilir. Yükleyici, tüm makinelerin sabit IP adreslerine sahip olmasını bekler. Ayarı doğrulamak için aşağıdaki komutları kullanın:

  • hostname, makinenin adını döndürür.
  • hostname -i, diğer makinelerden erişilebilen ana makine adının IP adresini döndürür.

İşletim sisteminizin türüne ve sürümüne bağlı olarak, ana makine adı doğru ayarlanmamışsa /etc/hosts ve /etc/sysconfig/network dosyalarını düzenlemeniz gerekebilir. Daha fazla bilgi için işletim sisteminizin belgelerine bakın.

TCP sarmalayıcıları

TCP sarmalayıcılar bazı bağlantı noktalarının iletişimini engelleyebilir ve OpenLDAP, Postgres ve Cassandra kurulumunu etkileyebilir. Bu düğümlerde, gerekli OpenLDAP, Postgres ve Cassandra bağlantı noktalarında bağlantı noktası kısıtlaması olmadığından emin olmak için /etc/hosts.allow ve /etc/hosts.deny dosyalarını kontrol edin.

iptables

Gerekli Edge bağlantı noktalarındaki düğümler arasında bağlantıyı engelleyen iptables politikaları olmadığını doğrulayın. Gerekirse aşağıdaki komutu kullanarak yükleme sırasında iptables'ı durdurabilirsiniz:

> sudo/etc/init.d/iptables stop

CentOS 7.x'te:

> systemctl stop firewalld

Edge Router'ın /etc/rc.d/init.d/functions dosyasına erişebildiğinden emin olun.

Edge Router ve BaaS Portal düğümleri, Nginx yönlendiricisini kullanır ve /etc/rc.d/init.d/functions için okuma erişimi gerektirir.

Güvenlik süreciniz /etc/rc.d/init.d/functions üzerinde izinler ayarlamanızı gerektiriyorsa bunları 700 olarak ayarlamayın. Aksi takdirde yönlendirici başlatılamaz. İzinler, /etc/rc.d/init.d/functions dosyasına okuma erişimi verecek şekilde 744 olarak ayarlanabilir.

Cassandra

Tüm Cassandra düğümlerinin bir halkaya bağlı olması gerekir. Cassandra, güvenilirlik ve hata toleransı sağlamak için veri replikalarını birden fazla düğümde depolar. Her bir Edge anahtar alanı için replikasyon stratejisi, replikaların yerleştirildiği Cassandra düğümlerini belirler. Daha fazla bilgi için Cassandra Çoğaltma Faktörü ve Tutarlılık Düzeyi Hakkında başlıklı makaleyi inceleyin.

Cassandra, Java yığın boyutunu kullanılabilir belleğe göre otomatik olarak ayarlar. Daha fazla bilgi için Java kaynaklarını ayarlama başlıklı makaleyi inceleyin. Performans düşüşü veya yüksek bellek tüketimi durumunda.

Edge for Private Cloud'u yükledikten sonra /<inst_root>/apigee/apigee-cassandra/conf/cassandra.yaml dosyasını inceleyerek Cassandra'nın doğru şekilde yapılandırılıp yapılandırılmadığını kontrol edebilirsiniz. Örneğin, Edge for Private Cloud yükleme komut dosyasının aşağıdaki özellikleri ayarladığından emin olun:

  • cluster_name
  • initial_token
  • partitioner
  • tohumlar
  • listen_address
  • rpc_address
  • snitch

Uyarı: Bu dosyayı düzenlemeyin.

PostgreSQL veritabanı

Edge'i yükledikten sonra, sisteminizdeki RAM miktarına göre aşağıdaki PostgreSQL veritabanı ayarlarını yapabilirsiniz:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

Bu değerleri ayarlamak için:

  1. postgresql.properties dosyasını düzenleyin:
    > vi /<inst_root>/apigee/customer/application/postgresql.properties

    Dosya yoksa oluşturun.
  2. Yukarıda listelenen özellikleri ayarlayın.
  3. Yaptığınız düzenlemeleri kaydedin.
  4. PostgreSQL veritabanını yeniden başlatın:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

Sistem sınırları

Cassandra ve Mesaj İşleyici düğümlerinde aşağıdaki sistem sınırlarını ayarladığınızdan emin olun:

  • Cassandra düğümlerinde, /etc/security/limits.d/90-apigee-edge-limits.conf dosyasında yükleme kullanıcısı (varsayılan "apigee"dir) için yumuşak ve sert memlock, nofile ve adres alanı (as) sınırlarını aşağıda gösterildiği gibi ayarlayın:
    apigee soft memlock unlimited
    apigee hard memlock unlimited
    apigee soft nofile 32768
    apigee hard nofile 65536
    apigee soft as unlimited
    apigee hard as unlimited

  • Mesaj İşleyici düğümlerinde, /etc/security/limits.d/90-apigee-edge-limits.conf dosyasında açık dosya tanımlayıcılarının maksimum sayısını 64K olarak ayarlayın:
    apigee soft nofile 32768
    apigee hard nofile 65536


    Gerekirse bu sınırı artırabilirsiniz. Örneğin, aynı anda çok sayıda geçici dosya açtıysanız.

jsvc

"jsvc", API BaaS'ı kullanmak için bir ön koşuldur. API BaaS'yi yüklediğinizde 1.0.15-dev sürümü yüklenir.

Ağ Güvenliği Hizmetleri (NSS)

Ağ Güvenliği Hizmetleri (NSS), güvenlik özellikli istemci ve sunucu uygulamalarının geliştirilmesini destekleyen bir kitaplık grubudur. NSS 3.19 veya sonraki bir sürümü yüklediğinizden emin olmanız gerekir.

Mevcut sürümünüzü kontrol etmek için:

> yum info nss

NSS'yi güncellemek için:

> yum update nss

Daha fazla bilgi için RedHat'in bu makalesine bakın.

NSCD (Ad Hizmeti Önbellek Arka Plan Programı) kullanırken IPv6'da DNS aramasını devre dışı bırakın.

NSCD'yi (Ad Hizmeti Önbellek Arka Plan Programı) yükleyip etkinleştirdiyseniz Mesaj İşleyiciler iki DNS araması yapar: biri IPv4, diğeri IPv6 için. NSCD kullanırken IPv6'da DNS aramasını devre dışı bırakmanız gerekir.

IPv6'da DNS aramasını devre dışı bırakmak için:

  1. Her Mesaj İşleyici düğümünde /etc/nscd.conf dosyasını düzenleyin.
  2. Aşağıdaki özelliği ayarlayın:
    enable-cache hosts no

RedHat/CentOS 7 için Google Cloud Platform'da IPv6'yı devre dışı bırakma

Edge'i Google Cloud Platform'da RedHat 7 veya CentOS 7'ye yüklüyorsanız tüm Qpid düğümlerinde IPv6'yı devre dışı bırakmanız gerekir.

IPv6'yı devre dışı bırakma talimatları için işletim sistemi sürümünüze ait RedHat veya CentOS belgelerine bakın. Örneğin, şunları yapabilirsiniz:

  1. /etc/hosts dosyasını bir düzenleyicide açın.
  2. Aşağıdaki satırın birinci sütununa "#" karakteri ekleyerek satırı yorum haline getirin:
    #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6
  3. Dosyayı kaydedin.

AWS AMI

Edge'i Red Hat Enterprise Linux 7.x için bir AWS Amazon Makine Görüntüsü'ne (AMI) yüklüyorsanız öncelikle aşağıdaki komutu çalıştırmanız gerekir:

> yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

Araçlar

Yükleyici, EL5 veya EL6 tarafından sağlanan standart sürümde aşağıdaki UNIX araçlarını kullanır.

awk

expr

lua-socket

devir/dk.

sıkıştırılmış dosyayı açma

basename

grep

ls

rpm2cpio

useradd

bash

ana makine adı

net-tools

sed

wc

bc

id

perl (procps'ten)

sudo

wget

curl

libaio

pgrep (procps'ten)

katran

xerces-c

cyrus-sasl
libdb-cxx
ps tr leziz

tarih

libibverbs

pwd

uuid

chkconfig

dirname
librdmacm
python uname
echo
libxslt

Not:

  • "useradd" aracının yürütülebilir dosyası /usr/sbin dizininde, chkconfig aracının yürütülebilir dosyası ise /sbin dizininde bulunur.
  • Sudo erişimiyle, çağrıyı yapan kullanıcının ortamına erişebilirsiniz. Örneğin, genellikle "sudo <komut>" veya "sudo PATH=$PATH:/usr/sbin:/sbin <komut>" komutunu çağırırsınız.
  • Hizmet paketi (yama) yüklemeden önce "yama" aracının yüklü olduğundan emin olun.

ntpdate: Sunucuların zaman senkronizasyonunun yapılması önerilir. Henüz yapılandırılmadıysa sunucuların zaman senkronizasyonunun yapılıp yapılmadığını doğrulayan "ntpdate" yardımcı programı bu amaçla kullanılabilir. Yardımcı programı yüklemek için "yum install ntp" komutunu kullanabilirsiniz. Bu, özellikle OpenLDAP kurulumlarını kopyalamak için kullanışlıdır. Sunucu saat dilimini UTC olarak ayarladığınızı unutmayın.

openldap 2.4: Şirket içi yükleme için OpenLDAP 2.4 gerekir. Sunucunuzun internet bağlantısı varsa Edge yükleme komut dosyası OpenLDAP'yi indirip yükler. Sunucunuzun internet bağlantısı yoksa Edge yükleme komut dosyasını çalıştırmadan önce OpenLDAP'nin yüklü olduğundan emin olmanız gerekir. RHEL/CentOS'ta, OpenLDAP'yi yüklemek için "yum install openldap-clients openldap-servers" komutunu çalıştırabilirsiniz.

13 ana makine içeren kurulumlarda ve iki veri merkezi içeren 12 ana makine içeren kurulumlarda, OpenLDAP'yi barındıran birden fazla düğüm olduğundan OpenLDAP replikasyonu gerekir.

Güvenlik Duvarları ve Sanal Ana Makineler

"Sanal" terimi, BT alanında genellikle aşırı kullanılır. Bu durum, Apigee Edge for Private Cloud dağıtımı ve sanal ana makineler için de geçerlidir. Açıklamak gerekirse, "sanal" teriminin iki temel kullanımı vardır:

  • Sanal makineler (VM): Gerekli değildir ancak bazı dağıtımlarda Apigee bileşenleri için yalıtılmış sunucular oluşturmak amacıyla sanal makine teknolojisi kullanılır. Sanal makine ana makineleri, fiziksel ana makineler gibi ağ arayüzlerine ve güvenlik duvarlarına sahip olabilir.
  • Sanal ana makineler: Apache sanal ana makinesine benzer web uç noktaları.

Sanal makinedeki bir yönlendirici, birden fazla sanal ana makineyi gösterebilir (ana makine takma adları veya arayüz bağlantı noktaları birbirinden farklı olduğu sürece).

Adlandırma örneği olarak, tek bir fiziksel sunucu "A"nın "VM1" ve "VM2" adlı iki sanal makineyi çalıştırdığını varsayalım. VM1'in, sanal makine içinde eth0 olarak adlandırılan ve sanallaştırma mekanizması veya bir ağ DHCP sunucusu tarafından 111.111.111.111 IP adresinin atandığı bir sanal Ethernet arayüzü sunduğunu varsayalım. VM2'nin de eth0 adlı bir sanal Ethernet arayüzü sunduğunu ve bu arayüze 111.111.111.222 IP adresinin atandığını varsayalım.

İki sanal makinenin her birinde çalışan bir Apigee yönlendiricimiz olabilir. Yönlendiriciler, sanal ana makine uç noktalarını bu varsayımsal örnekte olduğu gibi gösterir:

VM1'deki Apigee yönlendiricisi, eth0 arayüzünde (belirli bir IP adresine sahip) üç sanal ana makineyi kullanıma sunar: api.mycompany.com:80, api.mycompany.com:443 ve test.mycompany.com:80.

VM2'deki yönlendirici, api.mycompany.com:80'i (VM1 tarafından sunulan ad ve bağlantı noktasının aynısı) sunar.

Fiziksel ana makinenin işletim sisteminde bir ağ güvenlik duvarı olabilir. Böyle bir durumda, güvenlik duvarı, sanallaştırılmış arayüzlerde (111.111.111.111:{80, 443} ve 111.111.111.222:80) gösterilen bağlantı noktalarına bağlı TCP trafiğini geçirecek şekilde yapılandırılmalıdır. Ayrıca her sanal makinenin işletim sistemi, eth0 arayüzünde kendi güvenlik duvarını sağlayabilir ve bu güvenlik duvarları da bağlantı için 80 ve 443 numaralı bağlantı noktalarından gelen trafiğe izin vermelidir.

Temel yol, API çağrılarını dağıtmış olabileceğiniz farklı API proxy'lerine yönlendiren üçüncü bileşendir. API proxy paketleri, farklı temel yollara sahipse bir uç noktayı paylaşabilir. Örneğin, bir temel yol http://api.mycompany.com:80/, diğeri ise http://api.mycompany.com:80/salesdemo olarak tanımlanabilir.

Bu durumda, http://api.mycompany.com:80/ trafiğini iki IP adresi (VM1'de 111.111.111.111 ve VM2'de 111.111.111.222) arasında bölen bir yük dengeleyici veya trafik yöneticisi gerekir. Bu işlev, kurulumunuza özeldir ve yerel ağ grubunuz tarafından yapılandırılır.

Temel yol, bir API'yi dağıttığınızda ayarlanır. Yukarıdaki örnekte, mycompany-org kuruluşu için mycompany ve testmycompany adlı iki API dağıtabilirsiniz. Bu API'ler, ana makine takma adı api.mycompany.com ve bağlantı noktası 80 olarak ayarlanmış sanal ana makineyi kullanır. Dağıtımda bir temel yol bildirmezseniz yönlendirici, gelen istekleri hangi API'ye göndereceğini bilemez.

Ancak testmycompany API'sini /salesdemo ana URL'siyle dağıtırsanız kullanıcılar bu API'ye http://api.mycompany.com:80/salesdemo adresini kullanarak erişir. API'nizi / ana URL'siyle dağıtırsanız kullanıcılarınız API'ye http://api.mycompany.com:80/ URL'siyle erişir.

Uç bağlantı noktası gereksinimleri

Güvenlik duvarını yönetme ihtiyacı yalnızca sanal ana makinelerle sınırlı değildir. Hem sanal makine hem de fiziksel ana makine güvenlik duvarları, bileşenlerin birbirleriyle iletişim kurması için gereken bağlantı noktalarına yönelik trafiğe izin vermelidir.

Aşağıdaki resimde her bir Edge bileşeni için bağlantı noktası gereksinimleri gösterilmektedir:

Bu diyagramla ilgili notlar:

  • *Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırdığınızda, Mesaj İşleyici'deki 8082 numaralı bağlantı noktasının yalnızca Yönlendirici tarafından erişime açık olması gerekir. Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırmazsanız varsayılan yapılandırma olan 8082 numaralı bağlantı noktasının, bileşeni yönetmek için Mesaj İşleyici'de açık olması gerekir ancak Yönlendirici'nin bu bağlantı noktasına erişmesi gerekmez.
  • "M" ön ekine sahip bağlantı noktaları, bileşeni yönetmek için kullanılan bağlantı noktalarıdır ve Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.
  • Şu bileşenlerin Yönetim Sunucusu'ndaki 8080 bağlantı noktasına erişmesi gerekir: Yönlendirici, Mesaj İşlemcisi, Kullanıcı Arayüzü, Postgres ve Qpid.
  • Mesaj İşleyici, yönetim bağlantı noktası olarak 4528 numaralı bağlantı noktasını açmalıdır. Birden fazla Mesaj İşleyiciniz varsa bunların tümü 4528 numaralı bağlantı noktası üzerinden birbirine erişebilmelidir (Mesaj İşleyici'deki 4528 numaralı bağlantı noktası için yukarıdaki diyagramda döngü okuyla gösterilmiştir). Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm mesaj işlemcilerden erişilebilmelidir.
  • Zorunlu olmasa da herhangi bir Mesaj İşleyici'nin erişebilmesi için yönlendiricide 4527 numaralı bağlantı noktasını açabilirsiniz. Aksi takdirde, Mesaj İşleyici günlük dosyalarında hata mesajları görebilirsiniz.
  • Yönlendirici, yönetim bağlantı noktası olarak 4527 numaralı bağlantı noktasını açmalıdır. Birden fazla yönlendiriciniz varsa bunların tümü 4527 numaralı bağlantı noktası üzerinden birbirine erişebilmelidir (yukarıdaki şemada yönlendiricideki 4527 numaralı bağlantı noktası için döngü okuyla gösterilmiştir).
  • Edge kullanıcı arayüzü, izleme aracındaki Gönder düğmesini desteklemek için API proxy'leri tarafından sunulan bağlantı noktalarında yönlendiriciye erişim gerektirir.
  • Yönetim Sunucusu'nun Cassandra düğümlerindeki JMX bağlantı noktasına erişmesi gerekir.
  • JMX bağlantı noktalarına erişim, kullanıcı adı/şifre gerektirecek şekilde yapılandırılabilir. Daha fazla bilgi için İzleme bölümüne bakın.
  • İsterseniz farklı bağlantı noktaları kullanabilen belirli bağlantılar için TLS/SSL erişimini yapılandırabilirsiniz. Daha fazla bilgi için TLS/SSL bölümünü inceleyin.
  • İki Postgres düğümünü ana-yedek replikasyon kullanacak şekilde yapılandırıyorsanız ssh erişimi için her düğümde 22 numaralı bağlantı noktasını açmanız gerekir. SSH erişimine izin vermek için isteğe bağlı olarak ayrı ayrı düğümlerde bağlantı noktaları açabilirsiniz.
  • Yönetim Sunucusu ve Edge kullanıcı arayüzünü, harici bir SMTP sunucusu üzerinden e-posta gönderecek şekilde yapılandırabilirsiniz. Kullanıyorsanız Yönetim Sunucusu ve kullanıcı arayüzünün SMTP sunucusundaki gerekli bağlantı noktasına erişebildiğinden emin olmanız gerekir. TLS olmayan SMTP için bağlantı noktası numarası genellikle 25'tir. TLS özellikli SMTP için genellikle 465'tir ancak SMTP sağlayıcınızla iletişime geçerek doğrulayın.

Aşağıdaki tabloda, Edge bileşenine göre güvenlik duvarlarında açılması gereken bağlantı noktaları gösterilmektedir:

Bileşen

Bağlantı noktası

Açıklama

Standart HTTP bağlantı noktaları

80, 443

HTTP ve sanal ana makineler için kullandığınız diğer bağlantı noktaları

Yönetim Sunucusu

8080

Edge Management API çağrıları için bağlantı noktası. Şu bileşenlerin, Yönetim Sunucusu'ndaki 8080 bağlantı noktasına erişmesi gerekir: Yönlendirici, Mesaj İşlemcisi, Kullanıcı Arayüzü, Postgres ve Qpid.

1099

JMX bağlantı noktası

4526

Dağıtılmış önbellek ve yönetim çağrıları için

Yönetim kullanıcı arayüzü

9000

Yönetim kullanıcı arayüzüne tarayıcı erişimi için bağlantı noktası

Mesaj İşlemcisi

8998

Yönlendiriciden gelen iletişimler için Mesaj İşleyici bağlantı noktası

8082

Mesaj İşleyici için varsayılan yönetim bağlantı noktasıdır ve Management Server tarafından erişilebilmesi için bileşende açık olmalıdır.

Yönlendirici ile Mesaj İşleyici arasında TLS/SSL yapılandırırsanız Yönlendirici tarafından Mesaj İşleyici'de durum denetimleri yapmak için kullanılır.

1101

JMX bağlantı noktası

4528

Mesaj İşlemciler arasındaki dağıtılmış önbellek ve yönetim çağrıları ve Yönlendirici'den gelen iletişim için

Yönlendirici

8081

Yönlendirici için varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu tarafından erişim için bileşende açık olmalıdır.

4527

Dağıtılmış önbellek ve yönetim çağrıları için

15999

Durum denetimi bağlantı noktası. Yük dengeleyici, yönlendiricinin kullanılabilir olup olmadığını belirlemek için bu bağlantı noktasını kullanır.

Yük dengeleyici, yönlendiricinin durumunu öğrenmek için yönlendiricideki 15999 numaralı bağlantı noktasına istek gönderir:

> curl -v http://<routerIP>:15999/v1/servers/self/reachable

Yönlendiriciye erişilebiliyorsa istek HTTP 200 döndürür.

59001

apigee-validate yardımcı programı tarafından Edge kurulumunu test etmek için kullanılan bağlantı noktası. Bu yardımcı program, yönlendiricideki 59001 numaralı bağlantı noktasına erişim gerektirir. 59001 numaralı bağlantı noktası hakkında daha fazla bilgi için Yüklemeyi test etme bölümüne bakın.

ZooKeeper

2181

Yönetim Sunucusu, Yönlendirici, Mesaj İşlemcisi gibi diğer bileşenler tarafından kullanılır.

2888, 3888

ZooKeeper tarafından ZooKeeper kümesi (ZooKeeper topluluğu olarak bilinir) iletişimi için dahili olarak kullanılır.

Cassandra

7000, 9042, 9160

Cassandra düğümleri arasında iletişim ve diğer Edge bileşenleri tarafından erişim için Apache Cassandra bağlantı noktaları.

7199

JMX bağlantı noktası. Yönetim sunucusu tarafından erişime açık olmalıdır.

Qpid

5672

Yönlendirici ve Mesaj İşlemcisi'nden Qpid sunucusuna iletişim için kullanılır.

8083

Qpid sunucusundaki varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.

1102

JMX bağlantı noktası

4529

Dağıtılmış önbellek ve yönetim çağrıları için

Postgres

5432

Qpid/Yönetim Sunucusu'ndan Postgres'e iletişim için kullanılır.

8084

Postgres sunucusundaki varsayılan yönetim bağlantı noktasıdır ve Yönetim Sunucusu'nun erişebilmesi için bileşende açık olmalıdır.

1103

JMX bağlantı noktası

4530

Dağıtılmış önbellek ve yönetim çağrıları için

22

İki Postgres düğümünü ana-yedek replikasyon kullanacak şekilde yapılandırıyorsanız SSH erişimi için her düğümde 22 numaralı bağlantı noktasını açmanız gerekir.

LDAP

10389

OpenLDAP

SmartDocs

59002

SmartDocs sayfa isteklerinin gönderildiği Edge yönlendiricisindeki bağlantı noktası.

Aşağıdaki tabloda, kaynak ve hedef bileşenleriyle birlikte sayısal olarak listelenen aynı bağlantı noktaları gösterilmektedir:

Bağlantı Noktası Numarası

Amaç

Kaynak bileşen

Hedef Bileşen

<virtual host port#>

HTTP ve sanal ana makine API çağrısı trafiği için kullandığınız diğer bağlantı noktaları. En yaygın olarak 80 ve 443 numaralı bağlantı noktaları kullanılır. Message Router, TLS/SSL bağlantılarını sonlandırabilir.

Harici istemci (veya yük dengeleyici)

Mesaj yönlendiricisindeki dinleyici

1099 - 1103

JMX Yönetimi

JMX istemcisi

Yönetim Sunucusu (1099)

Mesaj İşlemcisi (1101)

Qpid Server (1102)

Postgres Sunucusu (1103)

2181

ZooKeeper istemci iletişimi

Yönetim Sunucusu

Yönlendirici

Mesaj İşleyici

Qpid Sunucusu

Postgres Server

Zookeeper

2888 ve 3888

Zookeeper düğümler arası yönetimi

Zookeeper

Zookeeper

4526

RPC yönetim bağlantı noktası

Yönetim Sunucusu

Yönetim Sunucusu

4527 Dağıtılmış önbellek ve yönetim çağrıları ile yönlendiriciler arasındaki iletişim için RPC yönetim bağlantı noktası

Yönetim Sunucusu

Yönlendirici

Yönlendirici

4528

Mesaj İşlemciler arasındaki dağıtılmış önbellek çağrıları ve Yönlendirici'den gelen iletişim için

Yönetim Sunucusu

Yönlendirici

Mesaj İşleyici

Mesaj İşleyici

4529 Dağıtılmış önbellek ve yönetim çağrıları için RPC yönetim bağlantı noktası Yönetim Sunucusu Qpid Sunucusu
4530 Dağıtılmış önbellek ve yönetim çağrıları için RPC yönetim bağlantı noktası Yönetim Sunucusu Postgres Server

5432

Postgres istemcisi

Qpid Sunucusu

Postgres

5672

Yönlendirici ve Mesaj İşlemcisi'nden Qpid'ye analiz göndermek için kullanılır.

Yönlendirici

Mesaj İşleyici

Qpid Sunucusu

7000

Cassandra düğümler arası iletişimleri

Cassandra

Diğer Cassandra düğümü

7199

JMX yönetimi. Yönetim Sunucusu tarafından Cassandra düğümünde erişime açık olmalıdır.

JMX istemcisi

Cassandra

8080

Management API bağlantı noktası

Management API istemcileri

Yönetim Sunucusu

8081 - 8084

API isteklerini doğrudan bağımsız bileşenlere göndermek için kullanılan bileşen API bağlantı noktaları. Her bileşen farklı bir bağlantı noktası açar. Kullanılan bağlantı noktası yapılandırmaya bağlıdır ancak Yönetim Sunucusu'nun erişebilmesi için bileşende açık olması gerekir.

Management API istemcileri

Yönlendirici (8081)

Mesaj İşlemcisi (8082)

Qpid Sunucusu (8083)

Postgres Sunucusu (8084)

8998

Yönlendirici ile Mesaj İşleyici arasındaki iletişim

Yönlendirici

Mesaj İşleyici

9000

Varsayılan Edge yönetim kullanıcı arayüzü bağlantı noktası

Tarayıcı

Yönetim Kullanıcı Arayüzü Sunucusu

9042

CQL yerel aktarımı

Yönlendirici

Mesaj İşleyici

Yönetim Sunucusu

Cassandra

9160

Cassandra Thrift istemcisi

Yönlendirici

Mesaj İşleyici

Yönetim Sunucusu

Cassandra

10389

LDAP bağlantı noktası

Yönetim Sunucusu

OpenLDAP

15999

Durum denetimi bağlantı noktası. Yük dengeleyici, yönlendiricinin kullanılabilir olup olmadığını belirlemek için bu bağlantı noktasını kullanır.

Yük dengeleyici Yönlendirici
59001 Edge kurulumunu test etmek için apigee-validate yardımcı programı tarafından kullanılan bağlantı noktası apigee-validate Yönlendirici

59002

SmartDocs sayfa isteklerinin gönderildiği yönlendirici bağlantı noktası

SmartDocs

Yönlendirici

Mesaj işlemcisi, Cassandra'ya özel bir bağlantı havuzunu açık tutar. Bu havuz, zaman aşımına uğramayacak şekilde yapılandırılmıştır. Bir Mesaj İşleyici ile Cassandra sunucusu arasında güvenlik duvarı olduğunda güvenlik duvarı, bağlantının zaman aşımına uğramasına neden olabilir. Ancak mesaj işleyici, Cassandra ile bağlantıları yeniden kurmak için tasarlanmamıştır.

Apigee, bu durumu önlemek için Cassandra sunucusunun, mesaj işleyicinin ve yönlendiricilerin aynı alt ağda olmasını önerir. Böylece bu bileşenlerin dağıtımında güvenlik duvarı kullanılmaz.

Yönlendirici ile mesaj işleyiciler arasında bir güvenlik duvarı varsa ve boşta TCP zaman aşımı ayarlanmışsa önerilerimiz şunlardır:

  1. Linux OS işletim sistemindeki sysctl ayarlarında net.ipv4.tcp_keepalive_time = 1800 değerini ayarlayın. Burada 1800, güvenlik duvarı boşta TCP zaman aşımından daha düşük olmalıdır. Bu ayar, güvenlik duvarının bağlantıyı kesmemesi için bağlantıyı kurulmuş durumda tutmalıdır.
  2. Tüm Mesaj İşleyicilerde, aşağıdaki özelliği eklemek için /<inst_root>/apigee/customer/application/message-processor.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  3. Mesaj İşleyici'yi yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  4. Tüm yönlendiricilerde, aşağıdaki özelliği eklemek için /<inst_root>/apigee/customer/application/router.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
    conf_system_cassandra.maxconnecttimeinmillis=-1
  5. Yönlendiriciyi yeniden başlatın:
    > /opt/apigee/apigee-service/bin/apigee-service edge-router restart

İki veri merkeziyle 12 ana makine kümelenmiş yapılandırmasını yüklerseniz iki veri merkezindeki düğümlerin aşağıda gösterilen bağlantı noktaları üzerinden iletişim kurabildiğinden emin olun:

API BaaS bağlantı noktası gereksinimleri

API BaaS'yi yüklemeyi seçerseniz API BaaS Stack ve API BaaS Portal bileşenlerini eklersiniz. Bu bileşenler, aşağıdaki şekilde gösterilen bağlantı noktalarını kullanır:

Bu diyagramla ilgili notlar:

  • API BaaS Portalı hiçbir zaman doğrudan bir BaaS Stack düğümüne istek göndermez. Geliştirici, Portal'a giriş yaptığında Portal uygulaması tarayıcıya indirilir. Tarayıcıda çalışan Portal uygulaması, BaaS Stack düğümlerine istek gönderir.
  • API BaaS'ın üretim kurulumunda, API BaaS Portal düğümü ile API BaaS Stack düğümleri arasında bir yük dengeleyici kullanılır. Portalı yapılandırırken ve BaaS API çağrıları yaparken Stack düğümlerinin değil, yük dengeleyicinin IP adresini veya DNS adını belirtirsiniz.
  • Tüm Stack düğümleri, diğer tüm Stack düğümlerinden erişim için 2551 numaralı bağlantı noktasını açmalıdır (Stack düğümlerindeki 2551 numaralı bağlantı noktası için yukarıdaki diyagramda döngü okuyla gösterilmiştir). Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm Stack düğümlerinden erişilebilmelidir.
  • Tüm Baas Stack düğümlerini, harici bir SMTP sunucusu üzerinden e-posta gönderecek şekilde yapılandırmanız gerekir. TLS olmayan SMTP için bağlantı noktası numarası genellikle 25'tir. TLS özellikli SMTP için genellikle 465'tir ancak SMTP sağlayıcınızla iletişime geçerek doğrulayın.
  • Cassandra düğümleri API BaaS'ye ayrılabilir veya Edge ile paylaşılabilir.

Aşağıdaki tabloda, güvenlik duvarlarında açılması gereken varsayılan bağlantı noktaları bileşene göre gösterilmektedir:

Bileşen

Bağlantı noktası

Açıklama

API BaaS Portal

9000

API BaaS kullanıcı arayüzü için bağlantı noktası

API BaaS Yığını

8080

API isteklerinin alındığı bağlantı noktası

2551

Tüm Stack düğümleri arasında iletişim için kullanılan bağlantı noktası. Veri merkezindeki diğer tüm Stack düğümleri tarafından erişilebilir olmalıdır.

Birden fazla veri merkeziniz varsa bağlantı noktasına tüm veri merkezlerindeki tüm Stack düğümlerinden erişilebilmelidir.

ElasticSearch

9.200-9.400

API BaaS Stack ile iletişim kurmak ve ElasticSearch düğümleri arasında iletişim kurmak için

Lisanslama

Her Edge kurulumu için Apigee'den alacağınız benzersiz bir lisans dosyası gerekir. Yönetim sunucusunu yüklerken lisans dosyasının yolunu (ör. /tmp/license.txt) belirtmeniz gerekir.

Yükleyici, lisans dosyasını /<inst_root>/apigee/customer/conf/license.txt konumuna kopyalar.

Lisans dosyası geçerliyse yönetim sunucusu, geçerlilik bitiş tarihini ve izin verilen Mesaj İşlemci (MP) sayısını doğrular. Lisans ayarlarından herhangi birinin süresi dolduysa günlükleri şu konumda bulabilirsiniz: /<inst_root>/apigee/var/log/edge-management-server/logs. Bu durumda, taşıma ayrıntıları için Apigee Destek Ekibi ile iletişime geçebilirsiniz.

Henüz lisansınız yoksa buradan satış ekibiyle iletişime geçin.