วิธีการติดตั้ง ownCloud Infinite Scale ด้วย Docker Compose บน Ubuntu

คุณทำการติดตั้ง Docker Compose เสร็จแล้ว รันคำสั่งdocker compose up -dแต่ก็ยังไม่สามารถเข้าถึง ownCloud ได้ นี่คือรูปแบบความล้มเหลวที่พบบ่อยที่สุดในทางปฏิบัติของ Infinite Scale: คอนเทนเนอร์อาจมีอยู่ แต่ DNS, TLS, เส้นทางจัดเก็บข้อมูล หรือค่าสภาพแวดล้อมที่จำเป็นบางอย่าง ทำให้ไม่สามารถใช้งานสแต็กได้

คู่มือนี้ใช้แนวทาง Docker Compose ที่เน้นการใช้งานจริงตามที่ ownCloud ได้บันทึกไว้สำหรับการใช้งานบนเซิร์ฟเวอร์เดียว หน้าเอกสารปัจจุบันของ ownCloud เผยแพร่ภายใต้เอกสารการพัฒนาเวอร์ชัน 9.0 แต่ระบุไว้อย่างชัดเจนว่าตัวอย่างการใช้งานจริงที่ดาวน์โหลดได้นั้นใช้เวอร์ชันเสถียรล่าสุดและปัจจุบันชี้ไปยังสาขาเวอร์ชันเสถียร 8.2 ความแตกต่างนี้มีความสำคัญ: อย่าคัดลอกแท็กอิมเมจสำหรับการพัฒนาไปยังเซิร์ฟเวอร์สำหรับการใช้งานจริง เว้นแต่คุณต้องการใช้เวอร์ชันสำหรับการพัฒนาโดยตั้งใจ

การตั้งค่าด้านล่างนี้เหมาะสมสำหรับการใช้งานในบ้านและองค์กรขนาดเล็กที่ต้องการใช้งาน Infinite Scale เพียงหนึ่งอินสแตนซ์อยู่เบื้องหลัง Reverse Proxy โดยใช้ HTTPS โดยสมมติว่าใช้ Ubuntu LTS, Docker Engine, ปลั๊กอิน Docker Compose, โดเมนที่คุณควบคุม และสิทธิ์การเข้าถึงระดับผู้ดูแลระบบบนเซิร์ฟเวอร์ ตัวอย่างการใช้งานจริงของ ownCloud แนะนำให้ใช้ RAM ประมาณ 4–6 GB สำหรับบริการที่เปิดใช้งานตามค่าเริ่มต้น และต้องมีโดเมน ownCloud เป็นอย่างน้อย ส่วนการผสานรวมกับ Office ที่เป็นตัวเลือกนั้นจำเป็นต้องมีโดเมนย่อยของตนเอง

ก่อนเริ่มต้น: แก้ปัญหาเรื่องเครือข่ายและพื้นที่จัดเก็บข้อมูลก่อน

อย่าเริ่มด้วยการดาวน์โหลดไฟล์ Compose ก่อนอื่นให้ตรวจสอบรายการที่แก้ไขได้ยากที่สุดหลังจากที่ระบบเริ่มทำงานแล้ว:

• DNS:ชื่อโฮสต์ที่คุณเลือก เช่นocis.example.comจะต้องสามารถแปลงเป็นที่อยู่ IP สาธารณะของเซิร์ฟเวอร์ได้
• ไฟร์วอลล์และ NAT:การติดตั้งที่เชื่อมต่อกับอินเทอร์เน็ตจำเป็นต้องมีพอร์ต TCP 80 และ 443 ที่สามารถเข้าถึงได้สำหรับพร็อกซีแบบย้อนกลับและการรับส่งใบรับรอง โดยปกติแล้วจำเป็นต้องใช้ SSH บนพอร์ต TCP 22 สำหรับการดูแลระบบ
• พื้นที่จัดเก็บข้อมูลถาวร:วอลุ่มที่จัดการโดย Docker นั้นสะดวก แต่ระบบที่ใช้งานจริงมักได้รับประโยชน์จากการกำหนดเส้นทางที่ชัดเจนสำหรับข้อมูลการกำหนดค่าและข้อมูลผู้ใช้ เพื่อให้การสำรองข้อมูลและการวางแผนความจุทำได้ง่ายขึ้น
• ผู้ส่งอีเมล:ต้องตั้งค่าตามตัวอย่างที่ระบุไว้ในเอกสารของ ownCloud SMTP_SENDERแม้ว่าคุณจะยังไม่ได้กำหนดค่าการส่งต่อ SMTP ที่ใช้งานได้ก็ตาม

ข้อกำหนดเหล่านี้มีบันทึกไว้ในคู่มือการติดตั้งเซิร์ฟเวอร์ ownCloud Infinite Scale อย่างเป็นทางการ สำหรับ Docker เอง ให้ใช้คำแนะนำการติดตั้ง Ubuntu Engineและคำแนะนำปลั๊กอิน Compose เวอร์ชัน ปัจจุบันของ Docker แทนที่จะใช้แพ็คเกจเวอร์ชันเก่ากว่า

1. ตรวจสอบ Docker และ Docker Compose

บนเซิร์ฟเวอร์ ให้ทำการอัปเดตระบบปฏิบัติการก่อน จากนั้นตรวจสอบว่า Docker Engine และปลั๊กอิน Compose พร้อมใช้งานแล้ว:

sudo apt-get update && sudo apt-get upgrade
docker --version
docker compose version

ประเด็นสำคัญไม่ใช่หมายเลขเวอร์ชันเฉพาะที่แสดงโดยคำสั่งเหล่านี้ คุณกำลังยืนยันว่าคำสั่งทั้งสองทำงานได้สำเร็จและ Compose พร้อมใช้docker composeงาน คู่มือของ ownCloud แนะนำให้ติดตั้ง Docker จากที่เก็บของ Docker เอง แทนที่จะพึ่งพาแพ็กเกจ Docker ที่ฝังอยู่ใน Ubuntu ซึ่งอาจล้าหลังได้

2. ดาวน์โหลดตัวอย่าง Compose เวอร์ชันเสถียรอย่างเป็นทางการ

ownCloud มีตัวอย่างการปรับใช้ Compose แบบเต็มรูปแบบ แทนที่จะให้ผู้ดูแลระบบสร้างระบบใช้งานจริงขึ้นมาเองทั้งหมด ณ เวลาที่ตรวจสอบ เอกสารระบุว่าการดาวน์โหลดเวอร์ชันใช้งานจริงในปัจจุบันนั้นอิงตามstable-8.2สาขา เนื่องจากเอกสารเวอร์ชัน 9.0 ยังคงถูกระบุว่าเป็นเวอร์ชันสำหรับการพัฒนาอยู่

ขั้นตอนการทำงานอย่างเป็นทางการจะดาวน์โหลดdeployments/examples/ocis_fullไดเร็กทอรี ถ่ายโอนไฟล์เก็บถาวรที่ได้ไปยังเซิร์ฟเวอร์ และแตกไฟล์ไปยังพาธเช่น/opt/compose/ocis/ocis_full<ชื่อไฟล์เก็บถาวร> ชื่อไฟล์เก็บถาวรที่แน่นอนอาจเปลี่ยนแปลงได้ในเวอร์ชันเสถียร ดังนั้นให้ใช้ลิงก์ดาวน์โหลดที่แสดงในเอกสาร ownCloud ฉบับปัจจุบันแทนการกำหนดชื่อไฟล์แบบตายตัวจากคู่มือฉบับเก่า

หลังจากแตกไฟล์แล้ว ให้เปลี่ยนไปยังไดเร็กทอรีการติดตั้งและตรวจสอบเนื้อหา:

cd /opt/compose/ocis/ocis_full
ls -la

คุณควรจะเห็นไฟล์ Compose, ไดเร็กทอรีการกำหนดค่า และ.envไฟล์ที่ให้มาในตัวอย่าง หากคุณกำลังอัปเดตตัวอย่างที่แตกไฟล์ไว้แล้ว โปรดสำรองข้อมูล.envตัวแรกไว้ก่อน เนื่องจาก ownCloud เตือนว่าการแตกไฟล์แพ็กเกจเวอร์ชันใหม่กว่าอาจเขียนทับไฟล์เดิมได้

3. ตั้งค่าไฟล์ .env อย่างระมัดระวัง

ปัญหาเริ่มต้นส่วนใหญ่มักเกิดจากไฟล์การตั้งค่าสภาพแวดล้อม แก้ไขไฟล์.envในไดเร็กทอรีที่แตกไฟล์ออกมาแล้ว และค่อยๆ ปรับการตั้งค่าตามลำดับอย่างรอบคอบ

กำหนดให้เป็นโดเมนสาธารณะ

ตั้งค่าOCIS_DOMAINเป็นชื่อโฮสต์ที่ชี้ไปยังเซิร์ฟเวอร์อยู่แล้ว ตัวอย่างเช่นocis.example.comหากคุณเปิดใช้งาน Collabora หรือ ONLYOFFICE ให้กำหนดค่าชื่อโฮสต์ตามที่ระบุไว้ในเอกสารด้วย อย่าใช้โดเมน.envที่แตกต่างจากระเบียน DNS ของคุณ

เตรียม TLS

สำหรับการใช้งานที่เชื่อมต่อกับอินเทอร์เน็ต ตัวอย่างอย่างเป็นทางการใช้ Traefik และ Let's Encrypt ตั้งค่าTRAEFIK_ACME_MAILเป็นที่อยู่อีเมลจริงที่คุณควบคุมได้ ownCloud แนะนำให้ใช้ Let's Encrypt staging CA ก่อน เพื่อตรวจสอบว่าการออกใบรับรองใช้งานได้ จากนั้นจึงค่อยเปลี่ยนไปใช้เวอร์ชันใช้งานจริง วิธีนี้จะช่วยลดโอกาสที่จะเจอปัญหาข้อจำกัดด้านอัตราการใช้งานของ Let's Encrypt ในระหว่างการแก้ไขปัญหา

เลือกตำแหน่งที่ตั้งของข้อมูลและการตั้งค่า

หากคุณต้องการใช้พื้นที่จัดเก็บข้อมูลแบบติดตั้งบนโฮสต์ ให้ตั้งค่าOCIS_CONFIG_DIRและOCIS_DATA_DIRกำหนดเส้นทางถาวรตามที่คุณวางแผนไว้ ตรวจสอบให้แน่ใจว่าระบบไฟล์พื้นฐานมีพื้นที่เพียงพอ และกระบวนการสำรองข้อมูลของคุณครอบคลุมทั้งการกำหนดค่าและข้อมูลทั่วไป

ตั้งค่าผู้ส่ง SMTP

อย่างน้อยที่สุด ให้กำหนดค่าSMTP_SENDER. คุณสามารถเพิ่มโฮสต์ SMTP พอร์ต ชื่อผู้ใช้ รหัสผ่าน วิธีการตรวจสอบสิทธิ์ และการตั้งค่าความปลอดภัยทั้งหมดได้เมื่อคุณพร้อมที่จะส่งการแจ้งเตือน

4. ตรวจสอบความถูกต้องของการตั้งค่า Compose จากนั้นเริ่มใช้งาน Stack

ก่อนที่จะดึงและเริ่มต้นคอนเทนเนอร์ ให้ขอให้ Compose แสดงผลและตรวจสอบความถูกต้องของโครงสร้างที่ประกอบขึ้น:

docker compose config

หากวิธีนี้ไม่ได้ผล ให้แก้ไขไวยากรณ์หรือตัวแปรที่ขาดหายไปก่อนดำเนินการต่อ การตรวจสอบนี้เร็วกว่าการวินิจฉัยการติดตั้งที่เริ่มต้นไม่สมบูรณ์มาก

เมื่อการตั้งค่าแสดงผลสำเร็จแล้ว ให้เริ่มการปรับใช้ในโหมดแยกต่างหาก:

docker compose up -d

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

หากการเริ่มต้นครั้งแรกไม่สำเร็จ ให้เริ่มแก้ไขปัญหาจากง่ายที่สุดไปยากที่สุด

ตรวจสอบสถานะของคอนเทนเนอร์

เริ่มจากการแสดงผลในมุมมอง "สร้างข้อความ" แทนที่จะเดาว่าบริการใดล้มเหลว:

docker compose ps -a --format "table {{.Service}}	{{.State}}	{{.ID}}"

บริการที่หยุดทำงานซ้ำๆ นั้นมีประโยชน์มากกว่าข้อผิดพลาดของเบราว์เซอร์ เพราะมันช่วยจำกัดปัญหาให้เหลือเพียงคอนเทนเนอร์เดียว

ตรวจสอบบันทึกของ Traefik เพื่อหาปัญหาเกี่ยวกับใบรับรอง

คู่มือของ ownCloud แนะนำให้ตรวจสอบ Traefik ก่อนเป็นอันดับแรกเมื่อ HTTPS ใช้งานไม่ได้ สาเหตุทั่วไป ได้แก่ อีเมลติดต่อ ACME ไม่ถูกต้อง พอร์ต 80/443 ปิด หรือ DNS ที่แสดง NXDOMAIN หรือชี้ไปยัง IP ที่ไม่ถูกต้อง หลังจากแก้ไขปัญหา ACME แล้ว ให้ทำตามคำแนะนำอย่างเป็นทางการเพื่อลบเฉพาะวอลุ่มใบรับรองที่มีข้อมูลทดสอบที่ล้มเหลวเท่านั้น อย่าลบวอลุ่มทั้งหมด

ตรวจสอบบันทึกการใช้งานบริการ ownCloud

ค้นหา ID ของคอนเทนเนอร์ด้วยคำสั่งdocker compose psจากนั้นตรวจสอบบันทึกของคอนเทนเนอร์นั้น:

docker logs -f <container_id>

กระบวนการเริ่มต้นระบบสามารถสร้างการกำหนดค่าเริ่มต้นได้ในการเรียกใช้งานครั้งแรก เอกสาร ownCloud ได้ระบุรูปแบบคำสั่งocis init || true; ocis serverสำหรับการปรับใช้ Compose ไว้ ดังนั้นการเริ่มต้นระบบจะถูกข้ามไปหากมีการกำหนดค่าไว้แล้ว

อย่าใช้คำสั่ง docker compose down -v อย่างไม่ระมัดระวัง

หากต้องการหยุดการติดตั้ง ให้ใช้คำสั่ง:

docker compose down --remove-orphans

อย่าเพิ่ม ข้อมูลต่อ -vท้ายเว้นแต่คุณต้องการลบวอลุ่มโดยเจตนา ownCloud เตือนไว้อย่างชัดเจนว่าการทำเช่นนี้อาจลบข้อมูลการปรับใช้ หากจำเป็นต้องลบวอลุ่มใบรับรองแบบใช้แล้วทิ้งหนึ่งรายการในระหว่างการแก้ไขปัญหา TLS ให้ลบวอลุ่มนั้นแบบเลือกเฉพาะแทน

วิธีตรวจสอบว่าการติดตั้งเสร็จสมบูรณ์แล้วจริงหรือไม่

ความสำเร็จdocker compose up -dเป็นเพียงการตรวจสอบขั้นแรกเท่านั้น ตรวจสอบผลลัพธ์ในสี่ระดับ:

1. DNS:ชื่อโฮสต์สาธารณะจะแปลงเป็นที่อยู่เซิร์ฟเวอร์ที่ถูกต้อง
2. TLS:เบราว์เซอร์เข้าถึงเว็บไซต์ผ่าน HTTPS โดยไม่มีการแจ้งเตือนเกี่ยวกับใบรับรอง หากคุณจงใจใช้ CA สำหรับการทดสอบของ Let's Encrypt โปรดตรวจสอบใบรับรองสำหรับการทดสอบก่อน จากนั้นจึงเปลี่ยนไปใช้ใบรับรองสำหรับการใช้งานจริงตามที่ระบุไว้ในเอกสาร
3. คอนเทนเนอร์: docker compose ps -aแสดงสถานะของบริการที่คาดว่าจะทำงานอยู่ ไม่ใช่สถานะรีสตาร์ทหรือหยุดทำงาน
4. การใช้งาน:คุณสามารถเปิด URL ของ ownCloud ที่กำหนดค่าไว้ ลงชื่อเข้าใช้ด้วยข้อมูลประจำตัวผู้ดูแลระบบเริ่มต้นที่คุณตั้งค่าหรือเรียกคืนมา สร้างโฟลเดอร์ และอัปโหลดไฟล์ทดสอบขนาดเล็กได้

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

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

หมายเหตุการบำรุงรักษาสำหรับการใช้งานที่เสถียร

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

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