กู้คืนการตั้งค่า Collabora CODE โดยไม่สูญเสียการเปลี่ยนแปลงการปรับใช้

คอนเทนเนอร์ Collabora CODE อาจรีสตาร์ทด้วยการตั้งค่าเริ่มต้นหลังจากการสร้างใหม่ หรือความล้มเหลวของเซิร์ฟเวอร์อาจทำให้คุณไม่มีสำเนาการกำหนดค่าที่ใช้งานได้ สำรองข้อมูลcoolwsd.xmlไฟล์ที่ใช้งานอยู่และไฟล์การปรับใช้ที่ให้การตั้งค่า กู้คืนไฟล์เหล่านั้นไปยังแหล่งข้อมูลถาวรเดียวกัน จากนั้นตรวจสอบความถูกต้องของไฟล์และบริการก่อนที่ผู้ใช้จะกลับมาแก้ไขอีกครั้ง

ไฟล์หลักมักจะเป็น/etc/coolwsd/coolwsd.xml. แหล่งข้อมูลที่ถูกต้องจะแตกต่างกันไปสำหรับการติดตั้งแบบแพ็กเกจ, Docker และ Helm ดังนั้นจึงต้องระบุรูปแบบการติดตั้งก่อนที่จะคัดลอกอะไรก็ตาม

1. ค้นหาแหล่งที่มาของการกำหนดค่าที่ใช้งานอยู่

ในการติดตั้งแพ็กเกจ ให้ตรวจสอบไฟล์ hosts ใน Docker ให้ตรวจสอบไฟล์ภายในคอนเทนเนอร์ที่กำลังทำงานอยู่ และตรวจสอบว่ามีการเมานต์ไฟล์ hosts หรือไดเร็กทอรีทับอยู่หรือไม่ นอกจากนี้ ให้เก็บรักษาค่า Compose ไฟล์สภาพแวดล้อมที่อ้างอิง หรือค่า Helm ไว้ด้วย เพราะตัวเลือกการเริ่มต้นที่ให้ไว้ในนั้นอาจไม่ได้ถูกจัดเก็บไว้ในไฟล์ XML เสมอไป

sudo ls -l /etc/coolwsd/coolwsd.xml
docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
docker exec collabora-code ls -l /etc/coolwsd/coolwsd.xml

แทนที่collabora-codeด้วยชื่อคอนเทนเนอร์จริงของคุณ เอกสารการกำหนดค่าและการใช้งาน Docker ของ Collabora อธิบายเส้นทางการปรับใช้เหล่านี้ และ Helm chart ต้นทางจะแสดงการตั้งค่าระดับ chart อ่านเอกสารสำหรับเวอร์ชันของคุณ ค่าเริ่มต้นและพฤติกรรมการปรับใช้อาจเปลี่ยนแปลงไปในแต่ละเวอร์ชัน

2. สำรองข้อมูล XML และไฟล์การติดตั้ง

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

สำหรับการติดตั้งแพ็กเกจ ให้เก็บรักษาข้อมูลเมตาของไฟล์ไว้:

sudo install -d -m 700 /var/backups/collabora/$(date +%F)
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/$(date +%F)/coolwsd.xml
sudo stat /var/backups/collabora/$(date +%F)/coolwsd.xml

สำหรับ Docker ให้คัดลอกไฟล์ live จากคอนเทนเนอร์ไปยังโฮสต์:

mkdir -p ~/backups/collabora/$(date +%F)
docker cp collabora-code:/etc/coolwsd/coolwsd.xml \
  ~/backups/collabora/$(date +%F)/coolwsd.xml
chmod 600 ~/backups/collabora/$(date +%F)/coolwsd.xml

หาก bind mount เป็นตัวจัดหาไฟล์ ให้สำรองข้อมูลแหล่งที่มาฝั่งโฮสต์ด้วย เพราะนั่นคือไฟล์ที่อาจเขียนทับการแก้ไขภายในคอนเทนเนอร์เมื่อรีสตาร์ท เก็บไฟล์ Compose และ.envไฟล์ที่อ้างอิงทั้งหมดไว้ในชุดสำรองข้อมูลที่ได้รับการป้องกันเดียวกัน สำหรับ Helm ให้บันทึกไฟล์ค่าที่แน่นอนและข้อมูลประจำตัวของรีลีส รวมถึง Secrets หรือ ConfigMaps ที่จัดการแยกต่างหากโดยใช้กระบวนการจัดการความลับที่มีอยู่ของคุณ

3. ทำให้การสำรองข้อมูลสามารถทำซ้ำได้

บันทึกแท็กรูปภาพ CODE หรือเวอร์ชันแพ็กเกจ ชื่อคอนเทนเนอร์ แหล่งที่มาของการเมานต์ และวันที่สำรองข้อมูล การติดตั้งแพ็กเกจสามารถใช้cp -aเพื่อเก็บรักษาข้อมูลเมตาได้ การเป็นเจ้าของไฟล์ในคอนเทนเนอร์อาจแตกต่างจากโฮสต์ ดังนั้นอย่าสันนิษฐานว่าเจ้าของหรือโหมดของโฮสต์จะเหมาะกับทุกเวอร์ชันของรูปภาพ

สำหรับ Compose ให้ตรวจสอบว่ามีการเมานต์ไฟล์หรือไดเร็กทอรีทั้งหมดที่ตำแหน่งใด/etc/coolwsdการเมานต์ไดเร็กทอรีอาจซ่อนไฟล์ที่มาพร้อมกับอิมเมจได้ ในขณะที่ไดเร็กทอรีที่ไม่สมบูรณ์อาจทำให้ไฟล์ที่คาดหวังไม่สามารถใช้งานได้ สำรองข้อมูลทุกไฟล์ในไดเร็กทอรีที่เมานต์ซึ่ง CODE ใช้งานอยู่ เก็บการตั้งค่าสภาพแวดล้อมแยกต่างหากและปกป้องข้อมูลที่เป็นความลับ

สำหรับ Helm อย่าพึ่งพาการแก้ไข Pod ที่สร้างขึ้นโดยอัตโนมัติ: การอัปเกรดอาจสร้าง Pod ขึ้นมาใหม่ได้ รักษาค่าของ Chart และ Secret หรือ ConfigMap ภายนอกใดๆ ไว้ Chart ต้นทางของ Collabora รองรับเนื้อหาการกำหนดค่าผ่านค่าต่างๆ ดังนั้นแหล่งที่มาที่ประกาศไว้จึงอาจน่าเชื่อถือมากกว่าการคัดลอกจาก Pod ที่กำลังทำงานอยู่

4. กู้คืนไปยังแหล่งข้อมูลถาวร

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

sudo systemctl stop coolwsd
sudo cp -a /etc/coolwsd/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml.before-restore
sudo cp /var/backups/collabora/2026-10-09/coolwsd.xml \
  /etc/coolwsd/coolwsd.xml
sudo chown root:cool /etc/coolwsd/coolwsd.xml
sudo chmod 640 /etc/coolwsd/coolwsd.xml
sudo systemctl start coolwsd

เจ้าของและกลุ่มตัวอย่างอาจไม่ตรงกับแพ็กเกจของคุณ ตรวจสอบไฟล์ที่มีอยู่statและรักษาสิทธิ์การเป็นเจ้าของและโหมดที่คาดหวังไว้ แทนที่จะใช้ค่าตัวอย่างโดยไม่ตรวจสอบ หากคอนเทนเนอร์ถูกเมานต์ด้วย bind-mount ให้กู้คืนไฟล์โฮสต์และทำตามขั้นตอนการรีสตาร์ทหรือสร้างใหม่ของ Compose หากอิมเมจแบบกำหนดเองหรือค่า Helm ให้การกำหนดค่า ให้อัปเดตแหล่งที่มานั้นและปรับใช้ใหม่ การแก้ไขคอนเทนเนอร์แบบใช้แล้วทิ้งจะไม่คงอยู่

ตรวจสอบการตั้งค่าก่อนทำการกู้คืนหลังจากมีการเปลี่ยนแปลงเวอร์ชันหลัก ตัวเลือกต่างๆ อาจเปลี่ยนแปลงไปในแต่ละเวอร์ชัน ดังนั้นให้เปรียบเทียบไฟล์ที่บันทึกไว้กับเทมเพลตและบันทึกการย้ายข้อมูลของเวอร์ชันเป้าหมาย การกู้คืนไฟล์ XML จะไม่กู้คืนใบรับรอง คีย์ส่วนตัว ฟอนต์ที่กำหนดเอง หรือการกำหนดค่าพร็อกซีแบบย้อนกลับ เว้นแต่จะมีการสำรองข้อมูลเหล่านั้นไว้แยกต่างหาก

5. ตรวจสอบให้แน่ใจก่อนเปิดการแก้ไขอีกครั้ง

ตรวจสอบว่าไฟล์มีอยู่จริง สามารถอ่านได้โดยบริการ และเป็นไฟล์ XML ที่มีรูปแบบถูกต้อง หากติดตั้งไว้xmllintจะตรวจสอบไวยากรณ์:

xmllint --noout /etc/coolwsd/coolwsd.xml

นี่เป็นการยืนยันไวยากรณ์ XML เท่านั้น ไม่ได้หมายความว่าทุกตัวเลือกได้รับการสนับสนุนโดยเวอร์ชัน CODE ของคุณ ตรวจสอบบันทึกเพื่อหาข้อผิดพลาดในการแยกวิเคราะห์และยืนยันว่าบริการยังคงทำงานอยู่ สำหรับคอนเทนเนอร์ ให้ตรวจสอบบันทึกdocker compose psและบันทึกล่าสุด สำหรับแพ็กเกจsystemctl status coolwsdให้ตรวจสอบบันทึกระบบ

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

• ตรวจสอบให้แน่ใจว่าเวอร์ชันสำรองข้อมูลและการติดตั้งใช้งานตรงกัน
• ตรวจสอบให้แน่ใจว่าค่า mount หรือ Helm ชี้ไปยังแหล่งที่มาที่กู้คืนแล้ว
• ยืนยันว่าการแยกวิเคราะห์ XML และการเริ่มต้นบริการสำเร็จแล้ว
• ทดสอบการเปิดและบันทึกข้อมูลผ่านแพลตฟอร์มจัดเก็บข้อมูลที่เชื่อมต่ออยู่

ข้อมูลอ้างอิงอย่างเป็นทางการ

• เอกสารประกอบการตั้งค่า Collabora Online
• เอกสารประกอบการใช้งานอิมเมจ Docker ของ Collabora CODE
• ค่า Helm chart ต้นน้ำของ Collabora
• เอกสารประกอบการใช้งาน Docker bind mounts