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

Edge สำหรับ Private Cloud เวอร์ชัน 4.16.09

การใช้ตัวจัดสรรภาระงาน

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

คุณสามารถใช้ DNS แบบ Round-robin แทนตัวจัดสรรภาระงานได้ ในสถานการณ์นี้ คุณจะสร้างรายการ DNS ที่มีระเบียน A หลายรายการที่ตรงกับที่อยู่ IP ของสแต็ก BaaS ในระหว่างการค้นหา DNS เซิร์ฟเวอร์ DNS จะส่งกลับค่าระเบียน A โดยอัตโนมัติแบบ Round Robin

กำลังเชื่อมต่อกับ Cassandra

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

สำหรับอัตราการส่งข้อมูลสูงและความพร้อมใช้งาน หรือการแยกคลัสเตอร์ Cassandra ออกเป็นโซนเครือข่ายต่างๆ Apigee ขอแนะนำให้คุณใช้คลัสเตอร์ Cassandra แยกต่างหาก คลัสเตอร์ที่แยกต่างหากจะเพิ่มประสิทธิภาพสูงสุดหากพบการโหลดที่สูงใน BaaS

การซิงค์วันที่

คุณต้องกำหนดวันที่/เวลาในเซิร์ฟเวอร์ทั้งหมดที่ซิงค์กัน หากยังไม่ได้กำหนดค่า ยูทิลิตี "ntpdate" จะช่วยให้บรรลุวัตถุประสงค์นี้ได้ ซึ่งจะตรวจสอบว่าเซิร์ฟเวอร์มีการซิงค์เวลาหรือไม่ คุณสามารถใช้ "yum install ntp" เพื่อติดตั้งยูทิลิตีได้

ความปลอดภัยของ Tomcat

โปรแกรมติดตั้ง API BaaS จะติดตั้งเซิร์ฟเวอร์ Apache Tomcat บนโหนด API BaaS Stack ทั้งหมด รวมถึง UI ของผู้ดูแลระบบ Tomcat โปรแกรมติดตั้งจะไม่เปลี่ยนแปลงข้อมูลเข้าสู่ระบบเริ่มต้นของผู้ดูแลระบบจาก admin:admin

หากจำเป็น คุณสามารถเปลี่ยนข้อมูลเข้าสู่ระบบเหล่านี้ในฐานะส่วนหนึ่งของการรักษาความปลอดภัยให้ Tomcat โปรดดูข้อมูลเพิ่มเติมที่หัวข้อต่อไปนี้

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

หลังจากติดตั้งยูทิลิตี 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 บนโหนด

Epp

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

อาซา

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

การสร้างไฟล์การกำหนดค่าแบบไม่มีเสียง

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

# 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

ตารางต่อไปนี้มีข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้เหล่านี้

พร็อพเพอร์ตี้

หมายเหตุ

CASS_HOSTS

หากคุณจะติดตั้ง Cassandra ให้ระบุ IP ของโหนด Cassandra (ไม่ใช่ชื่อ DNS) และใส่ตัวแก้ไข “:dc,ra” ที่ระบุศูนย์ข้อมูลและชั้นของโหนด Cassandra

เช่น "192.168.124.201:1,1 = ศูนย์ข้อมูล 1 และชั้น/พื้นที่ความพร้อมใช้งาน 1 และ "192.168.124.204:2,1 = ศูนย์ข้อมูล 2 และโซนชั้น/ความพร้อมใช้งาน 1

CASS_USERNAME
CASS_PASSWORD

ชื่อผู้ใช้และรหัสผ่าน Cassandra

หากปิดใช้การตรวจสอบสิทธิ์ Cassandra คุณยังต้องส่งค่าเหล่านี้ แต่ระบบจะไม่สนใจค่าดังกล่าว

BAAS_CASS_LOCALDC

ชื่อภูมิภาคต้องอยู่ในรูปแบบ dc-# โดยที่ # สอดคล้องกับค่าจำนวนเต็ม

เช่น dc-1, dc-2 เป็นต้น หากคุณจะเชื่อมต่อกับคลัสเตอร์ Cassandra ที่ติดตั้งด้วย Edge คุณจะสอบถามค่านี้ได้จากผู้ดูแลระบบ Edge ในการติดตั้งศูนย์ข้อมูลเดียวของ Edge ค่าเริ่มต้นคือ dc-1

หากคุณติดตั้ง Cassandra เป็นส่วนหนึ่งของการติดตั้ง API BaaS แล้วคุณได้เพิ่มตัวแก้ไข “:dc,ra” ลงในที่อยู่ IP ของ Cassandra ในระหว่างการติดตั้ง Cassandra ค่าแรก "dc" คือหมายเลขศูนย์ข้อมูล ชื่อศูนย์ข้อมูลคือสตริง "dc-" โดยมีหมายเลขศูนย์ข้อมูลเป็นคำต่อท้าย

BAAS_CASS_REPLICATION

รูปแบบคือ "dataCenterName:#CassandraNodes" ตัวอย่างเช่น สำหรับ dc-1 ที่มีโหนด Cassandra 3 โหนดจะเป็น dc-1:3

BAAS_USERGRID_URL

ในสภาพแวดล้อมการใช้งานจริง นี่คือ URL และพอร์ตของตัวจัดสรรภาระงานที่อยู่หน้าโหนด API BaaS Stack ในรูปแบบต่อไปนี้

http://myStackLoadBalancer:8443

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

http://stackIPorDNS:8080

หมายเลขพอร์ตสำหรับเซิร์ฟเวอร์ API BaaS Stack คือ 8080

BAAS_PORTAL_URL

URL และหมายเลขพอร์ตของตัวจัดสรรภาระงาน (หากมี) อยู่หน้าพอร์ทัลในรูปแบบ

http://myPortalLoadBalancer:8443

หากไม่มีตัวจัดสรรภาระงาน URL และหมายเลขพอร์ตของโหนดพอร์ทัลจะอยู่ใน รูปแบบ

http://portalIPorDNS:9000

โดยค่าเริ่มต้น หมายเลขพอร์ต AP สำหรับพอร์ทัลคือ

http://portalIPorDNS:9000

โดยค่าเริ่มต้น

BAAS_PORTAL_LISTEN_PORT

หมายเลขพอร์ตสำหรับเซิร์ฟเวอร์ API BaaS คือ 9000 หากพอร์ตนี้ไม่พร้อมใช้งาน ให้ระบุพอร์ตอื่น

หากคุณตั้งค่า BAAS_PORTAL_URL เป็น URL ของโหนดพอร์ทัล หมายเลขพอร์ตต้องเป็นหมายเลขเดียวกันสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการ

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

แม้ว่าคุณจะเชื่อมต่อ API BaaS กับคลัสเตอร์ Cassandra เดียวกันกับ Edge ได้ แต่ Apigee ขอแนะนำให้คุณใช้คลัสเตอร์แยกต่างหาก

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

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

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

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

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

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

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

การกำหนดค่าทำการตั้งค่าบนโหนดสำเร็จ

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

วิธีติดตั้ง API BaaS Stack

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

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

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

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

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

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

    ตัวเลือก “-p p” จะระบุให้ติดตั้ง API BaaS Portal
    ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านได้

โปรแกรมติดตั้งเริ่มต้นเว็บเซิร์ฟเวอร์ Nginx จากนั้นกำหนดค่า API BaaS พอร์ทัลให้เสร็จสิ้น

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

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

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

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

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

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 ด้วย 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_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 ด้วย URL ของตัวจัดสรรภาระงาน หากตัวจัดสรรภาระงานมีการกำหนดค่าให้ใช้ TLS ให้ใช้โปรโตคอล HTTPS คุณต้องระบุพอร์ตเฉพาะในกรณีที่ใช้พอร์ตที่ไม่ใช่แบบมาตรฐาน ซึ่งหมายถึงพอร์ต 80 สำหรับ HTTP และพอร์ต 443 สำหรับ HTTPS

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

  1. กำหนดค่าโหนดสแต็ก
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergridconfigure
  2. ทำให้การเปลี่ยนแปลงใช้งานได้กับ Tomcat ดังนี้
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergridวางโฆษณา
  3. เริ่มสแต็ก BaaS ใหม่
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergridและวิธีรีสตาร์ท
  4. หากคุณแก้ไข portal.properties ให้กำหนดค่าโหนดพอร์ทัล
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portalยังต้องกำหนดค่า
  5. ทำให้การเปลี่ยนแปลงใช้งานได้:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal publish
  6. รีสตาร์ทพอร์ทัล BaaS:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portalและวิธีรีสตาร์ท

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

การเริ่มต้นใช้งานคือกระบวนการสร้างองค์กรและผู้ดูแลระบบองค์กร หลังจากสร้างผู้ดูแลระบบองค์กรและองค์กรแล้ว คุณจะเข้าสู่ระบบ 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 โปรดดูเอกสารของ Apigee ที่ http://apigee.com/docs/content/build-apps-home