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

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

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

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

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

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

ผู้ที่ดำเนินการติดตั้งได้

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

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

• ยูทิลิตี apigee-service:
  • คำสั่ง apigee-service: install, install, appeal, update
  • คำสั่ง apigee-all: install, install, update (ติดตั้ง, ถอนการติดตั้ง, อัปเดต)
• สคริปต์ setup.sh เพื่อติดตั้งคอมโพเนนต์ Edge (ยกเว้นคุณได้ใช้ไปแล้ว "การติดตั้ง apigee-service" ถึง ให้ติดตั้ง 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

การตั้งค่าสิทธิ์เปิดอยู่ ไฟล์การกำหนดค่า

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

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

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

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

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

1. งานที่ดำเนินการโดยรูท:
   1. ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.17.09.sh ดังนี้
      Curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
      
      ขั้นตอนนี้จะติดตั้งยูทิลิตี apigee-service และสร้าง "Apigee" ผู้ใช้
   2. กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo แบบเต็มสำหรับ "apigee" ผู้ใช้ตามที่อธิบายไว้ข้างต้น
   3. ติดตั้งยูทิลิตี apigee-setup ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service ติดตั้ง apigee-setup
   4. ใช้ apigee-setup ยูทิลิตีในการติดตั้ง Edge RPM บนโหนด
      /opt/apigee/apigee-service/bin/apigee-service compName จำนวนการติดตั้ง
      
      RPM ของ Edge ที่คุณติดตั้งในโหนดจะขึ้นอยู่กับโทโพโลยีของคุณ รายการที่ใช้ได้ คอมโพเนนต์ประกอบด้วย apigee-provision, apigee-Validate apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, edge-management-server, Edge-UI, EDGE-Router, EDGE-message-processor, apigee-postgresql, apigee-qpidd edge-postgres-server, edge-qpid-server
2. หลังจากที่ผู้ใช้รูทติดตั้ง Edge RPM ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึงโดยสมบูรณ์ "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 ใน และเลือกเป็น "apigee:apigee"

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

โปรดดูติดตั้ง Edge คอมโพเนนต์บนโหนดสำหรับข้อมูลเพิ่มเติม

การจัดการความล้มเหลวในการติดตั้ง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• ทำความสะอาดแคชของ Yum ทั้งหมด โดยทำดังนี้
  ล้าง sudo yum ทั้งหมด
• หากต้องการอัปเดตคอมโพเนนต์ Edge ให้ทำดังนี้
  อัปเดต sudo yum componentName
  ตัวอย่างเช่น
  sudo yum อัปเดต apigee-setup
  sudo yum อัปเดต 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 ได้

กำลังกำหนดค่า 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 คอมโพเนนต์

ยูทิลิตีการจัดการการติดตั้ง 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

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

• เริ่มต้น หยุด รีสตาร์ท
• สถานะ, เวอร์ชัน
• การสำรอง, การคืนค่า
• ติดตั้ง, ถอนการติดตั้ง