การปรับใช้ด่วน

ภาพรวมหน้านี้

เหมาะสำหรับเหมาะกับการลองใช้งานด่วน สภาพแวดล้อมสาธิต การปรับใช้ขนาดเล็ก และการตรวจสอบสภาพแวดล้อมพื้นฐานก่อนส่งมอบรุ่นเชิงพาณิชย์

ข้อกำหนดเบื้องต้นเตรียมเซิร์ฟเวอร์ Linux หนึ่งเครื่อง และยืนยันว่า Docker, Docker Compose, การเข้าถึงเครือข่าย และพอร์ตทางธุรกิจพร้อมใช้งาน

ผลลัพธ์บริการแบ็กเอนด์, ฟรอนต์เอนด์, MySQL, Redis, EMQX ของ FastBee เริ่มทำงาน และเข้าสู่ระบบแพลตฟอร์มได้

จุดตรวจรับหน้าแพลตฟอร์มเข้าถึงได้ บัญชีเริ่มต้นเข้าสู่ระบบได้ สถานะคอนเทนเนอร์ปกติ และพอร์ตคอนโซล MQTT กับ EMQX เชื่อมต่อได้

ทางเข้าการปรับใช้และขั้นตอนขั้นต่ำ

1. ยืนยันระบบเซิร์ฟเวอร์, Docker, Docker Compose, การเปิดพอร์ต, ใบรับรองใบอนุญาต และแพ็กเกจติดตั้งก่อน
2. สำหรับการลองใช้งานด่วน ให้ใช้สคริปต์แบบคลิกเดียวก่อน สำหรับสภาพแวดล้อมส่งมอบหรือพัฒนาต่อยอด แนะนำใช้วิธี docker-compose เพื่อแทนที่ jar แบ็กเอนด์และไฟล์สแตติกฟรอนต์เอนด์ได้สะดวก
3. หลังบริการเริ่มทำงาน ให้ตรวจรับตามลำดับ: คอนเทนเนอร์ ล็อกแบ็กเอนด์ ฐานข้อมูล แคช MQTT หน้าเว็บ และหน้าใบอนุญาต
4. สุดท้าย ใช้ MQTTX ทดสอบเส้นทางผลิตภัณฑ์ อุปกรณ์ การรายงาน และการส่งคำสั่งลงให้สำเร็จ เพื่อยืนยันว่าสภาพแวดล้อมการปรับใช้รองรับธุรกิจจริงได้

การตรวจสอบก่อนปรับใช้

• เซิร์ฟเวอร์เปิดพอร์ตทางธุรกิจแล้ว เช่น 80, 1883, 8083, 5061, 30000-30100/tcp/udp
• ก่อนปรับใช้รุ่นเชิงพาณิชย์ ต้องเตรียมใบรับรองใบอนุญาตและรหัสผ่านการติดตั้ง และยืนยันว่าต้องกำหนดค่าข้อมูลใบอนุญาตหลังปรับใช้เสร็จ
• เมื่อปรับใช้ใหม่หลังพัฒนาต่อยอด ให้ยืนยันก่อนว่าแพ็กเกจ jar แบ็กเอนด์และไดเรกทอรีฟรอนต์เอนด์ vue ใต้ /var/data เป็นเวอร์ชันล่าสุด

提示

• หลังปรับใช้รุ่นเชิงพาณิชย์เสร็จ ให้เข้าสู่ระบบ จากหน้าแรกต้องกำหนดค่าข้อมูลใบอนุญาต (ภาษาจีน)ก่อนจึงจะใช้งานได้ตามปกติ
• การปรับใช้ใหม่หลังพัฒนาต่อยอด เพียงแทนที่แพ็กเกจ fastbee-admin.jar และเนื้อหาในไดเรกทอรี vue ใต้ /var/data

1. สคริปต์ปรับใช้ด่วน

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

sudo wget -c https://hub.fastbee.cn/resource/install.sh && bash ./install.sh

ข้อควรระวัง:

• สคริปต์มีทั้งรุ่นโอเพนซอร์สและรุ่นเชิงพาณิชย์ รุ่นเชิงพาณิชย์สำหรับผู้ใช้ที่ได้รับอนุญาตเท่านั้น การติดตั้งต้องใช้รหัสผ่านและใบรับรอง (ติดต่อฝ่ายบริการลูกค้าเพื่อขอรับ)
• การดาวน์โหลดไฟล์ระหว่างปรับใช้ใช้เวลาพอสมควร ระหว่างติดตั้งแนะนำใช้อิมเมจ Docker อย่างเป็นทางการ สคริปต์จะกำหนดค่าตัวเร่งอิมเมจโดยอัตโนมัติ ความเร็วจะค่อนข้างเร็ว
• เซิร์ฟเวอร์ต้องเปิดพอร์ตที่เกี่ยวข้อง (เช่น 80, 1883, 8083, 5061, 30000-30100/tcp/udp และอื่น ๆ)

2. การปรับใช้ด่วนด้วย docker-compose

การปรับใช้ด้วย docker-compose ต้องติดตั้ง docker และ docker-compose บนเซิร์ฟเวอร์ก่อน

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

1. อัปโหลดไฟล์

อัปโหลดโฟลเดอร์ docker/data/ จาก รีโพซิทอรี FastBee ไปยังไดเรกทอรี /var/ บนเซิร์ฟเวอร์หรือเครื่องในเครือข่ายก่อน สำหรับรุ่นเชิงพาณิชย์ต้องบรรจุแบ็กเอนด์และฟรอนต์เอนด์ใหม่ แบ็กเอนด์อัปโหลดไปยังไดเรกทอรี /var/data/java/ เพื่อแทนที่ไฟล์ jar ส่วนฟรอนต์เอนด์อัปโหลดไปยังไดเรกทอรี /var/data/nginx/vue/ เพื่อแทนที่เนื้อหาภายใน

2. เริ่มปรับใช้

เข้าไปยังไดเรกทอรี /var/data/ บนเซิร์ฟเวอร์หรือเครื่องในเครือข่าย แล้วรัน: docker-compose up -d รอจนทำงานเสร็จก็ปรับใช้เสร็จสมบูรณ์

3. เข้าถึงระบบ

• หลังปรับใช้เสร็จ เข้าถึงแพลตฟอร์ม IoT FastBee ผ่านที่อยู่เซิร์ฟเวอร์ บัญชีเริ่มต้น admin admin123
• การปรับใช้ใช้ emqx เข้าถึงคอนโซล EMQX ได้ผ่านพอร์ต 18083 บัญชีและรหัสผ่านเริ่มต้น admin admin123

提示

• การปรับใช้โปรเจกต์ใหม่ในภายหลัง เพียงแทนที่ไฟล์ fastbee-admin.jar และเนื้อหาในไดเรกทอรี vue

• คอนเทนเนอร์ mysql ต้องใช้เวลาเริ่มต้น หากแบ็กเอนด์แจ้งข้อผิดพลาด สามารถรัน docker restart java เพื่อรีสตาร์ทแบ็กเอนด์
• บัญชีเริ่มต้นของการปรับใช้ด่วน:
  • ผู้ดูแลระบบ: admin admin123
  • mysql: root fastbee
  • redis: fastbee
  • คอนโซล emqx: admin admin123
  • TDengine: root taosdata
  • SIP: 12345678
  • การตรวจสอบแหล่งข้อมูล: fastbee fastbee

4. คำสั่งที่ใช้บ่อยระหว่างปรับใช้

# ดึงอิมเมจของบริการล่วงหน้าได้ เวลาขึ้นกับเครือข่าย สามารถกำหนดค่าให้ docker ใช้มิเรอร์ในประเทศจีน
docker-compose pull
# สร้างและเริ่มคอนเทนเนอร์ของบริการ
docker-compose up -d  
# หยุดและลบคอนเทนเนอร์ของบริการ
docker-compose down   
# สร้างโฟลเดอร์ data
mkdir /var/data
# กำหนดสิทธิ์อ่าน เขียน และเรียกใช้ให้โฟลเดอร์
sudo chmod 777 /var/data

5. การกำหนดค่าตัวเร่งอิมเมจ Docker

รันคำสั่งตามขั้นตอนต่อไปนี้เพื่อกำหนดค่าตัวเร่งอิมเมจ ที่อยู่มิเรอร์อิมเมจ Docker รวบรวมจากเครือข่าย สามารถเพิ่มหรือลบตามความเหมาะสม

# 1. หยุดบริการ Docker
sudo systemctl stop docker

# 2. หากไฟล์ไม่มีอยู่ ให้สร้างใหม่
sudo mkdir -p /etc/docker

# 3. แก้ไขไฟล์กำหนดค่าของ Docker
sudo tee /etc/docker/daemon.json <<-EOF
{
    "registry-mirrors": [
        "https://mirrors.ustc.edu.cn",
        "https://docker.chenby.cn",
        "http://mirror.azure.cn",
        "https://dockerpull.org",
        "https://dockerhub.icu",
        "https://hub.rat.dev",
        "https://dockerproxy.com",
        "https://mirror.baidubce.com",
        "https://docker.m.daocloud.io",
        "https://docker.nju.edu.cn",
        "https://docker.mirrors.sjtug.sjtu.edu.cn",
        "https://docker.rainbond.cc",
        "https://mirror.ccs.tencentyun.com",
        "https://registry.docker-cn.com",
        "https://hub-mirror.c.163.com",
        "https://docker.1ms.run", 
        "https://doublezonline.cloud", 
        "https://dislabaiot.xyz", 
        "https://docker.fxxk.dedyn.io", 
        "https://docker.unsee.tech", 
        "https://docker.1panel.live", 
        "https://docker.nastool.de", 
        "https://docker.zhai.cm", 
        "https://docker.5z5f.com", 
        "https://a.ussh.net", 
        "https://docker.udayun.com", 
        "https://hub.geekery.cn",
        "https://noohub.ru", 
        "https://huecker.io",
        "https://dockerhub.timeweb.cloud",
        "https://0c105db5188026850f80c001def654a0.mirror.swr.myhuaweicloud.com",
        "https://5tqw56kt.mirror.aliyuncs.com",
        "https://docker.ckyl.me/",
        "https://docker.hpcloud.cloud"
    ]
}
EOF

# 5. เริ่มบริการ Docker ใหม่
sudo systemctl daemon-reload
sudo systemctl start docker

3. การตรวจสอบผลการปรับใช้

หลังปรับใช้เสร็จ ไม่แนะนำให้ดูแค่ว่าหน้าเว็บเปิดได้หรือไม่ แนะนำให้ตรวจรับแบบสมบูรณ์ตามลำดับ "คอนเทนเนอร์ แบ็กเอนด์ ฐานข้อมูล แคช MQTT หน้าธุรกิจ"

1. สถานะคอนเทนเนอร์

cd /var/data
docker-compose ps
docker ps

คอนเทนเนอร์หลักทั้งหมดควรอยู่ในสถานะกำลังทำงาน หากคอนเทนเนอร์ java, mysql, redis, emqx หรือ nginx รีสตาร์ทซ้ำ ๆ ให้ดูล็อกของตัวนั้นก่อน

docker logs -n 200 java
docker logs -n 200 mysql
docker logs -n 200 redis
docker logs -n 200 emqx
docker logs -n 200 nginx

2. บริการแบ็กเอนด์

docker logs -n 300 java

โดยเฉพาะยืนยันว่าไม่มีข้อผิดพลาดต่อไปนี้ปรากฏอย่างต่อเนื่อง:

• เชื่อมต่อฐานข้อมูลไม่สำเร็จ
• การยืนยันตัวตน Redis ล้มเหลว
• อ่านใบรับรองใบอนุญาตไม่สำเร็จ
• พอร์ตถูกใช้งาน
• เริ่มต้น SQL ไม่สำเร็จ
• เชื่อมต่อฐานข้อมูลอนุกรมเวลาไม่สำเร็จ

หาก MySQL เริ่มต้นช้า หลังแบ็กเอนด์เริ่มครั้งแรกล้มเหลว สามารถรอ 1-2 นาทีแล้วรีสตาร์ทใหม่:

docker restart java

3. หน้าเว็บ

เปิดในเบราว์เซอร์:

http://server-ip/

บัญชีเริ่มต้น:

ผู้ใช้	รหัสผ่าน
admin	admin123

หลังเข้าสู่ระบบ เปิดหน้าต่อไปนี้อย่างน้อยเพื่อยืนยันว่าอินเทอร์เฟซใช้งานได้:

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

4. บริการ MQTT

ที่อยู่คอนโซล EMQX:

http://server-ip:18083/

บัญชีเริ่มต้น:

ผู้ใช้	รหัสผ่าน
admin	admin123

หลังเข้าสู่คอนโซล ยืนยันว่า listener ทำงานปกติ จากนั้นสามารถทำตาม วงปิดสมบูรณ์จากผลิตภัณฑ์ถึงอุปกรณ์ (ภาษาจีน) เพื่อสร้างการเชื่อมต่อด้วย MQTTX

5. การตรวจสอบธุรกิจขั้นต่ำ

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

1. สร้างผลิตภัณฑ์ใหม่
2. กำหนด Thing Model
3. เผยแพร่ผลิตภัณฑ์
4. สร้างอุปกรณ์ใหม่
5. เชื่อมต่อแพลตฟอร์มด้วย MQTTX
6. รายงานข้อมูลคุณสมบัติ
7. แพลตฟอร์มส่งคำสั่งลง

ขั้นตอนฉบับสมบูรณ์ดูที่ วงปิดสมบูรณ์จากผลิตภัณฑ์ถึงอุปกรณ์ (ภาษาจีน)

4. บทแนะนำ Docker

Docker เป็นเอนจินคอนเทนเนอร์แอปพลิเคชันโอเพนซอร์ส ช่วยให้นักพัฒนาบรรจุแอปพลิเคชันและแพ็กเกจที่ต้องพึ่งพาลงในอิมเมจที่เบาและย้ายได้ แล้วเผยแพร่ไปยังเครื่องระบบปฏิบัติการ Linux หรือ Windows ยอดนิยมใดก็ได้ และยังทำเวอร์ชวลไลเซชันได้อีกด้วย คอนเทนเนอร์ใช้กลไกแซนด์บ็อกซ์โดยสมบูรณ์ ไม่มีอินเทอร์เฟซระหว่างกัน (คล้ายแอปบน iPhone) ที่สำคัญกว่านั้น คอนเทนเนอร์ใช้ทรัพยากรเพียงเล็กน้อย

1. ติดตั้ง Docker

提示

• อิมเมจ Docker ดึงจากรีจิสทรีอย่างเป็นทางการโดยค่าเริ่มต้น หากดาวน์โหลดช้า สามารถกำหนดค่าเป็นรีจิสทรีมิเรอร์ในประเทศจีนได้ บทแนะนำอ้างอิง
• การติดตั้ง Desktop มีทั้ง docker engine และ docker compose ในตัว เซิร์ฟเวอร์โดยทั่วไปติดตั้ง docker engine และ docker compose แยกกัน

ติดตั้ง Docker บน Linux

• Docker Desktop (ใช้ในเครื่อง)
• Docker Engine (ใช้บนเซิร์ฟเวอร์)
• ติดตั้ง Docker Compose

ติดตั้ง Docker Desktop บน Windows

• บทแนะนำอ้างอิง (ภาษาจีน) (แนะนำติดตั้งระบบย่อย WSL และ Windows Terminal ก่อน แล้วจึงติดตั้ง Docker)
• บทแนะนำการติดตั้ง Docker

ติดตั้ง Docker Desktop บน Mac

• บทแนะนำการติดตั้ง Docker

2. คำสั่ง Docker ที่ใช้บ่อย

docker -v                                # ดูเวอร์ชัน docker ตรวจสอบว่าติดตั้งสำเร็จหรือไม่
docker ps                                # ดูคอนเทนเนอร์ที่กำลังทำงาน
docker ps -a                             # ดูคอนเทนเนอร์ทั้งหมด
docker images                            # ดูอิมเมจในเครื่อง
docker info                              # ดูข้อมูลระดับระบบของ docker
docker pull [image]                      # ดึงอิมเมจ
docker run  [image]                      # รันอิมเมจ
docker restart  [container]              # รีสตาร์ทคอนเทนเนอร์
docker stop [container]                  # หยุดคอนเทนเนอร์
docker stats [container]                 # ดูการใช้ทรัพยากรของคอนเทนเนอร์
docker inspect [container]               # ดูเมทาดาทาของคอนเทนเนอร์
docker logs -n 1000 [container]          # ดูล็อก 1000 บรรทัดแรกของคอนเทนเนอร์
docker exec -it [container] /bin/bash    # เข้าไปภายในคอนเทนเนอร์ที่กำลังทำงาน
docker save nginx:latest > nginx.tar     # บันทึกอิมเมจเดียว
docker load -i nginx.tar                 # โหลดอิมเมจจากไฟล์ tar

docker network create -d bridge fastbee-bridge         # สร้างเครือข่ายใหม่ชื่อ fastbee-bridge
docker network ls                                      # แสดงเครือข่ายทั้งหมด
docker network connect fastbee-bridge test             # เพิ่มคอนเทนเนอร์ test เข้าเครือข่ายที่กำหนดเอง
docker inspect fastbee-bridge                          # ดูคอนเทนเนอร์ในเครือข่าย fastbee-bridge

3. โหมดเครือข่าย Docker

Docker มี 5 โหมดเครือข่าย สามารถระบุโหมดเครือข่ายของคอนเทนเนอร์ด้วย --net=***

โหมด bridge     # ค่าเริ่มต้น เมื่อภายนอกเข้าถึงบริการในคอนเทนเนอร์ ต้องเข้าถึง IP ของโฮสต์และพอร์ตของโฮสต์
โหมด host       # ที่อยู่ IP ของคอนเทนเนอร์คือที่อยู่ IP ของโฮสต์
โหมด container  # คอนเทนเนอร์จะแชร์สภาพแวดล้อมเครือข่ายของคอนเทนเนอร์อื่น
โหมด overlay    # การสื่อสารข้ามโฮสต์
โหมด none       # ไม่สร้างสภาพแวดล้อมเครือข่ายให้คอนเทนเนอร์ คอนเทนเนอร์ใช้ได้เฉพาะเครือข่ายในเครื่อง 127.0.0.1

4. บริดจ์เครือข่าย Docker

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

docker network create -d bridge fastbee-bridge

5. คำสั่ง docker-compose ที่ใช้บ่อย

docker-compose -v        # ดูเวอร์ชัน docker-compose ตรวจสอบว่าติดตั้งสำเร็จหรือไม่
docker-compose up -d     # สร้างและเริ่มคอนเทนเนอร์ของบริการ
docker-compose down      # หยุดและลบคอนเทนเนอร์ของบริการ
docker-compose ps        # แสดงรายการคอนเทนเนอร์ทั้งหมดในบริการ
docker-compose start     # เริ่มคอนเทนเนอร์ในบริการ
docker-compose stop      # หยุดคอนเทนเนอร์ที่กำลังทำงานในบริการ
docker-compose restart   # รีสตาร์ทคอนเทนเนอร์ในบริการ
docker-compose logs      # ดูเอาต์พุตของคอนเทนเนอร์ในบริการ
docker-compose pull      # ดึงอิมเมจที่บริการต้องพึ่งพา
docker-compose config    # ตรวจสอบและดูการกำหนดค่าไฟล์ compose

5. เอกสารที่เกี่ยวข้อง

• วงปิดสมบูรณ์จากผลิตภัณฑ์ถึงอุปกรณ์ (ภาษาจีน)
• การดูแลระบบ (ภาษาจีน)
• คู่มือการอัปเกรด (ภาษาจีน)
• การรองรับหลายแหล่งข้อมูล (ภาษาจีน)
• ฐานข้อมูลอนุกรมเวลา (ภาษาจีน)