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

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

เมื่อวันที่ 19 ธันวาคม 2024 เราได้เปิดตัว Apigee Edge สำหรับ 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. ดาวน์โหลดไฟล์ Edge 4.53.00 bootstrap_4.53.00.sh ล่าสุดไปที่ /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. ในโหนด Qpid ทั้งหมด ให้เรียกใช้สคริปต์ update.sh

   /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 สำหรับ Private Cloud 4.53.00 ตอนนี้คีย์และใบรับรอง IdP ที่ใช้ในคอมโพเนนต์ apigee-sso ได้รับการกำหนดค่าผ่านที่เก็บคีย์แล้ว คุณจะต้องส่งออกคีย์และใบรับรองที่ใช้ก่อนหน้านี้ไปยัง Keystore กำหนดค่า แล้วดำเนินการอัปเดต 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 Keystore โดยทำดังนี้

      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: เส้นทางไปยัง Keystore JKS ใหม่ที่จะส่งออกใบรับรองและคีย์
      • alias: นามแฝงที่ใช้สำหรับคู่คีย์และใบรับรองภายใน Keystore ของ 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 สำหรับ Private Cloud

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

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

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

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

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