7 ana makine ve 10 barındırıcı API BaaS Yükleme

Edge for Private Cloud 4.16.05 sürümü

Yük dengeleyici kullanma

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 Stack düğümlerinin değil, yük dengeleyicinin IP adresini veya DNS adını belirtirsiniz.

Yük dengeleyiciye alternatif olarak sıralı DNS kullanabilirsiniz. Bu senaryoda, BaaS yığını IP adreslerine karşılık gelen birden fazla A kaydı içeren 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ğlanma

BaaS'yi yüklerken BaaS ve Edge'i aynı Cassandra kümesine bağlamayı seçebilir veya BaaS için ayrı bir Cassandra kümesi oluşturabilirsiniz. Daha küçük BaaS kurulumları, yani daha düşük trafik hacmine sahip olanlar, genellikle Edge ile bir Cassandra kümesini paylaşır.

Yüksek gönderim hacmi ve kullanılabilirlik için veya Cassandra kümelerini farklı ağ bölgelerine ayırmak için Apigee, ayrı Cassandra kümeleri kullanmanızı önerir. BaaS'ta yüksek trafik yüküyle karşılaşıyorsanız ayrı kümeler performansı en üst düzeye çıkarır.

Tarih senkronizasyonu

Tüm sunucularda tarih/saat senkronize edilmiş olmalıdır. 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.

Tomcat güvenliği

API BaaS yükleyicisi, Tomcat yönetici kullanıcı arayüzü de dahil olmak üzere tüm API BaaS Stack düğümlerine Apache Tomcat sunucusunu da yükler. Yükleyici, varsayılan yönetici kimlik bilgilerini admin:admin olarak bırakır.

Gerekirse Tomcat'in güvenliğini sağlama kapsamında bu kimlik bilgilerini değiştirebilirsiniz. Daha fazla bilgi için aşağıdaki sayfalara 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 apigee-setup yardımcı programını bir düğüme yükledikten sonra, düğüme bir veya daha fazla BaaS bileşeni yüklemek için bu yardımcı programı kullanın. 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 bilgileri komut satırına girmenizi ister.

Tek şart, yapılandırma dosyasının "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmasıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.

Örneğin, API BaaS Stack'i 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 çeşitli seçenekleri 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 göre farklı seçenekler kullanabilirsiniz:

Sessiz yapılandırma dosyası oluşturma

Aşağıda, 10 düğümlü bir API BaaS kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Bu dosyayı yapılandırmanız için gerektiği şekilde düzenleyin. Bu dosyayı dahil etmek için setup.sh komutunda -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 özellikler hakkında ek bilgiler yer almaktadır:

İsteğe bağlı - Cassandra'yı yükleme: 8, 9 ve 10 numaralı makineler

API BaaS'yi Edge tarafından kullanılan 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 başlıklı makaleyi inceleyin.

1. İ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 başlıklı makaleyi inceleyin.
2. Komut isteminde kurulum komut dosyasını çalıştırın:
   > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
   
   "-p c" seçeneği, Cassandra'nın yükleneceğini belirtir.
   Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya 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 etkinleştirildiğini unutmayın. Cassandra'ya JMX uzaktan erişimi için şifre gerekmez. Cassandra'yı JMX için kimlik doğrulama kullanacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için İzleme yöntemi başlıklı makaleyi inceleyin.

Cassandra cron işini ayarlama

Her Cassandra düğümünde her saat çalışacak şekilde kilitleri temizlemek için nodetool kullanan bir cron işi oluşturun.

Birden fazla Cassandra düğümünüz varsa tüm düğümlerin aynı anda temizlenmemesi için her sunucudaki cron işini beş dakika kaydırı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.

ElasticSearch'ü yükleme: 1, 2 ve 3. makineler

ElasticSearch'ü yüklemek için:

1. İnternet veya internet dışı prosedürü kullanarak Edge apigee-setup yardımcı programını düğüme yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
2. Komut isteminde kurulum komut dosyasını çalıştırın:
   > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
   
   "-p e" seçeneği, ElasticSearch'ün yükleneceğini belirtir.
   Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.
3. (İsteğe bağlı) ElasticSearch'ü bağımsız bir düğüme yüklerseniz (API BaaS Stack ile yüklenmediği anlamına gelir) ElasticSearch için ayrılan belleği 4 GB'tan 6 GB'a yükseltmek üzere varsayılan bellek seçeneğini ayarlayın:
   1. /opt/apigee/customer/application/elasticsearch.properties dosyasını bir düzenleyicide açın. Bu dosya yoksa oluşturun.
   2. setenv_elasticsearch_max_mem_size özelliğini 6g olarak ayarlayın (varsayılan değer 4g'dir):
      setenv_elasticsearch_max_mem_size=6g
   3. Dosyayı kaydedin.
   4. Aşağıdaki komutu çalıştırın:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart

Yapılandırma, düğümdeki kurulumu başarıyla tamamlar.

API BaaS yığınını yükleme: 4, 5 ve 6. makineler

API BaaS yığınını yüklemek için:

1. İnternet veya internet dışı prosedürü kullanarak Edge apigee-setup yardımcı programını düğüme yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
2. Komut isteminde kurulum komut dosyasını çalıştırın:
   > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile
   
   "-p b" seçeneği, API BaaS Stack'in yükleneceğini belirtir.
   Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya 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ı ayarlar. SMTP, kullanıcı arayüzünün şifre onay e-postaları göndermesine izin verecek şekilde de yapılandırılmıştır.

API BaaS Portal'ı yükleme: Makine 7

API BaaS portalını yüklemek için:

1. İnternet veya internet dışı prosedürü kullanarak Edge apigee-setup yardımcı programını düğüme yükleyin. Daha fazla bilgi için Edge apigee-setup yardımcı programını yükleme başlıklı makaleyi inceleyin.
2. Komut isteminde kurulum komut dosyasını çalıştırın:
   > /opt/apigee/setup/bin/setup.sh -p p -f configFile
   
   "-p p" seçeneği, API BaaS Portal'ın yükleneceğini belirtir.
   Yapılandırma dosyası, "apigee" kullanıcısı tarafından erişilebilir veya okunabilir olmalıdır. Örneğin, dosyayı düğümdeki /tmp dizinine yerleştirin.

Yükleyici, Nginx web sunucusunu başlatır ve ardından 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 tarayıcıya girdiğiniz URL'dir.

API BaaS düğümlerini bir Stack veya Portal yük dengeleyicisi için yapılandırma

Stack veya Portal düğümlerinin önüne bir yük dengeleyici eklerseniz düğümleri yük dengeleyicinin doğru URL'siyle yapılandırmanız gerekir. Örneğin, Stack düğümleri şu durumlarda bu bilgilere ihtiyaç duyar:

• BaaS API isteklerindeki yanıtlara URL ekleme.
• Şifre sıfırlama veya başka bildirimler gönderme sırasında e-posta şablonlarına bağlantı ekleme
• Kullanıcıları belirli Portal sayfalarına yönlendirme.

Stack düğümlerinin önünde bir yük dengeleyici kullanıyorsanız /opt/apigee/customer/application/usergrid.properties dosyasında 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 adresini yük dengeleyicinin URL'siyle değiştirin. Yük dengeleyici TLS kullanacak şekilde yapılandırıldıysa HTTPS protokolünü kullanın. Yalnızca standart olmayan bir bağlantı noktası (HTTP için 80 ve HTTPS için 443 numaralı bağlantı noktası dışında bir bağlantı noktası) kullanıyorsanız bağlantı noktasını eklemeniz gerekir.

Yığın düğümlerinin önünde bir yük dengeleyici kullanıyorsanız /opt/apigee/customer/application/portal.properties dosyasında aşağıdaki özelliği de ayarlamanız gerekir:

baas.portal.config.overrideUrl=http://localhost:8080

http://localhost:8080 adresini yığının yük dengeleyicisinin URL'siyle değiştirin.

Portal düğümünün önünde bir yük dengeleyici kullanıyorsanız usergrid.properties dosyasında 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 adresini yük dengeleyicinin URL'siyle değiştirin. Yük dengeleyici TLS kullanacak şekilde yapılandırıldıysa HTTPS protokolünü kullanın. Yalnızca standart olmayan bir bağlantı noktası (HTTP için 80 ve HTTPS için 443 numaralı bağlantı noktası dışında bir bağlantı noktası) kullanıyorsanız bağlantı noktasını eklemeniz gerekir.

usergrid.properties ve portal.properties dosyalarını düzenledikten sonra:

1. Stack düğümünü yapılandırın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure
2. Değişiklikleri Tomcat'e dağıtın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid deploy
3. BaaS yığınını yeniden başlatın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart
4. portal.properties dosyasını değiştirdiyseniz Portal düğümünü yapılandırın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal configure
5. Değişiklikleri dağıtın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal deploy
6. BaaS portalını yeniden başlatın:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal restart

Yeni bir kuruluşun oryantasyonu

Oryantasyon, 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ş yapabilir ve 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 kopyalanabilecek ek yöneticiler ekleyebilirsiniz.

İlk katılımı 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şkenleri olmadan çağırmak, tüm bilgileri istemesine neden olur:

> python create_org_and_user.py

Alternatif olarak, seçeneklerin bir kısmını veya tamamını komut satırı bağımsız değişkeni olarak iletebilirsiniz. Komut satırında atladığınız tüm bilgiler için istem alırsınız:

> 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:

1. Dizini /opt/apigee/baas-usergrid/bin olarak değiştirin.
2. create_org_and_user.py Python komut dosyasını çağırın.
   Yalnızca sistem yöneticisinin çalıştırabilmesi için BaaS sistem yöneticisi kullanıcı adı ve şifresi istenir.
3. API BaaS Portal URL'si kurulumunun sonunda not ettiğiniz URL'yi kullanarak bir web tarayıcısında API BaaS Portal'a giriş yapın. Portala erişmek için API BaaS Portal URL'sini şu biçimde girin:
   http://{portalExternalIP}:9000/
   
   Not: IP, Portal makinesinin harici IP adresi/ana makine adıdır. Bu bağlantı noktasının açık olduğundan emin olun.
4. Portal giriş ekranı göründüğünde şunları yapabilirsiniz:
   • Kuruluş yöneticisinin kullanıcı adı ve şifresini kullanarak giriş yapın.
   • Sistem yöneticisinin kullanıcı adı ve şifresini kullanarak giriş yapın.

API BaaS REST API'ye erişme

API BaaS REST API'ye erişmek için şu biçimdeki 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. Bu, tek bir API BaaS yığınınız olduğu anlamına gelir. Tek bir API BaaS Stack düğümü olan ve yük dengeleyici içermeyen küçük bir ortamınız da olabilir. Bu tür ortamlarda, doğrudan API BaaS Stack düğümüne API çağrıları yapabilirsiniz:

curl -v "http://portalExternalIP:8080/status"

API BaaS Portal'ı kullanmaya başlama hakkında daha fazla bilgi için şu adresteki Apigee belgelerine bakın: http://apigee.com/docs/content/build-apps-home.