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

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

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

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

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

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

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

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

กำหนดค่าการสแตนด์บายต้นแบบของ Postgres เรพลิเคชัน

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

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

ไฟล์การกระจาย Apigee Edge ได้รับการติดตั้งเป็นชุด RPM และทรัพยากร Dependency ถึง ติดตั้ง ถอนการติดตั้ง และอัปเดต Edge คำสั่ง 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" user ให้แก้ไขไฟล์ sudoers เป็น เพิ่ม:

installUser        ALL=(apigee)      NOPASSWD: ALL

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

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

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

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

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

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

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

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

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

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

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

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

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

• หากคุณมีรายการ DNS สำหรับ myapis.apigee.net ให้ทำดังนี้
  
  ขด http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}
• หากไม่มีรายการ DNS สำหรับ myapis.apigee.net ให้ทำดังนี้
  
  ขด http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H "โฮสต์: 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. จากนั้น คุณจะต้องส่งส่วนหัวของโฮสต์ในทุกคำขอ โดยทำดังนี้

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

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

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

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

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

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

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

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

<inst_root>/apigee

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

ไฟล์บันทึก

ข้อมูล