ข้อกําหนดพอร์ทัลบริการสําหรับนักพัฒนาแอป

พอร์ทัลบริการสำหรับนักพัฒนาแอป เวอร์ชัน 4.16.09

ข้อกำหนดเกี่ยวกับฮาร์ดแวร์และซอฟต์แวร์สำหรับการติดตั้งมีดังนี้

ฮาร์ดแวร์	ข้อกำหนด
ระบบปฏิบัติการ	วิธีการติดตั้งและไฟล์ติดตั้งที่ให้มาเหล่านี้ได้รับการทดสอบในระบบปฏิบัติการที่ระบุไว้ที่ https://apigee.com/docs/api-services/reference/supported-software
RAM	1 GB
ฮาร์ดดิสก์	10 GB
อินเทอร์เฟซเครือข่าย	ต้องมีการเชื่อมต่ออินเทอร์เน็ตที่ใช้งานอยู่ โปรแกรมติดตั้งจะดาวน์โหลดทรัพยากรต่างๆ จากเว็บ ซึ่งเป็นส่วนหนึ่งของขั้นตอนการติดตั้ง หากคุณตั้งค่าสภาพแวดล้อมให้รับคำขอ HTTP และ HTTPS ขาออกของพร็อกซี จะต้องมีการกำหนดค่าพร็อกซีให้จัดการคำขอเปลี่ยนเส้นทางที่อาจเกิดขึ้นระหว่างการดาวน์โหลดได้อย่างถูกต้อง เช่น คำขอไปยัง https://drupal.org/ จะแสดงรหัสสถานะ HTTP 301 และเปลี่ยนเส้นทางไปที่ https://www.drupal.org/ คุณควรกำหนดค่าพร็อกซีให้ส่งคืนรหัสสถานะ HTTP 200 พร้อมเนื้อหาที่ขอจากการเปลี่ยนเส้นทาง สำหรับการติดตั้ง SAP หากมีการตั้งค่าสภาพแวดล้อมให้รองรับคำขอ HTTPS ขาออกของพร็อกซี พร็อกซีจะต้องรองรับ TLSv1.0 OpenSSL 0.9.8 ไม่รองรับ TLSv1.1 หรือ TLSv1.2 และรองรับเฉพาะ TLSv1.0

ข้อกำหนดของฐานข้อมูล MySQL

หากเลือกติดตั้งเซิร์ฟเวอร์ MySQL ในเครื่องเดียวกับบริการช่องทางของนักพัฒนาซอฟต์แวร์ โทโพโลยีแบบเครื่องเดียว โปรแกรมติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์จะแจ้งให้คุณป้อนชื่อฐานข้อมูลและผู้ใช้ฐานข้อมูล จากนั้นติดตั้งเซิร์ฟเวอร์ MySQL และสร้างสคีมาฐานข้อมูลให้คุณ เวอร์ชันที่ติดตั้งคือเวอร์ชันล่าสุดที่พร้อมใช้งานสำหรับระบบปฏิบัติการของคุณ

หากต้องการติดตั้งเซิร์ฟเวอร์ MySQL ในระบบที่แยกต่างหาก คุณต้องติดตั้งเซิร์ฟเวอร์ MySQL ในระบบนั้นก่อนเริ่มต้นโปรแกรมติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์ คุณต้องติดตั้ง MySQL 5.0.15 ขึ้นไป

โปรแกรมติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์กำหนดให้เซิร์ฟเวอร์ MySQL มีฐานข้อมูลที่มีสคีมาฐานข้อมูลที่ว่างเปล่า โปรแกรมติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์จะแจ้งให้คุณระบุชื่อโฮสต์ของฐานข้อมูล ชื่อฐานข้อมูล และผู้ใช้ฐานข้อมูล จากนั้นโปรแกรมติดตั้งจะเชื่อมต่อกับฐานข้อมูลเพื่อสร้างตารางฐานข้อมูลและข้อมูลเริ่มต้น

บริการช่องทางของนักพัฒนาซอฟต์แวร์จะใช้ผู้ใช้ฐานข้อมูลเพื่อเชื่อมต่อกับฐานข้อมูล และต้องมีสิทธิ์ต่อไปนี้: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES

ตัวอย่างเช่น ในการสร้างฐานข้อมูลชื่อ devportal และผู้ใช้ชื่อ devportal มีดังนี้

1. ติดตั้งเซิร์ฟเวอร์ MySQL ในระบบ
2. เข้าสู่ระบบ MySQL ในฐานะผู้ใช้รูทโดยใช้คำสั่งต่อไปนี้
   > mysql -u root -p
3. ป้อนรหัสผ่านรูทเมื่อระบบถาม
4. ที่พรอมต์ mysql> ป้อนข้อมูลต่อไปนี้เพื่อสร้างผู้ใช้ devportal:
   mysql>สร้างผู้ใช้ 'devportal'@'localhost' ที่ระบุโดย 'devportal';
   mysql> ให้สิทธิ์ทั้งหมดใน *.* ไปยัง 'devportal'@'localhost';
   mysql> สิทธิ์ล้างข้อมูล;
   mysql> ปิด
5. เมื่อมีข้อความแจ้งของระบบ ให้สร้างฐานข้อมูล devportal ดังนี้
   > mysqladmin -u devportal -p create devportal
   
   ป้อนรหัสผ่าน devportal
6. เข้าสู่ระบบ MySQL และให้สิทธิ์เข้าถึง devportal จาก IP ของพอร์ทัลเซิร์ฟเวอร์:
   mysql> GRANT ALL ON devportal* ถึง devportal@'portalIP' จะระบุโดย 'devportalPW'
   
   โดยที่ portalIP คือที่อยู่ IP ของพอร์ทัลเซิร์ฟเวอร์ และ devportalPW คือรหัสผ่านของผู้ใช้ devportal
7. แก้ไข /etc/my.cnf เพื่อตั้งค่า bind-address ให้กับที่อยู่ IP ของเซิร์ฟเวอร์ MySQL
8. รีสตาร์ท MySQL:
   > /etc/init.d/mysqld Restart
9. ตรวจสอบว่าพอร์ต 3306 เปิดอยู่ในเซิร์ฟเวอร์ MySQL ขั้นตอนนี้ขึ้นอยู่กับระบบปฏิบัติการของคุณ เช่น สําหรับ Linux ให้ใช้คําสั่ง
   > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

เมื่อคุณติดตั้งบริการช่องทางสำหรับนักพัฒนาซอฟต์แวร์ ให้ระบุไม่ให้ติดตั้งเซิร์ฟเวอร์ MySQL ภายในเครื่อง จากนั้นคุณจะได้รับแจ้งให้ป้อนที่อยู่ IP, ชื่อผู้ใช้ และชื่อฐานข้อมูลของฐานข้อมูลระยะไกล

ข้อกำหนดของ Red Hat Enterprise Linux (RHEL)

RHEL มีข้อกำหนดเพิ่มเติมเนื่องจากมีการสมัครใช้บริการเพื่อเข้าถึงการดาวน์โหลดซอฟต์แวร์จาก Red Hat เซิร์ฟเวอร์ต้องสามารถเชื่อมต่ออินเทอร์เน็ตเพื่อดาวน์โหลด RPM ผ่านทาง Yum หากใช้ RHEL เซิร์ฟเวอร์ต้องลงทะเบียนในเครือข่าย Red Hat (RHN) และลงทะเบียนไว้ในช่องทางที่ไม่บังคับของเซิร์ฟเวอร์

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

> subscription-manager register --username=my_username --password=my_password --auto-attach 

แทนที่ my_username และ my_password ด้วยข้อมูลเข้าสู่ระบบ Red Hat

หากคุณมี RHEL เวอร์ชันทดลองใช้ คุณสามารถขอรับใบอนุญาตทดลองใช้งาน 30 วัน ดูข้อมูลเพิ่มเติมได้ที่ https://access.redhat.com/solutions/32790

ข้อกำหนดของ SMTP

โดยค่าเริ่มต้น พอร์ทัลจะส่งอีเมลโดยใช้ฟังก์ชัน mail() ของ PHP PHP จะพยายามส่งอีเมลโดยใช้ sendmail ในระบบภายใน ซึ่งกำหนดค่าได้ในไฟล์ php.ini ของ PHP

ในสภาพแวดล้อมการใช้งานจริง Apigee ต้องการให้คุณกำหนดค่าเซิร์ฟเวอร์ SMTP เพื่อส่งข้อความอีเมลจากพอร์ทัลนี้ ดังนั้นคุณต้องตรวจสอบว่า Drupal เข้าถึงพอร์ตที่จำเป็นในเซิร์ฟเวอร์ SMTP ได้ สำหรับ SMTP ที่ไม่ใช่ TLS หมายเลขพอร์ตมักจะเป็น 25 สำหรับ SMTP ที่เปิดใช้ TLS มักจะเป็น 465 แต่โปรดตรวจสอบกับผู้ให้บริการ SMTP

ข้อกำหนดเพิ่มเติม

ผู้ใช้ที่ติดตั้งซอฟต์แวร์ต้องมีสิทธิ์เข้าถึงระดับรูทเพื่อดำเนินการติดตั้ง

ข้อกำหนดด้านสถาปัตยกรรมการทำให้ใช้งานได้

บริการช่องทางขายมีอินเทอร์เฟซเดียวกับเซิร์ฟเวอร์การจัดการ Apigee ผ่าน REST API เพื่อจัดเก็บและเรียกดูข้อมูลเกี่ยวกับแอปพลิเคชันของผู้ใช้ บริการช่องทางขายต้องเชื่อมต่อกับเซิร์ฟเวอร์การจัดการผ่าน HTTP หรือ HTTPS ได้ ทั้งนี้ขึ้นอยู่กับการติดตั้ง

ข้อมูลที่จำเป็นก่อนที่คุณจะเริ่มการติดตั้ง

ก่อนเริ่มการติดตั้ง คุณต้องมีข้อมูลต่อไปนี้

1. คุณกำลังกำหนดค่าแพลตฟอร์มใด ได้แก่ Red Hat หรือ CentOS หากเป็นการติดตั้ง Red Hat เครื่องจะต้องลงทะเบียนในเครือข่าย Red Hat เพื่อดาวน์โหลด RPM
2. คุณวางแผนที่จะติดตั้ง MySQL ในเครื่องหรือไม่ การติดตั้ง HA บางรายการกำหนดให้ MySQL อยู่ในเครื่องอื่นนอกเหนือจากเครื่องที่แสดงหน้าเว็บพอร์ทัล ในกรณีนี้ อย่าติดตั้ง MySQL ในเครื่อง หากต้องการการติดตั้งง่ายๆ ที่มีทุกอย่างในเครื่องเดียวกัน ให้ติดตั้ง MySQL ในเครื่อง
3. หากคุณต้องการเข้าถึงเซิร์ฟเวอร์ MySQL ระยะไกล ชื่อโฮสต์ พอร์ต ชื่อฐานข้อมูล ชื่อผู้ใช้ และรหัสผ่านของเซิร์ฟเวอร์ MySQL ระยะไกล ควรมีการกำหนดค่าเซิร์ฟเวอร์ MySQL ระยะไกลไว้แล้วก่อนเริ่มการติดตั้ง
4. ชื่อโดเมนที่สมบูรณ์ในตัวเองของเว็บเซิร์ฟเวอร์คืออะไร (ระบบจะเพิ่มข้อมูลนี้ลงใน /etc/hosts) นี่ควรเป็นที่อยู่ IP หรือชื่อโฮสต์ เช่น portalserver.example.com ค่าเริ่มต้นคือ localhost
5. คุณต้องการใช้การกำหนดค่าเริ่มต้นของ Apigee สำหรับโฮสต์เสมือนของ Apache ไหม โฮสต์เสมือน 1 รายการสร้างขึ้นด้วยชื่อโฮสต์ที่คุณระบุไว้ด้านบนในขั้นตอนที่ 7
6. มีข้อมูล 3 อย่างที่ช่วยให้พอร์ทัลสื่อสารกับเซิร์ฟเวอร์การจัดการ Apigee Edge ได้ ข้อมูลมีดังนี้
   1. URL ของปลายทาง Apigee Management API: จะเป็นชื่อโฮสต์หรือที่อยู่ IP อย่างใดอย่างหนึ่ง นี่คือปลายทาง REST ที่ระบบจะเรียกใช้ทั้งหมดเพื่อสร้างแอปและลงทะเบียนนักพัฒนาซอฟต์แวร์สำหรับคีย์ของแอป ปลายทางเริ่มต้นคือ https://api.enterprise.apigee.com/v1
      
      สำหรับการติดตั้ง Edge สำหรับ Private Cloud แล้ว URL จะอยู่ในรูปแบบ
      http://EdgeIp:8080/v1
      
      หรือ
      https://EdgeIp:SSLport/v1
      
      โดยที่ EdgeIp คือที่อยู่ IP ของเซิร์ฟเวอร์การจัดการ Edge และ พอร์ต SSL เช่น 8443
   2. ชื่อองค์กร Apigee: มีความสัมพันธ์ระหว่างพอร์ทัลกับองค์กร Apigee Edge คุณจะตั้งค่าองค์กรเริ่มต้นเมื่อตั้งค่าปลายทาง Management API ค่าเริ่มต้นคือ my-org
   3. ชื่อผู้ใช้และรหัสผ่านสำหรับปลายทาง API การจัดการ: ผู้ดูแลระบบขององค์กรจะเรียกเรียกใช้จากพอร์ทัลไปยัง Edge
      
      ชื่อผู้ใช้/รหัสผ่านนี้มีไว้สำหรับผู้ดูแลระบบในองค์กรและควรใช้สำหรับการเชื่อมต่อกับ Edge จากพอร์ทัลเท่านั้น เช่น หากคุณระบุข้อมูลเข้าสู่ระบบของผู้ใช้ และผู้ใช้ดังกล่าวถูกลบใน Edge พอร์ทัลก็จะเชื่อมต่อกับ Edge ไม่ได้อีกต่อไป ดังนั้น ให้สร้างผู้ดูแลระบบในองค์กรสำหรับการเชื่อมต่อนี้โดยเฉพาะ
      
      ตัวอย่างเช่น
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd