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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ไฟล์การจัดจำหน่าย Apigee Edge จะได้รับการติดตั้งเป็นชุด RPM และการอ้างอิง หากต้องการติดตั้ง ถอนการติดตั้ง และอัปเดต 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.52.02.sh โดยทำดังนี้

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.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 เพื่อติดตั้ง Edge RPM ในโหนด

      /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-ui, 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 ไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้โปรแกรมติดตั้งอีกครั้ง โปรแกรมติดตั้งได้รับการออกแบบมาให้เรียกใช้ซ้ำๆ ได้ในกรณีที่ตรวจพบความล้มเหลว หรือหากคุณต้องการเปลี่ยนหรืออัปเดตคอมโพเนนต์ในภายหลังหลังการติดตั้ง

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

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

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

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

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

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

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

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

การใช้ที่เก็บ Edge ในเครื่องเพื่อดูแลรักษาเวอร์ชัน Edge

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

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

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

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

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

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

ข้อมูล

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

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

ENABLE_SYSTEM_CHECK=y

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