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

Edge for Private Cloud v4.18.01

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

หลังจากติดตั้งยูทิลิตี apigee-setup ในโหนดของ Edge แล้ว ให้ใช้ยูทิลิตีดังกล่าวเพื่อติดตั้งคอมโพเนนต์ 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 สแต็ก, API BaaS พอร์ทัล, 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
SMTPMAILFROM="My Company <myco@company.com>"

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

  1. ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนผ่านอินเทอร์เน็ตหรือไม่ผ่านอินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. ที่พรอมต์คำสั่ง ให้เรียกใช้สคริปต์การตั้งค่า ดังนี้
    > /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 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
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

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

การกำหนดค่าตั้งค่าพื้นที่เก็บข้อมูลบนโหนดเสร็จเรียบร้อยแล้ว

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

ตั้งค่างาน Cron ของ Cassandra

หากต้องการติดตั้ง 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 จาก 4GB เป็น 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 โปรดรีสตาร์ท

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

ติดตั้งสแต็ก BaaS ของ API เครื่องที่ 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 ส่งอีเมลยืนยันรหัสผ่านได้อีกด้วย

ติดตั้งพอร์ทัล BaaS ของ API: เครื่อง 7

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

  1. ติดตั้งยูทิลิตีการตั้งค่า Apigee ของ Edge ในโหนดโดยใช้ขั้นตอนทางอินเทอร์เน็ตหรือไม่ใช่อินเทอร์เน็ต โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งยูทิลิตีการตั้งค่า Edge Apigee
  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 ของพอร์ทัล BaaS ของ API นี่คือ URL ที่คุณป้อนลงในเบราว์เซอร์เพื่อเข้าถึงอินเทอร์เฟซผู้ใช้ของพอร์ทัล BaaS ของ API

กำหนดค่าโหนด API BaaS สำหรับตัวจัดสรรภาระงานของพอร์ทัลหรือสแต็ก

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

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

หากคุณใช้โหลดบาลานเซอร์ไว้ด้านหน้าโหนดสแต็ก ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /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 ด้วยหากคุณใช้ตัวจัดสรรภาระงานที่ด้านหน้าโหนดสแต็ก

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

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

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

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

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

หลังจากแก้ไข usergrid.properties และ portal.properties

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

    หมายเหตุ: เมื่อรีสตาร์ทโหนด BaaS Stack ให้รีสตาร์ทตามลําดับเดียวกับที่แสดงใน BAAS_CLUSTER_SEEDS BAAS_CLUSTER_SEEDS แสดงรายการโหนดสแต็กได้สูงสุด 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 และส่งคำขอไปยัง API BaaS REST API ได้

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

  • ต้องแตกต่างจากอีเมลของผู้ดูแลระบบ
  • ต้องไม่ซ้ำกับองค์กรอื่นๆ ทั้งหมด กล่าวคือ คุณไม่สามารถสร้างองค์กร 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. เมื่อหน้าจอการเข้าสู่ระบบของพอร์ทัลปรากฏขึ้น คุณจะทำอย่างใดอย่างหนึ่งต่อไปนี้ได้
    • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบขององค์กร
    • เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ

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

หากต้องการเข้าถึง 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 Portal ได้ที่เอกสารประกอบของ Apigee ที่ http://apigee.com/docs/content/build-apps-home