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

พอร์ทัลบริการสำหรับนักพัฒนาแอปเวอร์ชัน 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* TO devportal@'portalIP' IDENTIFIED BY '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 Network (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 สำหรับระบบคลาวด์ส่วนตัว URL อยู่ในรูปแบบ
      http://EdgeIp:8080/v1
      
      หรือ
      https://EdgeIp:SSLport/v1
      
      โดยที่ EdgeIp คือที่อยู่ IP ของเซิร์ฟเวอร์การจัดการ Edge และ SSLport คือพอร์ต SSL สำหรับ API การจัดการ Edge เช่น 8443
   2. ชื่อองค์กร Apigee: มีพอร์ทัลและองค์กร Apigee Edge ที่เกี่ยวข้อง คุณจะตั้งค่าองค์กรเริ่มต้นเมื่อตั้งค่าปลายทาง Management API ค่าเริ่มต้นคือ my-org
   3. ชื่อผู้ใช้และรหัสผ่านสำหรับปลายทาง API การจัดการ: การเรียกใช้จากพอร์ทัลไปยัง Edge จะต้องดำเนินการโดยผู้ดูแลระบบขององค์กร
      
      ชื่อผู้ใช้/รหัสผ่านนี้มีไว้สำหรับผู้ดูแลระบบในองค์กรของคุณ และควรใช้เพื่อเชื่อมต่อกับ Edge จากพอร์ทัลเท่านั้น เช่น หากคุณระบุข้อมูลเข้าสู่ระบบของผู้ใช้ และผู้ใช้รายนั้นถูกลบใน Edge ไปแล้ว พอร์ทัลจะเชื่อมต่อกับ Edge ไม่ได้อีกต่อไป ดังนั้น ให้สร้างผู้ดูแลระบบในองค์กรสำหรับการเชื่อมต่อนี้โดยเฉพาะ
      
      ตัวอย่างเช่น
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd