Edge for Private Cloud เวอร์ชัน 4.16.09
การใช้ตัวจัดสรรภาระงาน
การติดตั้ง API BaaS เวอร์ชันที่ใช้งานจริงจะใช้ตัวจัดสรรภาระงานระหว่างโหนดพอร์ทัล API BaaS กับโหนดสแต็ก API BaaS เมื่อกำหนดค่าพอร์ทัล คุณจะต้องระบุที่อยู่ IP หรือชื่อ DNS ของตัวจัดสรรภาระงาน ไม่ใช่ของโหนด Stack
คุณสามารถใช้ 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 ดูข้อมูลเพิ่มเติมได้ที่
- https://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
- https://www.owasp.org/index.php/Securing_tomcat
ภาพรวมการติดตั้ง
หลังจากติดตั้ง Edge ยูทิลิตี 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 บนโหนด |
|
ebp |
ติดตั้ง ElasticSearch, API BaaS Portal, API BaaS Stack และ Tomcat พอร์ทัลนี้มีขนาดเล็กมาก จึงไม่จำเป็นต้องใช้ทรัพยากรเพิ่มเติม |
|
asa |
ติดตั้งคอมโพเนนต์ API ทั้งหมดในโหนดเดียว (Cassandra, Elasticsearch, API BaaS Stack และ API BaaS Portal) ใช้ตัวเลือกนี้สำหรับการพัฒนาและการทดสอบเท่านั้น ไม่ใช่สำหรับการใช้งานจริง |
การสร้างไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบ
ด้านล่างนี้คือตัวอย่างไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบสำหรับการติดตั้ง 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 |
ชื่อผู้ใช้และรหัสผ่าน 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 Stack ในรูปแบบต่อไปนี้ ในสภาพแวดล้อมการทดสอบหรือการพัฒนาซอฟต์แวร์ที่คุณมีโหนด API BaaS Stack เพียงโหนดเดียว ค่านี้อาจเป็น URL และหมายเลขพอร์ตของโหนด API BaaS Stack ในรูปแบบต่อไปนี้ http://stackIPorDNS:8080 หมายเลขพอร์ตสำหรับเซิร์ฟเวอร์ API BaaS Stack คือ 8080 |
|
BAAS_PORTAL_URL |
URL และหมายเลขพอร์ตของตัวจัดสรรภาระงาน หากมีตัวจัดสรรภาระงานอยู่หน้าพอร์ทัล ในรูปแบบ: |
|
BAAS_PORTAL_LISTEN_PORT |
หมายเลขพอร์ตสำหรับเซิร์ฟเวอร์พอร์ทัล API BaaS คือ 9000 หากพอร์ตนี้ไม่พร้อมใช้งาน ให้ระบุพอร์ตอื่น หากคุณตั้งค่า BAAS_PORTAL_URL เป็น URL ของโหนดพอร์ทัล หมายเลขพอร์ตต้องเหมือนกันสำหรับทั้ง 2 พร็อพเพอร์ตี้ |
ไม่บังคับ - ติดตั้ง Cassandra: เครื่องที่ 8, 9 และ 10
แม้ว่าคุณจะเชื่อมต่อ API BaaS กับคลัสเตอร์ Cassandra เดียวกันกับที่ Edge ใช้ได้ แต่ Apigee ขอแนะนำให้ใช้คลัสเตอร์แยกกัน
คลัสเตอร์ Cassandra สามารถใช้การตรวจสอบสิทธิ์ หรือจะปิดใช้การตรวจสอบสิทธิ์ Cassandra ก็ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเปิดใช้การตรวจสอบสิทธิ์ Cassandra
- ติดตั้งยูทิลิตี Edge apigee-setup ในโหนดโดยใช้ขั้นตอนที่ต้องใช้อินเทอร์เน็ตหรือไม่ต้องใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
- ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
> /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
ตัวเลือก "-p c" จะระบุให้ติดตั้ง Cassandra
ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้
การกำหนดค่าจะตั้งค่า Datastore ในโหนดให้เสร็จสมบูรณ์
โปรดทราบว่าระบบจะเปิดใช้ JMX โดยค่าเริ่มต้นสำหรับ Cassandra การเข้าถึง 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
- ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
- ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
> /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
ตัวเลือก "-p e" จะระบุให้ติดตั้ง ElasticSearch
ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้ - (ไม่บังคับ) หากคุณติดตั้ง ElasticSearch บนโหนดแบบสแตนด์อโลน ซึ่งหมายความว่าไม่ได้ติดตั้งด้วย API BaaS Stack ให้ปรับตัวเลือกหน่วยความจำเริ่มต้นเพื่อเพิ่มการจัดสรรหน่วยความจำสำหรับ ElasticSearch จาก 4 GB เป็น 6 GB ดังนี้
- เปิด /opt/apigee/customer/application/elasticsearch.properties ในเครื่องมือแก้ไข หากไม่มีไฟล์นี้ ให้สร้างขึ้นมา
- ตั้งค่าพร็อพเพอร์ตี้ setenv_elasticsearch_max_mem_size เป็น 6g (ค่าเริ่มต้นคือ 4g)
setenv_elasticsearch_max_mem_size=6g - บันทึกไฟล์
- เรียกใช้คำสั่งต่อไปนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart
การกำหนดค่าจะตั้งค่าในโหนดให้เสร็จสมบูรณ์
ติดตั้งสแต็ก API BaaS: เครื่อง 4, 5 และ 6
วิธีติดตั้ง API BaaS Stack
- ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
- ที่ 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 ส่งอีเมลยืนยันรหัสผ่านด้วย
ติดตั้งพอร์ทัล API BaaS: เครื่อง 7
วิธีติดตั้งพอร์ทัล API BaaS
- ติดตั้งยูทิลิตี apigee-setup ของ Edge ในโหนดโดยใช้ขั้นตอนแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
- ที่ Command Prompt ให้เรียกใช้สคริปต์การตั้งค่าดังนี้
> /opt/apigee/apigee-setup/bin/setup.sh -p p -f configFile
ตัวเลือก "-p p" ระบุให้ติดตั้งพอร์ทัล API BaaS
ผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้
โปรแกรมติดตั้งจะเริ่มเว็บเซิร์ฟเวอร์ Nginx แล้วกำหนดค่าพอร์ทัล API BaaS ให้เสร็จสิ้น
จดบันทึก URL ของพอร์ทัล API BaaS นี่คือ URL ที่คุณป้อนในเบราว์เซอร์เพื่อเข้าถึงอินเทอร์เฟซผู้ใช้ของพอร์ทัล API BaaS
กำหนดค่าโหนด API BaaS สำหรับ Stack หรือตัวจัดสรรภาระงานของพอร์ทัล
หากคุณรวมตัวจัดสรรภาระงานไว้หน้าโหนด Stack หรือ Portal คุณต้องกำหนดค่าโหนดด้วย URL ที่ถูกต้องของตัวจัดสรรภาระงาน ตัวอย่างเช่น โหนด Stack ต้องใช้ข้อมูลนี้ในกรณีต่อไปนี้
- การรวม URL ไว้ในการตอบกลับในคำขอ API ของ BaaS
- การเพิ่มลิงก์ในเทมเพลตอีเมลเมื่อรีเซ็ตรหัสผ่าน หรือส่งการแจ้งเตือนอื่นๆ
- การเปลี่ยนเส้นทางผู้ใช้ไปยังหน้าพอร์ทัลที่เฉพาะเจาะจง
หากคุณใช้ตัวจัดสรรภาระงานที่ด้านหน้าโหนด Stack ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน /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 หากคุณใช้ตัวจัดสรรภาระงานหน้าโหนด Stack
baas.portal.config.overrideUrl=http://localhost:8080
แทนที่ http://localhost:8080 ด้วย URL ของตัวจัดสรรภาระงานสำหรับ Stack
หากคุณใช้ตัวจัดสรรภาระงานที่ด้านหน้าโหนดพอร์ทัล ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ใน 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 ให้ทำดังนี้
- กำหนดค่าโหนด Stack:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure - ทำให้การเปลี่ยนแปลงมีผลกับ Tomcat:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid deploy - รีสตาร์ท BaaS Stack:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart - หากคุณแก้ไข portal.properties ให้กำหนดค่าโหนดพอร์ทัลดังนี้
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal configure - ทำให้การเปลี่ยนแปลงมีผล:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal deploy - รีสตาร์ทพอร์ทัล BaaS:
> /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal restart
การเริ่มต้นใช้งานองค์กรใหม่
การเริ่มต้นใช้งานคือกระบวนการสร้างองค์กรและผู้ดูแลระบบองค์กร หลังจากสร้างองค์กรและผู้ดูแลระบบองค์กรแล้ว คุณจะเข้าสู่ระบบ UI ของพอร์ทัล API BaaS และส่งคำขอไปยัง REST API ของ API BaaS ได้
เมื่อคุณสร้างองค์กร อีเมลของผู้ดูแลระบบองค์กรจะมีลักษณะดังนี้
- ต้องแตกต่างจากอีเมลของผู้ดูแลระบบ
- ต้องไม่ซ้ำกับองค์กรอื่นๆ ทั้งหมด กล่าวคือ คุณไม่สามารถสร้างองค์กร 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>'
วิธีสร้างองค์กร
- เปลี่ยนไดเรกทอรีเป็น /opt/apigee/baas-usergrid/bin
- เรียกใช้สคริปต์ Python create_org_and_user.py
ระบบจะแจ้งให้คุณป้อนชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ BaaS เพื่อให้มีเพียงผู้ดูแลระบบเท่านั้นที่เรียกใช้ได้ - เข้าสู่ระบบพอร์ทัล API BaaS ในเว็บเบราว์เซอร์โดยใช้ URL ที่คุณจดไว้ที่ส่วนท้ายของการติดตั้ง URL ของพอร์ทัล API BaaS หากต้องการเข้าถึงพอร์ทัล ให้ป้อน URL ของพอร์ทัล API BaaS ในรูปแบบต่อไปนี้
http://{portalExternalIP}:9000/
หมายเหตุ: IP คือที่อยู่ IP ภายนอก/ชื่อโฮสต์ของเครื่องพอร์ทัล ตรวจสอบว่าพอร์ตนั้นเปิดอยู่ - เมื่อหน้าจอเข้าสู่ระบบพอร์ทัลปรากฏขึ้น คุณจะทำอย่างใดอย่างหนึ่งต่อไปนี้ได้
- เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบองค์กร
- เข้าสู่ระบบโดยใช้ชื่อผู้ใช้และรหัสผ่านของผู้ดูแลระบบ
การเข้าถึง REST API ของ API BaaS
หากต้องการเข้าถึง 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