ข้อควรพิจารณาในการติดตั้ง

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

การติดตั้ง Edge โดยทั่วไปจะประกอบด้วยคอมโพเนนต์ Edge ที่กระจายอยู่ในโหนดหลายโหนด หลังจากติดตั้ง Edge ในโหนดแล้ว คุณจะติดตั้งและกำหนดค่าคอมโพเนนต์ Edge อย่างน้อย 1 รายการในโหนด

ขั้นตอนการติดตั้ง

การติดตั้ง Edge บนโหนดเป็นกระบวนการแบบหลายขั้นตอน ดังนี้

• ปิดใช้ SELinux ในโหนดหรือตั้งค่าเป็นโหมดอนุญาต ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
• เลือกการกำหนดค่า Edge จากรายการโทโพโลยีที่แนะนำ เช่น คุณสามารถติดตั้ง Edge ในโหนดเดียวเพื่อทดสอบ หรือติดตั้งใน 13 โหนดสำหรับการใช้งานจริง ดูข้อมูลเพิ่มเติมได้ที่โทโพโลยีการติดตั้ง
• ติดตั้งยูทิลิตี apigee-setup ของ Edge ในแต่ละโหนดในโทโพโลยีที่เลือก โดยทำดังนี้
  • ดาวน์โหลดไฟล์ Edge bootstrap_4.16.05.sh ไปยัง /tmp/bootstrap_4.16.05.sh
  • ติดตั้งยูทิลิตี Edge apigee-service และทรัพยากร Dependency
  • ติดตั้งยูทิลิตี Edge apigee-setup และทรัพยากร Dependency
    
    ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
• ใช้ยูทิลิตี apigee-setup เพื่อติดตั้งคอมโพเนนต์ Edge อย่างน้อย 1 รายการในแต่ละโหนดตามโทโพโลยีที่เลือก
  ดูหัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนดในโหนด
• ในโหนดเซิร์ฟเวอร์การจัดการ ให้ใช้ยูทิลิตี apigee-setup เพื่อติดตั้ง apigee-provision ซึ่งเป็นยูทิลิตีที่คุณใช้สร้างและจัดการองค์กร Edge
  ดูข้อมูลเพิ่มเติมได้ที่เริ่มต้นใช้งานองค์กร

การจัดการการติดตั้งที่ไม่สำเร็จ

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

กำหนดค่าการจำลอง Postgres แบบ Master-Standby

โดยค่าเริ่มต้น Edge จะติดตั้งโหนด Postgres ทั้งหมดในโหมดมาสเตอร์ อย่างไรก็ตาม ในระบบที่ใช้งานจริงซึ่งมีโหนด Postgres หลายโหนด คุณจะกำหนดค่าให้ใช้การจำลองแบบ Master-Standby เพื่อให้โหนดสแตนด์บายยังคงให้บริการการเข้าชมต่อไปได้หากโหนดหลักล้มเหลว ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าการจำลองแบบ Master-Standby สำหรับ Postgres

ผู้ที่ติดตั้งได้

ไฟล์การแจกจ่าย Apigee Edge ได้รับการติดตั้งเป็นชุด RPM และทรัพยากร Dependency หากต้องการติดตั้ง ถอนการติดตั้ง และอัปเดต Edge คำสั่ง Edge ต้องเรียกใช้โดยผู้ใช้รากหรือผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็ม สิทธิ์เข้าถึง sudo แบบเต็มหมายความว่าผู้ใช้มีสิทธิ์เข้าถึง sudo เพื่อดำเนินการแบบเดียวกับรูท

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นรูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็ม

• apigee-service:
  • apigee-service commands: install, uninstall, update
  • คำสั่ง apigee-all: install, uninstall, update
• สคริปต์ setup.sh เพื่อติดตั้งคอมโพเนนต์ Edge (เว้นแต่คุณจะใช้ "apigee-service install" เพื่อติดตั้ง RPM ที่จำเป็นแล้ว จากนั้นจึงใช้สิทธิ์เข้าถึงแบบรูทหรือ sudo แบบเต็ม หากไม่จำเป็น)
• สคริปต์ update.sh เพื่ออัปเดตคอมโพเนนต์ Edge

นอกจากนี้ โปรแกรมติดตั้ง Edge จะสร้างผู้ใช้ใหม่ในระบบชื่อ "apigee" คำสั่ง Edge จำนวนมากเรียกใช้ sudo เพื่อเรียกใช้ในฐานะผู้ใช้ "apigee"

ผู้ใช้ที่ต้องการเรียกใช้คำสั่งอื่นๆ ทั้งหมดนอกเหนือจากที่แสดงด้านบนต้องเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" คำสั่งเหล่านี้รวมถึง

• คำสั่งยูทิลิตี apigee-service ซึ่งรวมถึง
  • คำสั่ง apigee-service เช่น start, stop, restart, configure
  • คำสั่ง apigee-all เช่น start, stop, restart, configure

หากต้องการกำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" ให้แก้ไขไฟล์ sudoers เพื่อเพิ่มข้อมูลต่อไปนี้

installUser        ALL=(apigee)      NOPASSWD: ALL

โดยที่ installUser คือชื่อผู้ใช้ของบุคคลที่ทำงานกับ Edge

ผู้ใช้ "apigee" ต้องเข้าถึงไฟล์หรือทรัพยากรทั้งหมดที่คำสั่ง Edge ใช้ได้ ซึ่งรวมถึงไฟล์ใบอนุญาต Edge และไฟล์การกำหนดค่าต่างๆ

เมื่อสร้างไฟล์การกำหนดค่า คุณสามารถเปลี่ยนเจ้าของเป็น "apigee:apigee" เพื่อให้คำสั่ง Edge เข้าถึงได้ ดังนี้

1. สร้างไฟล์ในเครื่องมือแก้ไขในฐานะผู้ใช้รายใดก็ได้
2. เปลี่ยนเจ้าของไฟล์เป็น "apigee:apigee" หรือหากคุณเปลี่ยนผู้ใช้ที่เรียกใช้บริการ Edge จากผู้ใช้ "apigee" ให้เปลี่ยนเจ้าของไฟล์เป็นผู้ใช้ที่เรียกใช้บริการ Edge

การติดตั้งคอมโพเนนต์ Edge แบบเงียบ

คุณต้องส่งไฟล์การกำหนดค่าไปยังยูทิลิตี apigee-setup ที่มีข้อมูลเกี่ยวกับการติดตั้ง Edge ข้อกำหนดเพียงอย่างเดียวสำหรับการติดตั้งแบบเงียบคือไฟล์การกำหนดค่าต้องเข้าถึงได้หรืออ่านได้โดยผู้ใช้ "apigee" เช่น วางไฟล์ในไดเรกทอรี /tmp บนโหนดและ chown เป็น "apigee:apigee"

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

ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด

การติดตั้งแบบใช้อินเทอร์เน็ตหรือไม่ใช้อินเทอร์เน็ต

หากต้องการติดตั้ง Edge ในโหนด โหนดต้องเข้าถึงที่เก็บ Apigee ได้ โดยทำดังนี้

• โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
  
  โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เพื่อติดตั้ง RPM และทรัพยากร Dependency ของ Edge
• โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
  
  โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee เวอร์ชันมิเรอร์ที่คุณตั้งค่าไว้ภายในได้ ที่เก็บนี้มี RPM ของ Edge ทั้งหมด แต่คุณต้องตรวจสอบว่าคุณมีทรัพยากร Dependency อื่นๆ ทั้งหมดที่พร้อมใช้งานจากที่เก็บในเครือข่ายภายใน

การแก้ไขทรัพยากร Dependency ของการติดตั้ง RPM

ไฟล์การแจกจ่าย Apigee Edge จะติดตั้งเป็นชุดไฟล์ RPM ซึ่งแต่ละไฟล์จะมีเชนของทรัพยากร Dependency ของการติดตั้งของตัวเองได้ ทรัพยากร Dependency เหล่านี้จำนวนมากกำหนดโดยคอมโพเนนต์ของบุคคลที่สามซึ่งอยู่นอกเหนือการควบคุมของ Apigee และอาจเปลี่ยนแปลงได้ทุกเมื่อ ดังนั้นเอกสารประกอบจึงไม่ได้ระบุหมายเลขเวอร์ชันที่ชัดเจนของทรัพยากร Dependency แต่ละรายการ

หากคุณกำลังติดตั้งในเครื่องที่มีการเข้าถึงอินเทอร์เน็ต โหนดจะดาวน์โหลด RPM และทรัพยากร Dependency ที่จำเป็นได้ อย่างไรก็ตาม หากคุณติดตั้งจากโหนดที่ไม่มีการเข้าถึงอินเทอร์เน็ต โดยปกติแล้วคุณจะตั้งค่าที่เก็บภายในซึ่งมีทรัพยากร Dependency ที่จำเป็นทั้งหมด วิธีเดียวที่จะรับประกันได้ว่าทรัพยากร Dependency ทั้งหมดรวมอยู่ในที่เก็บในเครื่องคือการพยายามติดตั้ง ระบุทรัพยากร Dependency ที่ขาดหายไป และคัดลอกไปยังที่เก็บในเครื่องจนกว่าการติดตั้งจะสำเร็จ

การตั้งค่าโฮสต์เสมือน

โฮสต์เสมือนใน Edge จะกำหนดโดเมนและพอร์ต Edge Router ที่แสดงพร็อกซี API และ URL ที่แอปใช้เพื่อเข้าถึงพร็อกซี API ตามส่วนขยาย นอกจากนี้ โฮสต์เสมือนยังกำหนดว่าจะเข้าถึงพร็อกซี API โดยใช้โปรโตคอล HTTP หรือโปรโตคอล HTTPS ที่เข้ารหัส

ในกระบวนการเริ่มต้นใช้งาน Edge คุณต้องสร้างองค์กร สภาพแวดล้อม และโฮสต์เสมือน Edge มีคำสั่ง setup-org เพื่อให้กระบวนการนี้ง่ายขึ้นสำหรับผู้ใช้ใหม่

เมื่อสร้างโฮสต์เสมือน คุณต้องระบุข้อมูลต่อไปนี้

• ชื่อของโฮสต์เสมือนที่คุณใช้อ้างอิงในพร็อกซี API
• พอร์ตในเราเตอร์สำหรับโฮสต์เสมือน โดยปกติแล้ว พอร์ตเหล่านี้จะเริ่มต้นที่ 9001 และเพิ่มขึ้นทีละ 1 สำหรับโฮสต์เสมือนใหม่แต่ละรายการ
• ชื่อแทนโฮสต์ของโฮสต์เสมือน โดยปกติจะเป็นชื่อ DNS ของโฮสต์เสมือน

Edge Router จะเปรียบเทียบส่วนหัว Host ของคำขอขาเข้ากับรายการชื่อแทนโฮสต์ที่ใช้ได้ โดยเป็นส่วนหนึ่งของการกำหนดพร็อกซี API ที่จัดการคำขอ เมื่อส่งคำขอผ่านโฮสต์เสมือน ให้ระบุชื่อโดเมนที่ตรงกับชื่อแทนโฮสต์ของโฮสต์เสมือน หรือระบุที่อยู่ IP ของเราเตอร์และส่วนหัว Host ที่มีชื่อแทนโฮสต์

ตัวอย่างเช่น หากคุณสร้างโฮสต์เสมือนที่มีชื่อแทนโฮสต์เป็น myapis.apigee.net ในพอร์ต 9001 คำขอ cURL ไปยัง API ผ่านโฮสต์เสมือนนั้นอาจใช้รูปแบบใดรูปแบบหนึ่งต่อไปนี้

• หากคุณมีรายการ DNS สำหรับ myapis.apigee.net:
  
  curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• หากคุณไม่มีรายการ DNS สำหรับ myapis.apigee.net:
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
  
  ในรูปแบบนี้ คุณจะระบุที่อยู่ IP ของเราเตอร์ และส่งชื่อแทนโฮสต์ในส่วนหัวของโฮสต์
  
  หมายเหตุ: คำสั่ง curl, เบราว์เซอร์ส่วนใหญ่ และยูทิลิตีอื่นๆ อีกมากมายจะเพิ่มส่วนหัวของโฮสต์ที่มีโดเมนเป็นส่วนหนึ่งของคำขอโดยอัตโนมัติ คุณจึงใช้คำสั่ง curl ในรูปแบบต่อไปนี้ได้
  
  curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}

ตัวเลือกเมื่อคุณไม่มีรายการ DNS สำหรับโฮสต์เสมือน

ตัวเลือกหนึ่งเมื่อคุณไม่มีรายการ DNS คือการตั้งค่านามแฝงของโฮสต์เป็นที่อยู่ IP ของเราเตอร์และพอร์ตของโฮสต์เสมือนเป็น <routerIP>:port เช่น

192.168.1.31:9001

จากนั้นสร้างคำสั่ง curl ในแบบฟอร์มด้านล่าง

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

เราขอแนะนำตัวเลือกนี้เนื่องจากทำงานร่วมกับ Edge UI ได้ดี

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

หรือจะตั้งค่าชื่อแทนโฮสต์เป็นค่า เช่น temp.hostalias.com ก็ได้ จากนั้นคุณต้องส่งส่วนหัว Host ในทุกคำขอ ดังนี้

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path}  -H 'host: temp.hostalias.com'

หรือเพิ่มชื่อแทนโฮสต์ลงในไฟล์โฮสต์ /etc/hosts เช่น เพิ่มบรรทัดนี้ลงใน /etc/hosts:

192.168.1.31   temp.hostalias.com

จากนั้นคุณจะส่งคำขอได้เหมือนกับว่าคุณมีรายการ DNS ดังนี้

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}

การกำหนดค่าคอมโพเนนต์ Edge หลังการติดตั้ง

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

ไฟล์ .properties จะอยู่ในไดเรกทอรี /opt/apigee/customer/application แต่ละคอมโพเนนต์จะมีไฟล์ .properties ของตัวเองในไดเรกทอรีนั้น เช่น router.properties และ management-server.properties

หากต้องการตั้งค่าพร็อพเพอร์ตี้สำหรับคอมโพเนนต์ ให้แก้ไขไฟล์ .properties ที่เกี่ยวข้อง แล้วรีสตาร์ทคอมโพเนนต์ โดยทำดังนี้

> /opt/apigee/apigee-service/bin/apigee-service component restart

เช่น

> /opt/apigee/apigee-service/bin/apigee-service edge-router restart

เมื่อคุณอัปเดต Edge ระบบจะอ่านไฟล์ .properties ในไดเรกทอรี /opt/apigee/customer/application ซึ่งหมายความว่าการอัปเดตจะเก็บพร็อพเพอร์ตี้ที่คุณตั้งค่าไว้ในคอมโพเนนต์

ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่า Edge ได้ที่วิธีกำหนดค่า Edge

ตรวจสอบว่า Edge Router สามารถเข้าถึง /etc/rc.d/init.d/functions ได้

Edge Router และพอร์ทัล BaaS ต่างก็ใช้เราเตอร์ Nginx และต้องมีสิทธิ์อ่าน /etc/rc.d/init.d/functions

หากกระบวนการรักษาความปลอดภัยกำหนดให้คุณต้องตั้งค่าสิทธิ์ใน /etc/rc.d/init.d/functions อย่าตั้งค่าเป็น 700 ไม่เช่นนั้นเราเตอร์จะเริ่มทำงานไม่สำเร็จ คุณสามารถตั้งค่าสิทธิ์เป็น 744 เพื่ออนุญาตสิทธิ์การอ่านใน /etc/rc.d/init.d/functions

การเรียกใช้คำสั่งในคอมโพเนนต์ Edge

Edge จะติดตั้งยูทิลิตีการจัดการใน /opt/apigee/apigee-service/bin ซึ่งคุณสามารถใช้เพื่อจัดการการติดตั้ง Edge ได้ เช่น คุณสามารถใช้ยูทิลิตี apigee-all เพื่อเริ่ม หยุด รีสตาร์ท หรือระบุสถานะของคอมโพเนนต์ Edge ทั้งหมดในโหนดได้

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

ใช้ยูทิลิตี apigee-service เพื่อควบคุมและกำหนดค่าคอมโพเนนต์แต่ละรายการ ยูทิลิตี apigee-service มีรูปแบบดังนี้

/opt/apigee/apigee-service/bin/apigee-service component action

ตัวอย่างเช่น หากต้องการรีสตาร์ท Edge Router ให้ทำดังนี้

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

คุณสามารถระบุรายการคอมโพเนนต์ที่ติดตั้งในโหนดได้โดยตรวจสอบไดเรกทอรี /opt/apigee ไดเรกทอรีดังกล่าวมีไดเรกทอรีย่อยสำหรับคอมโพเนนต์ Edge ทุกรายการที่ติดตั้งในโหนด ไดเรกทอรีย่อยแต่ละรายการจะมีคำนำหน้าดังนี้

• apigee - คอมโพเนนต์ของบุคคลที่สามที่ Edge ใช้ ตัวอย่างเช่น apigee-cassandra
• edge - คอมโพเนนต์ Edge จาก Apigee เช่น edge-management-server
• edge-mint - คอมโพเนนต์การสร้างรายได้ เช่น edge-mint-management-server
• baas - คอมโพเนนต์ API BaaS เช่น baas-usergrid

รายการการทำงานทั้งหมดของคอมโพเนนต์จะขึ้นอยู่กับตัวคอมโพเนนต์เอง แต่คอมโพเนนต์ทั้งหมดจะรองรับการทำงานต่อไปนี้

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

การเข้าถึงไฟล์บันทึก

ระบบจะเขียนไฟล์บันทึกสำหรับ apigee-setup และสคริปต์ setup.sh ลงใน /tmp/setup-root.log

ไฟล์บันทึกสำหรับแต่ละคอมโพเนนต์จะอยู่ในไดเรกทอรี /opt/apigee/var/log แต่ละคอมโพเนนต์จะมีไดเรกทอรีย่อยของตัวเอง ตัวอย่างเช่น บันทึกสำหรับเซิร์ฟเวอร์การจัดการจะอยู่ในไดเรกทอรีต่อไปนี้

/opt/apigee/var/log/edge-management-server

คำสั่ง Yum ทั่วไป

เครื่องมือติดตั้ง Edge สำหรับ Linux อาศัย Yum ในการติดตั้งและอัปเดตคอมโพเนนต์ คุณอาจต้องใช้คำสั่ง Yum หลายคำสั่งเพื่อจัดการการติดตั้งในโหนด

• ล้างแคช Yum ทั้งหมด:
  sudo yum clean all
• วิธีอัปเดตคอมโพเนนต์ Edge
  sudo yum update componentName
  เช่น
  sudo yum update apigee-setup
  sudo yum update edge-management-server

โครงสร้างระบบไฟล์

Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee

ในคู่มือนี้และคู่มือการดำเนินการ Edge ไดเรกทอรีการติดตั้งรูทจะระบุไว้ดังนี้

<inst_root>/apigee

การติดตั้งจะใช้โครงสร้างระบบไฟล์ต่อไปนี้เพื่อติดตั้งใช้งาน Apigee Edge สำหรับ Private Cloud

ไฟล์บันทึก

ข้อมูล