Edge สำหรับ Private Cloud เวอร์ชัน 4.18.01
การติดตั้ง Edge โดยทั่วไปจะประกอบไปด้วยคอมโพเนนต์ Edge ที่กระจายไปยังโหนดหลายโหนด หลังจากติดตั้ง Edge ในโหนดแล้ว คุณจะติดตั้งและกำหนดค่าคอมโพเนนต์ Edge อย่างน้อย 1 รายการในโหนดนั้น
ขั้นตอนการติดตั้ง
การติดตั้ง Edge บนโหนดเป็นกระบวนการที่มีหลายขั้นตอน ดังนี้
- ปิดใช้ SELinux ในโหนดหรือตั้งค่าเป็นโหมดอนุญาต โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งยูทิลิตี Edge Apigee-setup
- เลือกว่าต้องการเปิดใช้การตรวจสอบสิทธิ์ Cassandra ไหม
- ตัดสินใจว่าคุณต้องการตั้งค่าการจำลองสแตนด์บายหลักสำหรับ Postgres หรือไม่
- เลือกการกำหนดค่า Edge จากรายการโทโพโลยีที่แนะนำ เช่น คุณอาจติดตั้ง Edge บนโหนดเดียวสำหรับการทดสอบ หรือใน 13 โหนดสำหรับเวอร์ชันที่ใช้งานจริง โปรดดูที่โทโพโลยีการติดตั้งสำหรับข้อมูลเพิ่มเติม
- ติดตั้งยูทิลิตี apigee-setup ของ Edge ในแต่ละโหนดของโทโพโลยีที่เลือก
- ดาวน์โหลดไฟล์ Edge bootstrap_4.18.01.sh ไปยัง bootstrap_4.18.01.sh
- ติดตั้งยูทิลิตีและการอ้างอิง apigee-service ของ Edge
- ติดตั้งยูทิลิตี apigee-setup และ Dependencies ของ Edge
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อติดตั้งยูทิลิตี Edge Apigee-setup
- ใช้ยูทิลิตี apigee-setup เพื่อติดตั้งคอมโพเนนต์ Edge อย่างน้อย 1 รายการในแต่ละโหนดโดยอิงตามโทโพโลยีที่เลือก
โปรดดูหัวข้อติดตั้งคอมโพเนนต์ Edge ในโหนดบนโหนด - ในโหนด Management Server ให้ใช้ยูทิลิตี apigee-setup เพื่อติดตั้ง apigee-provision ซึ่งเป็นยูทิลิตีที่คุณใช้สร้างและจัดการองค์กร Edge
โปรดดูวิธีเตรียมความพร้อมให้องค์กร
ผู้ที่มีสิทธิ์ติดตั้ง
ไฟล์การกระจาย Apigee Edge จะได้รับการติดตั้งเป็นชุด RPM และทรัพยากร Dependency หากต้องการติดตั้ง ถอนการติดตั้ง และอัปเดต RPM ของ Edge ผู้ใช้รูทหรือผู้ใช้ที่มีสิทธิ์เข้าถึง sudo แบบเต็มต้องเรียกใช้คำสั่ง สำหรับการเข้าถึง sudo เต็มรูปแบบ หมายความว่าผู้ใช้มีสิทธิ์เข้าถึง sudo เพื่อดำเนินการเช่นเดียวกับรูท
ผู้ใช้ที่ต้องการเรียกใช้คำสั่งหรือสคริปต์ต่อไปนี้ต้องเป็นรูทหรือเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo เต็มรูปแบบ
-
ยูทิลิตี apigee-service:
- คำสั่ง apigee-service: install, ถอนการติดตั้งแอป, อัปเดต
- คำสั่ง apigee-all: install, ทันใจ, updated
- สคริปต์ setup.sh เพื่อติดตั้งคอมโพเนนต์ Edge (ยกเว้นกรณีที่คุณใช้ "apigee-service install" เพื่อติดตั้ง RPM ที่จำเป็นแล้ว จากนั้นเข้าถึงรูทหรือการเข้าถึง sudo เต็มรูปแบบ หากไม่จำเป็น)
- สคริปต์ update.sh เพื่ออัปเดตคอมโพเนนต์ Edge
นอกจากนี้ โปรแกรมติดตั้ง Edge จะสร้างผู้ใช้ใหม่ในระบบโดยใช้ชื่อว่า "apigee" คำสั่ง Edge หลายรายการเรียกใช้ sudo เพื่อเรียกใช้ในฐานะผู้ใช้ "apigee"
ผู้ใช้ที่ต้องการเรียกใช้คำสั่งอื่นนอกเหนือจากที่แสดงข้างต้นต้องเป็นผู้ใช้ที่มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์ คำสั่งเหล่านี้ได้แก่
-
คำสั่งยูทิลิตี apigee-service ซึ่งรวมถึง
- คำสั่ง apigee-service เช่น start, start,stop,เรียกใช้งาน, กำหนดค่า
- apigee-all ของคำสั่ง เช่น start, start,stop, begin,configure
การสร้างผู้ใช้ที่มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์
หากต้องการกำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์ ให้ใช้คำสั่ง "visudo" เพื่อแก้ไขไฟล์ sudoers เพื่อเพิ่ม:
installUser ALL=(apigee) NOPASSWD: ALL
โดยที่ installUser เป็นชื่อผู้ใช้ของบุคคลที่ทํางานกับ Edge
การตั้งค่าสิทธิ์ในไฟล์การกำหนดค่า
ผู้ใช้ "Apigee" ต้องเข้าถึงไฟล์หรือทรัพยากรที่คำสั่ง Edge ได้ ซึ่งรวมถึงไฟล์ใบอนุญาต Edge และไฟล์การกำหนดค่าทั้งหมด
เมื่อสร้างไฟล์การกำหนดค่า คุณจะเปลี่ยนเจ้าของเป็น "apigee:apigee" ได้ เพื่อให้มั่นใจว่าคําสั่ง Edge จะเข้าถึงไฟล์ดังกล่าวได้
- สร้างไฟล์ในเครื่องมือแก้ไขในฐานะผู้ใช้ใดก็ได้
- กำหนดเจ้าของไฟล์เป็น "apigee:apigee" หรือหากคุณเปลี่ยนผู้ใช้ที่เรียกใช้บริการ Edge จากผู้ใช้ "apigee" ให้เปลี่ยนชื่อไฟล์เป็นผู้ใช้ที่กำลังเรียกใช้บริการ Edge
การแยกงานการติดตั้ง Edge ระหว่างผู้ใช้รูทและผู้ใช้ที่ไม่ใช่รูท
แม้ว่ากระบวนการติดตั้ง Edge ทั้งหมดจะเป็นวิธีรูทหรือโดยผู้ใช้ที่มีสิทธิ์เข้าถึง sudo โดยสมบูรณ์ที่ง่ายที่สุด แต่ก็เป็นไปไม่ได้เสมอไป แต่คุณแยกกระบวนการออกเป็นงานที่ดำเนินการโดยรูทและงานที่ดำเนินการโดยผู้ใช้ซึ่งมีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์แทนได้
- งานที่ดำเนินการโดยรูท
- ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.18.01.sh:??
> curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/Boottrap_4.18.01.sh
> sudo bash /tmp/นำเสนอจาก Boottrap_4.18.01.sh Apigeeuser=uName apigeeขั้นตอน Apigee uName apigee - กำหนดค่าผู้ใช้ให้มีสิทธิ์เข้าถึง sudo สำหรับผู้ใช้ "apigee" โดยสมบูรณ์ตามที่อธิบายด้านบน
- ติดตั้งยูทิลิตี apigee-setup ดังนี้
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install - ใช้ยูทิลิตี apigee-setup เพื่อติดตั้ง Edge RPM ในโหนดดังนี้
> /opt/apigee/apigee-service/bin/apigee-service compName install
Edge RPM ที่ติดตั้งในโหนดจะขึ้นอยู่กับโทโพโลยีของคุณ รายการคอมโพเนนต์ที่ใช้ได้ ได้แก่ apigee-provision, apigee-ตรวจสอบ, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-ui, edge-management-server, edge-ui, edge-router, edge-server-processor, apigee-postgresql, apigee-qpiddes
- ดาวน์โหลดและเรียกใช้ไฟล์ bootstrap_4.18.01.sh:??
-
หลังจากที่ผู้ใช้รูทติดตั้ง Edge RPM ในโหนดแล้ว ผู้ใช้ที่มีสิทธิ์เข้าถึง sudo เต็มรูปแบบสำหรับผู้ใช้ "apigee" จะทำตามขั้นตอนการกำหนดค่าดังนี้
- ใช้ยูทิลิตี 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
- ใช้ยูทิลิตี setup.sh เพื่อกำหนดค่าคอมโพเนนต์ Edge บนโหนดให้เสร็จสมบูรณ์ รูปแบบของคำสั่งจะขึ้นอยู่กับคอมโพเนนต์ที่คุณติดตั้งในโหนด ดูรายการทั้งหมดได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
ตำแหน่งของไฟล์การกำหนดค่าการติดตั้ง
คุณต้องส่งไฟล์การกำหนดค่าไปยังยูทิลิตี apigee-setup ที่มีข้อมูลเกี่ยวกับการติดตั้ง Edge ข้อกำหนดเพียงอย่างเดียวในการติดตั้งแบบเงียบคือผู้ใช้ "apigee" ต้องเข้าถึงหรืออ่านไฟล์การกำหนดค่าได้ เช่น นำไฟล์ไปใส่ไว้ในไดเรกทอรี /usr/local/var หรือ /usr/local/share บนโหนด แล้วกำหนดเป็น "apigee:apigee"
ต้องระบุข้อมูลทั้งหมดในไฟล์การกำหนดค่า ยกเว้นรหัสผ่านของผู้ดูแลระบบ Edge หากคุณไม่ใส่รหัสผ่าน ยูทิลิตี apigee-setup จะแจ้งให้คุณป้อนรหัสผ่านในบรรทัดคำสั่ง
ดูข้อมูลเพิ่มเติมได้ที่ติดตั้งคอมโพเนนต์ Edge ในโหนด
การจัดการกับความล้มเหลวในการติดตั้ง
ในกรณีที่เกิดข้อผิดพลาดระหว่างการติดตั้งคอมโพเนนต์ Edge ให้ลองแก้ไขปัญหาแล้วเรียกใช้โปรแกรมติดตั้งอีกครั้ง โปรแกรมติดตั้งออกแบบมาให้เรียกใช้ซ้ำๆ ในกรณีที่ตรวจพบการทำงานล้มเหลว หรือเมื่อคุณต้องการเปลี่ยนหรืออัปเดตคอมโพเนนต์หลังจากการติดตั้ง
การติดตั้งอินเทอร์เน็ตหรือไม่ติดตั้งอินเทอร์เน็ต
หากต้องการติดตั้ง Edge ในโหนด โหนดต้องเข้าถึงที่เก็บ Apigee ได้โดยทำดังนี้
- โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
โหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee ของ Apigee เพื่อติดตั้ง Edge RPM และ Dependencies - โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
โหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกจะเข้าถึงที่เก็บ Apigee ของเวอร์ชันมิเรอร์ที่คุณตั้งค่าภายในได้ ที่เก็บนี้มี RPM ของ Edge ทั้งหมด แต่คุณต้องตรวจสอบว่ามีทรัพยากร Dependency อื่นๆ ที่ใช้ได้จากที่เก็บในเครือข่ายภายใน
หมายเหตุ: Apigee ไม่ได้โฮสต์ทรัพยากร Dependency ของบุคคลที่สามทั้งหมดในที่เก็บสาธารณะของเรา คุณต้องดาวน์โหลดและติดตั้งทรัพยากร Dependency เหล่านี้จากที่เก็บที่เข้าถึงได้แบบสาธารณะ
หากต้องการสร้างที่เก็บ Apigee ภายใน คุณต้องมีโหนดที่มีสิทธิ์เข้าถึงอินเทอร์เน็ตภายนอกจึงจะดาวน์โหลด Edge RPM และทรัพยากร Dependency ได้ เมื่อสร้างที่เก็บภายในแล้ว คุณจะย้ายไปยังโหนดอื่นหรือกำหนดให้โหนด Edge เข้าถึงโหนดดังกล่าวเพื่อติดตั้งได้
การใช้ที่เก็บ Edge ในเครื่องเพื่อรักษาเวอร์ชัน Edge ของคุณ
หนึ่งในเหตุผลที่ควรใช้ที่เก็บในเครื่องหรือที่มิเรอร์คือการติดตั้ง Edge บนโหนดที่ไม่มีการเชื่อมต่ออินเทอร์เน็ตภายนอกตามที่อธิบายไว้ในส่วนก่อนหน้า
การแก้ไขการอ้างอิงการติดตั้ง RPM
ไฟล์การกระจาย Apigee Edge จะได้รับการติดตั้งเป็นชุดไฟล์ RPM ซึ่งแต่ละไฟล์จะมีเชนทรัพยากร Dependency การติดตั้งของตัวเองได้ ทรัพยากร Dependency เหล่านี้หลายรายการกำหนดโดยคอมโพเนนต์ของบุคคลที่สามซึ่งอยู่นอกเหนือการควบคุมของ Apigee และมีการเปลี่ยนแปลงได้ตลอดเวลา ดังนั้นเอกสารประกอบจะไม่แสดงหมายเลขเวอร์ชันที่ชัดเจนของทรัพยากร Dependency แต่ละรายการ
หากคุณกำลังติดตั้งบนเครื่องที่มีการเข้าถึงอินเทอร์เน็ต โหนดจะดาวน์โหลด RPM และทรัพยากร Dependency ที่จำเป็นได้ อย่างไรก็ตาม หากติดตั้งจากโหนดที่ไม่มีการเข้าถึงอินเทอร์เน็ต โดยปกติแล้วระบบจะตั้งค่าที่เก็บภายในที่มีทรัพยากร Dependency ที่จำเป็นทั้งหมด วิธีเดียวที่จะรับประกันว่าทรัพยากร Dependency ทั้งหมดจะรวมอยู่ในที่เก็บในเครื่องคือการพยายามติดตั้ง ค้นหาทรัพยากร Dependency ที่ขาดหายไป และคัดลอกทรัพยากรดังกล่าวไปยังที่เก็บในเครื่องจนกว่าการติดตั้งจะสำเร็จ
คำสั่ง Common Yum
เครื่องมือการติดตั้ง Edge สำหรับ Linux จะอาศัย Yum ในการติดตั้งและอัปเดตคอมโพเนนต์ คุณอาจต้องใช้คำสั่ง Yum หลายคำสั่งเพื่อจัดการการติดตั้งบนโหนด
- ล้างแคช Yum ทั้งหมด:
sudo yum clear all - หากต้องการอัปเดตคอมโพเนนต์ Edge
sudo yum update componentName
เช่น
sudo yumupdate apigee-setup
sudo yumupdate edge-management-server
โครงสร้างระบบไฟล์
Edge จะติดตั้งไฟล์ทั้งหมดในไดเรกทอรี /opt/apigee
ในคู่มือนี้และใน Edge Operations Guide ไดเรกทอรีการติดตั้งรูทจะมีข้อความระบุไว้ดังนี้
/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
ตารางต่อไปนี้จะแสดงตำแหน่งของไฟล์บันทึก
องค์ประกอบ |
ตำแหน่ง |
---|---|
เซิร์ฟเวอร์การจัดการ |
/opt/apigee/var/log/edge-management-server |
เราเตอร์ |
/opt/apigee/var/log/edge-router Edge Router จะใช้งานโดยใช้ Nginx โปรดดูบันทึกเพิ่มเติมที่ /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs |
Message Processor |
/opt/apigee/var/log/edge-message-processor |
เซิร์ฟเวอร์ Apigee Qpid |
/opt/apigee/var/log/edge-qpid-server |
เซิร์ฟเวอร์ Apigee Postgres |
/opt/apigee/var/log/edge-postgres-server |
UI ของ Edge |
/opt/apigee/var/log/edge-ui |
ZooKeeper |
/opt/apigee/var/log/apigee-zookeeper |
OpenLDAP |
/opt/apigee/var/log/apigee-openldap |
Cassandra |
/opt/apigee/var/log/apigee-cassandra |
คพิดด์ |
/opt/apigee/var/log/apigee-qpidd |
ฐานข้อมูล PostgreSQL |
/opt/apigee/var/log/apigee-postgresql |
ข้อมูล
องค์ประกอบ |
ตำแหน่ง |
---|---|
เซิร์ฟเวอร์การจัดการ |
/opt/apigee/data/edge-management-server |
เราเตอร์ |
/opt/apigee/data/edge-router |
Message Processor |
/opt/apigee/data/edge-message-processor |
Agent ของ Apigee Qpid |
/opt/apigee/data/edge-qpid-server |
ตัวแทน Apigee Postgres |
/opt/apigee/data/edge-postgres-server |
ZooKeeper |
/opt/apigee/data/apigee-zookeeper |
OpenLDAP |
/opt/apigee/data/apigee-openldap |
Cassandra |
/opt/apigee/data/apigee-cassandra/data |
คพิดด์ |
/opt/apigee/data/apigee-qpid/data |
ฐานข้อมูล PostgreSQL |
/opt/apigee/data/apigee-postgres/pgdata |
โพสต์งานการติดตั้ง
หลังจากติดตั้งเสร็จแล้ว คุณจะดำเนินการเพิ่มเติมกับคอมโพเนนต์ 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
/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
รายการการดำเนินการทั้งหมดของคอมโพเนนต์จะขึ้นอยู่กับคอมโพเนนต์นั้นเอง แต่คอมโพเนนต์ทั้งหมดรองรับการดำเนินการต่อไปนี้
- เริ่มต้น หยุด เริ่มต้นใหม่
- สถานะ, เวอร์ชัน
- สำรอง, กู้คืน
- ติดตั้ง ถอนการติดตั้ง