กำหนดค่า Edge UI ใหม่

เอกสารนี้อธิบายวิธีติดตั้งและกำหนดค่า UI ของ Edge เวอร์ชันใหม่สำหรับ Apigee Edge for Private Cloud ในเวอร์ชัน 4.54.00 UI ของ Edge เวอร์ชันใหม่ประกอบด้วยคอมโพเนนต์ RPM 2 รายการ ดังนี้

• edge-management-ui: เซิร์ฟเวอร์แบ็กเอนด์ของ UI ของ Edge เวอร์ชันใหม่
• edge-management-ui-static: ชิ้นงานเว็บแบบคงที่สำหรับส่วนหน้าของ UI ของ Edge เวอร์ชันใหม่

ระบบจะติดตั้ง UI ของ Edge เวอร์ชันใหม่โดยค่าเริ่มต้นเมื่อคุณเรียกใช้ setup.sh ด้วยโปรไฟล์ aio (ทั้งหมดในหนึ่งเดียว), sa (แบบสแตนด์อโลน) หรือ ms (เซิร์ฟเวอร์ การจัดการ) หรือจะติดตั้งแยกกันในโหนดโดยใช้โปรไฟล์ ue ก็ได้

ข้อกำหนดเบื้องต้น

ก่อนติดตั้งหรือกำหนดค่า UI ของ Edge เวอร์ชันใหม่ในการติดตั้ง Apigee Edge for Private Cloud โปรดตรวจสอบว่าโหนดมีคุณสมบัติตรงตาม ข้อกำหนดต่อไปนี้

• ข้อกำหนดด้านฮาร์ดแวร์และระบบปฏิบัติการ
  • RAM ขนาด 4 GB
  • CPU 2 คอร์
  • พื้นที่ในดิสก์ 60 GB
  • ติดตั้งยูทิลิตี apigee-setup เวอร์ชัน 4.54.00 ในโหนดตามที่อธิบายไว้ในหัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  • พอร์ต 3001 ต้องเปิดอยู่ ซึ่งเป็นพอร์ตเริ่มต้นที่ใช้สำหรับคำขอไปยัง UI ของ Edge เวอร์ชันใหม่ หากคุณเปลี่ยนพอร์ตโดยใช้พร็อพเพอร์ตี้ที่อธิบายไว้ใน ไฟล์การกำหนดค่า UI ของ Edge เวอร์ชันใหม่ โปรดตรวจสอบว่า พอร์ตนั้นเปิดอยู่
• การตรวจสอบสิทธิ์
  • การตรวจสอบสิทธิ์พื้นฐาน (ค่าเริ่มต้น): เปิดใช้โดยค่าเริ่มต้น (AUTH_MODE=basic) ใช้ข้อมูลเข้าสู่ระบบของเซิร์ฟเวอร์การจัดการ Edge และ SymasLDAP โดยไม่จำเป็นต้องใช้ผู้ให้บริการข้อมูลประจำตัว (IdP) ภายนอก
  • SSO / IdP ภายนอก (ไม่บังคับ): คุณสามารถกำหนดค่า Apigee SSO หรือ IdP ภายนอก (เช่น SAML หรือ OIDC) ได้ หากคุณเชื่อมต่อกับ IdP ภายนอกผ่าน TLS, IdP ของคุณต้องรองรับ TLS เวอร์ชัน 1.2 ขึ้นไป

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ของ UI ของ Edge เวอร์ชันใหม่ได้ที่ UI ของ Edge เวอร์ชันใหม่สำหรับ Private Cloud

ภาพรวมการติดตั้งและการกำหนดค่า

กระบวนการติดตั้งหรือกำหนดค่า UI ของ Edge เวอร์ชันใหม่โดยใช้โปรไฟล์ ue มีลักษณะดังนี้

• ตรวจสอบว่าได้ติดตั้งยูทิลิตี apigee-setup ในโหนดแล้ว
• สร้างไฟล์การกำหนดค่าแบบไม่มีเสียงและแก้ไขด้วยการตั้งค่าของคุณ
• วิ่ง /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile ซึ่งจะติดตั้งและกำหนดค่าทั้ง edge-management-ui และ edge-management-ui-static
• เข้าสู่ระบบและทดสอบ UI ของ Edge เวอร์ชันใหม่ที่ http://new_edge_UI_IP:3001

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

ไฟล์การกำหนดค่า UI ของ Edge เวอร์ชันใหม่

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

การกำหนดค่าการตรวจสอบสิทธิ์พื้นฐาน (ค่าเริ่มต้น)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

ติดตั้งหรือกำหนดค่า UI ของ Edge เวอร์ชันใหม่

วิธีติดตั้งหรือกำหนดค่า UI ของ Edge เวอร์ชันใหม่โดยใช้โปรไฟล์ ue:

1. เข้าสู่ระบบโหนดเป้าหมายในฐานะผู้ดูแลระบบ
2. ติดตั้งยูทิลิตี apigee-setup เวอร์ชัน 4.54.00 ในโหนด ตามที่อธิบายไว้ในหัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
3. ล้างข้อมูลที่แคชไว้ทั้งหมดด้วย Yum โดยเรียกใช้คำสั่งต่อไปนี้

   sudo yum clean all

4. สร้างไฟล์การกำหนดค่าตามที่อธิบายไว้ใน UI ของ Edge เวอร์ชันใหม่ และตรวจสอบว่าผู้ใช้ "apigee" เป็นเจ้าของไฟล์

   chown apigee:apigee configFile

5. เรียกใช้คำสั่งต่อไปนี้ในโหนด

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

   ยูทิลิตี apigee-setup จะติดตั้งและกำหนดค่า edge-management-ui และ edge-management-ui-static

6. เข้าสู่ระบบ UI ของ Edge เวอร์ชันใหม่โดยเปิด URL ต่อไปนี้ในเบราว์เซอร์

   http://new_edge_UI_IP:3001

   โดยที่ new_edge_UI_IP คือที่อยู่ IP หรือชื่อโฮสต์ของโหนดที่โฮสต์ UI ของ Edge เวอร์ชันใหม่

7. ป้อนข้อมูลเข้าสู่ระบบ

   UI ของ Edge เวอร์ชันใหม่จะปรากฏขึ้น ดูข้อมูลเกี่ยวกับการใช้ UI ของ Edge เวอร์ชันใหม่ได้ที่ UI ของ Edge เวอร์ชันใหม่สำหรับ Private Cloud

   หาก UI ของ Edge เวอร์ชันใหม่ไม่แสดงขึ้น โปรดตรวจสอบว่าพอร์ต 3001 เปิดอยู่สำหรับการเชื่อมต่อ

ไม่บังคับ: หากต้องการกำหนดค่า Apigee SSO สำหรับ การตรวจสอบสิทธิ์ ให้ทำตามขั้นตอนใน ติดตั้งและกำหนดค่า Apigee SSO และ เปิดใช้ IdP ภายนอกใน UI ของ Edge เวอร์ชันใหม่

ถอนการติดตั้ง UI ของ Edge เวอร์ชันใหม่

หากต้องการถอนการติดตั้ง UI ของ Edge เวอร์ชันใหม่จากโหนด ให้ถอนการติดตั้งทั้ง edge-management-ui และ edge-management-ui-static คอมโพเนนต์

วิธีถอนการติดตั้งคอมโพเนนต์ UI ของ Edge เวอร์ชันใหม่

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

วิธีนำคอมโพเนนต์ Edge ทั้งหมดออกจากโหนด

1. หยุดบริการ Edge ทั้งหมดที่ทำงานในเครื่อง

   /opt/apigee/apigee-service/bin/apigee-all stop

2. ล้างแคช Yum

   sudo yum clean all

3. นำ RPM ของ Apigee ทั้งหมดออก

   sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")

4. นำไดเรกทอรีรากของการติดตั้งออก

   sudo rm -rf /opt/apigee