ภาพรวมการติดตั้ง Edge

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

กระบวนการติดตั้ง

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

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

     ดูข้อมูลเพิ่มเติมได้ที่หัวข้อติดตั้งยูทิลิตี้ apigee-setup ของ Edge

6. ใช้ยูทิลิตี้ apigee-setup เพื่อติดตั้งคอมโพเนนต์ Edge อย่างน้อย 1 รายการในแต่ละ โหนดตามโทโพโลยีที่เลือก

   ดูหัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนด

7. ในโหนด Management Server ให้ใช้ยูทิลิตี้ apigee-setup เพื่อติดตั้ง apigee-provision ซึ่งเป็นยูทิลิตี้ที่คุณใช้สร้างและจัดการองค์กร Edge

   ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเริ่มต้นใช้งานองค์กร

8. รีสตาร์ทคอมโพเนนต์ UI ใหม่ของ Edge ในแต่ละโหนด หลังจากติดตั้งเสร็จสมบูรณ์ ดังตัวอย่างต่อไปนี้

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9. กำหนดค่าการตรวจสอบสิทธิ์และการตั้งค่าที่ไม่บังคับสำหรับ UI ใหม่ของ Edge (ซึ่งมีชื่อคอมโพเนนต์เป็น edge-management-ui และ edge-management-ui-static)

   ดูข้อมูลเพิ่มเติมได้ที่หัวข้อกำหนดค่า UI ใหม่ของ Edge

หลังจากติดตั้งเสร็จแล้ว ให้ดู รายการ การดำเนินการทั่วไปหลังการติดตั้ง

ผู้ที่มีสิทธิ์ติดตั้ง

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

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

• ยูทิลิตี้ apigee-service:
  • คำสั่ง apigee-service ได้แก่ 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"

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

installUser        ALL=(apigee)      NOPASSWD: ALL

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

การตั้งค่าสิทธิ์ในไฟล์การกำหนดค่า

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

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

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

การแยกงานติดตั้ง Edge ระหว่างผู้ใช้รากและผู้ใช้ที่ไม่ใช่รูท

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

1. งานที่ดำเนินการโดยรูท
   1. ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.54.00.sh ดังนี้

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

      ขั้นตอนนี้จะติดตั้งยูทิลิตี้ apigee-service และสร้างผู้ใช้ "apigee"

   2. กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee" ตามที่อธิบายไว้ใน การสร้างผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับผู้ใช้ "apigee".
   3. ติดตั้งยูทิลิตี้ apigee-setup ดังนี้

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. ใช้ยูทิลิตี้ apigee-setup เพื่อติดตั้ง RPM ของ Edge ในโหนด ดังนี้

      /opt/apigee/apigee-service/bin/apigee-service compName install

      RPM ของ Edge ที่คุณติดตั้งในโหนดจะขึ้นอยู่กับโทโพโลยี รายการคอมโพเนนต์ที่พร้อมใช้งาน ได้แก่ apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server

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

      ตัวอย่างเช่น หากต้องการติดตั้ง ZooKeeper และ Cassandra ให้เสร็จสมบูรณ์ ให้ใช้คำสั่งต่อไปนี้

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      โดย configFile คือไฟล์การกำหนดค่า Edge

      หรือหากต้องการติดตั้งแบบครบวงจร ให้ใช้คำสั่งต่อไปนี้

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

ตำแหน่งของไฟล์การกำหนดค่าการติดตั้ง

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

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

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

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

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

หลังจากติดตั้งหรืออัปเกรดแล้ว ให้รีสตาร์ทคอมโพเนนต์ UI ใหม่ของ Edge ในแต่ละโหนดที่ คอมโพเนนต์ทำงานอยู่

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

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

• โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

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

• โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

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

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

การใช้ที่เก็บ Edge ในเครื่องเพื่อคงเวอร์ชัน Edge ไว้

เหตุผลหนึ่งที่ควรใช้ที่เก็บในเครื่องหรือที่เก็บที่จำลองขึ้นคือเพื่อติดตั้ง Edge ในโหนด ที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกตามที่อธิบายไว้ในส่วนก่อนหน้า

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

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

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

คำสั่ง 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 เราจะระบุไดเรกทอรีการติดตั้งรูทเป็น

/opt/apigee

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

ไฟล์บันทึก

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

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

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

ตารางต่อไปนี้แสดงตำแหน่งของไฟล์บันทึก

ข้อมูล

เปิดใช้การตรวจสอบระบบเมื่อติดตั้ง

ไฟล์การกำหนดค่าการติดตั้ง Edge รองรับพร็อพเพอร์ตี้ต่อไปนี้

ENABLE_SYSTEM_CHECK=y

หากตั้งค่าพร็อพเพอร์ตี้นี้เป็น "y" โปรแกรมติดตั้งจะตรวจสอบว่าระบบตรงตามข้อกำหนดด้าน CPU และ หน่วยความจำสำหรับคอมโพเนนต์ที่กำลังติดตั้ง ค่าเริ่มต้นคือ "n" เพื่อปิดใช้การ ตรวจสอบ