Edge for Private Cloud v. 4.16.05
Yük Dengeleyici Kullanma
API BaaS üretim kurulumunda, API BaaS Portal düğümü ile API BaaS Yığın düğümleri arasında bir yük dengeleyici kullanılır. Portal'ı yapılandırırken Yığın düğümlerinin değil, yük dengeleyicinin IP adresini veya DNS adını belirtirsiniz.
Yük dengeleyiciye alternatif olarak döngüsel DNS kullanabilirsiniz. Bu senaryoda, BaaS yığını IP adreslerine karşılık gelen birden fazla A kaydına sahip bir DNS girişi oluşturursunuz. DNS araması sırasında DNS sunucusu A kaydı değerlerini otomatik olarak sırayla döndürür.
Cassandra'ya bağlanılıyor
BaaS yüklerken BaaS ve Edge'i aynı Cassandra kümesine bağlamayı veya BaaS için ayrı bir Cassandra kümesi oluşturmayı seçebilirsiniz. Daha küçük BaaS kurulumları (diğer bir deyişle, daha düşük trafik hacimleri) genellikle Edge ile bir Cassandra kümesini paylaşır.
Apigee, yüksek işleme hızı ve kullanılabilirlik sağlamak ya da Cassandra kümelerini farklı ağ alt bölgelerine ayırmak için ayrı Cassandra kümeleri kullanmanızı önerir. BaaS'da yüksek trafik yükü yaşıyorsanız ayrı kümeler performansı en üst düzeye çıkarır.
Tarih senkronizasyonu
Tarih/saatin tüm sunucularda senkronize edilmiş olması gerekir. Önceden yapılandırılmamışsa "ntpdate" yardımcı programı, sunucuların zaman senkronize olup olmadığını doğrulayarak bu amaca hizmet edebilir. Yardımcı programı yüklemek için "yum install ntp" komutunu kullanabilirsiniz.
Tomcat güvenliği
API BaaS yükleyicisi, Apache Tomcat sunucusunu Tomcat yönetici kullanıcı arayüzü de dahil olmak üzere tüm API BaaS Yığın düğümlerine de yükler. Yükleyici, varsayılan yönetici kimlik bilgilerini "admin:admin"de değiştirmeden bırakır.
Gerekirse Tomcat'in güvenliğini sağlamak için bu kimlik bilgilerini değiştirebilirsiniz. Daha fazla bilgi için şu makalelere göz atın:
- https://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
- https://www.owasp.org/index.php/Securing_tomcat
Yüklemeye genel bakış
Edge'i bir düğüme apigee-setup yardımcı programını yükledikten sonra, bu yardımcı programı kullanarak düğüme bir veya daha fazla BaaS bileşeni yükleyin. apigee-setup yardımcı programı şu biçimdedir:
> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Yüklemeyle ilgili bilgileri içeren apigee-setup yardımcı programına bir yapılandırma dosyası iletin. Yapılandırma dosyasında gerekli bilgiler eksikse apigee-setup yardımcı programı, bu dosyayı komut satırına girmenizi ister.
Tek şart, yapılandırma dosyasının "Apigee" kullanıcısı tarafından erişilebilir ve okunabilmesidir. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
Örneğin, API BaaS Grubunu yüklemek için aşağıdaki komutu kullanın:
> sudo /opt/apigee/apigee-setup/bin/setup.sh -p b -f myConfig
Apigee setup.sh yardımcı programı, API BaaS bileşenlerini yüklemek için sunulan birçok seçeneği destekler. Aşağıdaki talimatlarda bağımsız seçenekler (c, e, b ve p) kullanılmaktadır ancak düğüm yapılandırmanıza bağlı olarak farklı seçenekler de kullanabilirsiniz:
|
Seçenek |
Açıklama |
|---|---|
|
e |
Yalnızca Elastik Arama'yı yükleyin. |
|
b |
Yalnızca API BaaS Stack'i yükleyin (bu şekilde Tomcat'i de yükler). |
|
p |
Yalnızca API BaaS Portalı'nı yükleyin. Bu işlem ayrıca web sunucusu olarak kullanılacak Nginx yönlendiricisini de yükler. |
|
c |
Yalnızca Cassandra'yı yükleyin. |
|
eb |
Düğüme ElasticSearch, API BaaS Stack ve Tomcat'i yükleyin. |
|
ebp |
ElasticSearch, API BaaS Portal, API BaaS Stack ve Tomcat'i yükleyin. Portal çok hafif olduğundan ek kaynak gerektirmez. |
|
Asa |
Tüm API bileşenlerini tek bir düğüme yükleyin (Cassandra, Elasticsearch, API BaaS Yığını ve API BaaS Portalı). Bu seçeneği üretim için değil, yalnızca geliştirme ve test için kullanın. |
Sessiz yapılandırma dosyası oluşturma
Aşağıda 10 düğümlü API BaaS yüklemesi için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bu dosyayı yapılandırmanız için gereken şekilde düzenleyin. Bu dosyayı eklemek için setup.sh bölümünde -f seçeneğini kullanın.
# Specify IP address or DNS name of node. IP1=192.168.1.1 # ElasticSearch IP2=192.168.1.2 # ElasticSearch IP3=192.168.1.3 # ElasticSearch IP4=192.168.1.4 # API BaaS Stack IP5=192.168.1.5 # API BaaS Stack IP6=192.168.1.6 # API BaaS Stack IP7=192.168.1.7 # API BaaS Portal IP8=192.168.1.8 # Cassandra (shared with Edge or standalone) IP9=192.168.1.9 # Cassandra (shared with Edge or standalone) IP10=192.168.1.10 # Cassandra (shared with Edge or standalone) # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Define the API BaaS administrator account. AS_ADMIN="superuser" # User name - default is "superuser". AS_ADMIN_EMAIL=stackAdmin@email.com AS_PASSWD=stackAdminPWrod # Only if you are installing Cassandra. # Specify Cassandra configuration information. # Must use IP addresses for CASS_HOSTS, not DNS names. # CASS_HOSTS="$IP8:1,1 $IP9:1,1 $IP10:1,1" # If connecting to existing Cassandra nodes, # specify Cassandra IPs. # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP8 $IP9 $IP10" # Cassandra uname/pword. # Even if Cassandra authentication is disabled, # you must still pass values for these properties. CASS_USERNAME=cassandra # Default value CASS_PASSWORD=cassandra # Default value # Specify BaaS Cassandra connection information. # Specify the data center name. BAAS_CASS_LOCALDC=dc-1 # Default is dc-1. # Replication is in the form "dataCenterName:#CassandraNodes". # For example, for dc-1 with three Cassandra nodes, it is dc-1:3. BAAS_CASS_REPLICATION=dc-1:3 # ElasticSearch IPs or DNS names, separated by spaces. ES_HOSTS="$IP1 $IP2 $IP3" # API BaaS Stack information. # Default cluster name is "apigee_baas" BAAS_USERGRID_CLUSTERNAME="apigee_baas" # URL and port of the load balancer for the API BaaS Stack nodes, # or IP/DNS and port 8080 of a single Stack node with no load balancer. BAAS_USERGRID_URL=http://myloadbalancer:8443 # API BaaS Portal information. # URL and port number of load balancer, if there is one in front of the Portal, # or the URL and port of the Portal node. BAAS_PORTAL_URL="http://$IP7:9000" # Portal port. Default value is 9000. BAAS_PORTAL_LISTEN_PORT=9000 # SMTP information. BaaS requires an SMTP server. SMTPHOST=smtp.gmail.com SMTPPORT=465 SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y
Aşağıdaki tabloda bu mülkler hakkında ek bilgiler yer almaktadır:
|
Özellik |
Not |
|---|---|
|
CASS_HOSTS |
Cassandra'yı yüklüyorsanız Cassandra düğüm IP'lerini (DNS adlarını değil) belirtin ve Cassandra düğümünün veri merkezini ve rafını belirten ":dc,ra" değiştiricisini ekleyin. Örneğin "192.168.124.201:1,1 = veri merkezi 1 ve raf/kullanılabilirlik bölgesi 1 ile "192.168.124.204:2,1 = veri merkezi 2 ve raf/kullanılabilirlik bölgesi 1. |
|
CASS_KULLANICI_ADI |
Cassandra kullanıcı adı ve şifresi. Cassandra kimlik doğrulaması devre dışı bırakılmış olsa bile bu değerleri iletmeniz gerekir. Ancak bu değerler yoksayılır. |
|
BAAS_CASS_LOCALDC |
Bölge adları dc-# biçiminde olmalıdır. Burada #, bir tam sayı değerine karşılık gelir. Örneğin, dc-1, dc-2 vb. Edge ile yüklü bir Cassandra kümesine bağlanıyorsanız Edge sistem yöneticisinden bu değeri isteyebilirsiniz. Edge tek bir veri merkezi kurulumunda varsayılan değer dc-1'dir. API BaaS'yi yükleme işleminin bir parçası olarak Cassandra'yı yüklediyseniz Cassandra kurulumu sırasında Cassandra IP adreslerine ":dc,ra" değiştiricisini eklediniz. İlk değer "dc", veri merkezi numarasıdır. Veri merkezi adı, son ek olarak veri merkezi numarasını içeren "dc-" dizesidir. |
|
BAAS_CASS_REPLICATION |
Biçim şöyle olmalıdır: "dataCenterName:#CassandraNodes". Örneğin, üç Cassandra düğümü olan dc-1 için dc-1:3 değeri kullanılır. |
|
BAAS_USERGRID_URL |
Bir üretim ortamında yük dengeleyicinin API BaaS Yığın düğümlerinin önünde yer alan şu biçimde URL'si ve bağlantı noktasıdır: Tek bir API BaaS Yığını düğümünüzün bulunduğu bir test veya geliştirme ortamında; bu, aşağıdaki biçimde bir API BaaS Yığını düğümünün URL'si ve bağlantı noktası numarası olabilir: http://stackIPorDNS:8080 API BaaS Yığın sunucusunun bağlantı noktası numarası 8080'dir. |
|
BAAS_PORTAL_URL |
Portal'ın önünde varsa yük dengeleyicinin URL'si ve bağlantı noktası numarası (Portal'ın önünde varsa) şu biçimdedir: |
|
BAAS_PORTAL_LISTEN_PORT |
API BaaS Portal sunucusunun bağlantı noktası numarası 9000'dür. Bu bağlantı noktası kullanılamıyorsa farklı bir bağlantı noktası belirtin. Portal düğümünün URL'sini BAAS_PORTAL_URL olarak ayarlıyorsanız bağlantı noktası numaraları her iki mülk için de aynı olmalıdır. |
İsteğe bağlı - Cassandra'yı yükleme: Makine 8, 9 ve 10
API BaaS'yi, Edge'in kullandığıyla aynı Cassandra kümesine bağlayabilirsiniz ancak Apigee, ayrı kümeler kullanmanızı önerir.
Cassandra kümesi kimlik doğrulama kullanabilir veya Cassandra kimlik doğrulaması devre dışı bırakılabilir. Daha fazla bilgi için Cassandra kimlik doğrulamasını etkinleştirme bölümüne bakın.
- İnternet veya internet dışı prosedürü kullanarak düğüme Edge apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.
- Komut isteminde kurulum komut dosyasını çalıştırın:
> /opt/../..//impression-setup/bin/setup.sh -p c -f configFile
"-p c" seçeneği, Cassandra'nın yüklenmesini belirtir.
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
Yapılandırma, düğümdeki veri deposu kurulumunu başarıyla tamamlar.
JMX'in, Cassandra için varsayılan olarak etkin olduğunu unutmayın. Cassandra'ya JMX uzaktan erişimi şifre gerektirmez. Cassandra'yı, JMX için kimlik doğrulaması kullanacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Nasıl İzlenir? sayfasını inceleyin.
Cassandra cron işi ayarla
Her Cassandra düğümünde saat bir kilitlerin çalışması için kilitleri boşaltmak için nodetool öğesini kullanan bir cron işi oluşturun.
Birden fazla Cassandra düğümünüz varsa tüm düğümlerin aynı anda boşaltılmaması için her sunucudaki cron işini beş dakika ayarlayın.
Cron işi aşağıdaki komutu yürütmelidir:
/opt/apigee/apigee-cassandra/bin/nodetool -h IP_address flush Apigee_Baas_Locks
burada IP_address, Cassandra düğümünün IP adresidir.
Elastik Search'ü yükleme: Makine 1, 2 ve 3
Elastik Search'ü yüklemek için:
- İnternet veya internet dışı prosedürü kullanarak düğüme Edge Apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.
- Komut isteminde kurulum komut dosyasını çalıştırın:
> /opt/impression/Apigee-setup/bin/setup.sh -p e -f configFile
"-p e" seçeneği, ElastikSearch'ün yüklenmesini belirtir.
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin. - (İsteğe bağlı) Elastik Search'ü bağımsız bir düğüme yüklerseniz (yani API BaaS Yığını ile yüklenmemişse) varsayılan bellek seçeneğini, Elastik Search için ayrılan belleği 4 GB'tan 6 GB'a yükseltecek şekilde ayarlayın:
- Bir düzenleyicide /opt/apigee/customer/application/elasticsearch.properties dosyasını açın. Bu dosya yoksa oluşturun.
- setenv_elasticsearch_max_mem_size
özelliğini 6 g olarak ayarlayın (varsayılan değer 4 g'dir):
setenv_elastiksearch_max_mem_size=6g - Dosyayı kaydedin.
- Şu komutu çalıştırın:
> /opt/Apigee/Apigee-service/bin/Apigee-service Apigee-elasticsearch restart
Yapılandırma, düğümdeki kurulumu başarıyla tamamladı.
API BaaS Yığını Yükleme: Makine 4, 5 ve 6
API BaaS Yığınını yüklemek için:
- İnternet veya internet dışı prosedürü kullanarak düğüme Edge Apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.
- Komut isteminde kurulum komut dosyasını çalıştırın:
> /opt/../..//Apigee-setup/bin/setup.sh -p b -f configFile
"-p b" seçeneği, API BaaS yığınının yüklenmesini belirtir.
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
Yükleyici doğru yönetici kimlik bilgilerini aldıktan sonra Tomcat'i yükler, API BaaS anahtar alanları oluşturur ve sunucuda API BaaS Yığını'nı kurar. SMTP, kullanıcı arayüzünün şifre onay e-postaları göndermesine izin verecek şekilde de yapılandırılır.
API BaaS Portalı'nı Yükleme: Makine 7
API BaaS Portalı'nı yüklemek için:
- İnternet veya internet dışı prosedürü kullanarak düğüme Edge Apigee-setup yardımcı programını yükleyin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme bölümüne bakın.
- Komut isteminde kurulum komut dosyasını çalıştırın:
> /opt/impression/setup/bin/setup.sh -p p -f configFile
"-p p" seçeneği, API BaaS Portalı'nın yüklenmesini belirtir.
Yapılandırma dosyası, "Apigee" kullanıcısı tarafından erişilebilir ve okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
Yükleyici, Nginx web sunucusunu başlatır ve API BaaS Portalı yapılandırmasını tamamlar.
API BaaS Portal URL'sini not edin. Bu, API BaaS Portal kullanıcı arayüzüne erişmek için bir tarayıcıya girdiğiniz URL'dir.
Yığın veya Portal yük dengeleyici için API BaaS düğümlerini yapılandırma
Yığın veya Portal düğümlerinin önüne bir yük dengeleyici eklerseniz düğümleri doğru yük dengeleyici URL'si ile yapılandırmanız gerekir. Örneğin, Yığın düğümleri aşağıdaki durumlarda bu bilgileri gerektirir:
- BaaS API isteklerindeki yanıtlara URL ekleme.
- Şifreyi sıfırlarken veya başka bildirimler gönderirken e-posta şablonlarına bağlantı ekleme.
- Kullanıcıları belirli Portal sayfalarına yönlendirme.
Yığın düğümlerinin önünde bir yük dengeleyici kullanıyorsanız /opt/apigee/customer/application/usergrid.properties adresinde aşağıdaki özellikleri ayarlayın:
usergrid-deployment_swagger.basepath=http://localhost:8080 usergrid-deployment_usergrid.organization.activation.url=http://localhost:8080/management/organizations/%s/activate usergrid-deployment_usergrid.admin.activation.url=http://localhost:8080/management/users/%s/activate usergrid-deployment_usergrid.admin.resetpw.url=http://localhost:8080/management/users/%s/resetpw usergrid-deployment_usergrid.admin.confirmation.url=http://localhost:8080/management/users/%s/confirm usergrid-deployment_usergrid.user.activation.url=http://localhost:8080/%s/%s/users/%s/activate usergrid-deployment_usergrid.user.confirmation.url=http://localhost:8080/%s/%s/users/%s/confirm usergrid-deployment_usergrid.user.resetpw.url=http://localhost:8080/%s/%s/users/%s/resetpw
http://localhost:8080 ifadesini yük dengeleyicinin URL'siyle değiştirin. Yük dengeleyici TLS kullanacak şekilde yapılandırıldıysa HTTPS protokolünü kullanın. Bağlantı noktasını yalnızca standart olmayan bir bağlantı noktası kullanıyorsanız (yani HTTP için 80 ve HTTPS için bağlantı noktası 443 dışında bir bağlantı noktası) eklemeniz gerekir.
Yığın düğümlerinin önünde bir yük dengeleyici kullanıyorsanız /opt/Apigee/customer/application/portal.properties içinde aşağıdaki özelliği de ayarlamanız gerekir:
baas.portal.config.overrideUrl=http://localhost:8080
http://localhost:8080 ifadesini Yığın için yük dengeleyicinin URL'si ile değiştirin.
Portal düğümünün önünde bir yük dengeleyici kullanıyorsanız usergrid.properties içinde aşağıdaki özellikleri ayarlayın:
usergrid-deployment_usergrid.view.management.organizations.organization.activate=http://localhost:9000 usergrid-deployment_usergrid.view.management.organizations.organization.confirm=http://localhost:9000 usergrid-deployment_usergrid.view.management.users.user.activate=http://localhost:9000 usergrid-deployment_usergrid.view.management.users.user.confirm=http://localhost:9000
http://localhost:9000 ifadesini yük dengeleyicinin URL'siyle değiştirin. Yük dengeleyici TLS kullanacak şekilde yapılandırıldıysa HTTPS protokolünü kullanın. Bağlantı noktasını yalnızca standart olmayan bir bağlantı noktası kullanıyorsanız (HTTP için 80 ve HTTPS için bağlantı noktası 443 dışında bir bağlantı noktası) kullanmanız gerekir.
usergrid.properties ve portal.properties düzenlendikten sonra:
- Yığın düğümünü yapılandırın:
> /<inst_root>/Apigee/Apigee-service/bin/Apigee-service baas-usergrid yapılandır - Değişiklikleri Tomcat'e dağıtın:
> /<inst_root>/Apigee/../../-service/bin/Apigee-service baas-usergrid Distribution - BaaS Grubunu yeniden başlatın:
> /<inst_root>/Apigee/teslim-hizmeti/bin/Apigee-service baas-usergrid yeniden başlatma - portal.properties değerini değiştirdiyseniz Portal düğümünü yapılandırın:
> /<inst_root>/Apigee/Apigee-service/bin/Apigee-service baas-portal yapılandır - Değişiklikleri dağıtın:
> /<inst_root>/Apigee/Apigee-service/bin/Apigee-service baas-portal dağıtımını - BaaS Portalı'nı yeniden başlatın:
> /<inst_root>/Apigee/Apigee-service/bin/Apigee-service baas-portal restart
Yeni bir kuruluşa ilk katılım
İlk katılım, kuruluş ve kuruluş yöneticisi oluşturma sürecidir. Kuruluşu ve kuruluş yöneticisini oluşturduktan sonra API BaaS Portalı kullanıcı arayüzüne giriş yapıp API BaaS REST API'ye istek gönderebilirsiniz.
Bir kuruluş oluşturduğunuzda kuruluş yöneticisinin e-posta adresi:
- Sistem yöneticisinin e-posta adresinden farklı olmalıdır.
- Diğer tüm kuruluşlar arasında benzersiz olmalıdır. Yani, kuruluş yöneticisi için aynı e-posta adresine sahip iki kuruluş oluşturamazsınız. Ancak, kuruluşu oluşturduktan sonra birden fazla kuruluşta yinelenebilecek başka yöneticiler ekleyebilirsiniz.
İlk katılım işlemini gerçekleştirmek için create_org_and_user.py Python komut dosyasını kullanın. Bu komut dosyasını komut satırı bağımsız değişkeni olmadan çağırmak, sizden tüm bilgileri istemesine neden olur:
> python create_org_and_user.py
Alternatif olarak, seçeneklerin herhangi birini veya tümünü komut satırı bağımsız değişkeni olarak aktarabilirsiniz. Komut satırından çıkarmadığınız tüm bilgiler istenir:
> python create_org_and_user.py -o '<org name>' > python create_org_and_user.py -o '<org name>' -a '<new admin email>' -p '<new admin password>'
Kuruluş oluşturmak için:
- Dizini /opt/apigee/baas-usergrid/bin olarak değiştirin.
- create_org_and_user.py Python komut dosyasını çağırın.
Yalnızca bir sistem yöneticisinin çalıştırabilmesi için BaaS sistem yöneticisi kullanıcı adını ve şifresini girmeniz istenir. - API BaaS Portalı URL kurulumunun sonunda not ettiğiniz URL'yi kullanarak bir web tarayıcısında API BaaS Portalı'na giriş yapın. Portala erişmek için API BaaS Portalı URL'sini şu forma girin:
http://{portalExternalIP}:9000/
Not: IP, Portal makinesinin harici IP adresi/ana makine adıdır. Bağlantı noktasının açık olduğundan emin olun. - Portal giriş ekranı göründüğünde aşağıdakilerden birini yapabilirsiniz:
- Kuruluş yöneticisinin kullanıcı adını ve şifresini kullanarak giriş yapın.
- Sistem yöneticilerinin kullanıcı adını ve şifresini kullanarak giriş yapın.
API BaaS REST API'ye erişme
API BaaS REST API'ye erişmek için şu formdaki bir URL'yi kullanın:
https://{loadBalancerIP}:8080/{your-org}/{your-app}
Geliştirme ortamında tüm API BaaS bileşenlerini tek bir düğüme yükleyebilirsiniz. Yani, tek bir API BaaS Yığını olur. Tek bir API BaaS Yığın düğümü ve yük dengeleyicisi olmayan küçük bir ortamınız da olabilir. Bu tür ortamlarda doğrudan API BaaS Yığın düğümüne API çağrıları yapabilirsiniz:
curl -v "http://portalExternalIP:8080/status"
API BaaS Portalı'nı kullanmaya başlama hakkında daha fazla bilgi için http://apigee.com/docs/content/build-apps-home adresindeki Apigee belgelerini inceleyin.