การติดตั้ง BaaS ของ API

Edge for Private Cloud เวอร์ชัน 4.17.05

ภาพรวมการติดตั้ง

หลังจากติดตั้ง Edge ยูทิลิตี apigee-setup ในโหนดแล้ว ให้ใช้ยูทิลิตีนั้นเพื่อติดตั้งคอมโพเนนต์ BaaS อย่างน้อย 1 รายการในโหนด

ยูทิลิตี apigee-setup มีรูปแบบดังนี้

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

ส่งไฟล์การกำหนดค่าไปยังยูทิลิตี apigee-setup ที่มีข้อมูลเกี่ยวกับการติดตั้ง หากไฟล์การกำหนดค่าไม่มีข้อมูลที่จำเป็น ยูทิลิตี apigee-setup จะแจ้งให้คุณป้อนข้อมูลในบรรทัดคำสั่ง

ข้อกำหนดเพียงอย่างเดียวคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee"

เช่น ใช้คำสั่งต่อไปนี้เพื่อติดตั้ง API BaaS Stack

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

การระบุคอมโพเนนต์ที่จะติดตั้ง

ยูทิลิตี setup.sh ของ Apigee รองรับตัวเลือกหลายรายการสำหรับการติดตั้งคอมโพเนนต์ API BaaS วิธีการด้านล่างใช้ตัวเลือกแบบสแตนด์อโลน (c, e, b และ p) แต่คุณสามารถใช้ตัวเลือกอื่นตามการกำหนดค่าโหนดได้ ดังนี้

ตัวเลือก

คำอธิบาย

e

ติดตั้ง ElasticSearch เท่านั้น

b

ติดตั้ง API BaaS Stack เท่านั้น ซึ่งจะติดตั้ง Tomcat ด้วย

p

ติดตั้งเฉพาะพอร์ทัล API BaaS ซึ่งจะติดตั้งเราเตอร์ Nginx เพื่อใช้เป็นเว็บเซิร์ฟเวอร์ด้วย

c

ติดตั้ง Cassandra เท่านั้น

eb

ติดตั้ง ElasticSearch, API BaaS Stack และ Tomcat บนโหนด

ebp

ติดตั้ง ElasticSearch, API BaaS Portal, API BaaS Stack และ Tomcat แต่ไม่ติดตั้ง Cassandra พอร์ทัลนี้มีขนาดเล็กมาก จึงไม่จำเป็นต้องใช้ทรัพยากรเพิ่มเติม

asa

ติดตั้งคอมโพเนนต์ API BaaS ทั้งหมดในโหนดเดียว (Cassandra, Elasticsearch, API BaaS Stack, API BaaS Portal, Tomcat) ใช้ตัวเลือกนี้เพื่อการพัฒนาและการทดสอบเท่านั้น ไม่ใช่สำหรับการใช้งานจริง

การสร้างไฟล์การกำหนดค่า

ไฟล์การกำหนดค่ามีข้อมูลทั้งหมดที่จำเป็นสำหรับการติดตั้ง API BaaS คุณมักจะใช้ไฟล์การกำหนดค่าเดียวกันเพื่อติดตั้งคอมโพเนนต์ทั้งหมดในการติดตั้ง BaaS ได้

โทโพโลยีการติดตั้งแต่ละรายการที่อธิบายไว้ด้านล่างจะแสดงตัวอย่างไฟล์การกำหนดค่าสำหรับโทโพโลยีนั้น ดูข้อมูลอ้างอิงทั้งหมดเกี่ยวกับไฟล์การกำหนดค่าได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า BaaS

ติดตั้ง API BaaS ในโหนดเดียว

ด้านล่างนี้คือไฟล์การกำหนดค่าสำหรับการติดตั้ง API BaaS ในโหนดเดียว แก้ไขไฟล์นี้ตามที่จำเป็นสำหรับการกำหนดค่า ดูข้อมูลอ้างอิงทั้งหมดเกี่ยวกับไฟล์การกำหนดค่าได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า BaaS 

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 ในโหนดของตัวเอง

  1. ติดตั้งยูทิลิตี Edge apigee-setup ในโหนดโดยใช้ขั้นตอนทางอินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
    > /opt/apigee/apigee-setup/bin/setup.sh -p asa -f configFile

    ตัวเลือก "-p asa" จะระบุให้ติดตั้งคอมโพเนนต์ API BaaS ทั้งหมดในโหนดเดียว (Cassandra, Elasticsearch, API BaaS Stack, API BaaS Portal, Tomcat)
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้
  3. เนื่องจากคุณติดตั้ง ElasticSearch บนโหนดแบบสแตนด์อโลน ให้ปรับตัวเลือกหน่วยความจำเริ่มต้นเพื่อเพิ่มการจัดสรรหน่วยความจำสำหรับ ElasticSearch จาก 4 GB เป็น 6 GB โดยทำดังนี้
    1. เปิด /opt/apigee/customer/application/elasticsearch.properties ในเครื่องมือแก้ไข หากไม่มีไฟล์นี้ ให้สร้างขึ้นมา
    2. ตั้งค่าพร็อพเพอร์ตี้ setenv_elasticsearch_max_mem_size เป็น 6g (ค่าเริ่มต้นคือ 4g) ดังนี้
      setenv_elasticsearch_max_mem_size=6g
    3. บันทึกไฟล์
    4. เรียกใช้คำสั่งต่อไปนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart
  4. เริ่มต้นใช้งานองค์กรตามที่อธิบายไว้ด้านล่างในหัวข้อการเริ่มต้นใช้งานองค์กรใหม่

การกำหนดค่าจะตั้งค่าในโหนดให้เสร็จสมบูรณ์

ติดตั้ง API BaaS ใน 7 หรือ 10 โหนด

ขั้นตอนการติดตั้ง API BaaS เวอร์ชัน 7 หรือ 10 โหนดจะคล้ายกันมาก ข้อแตกต่างเพียงอย่างเดียวคือสำหรับ

  • การติดตั้ง 10 โหนด คุณจะติดตั้งคอมโพเนนต์ ElasticSearch 3 รายการและคอมโพเนนต์ API BaaS Stack 3 รายการในโหนดแยกกัน รวมเป็น 6 โหนด ซึ่งเป็นการกำหนดค่าที่แนะนำเพื่อให้ได้ประสิทธิภาพสูงสุด เนื่องจาก ElasticSearch ต้องใช้ I/O ของดิสก์และหน่วยความจำจำนวนมาก
  • การติดตั้ง 7 โหนด คุณจะติดตั้งคอมโพเนนต์ ElasticSearch 3 รายการและคอมโพเนนต์ API BaaS Stack 3 รายการในโหนดเดียวกัน รวมเป็น 3 โหนด

สำหรับ API BaaS ทั้งเวอร์ชัน 7 และ 10 โหนด คุณต้องเชื่อมต่อกับคลัสเตอร์ Cassandra หากติดตั้ง Edge ไว้แล้ว คุณจะเชื่อมต่อกับคลัสเตอร์ Cassandra ได้ ซึ่งหมายความว่าคุณไม่จำเป็นต้องติดตั้ง Cassandra เป็นส่วนหนึ่งของการติดตั้ง API BaaS

ด้านล่างนี้คือตัวอย่างไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบสำหรับการติดตั้ง API BaaS แบบ 10 โหนด หากคุณติดตั้งคอมโพเนนต์ ElasticSearch และ API BaaS Stack ในโหนดเดียวกัน 3 โหนด ให้แก้ไขไฟล์เพื่อให้มีลักษณะดังนี้

  • IP1 และ IP4 ตั้งค่าเป็นที่อยู่ IP เดียวกัน
  • IP2 และ IP5 ตั้งค่าเป็นที่อยู่ IP เดียวกัน
  • IP3 และ IP6 ตั้งค่าเป็นที่อยู่ IP เดียวกัน

แก้ไขไฟล์นี้ตามที่จำเป็นสำหรับการกำหนดค่าของคุณ ดูข้อมูลอ้างอิงทั้งหมดเกี่ยวกับไฟล์การกำหนดค่าได้ที่ข้อมูลอ้างอิงไฟล์การกำหนดค่า BaaS 

# 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

ไม่บังคับ - ติดตั้ง Cassandra: เครื่องที่ 8, 9 และ 10

คุณสามารถเชื่อมต่อ API BaaS กับคลัสเตอร์ Cassandra เดียวกันกับที่ Edge ใช้ได้ หากยังไม่ได้ติดตั้ง Edge คุณสามารถเลือกติดตั้ง Cassandra เพื่อใช้กับ API BaaS ได้

คลัสเตอร์ Cassandra สามารถใช้การตรวจสอบสิทธิ์ หรือจะปิดใช้การตรวจสอบสิทธิ์ Cassandra ก็ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเปิดใช้การตรวจสอบสิทธิ์ Cassandra

  1. ติดตั้งยูทิลิตี Edge apigee-setup ในโหนดโดยใช้ขั้นตอนที่ต้องใช้อินเทอร์เน็ตหรือไม่ต้องใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
    > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

    ตัวเลือก "-p c" จะระบุให้ติดตั้ง Cassandra
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้

การกำหนดค่าจะตั้งค่า Datastore ในโหนดให้เสร็จสมบูรณ์

โปรดทราบว่าระบบจะเปิดใช้ JMX โดยค่าเริ่มต้นสำหรับ Cassandra การเข้าถึง Cassandra ระยะไกลของ JMX ไม่ต้องใช้รหัสผ่าน คุณสามารถกำหนดค่า Cassandra ให้ใช้การตรวจสอบสิทธิ์สำหรับ JMX ได้ ดูข้อมูลเพิ่มเติมได้ที่วิธีตรวจสอบ

ตั้งค่างาน Cassandra cron

หากต้องติดตั้ง Cassandra ให้ตั้งค่างาน Cron ที่ใช้ nodetool เพื่อล้างการล็อกให้ทำงานทุกชั่วโมงในโหนด Cassandra ทุกโหนด

หากคุณมีโหนด Cassandra หลายโหนด ให้เลื่อนงาน Cron ในแต่ละเซิร์ฟเวอร์ออกไป 5 นาที เพื่อไม่ให้โหนดทั้งหมดล้างข้อมูลพร้อมกัน

งาน Cron ต้องเรียกใช้คำสั่งต่อไปนี้

/opt/apigee/apigee-cassandra/bin/nodetool -h IP_address flush Apigee_Baas_Locks

โดยที่ IP_address คือที่อยู่ IP ของโหนด Cassandra

ติดตั้ง ElasticSearch: เครื่อง 1, 2 และ 3

วิธีติดตั้ง ElasticSearch ในโหนดของตัวเอง

  1. ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
    > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile

    ตัวเลือก "-p e" จะระบุให้ติดตั้ง ElasticSearch
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้
  3. (ไม่บังคับ) หากคุณติดตั้ง ElasticSearch บนโหนดแบบสแตนด์อโลน ซึ่งหมายความว่าไม่ได้ติดตั้งด้วย API BaaS Stack ให้ปรับตัวเลือกหน่วยความจำเริ่มต้นเพื่อเพิ่มการจัดสรรหน่วยความจำสำหรับ ElasticSearch จาก 4 GB เป็น 6 GB ดังนี้
    1. เปิด /opt/apigee/customer/application/elasticsearch.properties ในเครื่องมือแก้ไข หากไม่มีไฟล์นี้ ให้สร้างขึ้นมา
    2. ตั้งค่าพร็อพเพอร์ตี้ setenv_elasticsearch_max_mem_size เป็น 6g (ค่าเริ่มต้นคือ 4g)
      setenv_elasticsearch_max_mem_size=6g
    3. บันทึกไฟล์
    4. เรียกใช้คำสั่งต่อไปนี้
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart

การกำหนดค่าจะตั้งค่าในโหนดให้เสร็จสมบูรณ์

ติดตั้ง API BaaS Stack: เครื่อง 4, 5 และ 6

วิธีติดตั้ง API BaaS Stack ในโหนดของตัวเอง

  1. ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
    > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile

    ตัวเลือก "-p b" ระบุให้ติดตั้ง API BaaS Stack
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้

หลังจากโปรแกรมติดตั้งดึงข้อมูลเข้าสู่ระบบของผู้ดูแลระบบที่ถูกต้องแล้ว โปรแกรมจะติดตั้ง Tomcat, สร้างคีย์สเปซ API BaaS และตั้งค่าสแต็ก API BaaS บนเซิร์ฟเวอร์ นอกจากนี้ SMTP ยังได้รับการกำหนดค่าให้อนุญาต UI ส่งอีเมลยืนยันรหัสผ่านด้วย

ติดตั้ง API BaaS Portal: เครื่อง 7

วิธีติดตั้งพอร์ทัล API BaaS

  1. ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
    > /opt/apigee/apigee-setup/bin/setup.sh -p p -f configFile

    ตัวเลือก "-p p" ระบุให้ติดตั้งพอร์ทัล API BaaS
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้

    โปรแกรมติดตั้งจะเริ่มเว็บเซิร์ฟเวอร์ Nginx แล้วจึงกำหนดค่าพอร์ทัล API BaaS ให้เสร็จสิ้น
  3. ขั้นตอนถัดไปจะขึ้นอยู่กับการติดตั้งของคุณ
    1. หากคุณมีตัวจัดสรรภาระงานอยู่หน้าโหนด Portal หรือ Stack ส่วนถัดไปจะอธิบายวิธีกำหนดค่า API BaaS สำหรับตัวจัดสรรภาระงาน
    2. หากไม่มีตัวจัดสรรภาระงานอยู่หน้าโหนด Portal หรือ Stack ให้เริ่มต้นใช้งานองค์กรตามที่อธิบายไว้ด้านล่างในหัวข้อการเริ่มต้นใช้งานองค์กรใหม่

จดบันทึก URL ของพอร์ทัล API BaaS นี่คือ URL ที่คุณป้อนในเบราว์เซอร์เพื่อเข้าถึงอินเทอร์เฟซผู้ใช้ของพอร์ทัล API BaaS

กำหนดค่าโหนด API BaaS สำหรับตัวจัดสรรภาระงาน Stack หรือ Portal

หากคุณรวมตัวจัดสรรภาระงานไว้หน้าโหนด Stack หรือ Portal คุณต้องกำหนดค่าโหนดด้วย URL ที่ถูกต้องของตัวจัดสรรภาระงาน ตัวอย่างเช่น โหนด Stack ต้องใช้ข้อมูลนี้ในกรณีต่อไปนี้

  • การรวม URL ไว้ในการตอบกลับในคำขอ API ของ BaaS
  • การเพิ่มลิงก์ในเทมเพลตอีเมลเมื่อรีเซ็ตรหัสผ่าน หรือส่งการแจ้งเตือนอื่นๆ
  • การเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าพอร์ทัลที่เฉพาะเจาะจง

หากคุณใช้ตัวจัดสรรภาระงานที่ด้านหน้าโหนด Stack ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /opt/apigee/customer/application/usergrid.properties 

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

แทนที่ http://localhost:8080 ด้วย URL ของตัวจัดสรรภาระงาน หากกำหนดค่าตัวจัดสรรภาระงานให้ใช้ TLS ให้ใช้โปรโตคอล HTTPS คุณต้องระบุพอร์ตเฉพาะในกรณีที่ใช้พอร์ตที่ไม่เป็นไปตามมาตรฐาน ซึ่งหมายถึงพอร์ตอื่นที่ไม่ใช่พอร์ต 80 สำหรับ HTTP และพอร์ต 443 สำหรับ HTTPS

นอกจากนี้ คุณยังต้องตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /opt/apigee/customer/application/portal.properties หากคุณใช้ตัวจัดสรรภาระงานหน้าโหนด Stack

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

แทนที่ http://localhost:8080 ด้วย URL ของตัวจัดสรรภาระงานสำหรับ Stack

หากคุณใช้ตัวจัดสรรภาระงานที่ด้านหน้าโหนดพอร์ทัล ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน usergrid.properties 

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

แทนที่ http://localhost:9000 ด้วย URL ของตัวจัดสรรภาระงาน หากกำหนดค่าตัวจัดสรรภาระงานให้ใช้ TLS ให้ใช้โปรโตคอล HTTPS คุณต้องระบุพอร์ตเฉพาะในกรณีที่ใช้พอร์ตที่ไม่ได้มาตรฐาน ซึ่งหมายถึงพอร์ตอื่นที่ไม่ใช่พอร์ต 80 สำหรับ HTTP และพอร์ต 443 สำหรับ HTTPS

หลังจากแก้ไข usergrid.properties และ portal.properties ให้ทำดังนี้

  1. กำหนดค่าโหนด Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
  2. รีสตาร์ท BaaS Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart

    หมายเหตุ: เมื่อรีสตาร์ทโหนด BaaS Stack ให้รีสตาร์ทตามลำดับเดียวกับที่แสดงใน BAAS_CLUSTER_SEEDS BAAS_CLUSTER_SEEDS แสดงโหนด Stack ได้สูงสุด 2 โหนด หลังจากรีสตาร์ทโหนดทั้ง 2 โหนดตามลำดับแล้ว คุณสามารถรีสตาร์ทโหนดที่เหลือตามลำดับใดก็ได้

  3. หากคุณแก้ไข portal.properties ให้กำหนดค่าโหนดพอร์ทัลดังนี้
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure
  4. รีสตาร์ทพอร์ทัล BaaS:
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal restart

การเริ่มต้นใช้งานองค์กรใหม่

การเริ่มต้นใช้งานคือกระบวนการสร้างองค์กรและผู้ดูแลระบบองค์กร หลังจากสร้างองค์กรและผู้ดูแลระบบองค์กรแล้ว คุณจะเข้าสู่ระบบ UI ของพอร์ทัล API BaaS และส่งคำขอไปยัง REST API ของ API BaaS ได้

เมื่อคุณสร้างองค์กร อีเมลของผู้ดูแลระบบองค์กรจะมีลักษณะดังนี้

  • ต้องแตกต่างจากอีเมลของผู้ดูแลระบบ
  • ต้องไม่ซ้ำกับองค์กรอื่นๆ ทั้งหมด กล่าวคือ คุณไม่สามารถสร้างองค์กร 2 แห่งที่มีอีเมลเดียวกันสำหรับผู้ดูแลระบบองค์กร อย่างไรก็ตาม หลังจากสร้างองค์กรแล้ว คุณสามารถเพิ่มผู้ดูแลระบบที่ซ้ำกันในหลายองค์กรได้

หากต้องการเตรียมความพร้อมผู้ใช้งานใหม่ ให้ใช้สคริปต์ Python create_org_and_user.py การเรียกใช้สคริปต์นี้โดยไม่มีอาร์กิวเมนต์บรรทัดคำสั่งจะทำให้ระบบแจ้งให้คุณป้อนข้อมูลทั้งหมด ดังนี้

> python create_org_and_user.py

หรือจะส่งตัวเลือกใดๆ หรือทั้งหมดเป็นอาร์กิวเมนต์บรรทัดคำสั่งก็ได้ ระบบจะแจ้งให้คุณป้อนข้อมูลที่ละเว้นจากบรรทัดคำสั่ง ดังนี้

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

วิธีสร้างองค์กร

  1. เปลี่ยนไดเรกทอรีเป็น /opt/apigee/baas-usergrid/bin
  2. เรียกใช้สคริปต์ Python create_org_and_user.py
    ระบบจะแจ้งให้คุณป้อนชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ BaaS เพื่อให้มีเพียงผู้ดูแลระบบเท่านั้นที่เรียกใช้ได้
  3. เข้าสู่ระบบพอร์ทัล API BaaS ในเว็บเบราว์เซอร์โดยใช้ URL ที่คุณจดไว้ที่ส่วนท้ายของการติดตั้ง URL ของพอร์ทัล API BaaS หากต้องการเข้าถึงพอร์ทัล ให้ป้อน URL ของพอร์ทัล API BaaS ในรูปแบบต่อไปนี้
    http://{portalExternalIP}:9000/

    หมายเหตุ: IP คือที่อยู่ IP ภายนอก/ชื่อโฮสต์ของเครื่องพอร์ทัล ตรวจสอบว่าพอร์ตนั้นเปิดอยู่
  4. เมื่อหน้าจอเข้าสู่ระบบพอร์ทัลปรากฏขึ้น คุณจะทำอย่างใดอย่างหนึ่งต่อไปนี้ได้
    • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบองค์กร
    • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ

การเข้าถึง REST API ของ API BaaS

หากต้องการเข้าถึง API BaaS REST API ให้ใช้ URL ในรูปแบบต่อไปนี้

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

ในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ คุณสามารถติดตั้งคอมโพเนนต์ API BaaS ทั้งหมดในโหนดเดียว ซึ่งหมายความว่าคุณมี API BaaS Stack เดียว หรือคุณอาจมีสภาพแวดล้อมขนาดเล็กที่มีโหนด API BaaS Stack โหนดเดียวและไม่มีตัวจัดสรรภาระงาน ในสภาพแวดล้อมประเภทนี้ คุณสามารถเรียก API ไปยังโหนด API BaaS Stack ได้โดยตรง ดังนี้

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเริ่มต้นใช้งานพอร์ทัล API BaaS ได้ในเอกสารประกอบของ Apigee ที่ http://apigee.com/docs/content/build-apps-home