API BaaS Yükleme

Edge for Private Cloud s. 4.17.05

Yüklemeye genel bakış

Edge'i bir düğüme Apigee-setup yardımcı programını yükledikten sonra, yardımcı programını kullanarak düğüme bir veya daha fazla BaaS bileşeni yükleyebilirsiniz.

Apigee-setup yardımcı programı şu formu kullanın:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Apigee-setup yardımcı programına bilgilere göz atın. Yapılandırma dosyasında Apigee-setup yardımcı program, kodu komut satırına girmenizi ister.

Tek şart, yapılandırma dosyasının "Apigee" belirtir.

Örneğin, API BaaS Yığınını yüklemek için aşağıdaki komutu kullanın:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p b -f myConfig

Yüklenecek bileşenleri belirtme

Apigee setup.sh yardımcı programı , API BaaS bileşenlerini yüklemek için çeşitli seçenekleri destekler. Aşağıdaki talimatlarda seçenekleri de kullanabilirsiniz (c, e, b ve p) ancak düğümünüze bağlı olarak farklı seçenekler yapılandırma:

Seçenek

Açıklama

e

Yalnızca ElasticSearch'ü yükleyin.

b

Yalnızca, Tomcat'i de yükleyen API BaaS Stack'i yükleyin.

p

Yalnızca API BaaS Portalı'nı yükleyin. Bu uygulama, web olarak kullanılacak Nginx yönlendiricisini de yükler. sunucu.

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 ancak Cassandra'yı yüklemeyin. Portal son derece hafiftir, bunun için ek kaynak gerekmez.

Asa

Tüm API BaaS bileşenlerini tek bir düğüme (Cassandra, Elasticsearch, API BaaS) yükleyin Yığın, API BaaS Portalı, Tomcat). Bu seçeneği yalnızca geliştirme ve test için kullanın, kullanmayın. gerekir.

Yapılandırma dosyası oluşturma

Yapılandırma dosyası, API BaaS'yi yüklemek için gereken tüm bilgileri içerir. Şunları yapabilirsiniz: çoğu zaman bir BaaS kurulumundaki tüm bileşenleri yüklemek için aynı yapılandırma dosyasını kullanırlar.

Aşağıda açıklanan her yükleme topolojisi, söz konusu topoloji için örnek bir yapılandırma dosyası gösterir. Örneğin, tam referans için BaaS Configuration File Reference (BaaS Yapılandırması Dosyası Referansı) bölümüne bakın.

Tek bir düğüme API BaaS yükleme

Aşağıda, tek bir düğüme API BaaS yüklemek için kullanılabilecek yapılandırma dosyası gösterilmektedir. Bu dosyayı şu şekilde düzenle: bu gereklidir. Yapılandırma dosyasının tam referansı için bkz. BaaS Yapılandırma Dosyası Referansı. 

IP1=192.168.56.101   # IP address of single node

# 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=stackAdminPWord

# Because you are installing Cassandra,
# specify Cassandra data center and rack suffix.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1"

# Specify the Cassandra region.
REGION=dc-1

# 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 Cassandra data center name.
BAAS_CASS_LOCALDC=dc-1

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=dc-1

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For dc-1 with one Cassandra node, it is dc-1:1.
BAAS_CASS_REPLICATION=dc-1:1

# Defines the initial contact points for members of the BaaS cluster. 
# For a single node install, specify the IP address of the node. 
BAAS_CLUSTER_SEEDS="dc-1:$IP1"

# Single ElasticSearch IP.
ES_HOSTS="$IP1"

# API BaaS Stack information.
# Default cluster name is "apigee_baas"
BAAS_USERGRID_CLUSTERNAME="apigee_baas" 

# IP/DNS and port 8080 of a single Stack node.
BAAS_USERGRID_URL="http://$IP1:8080"

# URL and port of the BaaS Portal node.  
BAAS_PORTAL_URL="http://$IP1: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

API BaaS'yi kendi düğümüne yüklemek için:

  1. internette olup olmadığını kontrol edin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme daha fazla.
  2. Komut isteminde kurulum komut dosyasını çalıştırın:
    > /opt/Apigee/Apigee-setup/bin/setup.sh -p asa -f configFile

    . "-p asa" seçeneği, tüm API BaaS bileşenlerinin tek bir düğüme yükleneceğini belirtir. (Cassandra, Elasticsearch, API BaaS Stack, API BaaS Portalı, Tomcat).
    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
  3. ElasticSearch'ü bağımsız bir düğüme yüklediğiniz için varsayılan belleği ayarlayın. seçeneği ile ElasticSearch için ayrılan belleği 4 GB'tan 6 GB'a yükseltebilirsiniz:
    1. /opt/apigee/customer/application/elasticsearch.properties dosyasını açın. düzenleyicidir. Bu dosya mevcut değilse dosyayı oluşturun.
    2. setenv_elasticsearch_max_mem_size özelliğini ayarlayın 6 g (varsayılan 4 g):
      setenv_elasticsearch_max_mem_size=6g
    3. Dosyayı kaydedin.
    4. Aşağıdaki komutu çalıştırın:
      > /opt/Apigee/Apigee-service/bin/potansiyel-service talep-elasticsearch yeniden başlatma
  4. Aşağıdaki Yeni kuruluşu oryantasyon bölümünde açıklandığı şekilde bir kuruluşa ilk katılım işlemini gerçekleştirin.

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

7 veya 10 düğüme API BaaS yükleme

API BaaS'nin 7 veya 10 düğümlü sürümünü yükleme prosedürü çok benzerdir. Tek şu kadar fark vardır:

  • üç ElasticSearch bileşeni ve üç API yüklemeniz gerekir, Ayrı düğümlerdeki BaaS Yığını bileşenleri, toplamda altı düğüme sahiptir. Bu, ElasticSearch için büyük miktarda veri gerektiğinden en yüksek performans için önerilen yapılandırma %60'lık bir etkiye sahip.
  • üç ElasticSearch bileşeni ve üç API BaaS'si yüklersiniz. Bileşenleri aynı düğümlerde toplam üç tane olacak şekilde yığın düğüm.

API BaaS'nin hem 7 hem de 10 düğümlü sürümü için bir Cassandra kümesine bağlanmanız gerekir. Eğer Edge'i zaten yüklediyseniz, Cassandra kümesine bağlanabilirsiniz. Böylece, Cassandra'yı yüklemek zorunda olduğundan emin olun.

Aşağıda, 10 düğümlü API BaaS kurulumu için örnek bir sessiz yapılandırma dosyası gösterilmektedir. Eğer ElasticSearch ve API BaaS Stack bileşenlerini aynı üç düğüme yüklüyorsunuz. dosyayı şu şekilde düzenleyin:

  • IP1 ve IP4 aynı IP adresine ayarlanmış
  • IP2 ve IP5 aynı IP adresine ayarlanmış
  • IP3 ve IP6 aynı IP adresine ayarlanmış

Bu dosyayı yapılandırmanız için gereken şekilde düzenleyin. Eksiksiz bir referans için yapılandırma dosyası için BaaS'ye Yapılandırma Dosyası Referansı. 

# 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=stackAdminPWord

# Only if you are installing Cassandra.
# Specify Cassandra data center and rack suffix.
# 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"

# Specify the Cassandra region.
REGION=dc-1

# 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.

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=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

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# 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

İsteğe bağlı - Yükleme Cassandra: Makine 8, 9 ve 10

API BaaS'yi Edge'in kullandığı Cassandra kümesine bağlayabilirsiniz. Henüz yapmadıysanız Edge yüklüyse, isteğe bağlı olarak API BaaS tarafından kullanılmak üzere Cassandra'yı yükleyebilirsiniz.

Cassandra kümesi kimlik doğrulamayı kullanabilir veya Cassandra kimlik doğrulaması devre dışı bırakılabilir. Görüntüleyin Cassandra kimlik doğrulamasını etkinleştir daha fazla.

  1. internette olup olmadığını kontrol edin. Daha fazla bilgi için Edge Apigee-setup yardımcı programını yükleme daha fazla.
  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" tarafından erişilebilir veya okunabilir olmalıdır belirtir.

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şiminde şifre kullanılmasını zorunlu kılar. Cassandra'yı JMX için kimlik doğrulaması kullanacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için bkz. Nasıl İzlenir?

Cassandra cron işini ayarlama

Cassandra'yı yüklemeniz gerekiyorsa kilitlerin saatte bir çalışması için nodetool öğesini kullanan bir cron işi oluşturun her Cassandra düğümünde kullanabilirsiniz.

Birden fazla Cassandra düğümünüz varsa, her sunucuda cron işini beş dakikaya aynı anda temizlenmemesini sağlar.

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ükleyin: Makine 1, 2 ve 3

ElasticSearch'ü kendi düğümüne yüklemek için:

  1. İnternet'i veya internet olmayan bir bağlantıyı kullanarak Edge Apigee-setup yardımcı programını düğüme yükleme gerekir. Bkz. Edge'yi Yükleme Apigee-setup fayda sağlayın.
  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" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
  3. (İsteğe bağlı) ElasticSearch'ü bağımsız bir düğüme yüklerseniz (yani yüklü değilse) kullanabilir, daha sonra etkinlik için ayrılan belleği artırmak üzere varsayılan bellek seçeneğini 4 GB'tan 6 GB'a kadar ElasticSearch:
    1. /opt/apigee/customer/application/elasticsearch.properties sayfasını açın. kullanabilirsiniz. Bu dosya mevcut değilse dosyayı oluşturun.
    2. setenv_elasticsearch_max_mem_size özelliğini ayarlayın. mülkü 6g olarak ayarlayın (varsayılan 4g):
      setenv_elasticsearch_max_mem_size=6g
    3. Dosyayı kaydedin.
    4. Aşağıdaki komutu çalıştırın:
      > /opt/Apigee/Apigee-service/bin/potansiyel-service talep-elasticsearch yeniden başlatma

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

API BaaS yığınını yükleyin: Makine 4, 5 ve 6

API BaaS Yığınını kendi düğümüne yüklemek için:

  1. İnternet'i veya internet olmayan bir bağlantıyı kullanarak Edge Apigee-setup yardımcı programını düğüme yükleme gerekir. Bkz. Edge'yi Yükleme Apigee-setup fayda sağlayın.
  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 Yığını'nın yükleneceğini belirtir.
    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.

Yükleyici doğru yönetici kimlik bilgilerini aldıktan sonra Tomcat'i yükler, BaaS tuş boşluklarını kullanır ve sunucuda API BaaS Yığınını ayarlar. SMTP, ayrıca Merchant Center'a izin verecek şekilde şifre onayı e-postaları göndermek için kullanılan kullanıcı arayüzünü kullanın.

API BaaS Portalı'nı Yükleme: Makine 7

API BaaS Portalı'nı yüklemek için:

  1. İnternet'i veya internet olmayan bir bağlantıyı kullanarak Edge Apigee-setup yardımcı programını düğüme yükleme gerekir. Bkz. Edge'yi Yükleme Apigee-setup fayda sağlayın.
  2. Komut isteminde kurulum komut dosyasını çalıştırın:
    > /opt/Apigee/Apigee-setup/bin/setup.sh -p p -f configFile

    . "-p p" seçeneği, API BaaS Portalı'nın yükleneceğini belirtir.
    . Yapılandırma dosyası "Apigee" tarafından erişilebilir veya okunabilir olmalıdır belirtir.
    .
    . Yükleyici Nginx web sunucusunu başlatır ve API BaaS Portalı'nı bitirir yapılandırma.
  3. Bir sonraki adımınız, yükleme işleminize bağlıdır.
    1. Portalor Stack düğümlerinin önünde bir yük dengeleyiciniz varsa sonraki bölüm yük dengeleyiciler için API BaaS'nin nasıl yapılandırılacağını açıklar.
    2. Portalor Stack düğümlerinin önünde bir yük dengeleyiciniz yoksa aşağıdaki İlk Katılım oluşturmanız gerekir.

API BaaS Portalı URL'sini not edin. Bu, web'e erişmek için tarayıcıya gireceğiniz URL'dir. API BaaS Portalı kullanıcı arayüzü.

Yapılandır Yığın veya Portal yük dengeleyici için API BaaS düğümleri

Yığın veya Portal düğümlerinin önüne bir yük dengeleyici dahil ederseniz yük dengeleyicinin doğru URL'sine sahip olan düğümleri gösterir. Örneğin, Stack düğümleri için bu, şu durumlarda bilgi verilmelidir:

  • BaaS API isteklerindeki yanıtlara URL ekleme.
  • Bir şifreyi sıfırlarken e-posta şablonlarına bağlantı ekleme veya bildirimleri etkinleştirebilirsiniz.
  • Kullanıcıları belirli Portal sayfalarına yönlendirme.

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

usergrid-deployment_usergrid.api.url.base=http://localhost:8080

http://localhost:8080 kısmını yüklemenin URL'si ile değiştirin kullanabilirsiniz. Yük dengeleyici TLS'yi kullanacak şekilde yapılandırılmışsa HTTPS protokolünü kullanın. Yalnızca siz standart olmayan bir bağlantı noktası kullanıyorsanız bağlantı noktasını dahil etmeniz gerekir. HTTP için 80 ve HTTPS için bağlantı noktası 443.

Ayrıca, Yığın düğümlerinin önünde bir yük dengeleyici kullanırsınız:

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

http://localhost:8080 kısmını yük dengeleyiciye dahil edilir.

Portal düğümünün önünde bir yük dengeleyici kullanıyorsanız aşağıdaki özellikleri ayarlayın usergrid.properties dosyasında: 

usergrid-deployment_portal.url=http://localhost:9000

http://localhost:9000 ifadesinin yerine yük dengeleyiciye dahil edilir. Yük dengeleyici TLS'yi kullanacak şekilde yapılandırılmışsa HTTPS protokolünü kullanın. Siz Yalnızca standart olmayan bir bağlantı noktası kullanıyorsanız bağlantı noktası eklemeniz gerekir. Diğer bir deyişle bağlantı noktası 80, HTTPS için bağlantı noktası 443 olmalıdır.

usergrid.properties ve portal.properties'i düzenledikten sonra:

  1. Yığın düğümünü yapılandırın:
    > /opt/Apigee/Apigee-service/bin/ekip-service baas-usergrid yapılandırması
  2. BaaS Yığınını yeniden başlatın:
    > /opt/Apigee/Apigee-service/bin/ekip-service baas-usergrid restart

    Not: BaaS Yığını düğümlerini yeniden başlatırken aynı sırayla yeniden başlatın. BAAS_CLUSTER_SEEDS altında listelenir. BAAS_CLUSTER_SEEDS şunlardan en fazla iki tanesini listeler: Stack düğümlerini tıklayın. Bu iki düğümü sırayla yeniden başlattıktan sonra, kalan herhangi bir sırada görebilirsiniz.

  3. portal.properties dosyasını değiştirdiyseniz Portal düğümü:
    > /opt/Apigee/Apigee-service/bin/gelir-hizmeti baas-portal yapılandırması
  4. BaaS Portalı'nı yeniden başlatın:
    > /opt/Apigee/Apigee-service/bin/ekip-service baas-portal restart

Yeni bir kuruluşu kullanmaya başlama

Oryantasyon, kuruluş ve kuruluş yöneticisi oluşturma sürecidir. Şu tarihten sonra: Kuruluş ve kuruluş yöneticisini oluşturduktan sonra, API BaaS Portalı'na giriş yaparak kullanıcı arayüzü oluşturabilir ve API BaaS REST API'ye istek gönderebilir.

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 iki kuruluş oluşturamazsınız kuruluş yöneticisi için aynı e-posta adresine sahip olmalıdır. Ancak, başka yöneticilere, birden fazla yöneticiye kopyalanabilecek kuruluşlar.

İlk katılımı gerçekleştirmek için create_org_and_user.py Python komut dosyasını kullanın. Bu komut dosyasının, komut satırı bağımsız değişkeni olmadan çağrılması durumunda bilgi:

> 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. Sizden komut satırından çıkardığınız tüm bilgiler:

> 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 bir sistemin doğru giriş yapması için sizden BaaS sistem yöneticisi çalıştırabilir.
  3. API BaaS Portalı URL'sinin yüklenmesi. Portala erişmek için API BaaS Portal URL'sini şu formu kullanın:
    http://{portalExternalIP}:9000/

    . Not: IP, Portal makinesinin harici IP adresi/ana makine adıdır. Emin olun o bağlantı noktası açık olmalıdır.
  4. 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öneticileri yöneticisinin 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 biçimde bir URL kullanın:

https://{loadBalancerIP}:8080/{your-org}/{your-app}

Bir geliştirme ortamında, tüm API BaaS bileşenlerini tek bir düğüme yükleyebilirsiniz. yani tek bir API BaaS Yığınınız olur. Veya tek bir iş ortağı olan küçük bir API BaaS Yığını düğümü ve yük dengeleyici yok. Bu tür ortamlarda, API çağrıları yapabilirsiniz doğrudan API BaaS Yığını düğümüne gönderme:

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

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