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

พอร์ทัลบริการสำหรับนักพัฒนาซอฟต์แวร์ v. 4.16.05

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

ฮาร์ดแวร์

ข้อกำหนด

ระบบปฏิบัติการ

วิธีการติดตั้งเหล่านี้และไฟล์การติดตั้งที่ให้มาได้รับการทดสอบในระบบปฏิบัติการที่ระบุไว้ที่นี่: 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 ในเครื่องเดียวกับ Developer Channel Services ซึ่งเป็นโทโพโลยีแบบเครื่องเดียว โปรแกรมติดตั้ง Developer Channel Services จะแจ้งให้คุณป้อนชื่อฐานข้อมูลและผู้ใช้ฐานข้อมูล จากนั้นจะติดตั้งเซิร์ฟเวอร์ MySQL และสร้างสคีมาฐานข้อมูลให้คุณ เวอร์ชันที่ติดตั้งเป็นเวอร์ชันล่าสุดที่พร้อมใช้งานสำหรับระบบปฏิบัติการของคุณ

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

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

Developer Channel Services จะใช้ผู้ใช้ฐานข้อมูลเพื่อเชื่อมต่อกับฐานข้อมูล และผู้ใช้ต้องมีสิทธิ์ต่อไปนี้ 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>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  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

เมื่อติดตั้ง Developer Channel Services ให้ระบุว่าไม่ต้องติดตั้งเซิร์ฟเวอร์ 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 ของคุณ

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

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

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

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

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

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

  1. คุณกำลังกำหนดค่าแพลตฟอร์มใด Red Hat หรือ CentOS หากเป็นการติดตั้ง Red Hat คุณต้องลงทะเบียนเครื่องใน Red Hat Network เพื่อดาวน์โหลด 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 และ SSLport คือพอร์ต SSL สำหรับ Edge Management API เช่น 8443
    2. ชื่อองค์กร Apigee: พอร์ทัลและองค์กร Apigee Edge มีความสัมพันธ์กัน คุณจะตั้งค่าองค์กรเริ่มต้นเมื่อตั้งค่าปลายทาง Management API ค่าเริ่มต้นคือ my-org
    3. ชื่อผู้ใช้และรหัสผ่านสำหรับปลายทาง Management API: การเรียกจากพอร์ทัลไปยัง Edge ต้องดำเนินการโดยผู้ดูแลระบบขององค์กร

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

      เช่น
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd