4.53.00.02 - บันทึกประจำรุ่นของ Edge สำหรับ Private Cloud

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X info

เมื่อวันที่ 19 ธันวาคม 2024 เราได้เปิดตัว Apigee Edge for Private Cloud เวอร์ชันใหม่

ขั้นตอนการอัปเดต

ส่วนนี้อธิบายวิธีติดตั้งรุ่นนี้หากคุณอัปเดตจาก Edge for Private Cloud รุ่นก่อนหน้า หากต้องการอัปเดตจากรุ่นก่อนหน้า โปรดดู การใช้แพตช์หลายเวอร์ชัน

การอัปเดตรุ่นนี้จะอัปเดตคอมโพเนนต์ที่ระบุไว้ด้านล่าง

• apigee-nginx-1.26.1-el8.x86_64.rpm
• apigee-nginx-1.26.1-el9.x86_64.rpm
• apigee-qpidd-8.0.6-0.0.2534.noarch.rpm
• apigee-sso-4.53.00-0.0.21506.noarch.rpm
• apigee-tomcat-9.0.86-0.0.948.noarch.rpm

คุณสามารถตรวจสอบเวอร์ชัน RPM ที่ติดตั้งอยู่ในปัจจุบันเพื่อดูว่าต้องอัปเดตหรือไม่โดยป้อนคำสั่งต่อไปนี้

apigee-all version

หากต้องการอัปเดตการติดตั้ง ให้ทำตามขั้นตอนต่อไปนี้ในโหนด Edge

1. ในโหนด Edge ทั้งหมด ให้ทำดังนี้

   1. ล้างข้อมูลที่เก็บ Yum

      sudo yum clean all

   2. ดาวน์โหลดไฟล์ bootstrap_4.53.00.sh ของ Edge 4.53.00 เวอร์ชันล่าสุดไปที่ /tmp/bootstrap_4.53.00.sh

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

   3. ติดตั้งยูทิลิตี apigee-service และการอ้างอิงของ Edge 4.53.00 โดยใช้คำสั่งต่อไปนี้

      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      โดยที่ uName และ pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากไม่ระบุ pWord ระบบจะแจ้งให้คุณป้อนรหัสผ่าน

   4. ใช้คำสั่ง source เพื่อเรียกใช้สคริปต์ apigee-service.sh

      source /etc/profile.d/apigee-service.sh

2. เรียกใช้สคริปต์ update.sh ในโหนด Qpid ทั้งหมด

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. ในโหนด SSO ให้ทำตามขั้นตอนที่ระบุไว้ในส่วน ขั้นตอนการอัปเดต Apigee SSO จากเวอร์ชันเก่า

/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

ขั้นตอนการอัปเดต Apigee SSO จากเวอร์ชันเก่า

ใน Edge for Private Cloud 4.53.00 ตอนนี้ระบบจะกำหนดค่าคีย์และใบรับรอง IDP ที่ใช้ในคอมโพเนนต์ apigee-sso ผ่านคีย์สโตร์ คุณจะต้องส่งออกคีย์และใบรับรองที่ใช้ก่อนหน้านี้ไปยังคีย์สโตร์ กำหนดค่า แล้วดำเนินการอัปเดต SSO ตามปกติ

1. ระบุคีย์และใบรับรองที่มีอยู่ซึ่งใช้สำหรับการกำหนดค่า IDP โดยทำดังนี้

   1. เรียกใบรับรองโดยค้นหาค่าของ SSO_SAML_SERVICE_PROVIDER_CERTIFICATE ในไฟล์การกำหนดค่าการติดตั้ง SSO หรือโดยการค้นหาคอมโพเนนต์ apigee-sso สำหรับ conf_login_service_provider_certificate

      ใช้คำสั่งต่อไปนี้ในโหนด SSO เพื่อค้นหา apigee-sso สำหรับเส้นทางใบรับรอง IDP ในเอาต์พุต ให้มองหาค่าในบรรทัดสุดท้าย

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

   2. เรียกคีย์โดยค้นหาค่าของ SSO_SAML_SERVICE_PROVIDER_KEY ในไฟล์การกำหนดค่าการติดตั้ง SSO หรือโดยการค้นหาคอมโพเนนต์ apigee-sso สำหรับ conf_login_service_provider_key

      ใช้คำสั่งต่อไปนี้ในโหนด SSO เพื่อค้นหา apigee-sso สำหรับเส้นทางคีย์ IDP ในเอาต์พุต ให้มองหาค่าในบรรทัดสุดท้าย

      apigee-service apigee-sso configure -search conf_login_service_provider_key

2. ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์โดยทำดังนี้
   1. ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์ PKCS12 โดยใช้คำสั่งต่อไปนี้

      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      พารามิเตอร์ ได้แก่

      • certificate_path: เส้นทางไปยังไฟล์ใบรับรองที่เรียกในขั้นตอนที่ 1.a
      • key_path: เส้นทางไปยังไฟล์คีย์ส่วนตัวที่เรียกในขั้นตอนที่ 1.b
      • keystore_path: เส้นทางไปยังคีย์สโตร์ที่สร้างขึ้นใหม่ซึ่งมีใบรับรองและคีย์ส่วนตัว
      • alias: ชื่อแทนที่ใช้สำหรับคู่คีย์และใบรับรองภายในคีย์สโตร์

      ดูรายละเอียดเพิ่มเติมได้จากเอกสารประกอบของ OpenSSL

   2. (ไม่บังคับ) ส่งออกคีย์และใบรับรองจาก PKCS12 ไปยังคีย์สโตร์ JKS โดยใช้คำสั่งต่อไปนี้

      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      พารามิเตอร์ ได้แก่

      • PKCS12_keystore_path: เส้นทางไปยังคีย์สโตร์ PKCS12 ที่สร้างขึ้นในขั้นตอนที่ 2.a ซึ่งมีใบรับรองและคีย์
      • destination_keystore_path: เส้นทางไปยังคีย์สโตร์ JKS ใหม่ที่จะส่งออกใบรับรองและคีย์
      • alias: ชื่อแทนที่ใช้สำหรับคู่คีย์และใบรับรองภายในคีย์สโตร์ JKS

   ดูรายละเอียดเพิ่มเติมได้จากเอกสารประกอบของ Keytool

3. เปลี่ยนเจ้าของไฟล์คีย์สโตร์เอาต์พุตเป็นผู้ใช้ "apigee" โดยใช้คำสั่งต่อไปนี้

   sudo chown apigee:apigee <keystore_file>

4. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ใน ไฟล์การกำหนดค่า Apigee SSO และอัปเดตพร็อพเพอร์ตี้ด้วยเส้นทางไฟล์คีย์สโตร์ รหัสผ่าน ประเภทคีย์สโตร์ และชื่อแทน

   # Path to the keystore file
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks
   
   # Keystore password
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore
   
   # Keystore type
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12
   
   # Alias within keystore that stores the key and certificate
   SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert

5. อัปเดตซอฟต์แวร์ Apigee SSO ในโหนด SSO ตามปกติโดยใช้คำสั่งต่อไปนี้

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

การแก้ไขบั๊ก

ส่วนนี้แสดงรายการบั๊กของ Private Cloud ที่ได้รับการแก้ไขในรุ่นนี้

ปัญหาด้านความปลอดภัยที่ได้รับการแก้ไข

ต่อไปนี้เป็นรายการปัญหาด้านความปลอดภัยที่ทราบซึ่งได้รับการแก้ไขในรุ่นนี้ โปรดติดตั้ง Edge Private Cloud เวอร์ชันล่าสุดเพื่อหลีกเลี่ยงปัญหาเหล่านี้

การเปลี่ยนแปลงซอฟต์แวร์ที่รองรับ

รุ่นนี้ไม่มีการรองรับซอฟต์แวร์ใหม่

การเลิกใช้งานและการเลิกให้บริการ

รุ่นนี้ไม่มีการเลิกใช้งานหรือเลิกให้บริการใหม่

ฟีเจอร์ใหม่

ส่วนนี้แสดงรายการฟีเจอร์ใหม่ในรุ่นนี้

ปัญหาที่ทราบ

ดูรายการปัญหาที่ทราบทั้งหมดได้ที่ ปัญหาที่ทราบเกี่ยวกับ Edge for Private Cloud

การใช้แพตช์หลายเวอร์ชัน

ส่วนนี้อธิบายวิธีใช้แพตช์หลายเวอร์ชันในกรณีที่คุณอัปเดตจาก Edge for Private Cloud เวอร์ชันที่เก่ากว่าเวอร์ชันแพตช์ที่เปิดตัวก่อนหน้านี้

แพตช์แต่ละเวอร์ชันจะมีการอัปเดตคอมโพเนนต์ที่เฉพาะเจาะจงของ Edge for Private Cloud เช่น edge-management-server หากต้องการใช้แพตช์หลายเวอร์ชัน คุณต้องอัปเดตคอมโพเนนต์ Edge แต่ละรายการที่รวมอยู่ใน แพตช์เวอร์ชันที่ใหม่กว่าเวอร์ชันที่ติดตั้งอยู่ในปัจจุบัน คุณสามารถค้นหาคอมโพเนนต์เหล่านี้ได้โดย ดูที่หมายเหตุประจำรุ่นของ Edge for Private Cloud สำหรับทุกเวอร์ชันที่ใหม่กว่าเวอร์ชันปัจจุบัน และตรวจสอบรายการ RPM สำหรับเวอร์ชันเหล่านั้น ดูลิงก์ไปยังหมายเหตุประจำรุ่นทั้งหมดของ Edge for Private Cloud ได้ที่ หมายเหตุประจำรุ่นของ Apigee

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

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