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

Edge for Private Cloud v. 4.17.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 Portal เท่านั้น ซึ่งจะติดตั้งเราเตอร์ Nginx เพื่อใช้เป็นเว็บเซิร์ฟเวอร์ด้วย

c

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

eb

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

ebp

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

อาซา

ติดตั้งคอมโพเนนต์ 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

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

  1. ติดตั้งยูทิลิตี Apigee-setup ของ Edge ในโหนดโดยใช้กระบวนการอินเทอร์เน็ตหรือขั้นตอนที่ไม่ใช่อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี 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)
    ผู้ใช้ "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 โปรดรีสตาร์ท
  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

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

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

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

  1. ติดตั้งยูทิลิตี apigee-setup ขอบบนโหนดโดยใช้ กระบวนการอินเทอร์เน็ตหรือขั้นตอนที่ไม่ใช่อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี 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 ให้ปรับตัวเลือกหน่วยความจำเริ่มต้นเพื่อเพิ่มหน่วยความจำที่กําหนดให้กับ 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, สร้างคีย์ Space ของ API BaaS และตั้งค่า API BaaS Stack บนเซิร์ฟเวอร์ นอกจากนี้ ระบบยังกำหนดค่า SMTP เพื่ออนุญาตให้ UI ส่งอีเมลยืนยันรหัสผ่านด้วย

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

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

  1. ติดตั้งยูทิลิตี apigee-setup ของ 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. หากคุณไม่มีตัวจัดสรรภาระงานที่หน้าโหนดพอร์ทัลor 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 ให้รีสตาร์ทโหนดในลำดับเดียวกันกับที่แสดงอยู่ใน 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-portalRestart

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

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

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

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