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

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

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

หลังจากติดตั้งยูทิลิตี 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, 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 ขอบบนโหนดโดยใช้คำสั่ง ทางอินเทอร์เน็ตหรือที่ไม่ใช่อินเทอร์เน็ต โปรดดูติดตั้งยูทิลิตีการตั้งค่า Apigee ของ 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 จาก 4GB เป็น 6GB ดังนี้
    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 3 รายการ คอมโพเนนต์ BaaS Stack บนโหนดแยกกัน รวมทั้งหมด 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

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

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

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

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

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

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

โปรดทราบว่า JMX จะเปิดใช้โดยค่าเริ่มต้นสำหรับ Cassandra การเข้าถึง Cassandra ระยะไกลของ JMX เข้าถึง Cassandra ไม่ได้ ต้องใช้รหัสผ่าน คุณสามารถกำหนดค่า 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 ของ Edge ในโหนดโดยใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต โปรดดูติดตั้งการตั้งค่า Apigee ของ Edge ยูทิลิตีเพิ่มเติม
  2. เรียกใช้สคริปต์การตั้งค่าที่ Command Prompt
    > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile

    ตัวเลือก "-p e" จะระบุให้ติดตั้ง ElasticSearch
    ไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดย "apigee" ผู้ใช้
  3. (ไม่บังคับ) ถ้าคุณติดตั้ง ElasticSearch ในโหนดแบบสแตนด์อโลน หมายความว่าไม่มีการติดตั้ง ElasticSearch ด้วย API BaaS Stack แล้วปรับตัวเลือกหน่วยความจำเริ่มต้นเพื่อเพิ่มหน่วยความจำที่จัดสรรให้ ElasticSearch จาก 4GB ถึง 6GB:
    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 เริ่มต้นใหม่

การกำหนดค่าในโหนดเสร็จเรียบร้อยแล้ว

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

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

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

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

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

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

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

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

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

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

จด URL ของพอร์ทัล API BaaS ไว้ นี่คือ 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 กำหนดค่า
  2. รีสตาร์ทสแต็ก BaaS ด้วยคำสั่ง
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid โปรดรีสตาร์ท

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

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

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

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

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

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