วิธีเพิ่มฟอนต์แบบกำหนดเองลงใน Collabora Online CODE Docker

เพื่อให้สามารถใช้งานแบบอักษรที่กำหนดเองใน Collabora Online CODE (Collabora Online Development Edition) ที่ทำงานใน Docker ได้ ไฟล์แบบอักษรจะต้องพร้อมใช้งานสำหรับคอนเทนเนอร์ Collabora เอง การติดตั้งเฉพาะบนโฮสต์ Docker หรือในคอนเทนเนอร์ Nextcloud แยกต่างหากจะไม่ทำให้แบบอักษรนั้นพร้อมใช้งานสำหรับเซิร์ฟเวอร์ของสำนักงาน สำหรับการใช้งาน Compose เพียงครั้งเดียว การเชื่อมต่อแบบอ่านอย่างเดียวมักเป็นตัวเลือกที่ง่ายที่สุด รูปภาพที่กำหนดเองนั้นง่ายต่อการสร้างซ้ำในกลุ่มเซิร์ฟเวอร์ที่ได้รับการจัดการ ในขณะที่การกำหนดค่าแบบอักษรจากระยะไกลสามารถรวมศูนย์การส่งมอบได้หากคุณสามารถดำเนินการได้อย่างปลอดภัย

ไดเร็กทอรีฟอนต์ที่แน่นอนอาจแตกต่างกันไปตามอิมเมจและเวอร์ชัน การใช้งาน Helm เวอร์ชันปัจจุบันของ Collabora จะติดตั้งฟอนต์แบบกำหนดเองไว้ที่ทั้งสอง/usr/share/fonts/customตำแหน่ง/opt/cool/systemplate/usr/share/fonts/customนี่เป็นข้อมูลอ้างอิงที่มีประโยชน์สำหรับสองตำแหน่งนี้ แต่ไม่ใช่การรับประกันสำหรับแท็ก Docker แบบสแตนด์อโลนทุกแท็ก ตรวจสอบเส้นทางในอิมเมจที่คุณใช้งานจริงก่อนที่จะปรับใช้ตัวอย่างด้านล่าง

วิธีการติดตั้งฟอนต์แบบใดที่เหมาะสมกับการใช้งานของคุณ?

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

หากคุณติดตั้ง Collabora โดยใช้ Helm chart ก่อนอื่นให้ตรวจสอบการตั้งค่าของ chart นั้นdeployment.customFonts: chart ต้นทางมีตัวเลือกการเมานต์ฟอนต์แบบกำหนดเองอยู่แล้ว สำหรับการตั้งค่า Docker Compose แบบสแตนด์อโลน ให้ดำเนินการต่อด้วยการเมานต์แบบ bind หากเส้นทางของอิมเมจตรงกัน

ตรวจสอบเทมเพลตการปรับใช้ Helm ต้นทางและตำแหน่งการติดตั้งฟอนต์ทั้งสองตำแหน่งและตรวจสอบค่าฟอนต์แบบกำหนดเองของชาร์ต

ก่อนที่จะเปลี่ยนมาใช้ Docker คุณควรตรวจสอบอะไรบ้าง?

• รูปแบบฟอนต์:ใช้ไฟล์ฟอนต์ที่รองรับโดยการตั้งค่า Collabora ของคุณ เอกสารโครงการฟอนต์เซิร์ฟเวอร์อย่างเป็นทางการของ Collabora ระบุไฟล์ TrueType ( .ttf) และ OpenType ( ) ไว้.otf
• เงื่อนไขการใช้งาน:โปรดตรวจสอบให้แน่ใจว่าเงื่อนไขการใช้งานฟอนต์อนุญาตให้ใช้งานบนเซิร์ฟเวอร์และแจกจ่ายให้กับผู้ใช้ของคุณ ห้ามคัดลอกฟอนต์จากระบบปฏิบัติการเดสก์ท็อป เว้นแต่เงื่อนไขการใช้งานจะอนุญาตให้ทำเช่นนั้น
• ชื่อตระกูลฟอนต์:ชื่อที่แสดงในเมนูฟอนต์มาจากข้อมูลเมตาภายในของฟอนต์ ซึ่งอาจแตกต่างจากชื่อไฟล์ ทดสอบโดยใช้ชื่อตระกูลฟอนต์ ไม่ใช่แค่ชื่อไฟล์เท่านั้น
• ทุกกรณี:หากพร็อกซีส่งต่อผู้ใช้ไปยังคอนเทนเนอร์ Collabora หลายแห่ง ให้ติดตั้งไฟล์ฟอนต์เดียวกันในทุกอินสแตนซ์ มิเช่นนั้นเอกสารเดียวกันอาจแสดงผลแตกต่างกันไปขึ้นอยู่กับว่าเซิร์ฟเวอร์ใดเปิดเอกสารนั้น
• เส้นทางของอิมเมจที่ถูกต้อง:ตรวจสอบไดเร็กทอรีของอิมเมจที่กำลังทำงานและการตั้งค่าการเริ่มต้น อย่านำเส้นทางเก่ามาใช้ซ้ำโดยไม่ตรวจสอบ เช่น/opt/loolเส้นทางจากแพ็กเกจที่ไม่เกี่ยวข้อง

สร้างไดเร็กทอรีสำหรับจัดเก็บไฟล์ เช่น ไดเร็กทอรี./fontsที่อยู่ติดกับไฟล์ Compose ของคุณ แล้ววางไฟล์ที่ได้รับอนุญาตไว้.ttfใน.otfนั้น จำกัดไดเร็กทอรีนี้ให้เหลือเฉพาะฟอนต์ที่คุณต้องการแสดงผ่าน Collabora เท่านั้น

วิธีการเพิ่มฟอนต์ด้วย Docker Compose ทำอย่างไร?

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

services:
  collabora:
    volumes:
      - ./fonts:/usr/share/fonts/custom:ro
      - ./fonts:/opt/cool/systemplate/usr/share/fonts/custom:ro

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

ควรทำการเปลี่ยนแปลง Compose ในช่วงเวลาที่ไม่วุ่นวาย เนื่องจาก1การสร้างบริการ Collabora ขึ้นใหม่ อาจขัดจังหวะเซสชันการแก้ไขที่กำลังใช้งานอยู่ หากบริการของคุณมีชื่อว่า ให้collaboraเรียกใช้คำสั่ง:

docker compose up -d collabora

หากชื่อบริการ Compose ของคุณแตกต่างกัน ให้ใช้ชื่อบริการนั้นจริง ๆ หลีกเลี่ยงการรีสตาร์ทระบบทั้งหมด เว้นแต่ว่าบริการอื่น ๆ ก็จำเป็นต้องมีการเปลี่ยนแปลงการกำหนดค่าด้วยเช่นกัน

คุณจะยืนยันได้อย่างไรว่าคอนเทนเนอร์สามารถมองเห็นไฟล์ได้?

ขั้นแรก ตรวจสอบให้แน่ใจว่าไดเร็กทอรีที่เชื่อมต่อมีไฟล์ฟอนต์อยู่ แทนที่collaboraด้วยชื่อคอนเทนเนอร์ที่ใช้ในการตั้งค่าของคุณ:

docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom

การตรวจสอบไฟล์ยืนยันว่า Docker ได้ทำการเมานต์แล้ว แต่ไม่ได้พิสูจน์ว่าโปรแกรมแก้ไขได้โหลดฟอนต์แล้ว หากอิมเมจมีโปรแกรมยูทิลิตี้ Fontconfig คุณสามารถตรวจสอบชื่อตระกูลฟอนต์ที่ค้นพบได้โดยใช้คำสั่งfc-listเช่น:

docker exec collabora fc-list : family file

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

คุณทดสอบฟอนต์ใน Collabora Online อย่างไร?

1. เปิดหรือสร้างเอกสารทดสอบผ่านการเชื่อมต่อตามปกติ ซึ่งจะเปิดใช้งานโปรแกรมแก้ไข Collabora ของคุณ
2. เปิดเมนูตระกูลฟอนต์ แล้วมองหาชื่อตระกูลฟอนต์ภายในของฟอนต์นั้น
3. เลือกตัวเลือกนั้น พิมพ์ตัวอย่างสั้นๆ บันทึก ปิด แล้วเปิดเอกสารอีกครั้ง
4. หากระบบของคุณมีการใช้งาน Collabora หลายอินสแตนซ์ โปรดตรวจสอบเอกสารเดียวกันจากผู้ใช้หรือเบราว์เซอร์อื่น

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

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

เมื่อไหร่การใช้บริการภาพแบบกำหนดเองหรือบริการฟอนต์ระยะไกลจึงคุ้มค่า?

สร้างภาพที่กำหนดเองเพื่อให้สามารถใช้งานซ้ำได้

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

ใช้การกำหนดค่าฟอนต์ระยะไกลสำหรับแคตตาล็อกที่ใช้ร่วมกัน

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

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

คุณควรเลือกตัวเลือกใด?

สำหรับคอนเทนเนอร์ CODE หนึ่งตัวที่จัดการด้วย Docker Compose ให้เริ่มต้นด้วยการเชื่อมต่อแบบอ่านอย่างเดียว (read-only bind mount): วิธีนี้ง่ายต่อการย้อนกลับและไม่จำเป็นต้องสร้างแบบกำหนดเอง สำหรับกลุ่มคอนเทนเนอร์ที่ดูแลผ่าน CI/CD ควรเลือกใช้ภาพแบบกำหนดเองเมื่อคุณต้องการให้การปรับใช้แต่ละครั้งมีชุดฟอนต์ที่ชัดเจนและตรวจสอบได้ พิจารณาการกำหนดค่าฟอนต์ระยะไกลเฉพาะเมื่อการกระจายส่วนกลางเป็นประโยชน์ในการดำเนินงานอย่างมีนัยสำคัญและคุณสามารถให้บริการ HTTPS ที่ปลอดภัยและเชื่อถือได้ ในทุกกรณี ให้ตรวจสอบเส้นทางและทดสอบฟอนต์ในเอกสารจริงหลังจากการปรับใช้ รายชื่อฟอนต์ของโฮสต์เพียงอย่างเดียวไม่สามารถยืนยันได้ว่า Collabora โหลดฟอนต์นั้นแล้ว