การติดตั้ง BaaS API แบบ 7 โฮสต์และ 10 โฮสต์

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

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

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

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

กำลังเชื่อมต่อกับ 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 ทั้งหมดด้วย รวมถึง UI ผู้ดูแลระบบ Tomcat โปรแกรมติดตั้งทิ้งข้อมูลเข้าสู่ระบบเริ่มต้นของผู้ดูแลระบบ ไม่เปลี่ยนแปลงจาก admin:admin

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

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

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

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

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

ข้อกำหนดเพียงอย่างเดียวคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรือสามารถอ่านได้โดย "Apigee" ผู้ใช้ ตัวอย่างเช่น วางไฟล์ไว้ในไดเรกทอรี /tmp บนโหนด

เช่น ใช้คำสั่งต่อไปนี้เพื่อติดตั้ง 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 พอร์ทัลของเรา โดยไม่ต้องใช้ทรัพยากรใดๆ เพิ่มเติมในเรื่องนี้

อาซา

ติดตั้งคอมโพเนนต์ 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 ระหว่างที่ Cassandra คุณเพิ่มตัวแก้ไข ":dc,ra" ให้กับที่อยู่ IP ของ Cassandra ค่าแรก "dc" คือหมายเลขศูนย์ข้อมูล ชื่อศูนย์ข้อมูลคือสตริง "dc-" โดยใช้หมายเลขศูนย์ข้อมูลเป็นคำต่อท้าย

BAAS_CASS_REPLICATION

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

BAAS_USERGRID_URL

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

http://myStackLoadBalancer:8443

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

http://stackIPorDNS:8080

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

BAAS_PORTAL_URL

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

http://myPortalLoadBalancer:8443

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

http://portalIPorDNS:9000

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

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

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

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

    ตัวเลือก "-p e" จะระบุให้ติดตั้ง ElasticSearch
    ไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดย "apigee" ผู้ใช้ ตัวอย่างเช่น ป้อน ไฟล์ในไดเรกทอรี /tmp บนโหนด
  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 Stack: เครื่อง 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" ผู้ใช้ ตัวอย่างเช่น ป้อน ไฟล์ในไดเรกทอรี /tmp บนโหนด

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

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

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

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

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

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

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

กำหนดค่าโหนด 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. กำหนดค่าโหนดของสแต็ก:
    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid กำหนดค่า
  2. นำการเปลี่ยนแปลงไปใช้กับ Tomcat:
    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid ติดตั้งใช้งาน
  3. รีสตาร์ทสแต็ก BaaS ด้วยคำสั่ง
    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid เปิดใหม่
  4. หากคุณแก้ไข portal.properties ให้กำหนดค่า โหนดพอร์ทัล:
    /<inst_root>/apigee/apigee-service/bin/apigee-service กำหนดค่า baas-portal
  5. นำการเปลี่ยนแปลงไปใช้:
    &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal ทำให้ใช้งานได้
  6. รีสตาร์ทพอร์ทัล BaaS โดยทำดังนี้
    &gt; /<inst_root>/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.