ติดตั้งแพลตฟอร์มใหม่

หน้านี้อธิบายการติดตั้งแพลตฟอร์มใหม่ตั้งแต่ต้นจนลงชื่อเข้าใช้ได้ ถ้าเป็นแพลตฟอร์ม v4 เดิม ให้ไปที่อัปเกรดจาก v4

ก่อนเริ่มคัดลอกลิงก์ของหัวข้อ

• Docker, Docker Compose และ curl (สิ่งที่ต้องมี)
• ชื่อผู้ใช้และรหัสผ่านของ registry ที่ได้จาก aWhere
• ที่อยู่เว็บที่ผู้ใช้จะเปิด เช่น https://app.example.com

ติดตั้งคัดลอกลิงก์ของหัวข้อ

1. ติดตั้ง aWhere CLI

   คัดลอกข้อความ

   curl -fsSL https://docs.awhere.online/install.sh | sh -s -- 5.0.0

2. สร้างแพลตฟอร์ม คำสั่งนี้จะถามข้อมูลทีละข้อ สร้างรหัสผ่านและ secret ที่ระบบต้องใช้ให้ทั้งหมด รัน Preflight แล้วจึง deploy

   คัดลอกข้อความ

   awhere setup

   ถ้ารันจากสคริปต์ ให้ส่งคำตอบเป็น flag แทน เช่น awhere setup --yes --url https://app.example.com

3. ตรวจว่าทุกคอนเทนเนอร์พร้อมแล้ว

   คัดลอกข้อความ

   awhere status

   ถ้าพร้อมครบจะเห็นข้อความนี้

   คัดลอกข้อความ

   ✓ all N components are ready

4. เปิด https://app.example.com/ จะเห็นหน้าแรกของแพลตฟอร์ม (Portal) ซึ่งตอนนี้แสดงแค่ชื่อและปุ่ม เข้าสู่ระบบ เพราะการเข้าถึงสาธารณะปิดอยู่

5. เปิด https://app.example.com/configuration/ แล้วลงชื่อเข้าใช้ด้วยบัญชีผู้ดูแลระบบที่ตั้งไว้ตอนติดตั้ง

จากนั้นเปิดหน้า ระบบ ใน Configuration ทุกโหนดควรขึ้นว่า พร้อมใช้งาน และทุก migration ควรขึ้นว่า เสร็จแล้ว ถ้าไม่ใช่ ให้ดูแก้ปัญหา

สร้างผู้ดูแลระบบคนแรกคัดลอกลิงก์ของหัวข้อ

แพลตฟอร์มใหม่ยังไม่มีผู้ใช้และไม่มีรหัสผ่านตั้งต้น ดังนั้นก่อนเริ่มติดตั้ง awhere setup จะถามชื่อผู้ใช้ของผู้ดูแลระบบ ถ้าไม่ใส่จะใช้ admin แล้วให้ตั้งรหัสผ่านยาวอย่างน้อย 8 ตัวอักษร โดยพิมพ์สองครั้ง

ถ้ากด Enter โดยไม่พิมพ์รหัสผ่าน ระบบจะสร้างรหัสผ่านให้ และแสดงตอนติดตั้งเสร็จเพียงครั้งเดียว ต้องจดไว้ทันที เพราะระบบไม่ได้บันทึกรหัสผ่านนี้ไว้ที่ไหนเลย

ถ้ารันจากสคริปต์ด้วย --yes ให้ส่งรหัสผ่านผ่านตัวแปร AWHERE_ADMIN_PASSWORD และใส่ชื่อผู้ใช้แทน <username>

read -rs AWHERE_ADMIN_PASSWORD && export AWHERE_ADMIN_PASSWORD
awhere setup --yes --url https://app.example.com --admin-username <username>

ถ้าแพลตฟอร์มมีผู้ดูแลระบบอยู่แล้ว เช่น แพลตฟอร์มที่ย้ายมาจาก v4 ขั้นตอนนี้จะไม่แก้อะไร ถ้า setup สร้างผู้ดูแลระบบไม่สำเร็จ แพลตฟอร์มก็ยังทำงานตามปกติ ให้รัน awhere admin ภายหลัง (จากสคริปต์ใช้ awhere admin --username <username> --yes)

หลังลงชื่อเข้าใช้แล้ว เปลี่ยนรหัสผ่านได้ที่ จัดการบัญชีของคุณ (เปลี่ยนรหัสผ่าน) และเพิ่มผู้ใช้คนอื่นได้ที่หน้า ผู้ใช้งาน (ผู้ใช้งาน)

ถ้าใช้ Apple Containerคัดลอกลิงก์ของหัวข้อ

ถ้าใช้ Docker ข้ามส่วนนี้ได้เลย

ขั้นตอนเหมือน Docker ทุกอย่าง ต่างกันแค่นี้

• รัน container system start ก่อน awhere setup
• ไม่มี proxy มาให้ ต้องตั้งเอง (proxy ของคุณเอง)
• ต้องติดตั้ง watchdog ตามหัวข้อด้านล่าง

ให้แพลตฟอร์มกลับมาทำงานเองหลังรีบูตเครื่องคัดลอกลิงก์ของหัวข้อ

Apple Container ไม่มี restart policy จึงต้องติดตั้ง watchdog ไว้หนึ่งครั้ง watchdog จะคอยเริ่มคอนเทนเนอร์ที่หยุดไปให้ใหม่

awhere watchdog install

ลบแพลตฟอร์มคัดลอกลิงก์ของหัวข้อ

คำสั่ง awhere teardown จะลบคอนเทนเนอร์ volume และไฟล์ทั้งหมดของแพลตฟอร์มนี้ ถ้าต้องการเก็บข้อมูลและ secret ไว้ ให้ใช้ awhere teardown --keep-data