Despliegue rápido
Guía de la página
Entrada de despliegue y flujo mínimo
- Confirme primero el sistema del servidor, Docker, Docker Compose, la apertura de puertos, el certificado de licencia y el paquete de instalación.
- Para una prueba rápida, utilice preferentemente el script de un solo comando; para entornos de entrega o de desarrollo de extensiones, se recomienda el método docker-compose, que facilita la sustitución del jar del backend y de los archivos estáticos del frontend.
- Tras el arranque de los servicios, realice la verificación en este orden: contenedores, logs del backend, base de datos, caché, MQTT, página web y página de licencia.
- Por último, utilice MQTTX para completar la cadena de producto, dispositivo, reporte y envío de comandos, y confirme que el entorno de despliegue puede soportar el negocio real.
- El servidor tiene abiertos los puertos de negocio 80, 1883, 8083, 5061, 30000-30100/tcp/udp, entre otros.
- Antes de desplegar la edición comercial, prepare el certificado de licencia y la contraseña de instalación, y confirme que tras el despliegue será necesario configurar la información de la licencia.
- Al redesplegar tras un desarrollo de extensiones, confirme primero que el paquete jar del backend y el directorio
vuedel frontend bajo/var/datasean la versión más reciente.
提示
- Una vez completado el despliegue de la edición comercial, inicie sesión en el sistema: para usar la página de inicio es necesario primero configurar la información de la licencia (简体中文)
- Para redesplegar tras un desarrollo de extensiones, solo es necesario sustituir el paquete fastbee-admin.jar correspondiente y el contenido del directorio vue bajo el directorio
/var/data
1. Script de despliegue rápido
El script de despliegue en un solo comando está basado en Docker y requiere tener instalados docker y docker-compose. El proceso real es similar al método de despliegue con docker-compose que se muestra a continuación, integrado en un único script que completa el despliegue con un solo comando. El comando es el siguiente:
sudo wget -c https://hub.fastbee.cn/resource/install.sh && bash ./install.sh
Consideraciones:
- El script incluye las ediciones open source y comercial; la edición comercial está dirigida únicamente a usuarios con licencia, y la instalación requiere una contraseña y un certificado (solicítelos al servicio de atención al cliente)
- La descarga de archivos durante el despliegue puede llevar cierto tiempo; durante la instalación se recomienda usar las imágenes oficiales de Docker, y el script configura automáticamente la aceleración de imágenes, por lo que la velocidad será mayor
- Abra los puertos correspondientes en el servidor (por ejemplo: 80, 1883, 8083, 5061, 30000-30100/tcp/udp, etc.)
2. Despliegue rápido con docker-compose
Para desplegar con docker-compose, el servidor debe tener instalados previamente docker y docker-compose
docker-compose instala en el servidor o en local las aplicaciones y el entorno de los que depende el proyecto; siga estos pasos para completar la instalación y el despliegue:
1. Subir los archivos
Suba primero la carpeta docker/data/ del repositorio de FastBee al directorio /var/ del servidor o de su equipo local. La edición comercial requiere volver a empaquetar el backend y el frontend: el backend se sube al directorio /var/data/java/ sustituyendo el archivo jar, y el frontend se sube al directorio /var/data/nginx/vue/ sustituyendo su contenido.
2. Iniciar el despliegue
Entre en el directorio /var/data/ del servidor o de su equipo local y ejecute: docker-compose up -d ; el despliegue finaliza cuando termina la ejecución
3. Acceder al sistema
- Una vez completado el despliegue, acceda a la plataforma IoT FastBee a través de la dirección del servidor; la cuenta predeterminada es
admin admin123 - El despliegue utiliza emqx; puede acceder a la consola EMQX a través del puerto 18083, con cuenta y contraseña predeterminadas
admin admin123
提示
- Para redespliegues posteriores del proyecto, solo es necesario sustituir el archivo
fastbee-admin.jary el contenido del directoriovue - La inicialización del contenedor mysql lleva tiempo; si el backend devuelve errores, puede reiniciarlo con
docker restart java - Cuentas predeterminadas del despliegue rápido:
- Administrador del sistema: admin admin123
- mysql: root fastbee
- redis: fastbee
- Consola emqx: admin admin123
- TDengine: root taosdata
- SIP: 12345678
- Monitorización de fuentes de datos: fastbee fastbee
4. Referencia de comandos habituales durante el despliegue
# Puede descargar primero las imágenes de los servicios; el tiempo depende de la red y se puede configurar un registro de imágenes regional para docker
docker-compose pull
# Construir e iniciar los contenedores de los servicios
docker-compose up -d
# Detener y eliminar los contenedores de los servicios
docker-compose down
# Crear la carpeta data
mkdir /var/data
# Asignar permisos de lectura, escritura y ejecución a la carpeta
sudo chmod 777 /var/data5. Configuración de la aceleración de imágenes docker
Ejecute los comandos siguiendo estos pasos para completar la configuración de la aceleración de imágenes. Las direcciones de aceleración de imágenes docker se han recopilado de la red y pueden añadirse o eliminarse según las circunstancias
# 1. Detener el servicio Docker
sudo systemctl stop docker
# 2. Si el archivo no existe, créelo
sudo mkdir -p /etc/docker
# 3. Modificar el archivo de configuración de 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. Reiniciar el servicio Docker
sudo systemctl daemon-reload
sudo systemctl start docker3. Verificación del resultado del despliegue
Una vez completado el despliegue, no se recomienda limitarse a comprobar si la página se abre. Se recomienda realizar una verificación completa en el orden «contenedores, backend, base de datos, caché, MQTT, páginas de negocio».
1. Estado de los contenedores
cd /var/data
docker-compose ps
docker psTodos los contenedores principales deben estar en ejecución. Si los contenedores java, mysql, redis, emqx o nginx se reinician constantemente, consulte primero los logs correspondientes.
docker logs -n 200 java
docker logs -n 200 mysql
docker logs -n 200 redis
docker logs -n 200 emqx
docker logs -n 200 nginx2. Servicio backend
docker logs -n 300 javaConfirme especialmente que no aparezcan de forma continuada los siguientes errores:
- Fallo de conexión con la base de datos.
- Fallo de autenticación de Redis.
- Fallo de lectura del certificado de licencia.
- Puerto ocupado.
- Fallo en la inicialización SQL.
- Fallo de conexión con la base de datos de series temporales.
Si la inicialización de MySQL es lenta, después de que el primer arranque del backend falle puede esperar 1-2 minutos y reiniciarlo:
docker restart java3. Páginas web
Acceda desde el navegador a:
http://IP-del-servidor/Cuenta predeterminada:
| Usuario | Contraseña |
|---|---|
admin | admin123 |
Tras iniciar sesión, abra al menos las siguientes páginas para confirmar que las interfaces están disponibles:
| Página | Criterio de aceptación |
|---|---|
| Página de inicio | Las tarjetas de estadísticas y los menús se cargan con normalidad |
| Gestión de productos | La lista se abre y el botón de añadir funciona con normalidad |
| Gestión de dispositivos | La lista se abre y la entrada a los detalles del dispositivo funciona con normalidad |
| Gestión del sistema | Las páginas de usuarios, roles y menús se abren |
| Página de licencia | La edición comercial permite subir o consultar la información de la licencia |
4. Servicio MQTT
Dirección de la consola EMQX:
http://IP-del-servidor:18083/Cuenta predeterminada:
| Usuario | Contraseña |
|---|---|
admin | admin123 |
Tras entrar en la consola, confirme que los listeners funcionan con normalidad. A continuación, puede establecer una conexión con MQTTX siguiendo el ciclo completo del producto al dispositivo (简体中文).
5. Verificación mínima del negocio
El criterio final de aceptación del despliegue no es que los contenedores estén en ejecución, sino que la plataforma pueda completar una cadena de negocio real:
- Crear un producto.
- Definir el Thing Model.
- Publicar el producto.
- Crear un dispositivo.
- Conectar MQTTX a la plataforma.
- Reportar datos de propiedades.
- Enviar comandos desde la plataforma.
Los pasos completos están en el ciclo completo del producto al dispositivo (简体中文).
4. Tutorial de docker
Docker es un motor de contenedores de aplicaciones open source que permite a los desarrolladores empaquetar sus aplicaciones junto con sus dependencias en una imagen ligera y portátil, que luego puede publicarse en cualquier máquina con un sistema operativo Linux o Windows popular, y que también permite la virtualización. Los contenedores utilizan por completo un mecanismo de sandbox y no tienen ninguna interfaz entre sí (similar a las apps del iPhone); lo más importante es que la sobrecarga de rendimiento de los contenedores es extremadamente baja.
1. Instalación de docker
提示
- Las imágenes docker se obtienen por defecto del repositorio oficial; si la descarga es lenta, puede configurar un repositorio de imágenes regional, tutorial de referencia
- La instalación de la versión de escritorio ya incluye el motor docker y docker compose. En un servidor se suelen instalar por separado docker engine y docker compose
Instalación de docker en Linux
Instalación de docker versión de escritorio en Windows
- tutorial de referencia (se recomienda instalar el subsistema WSL y Windows Terminal, y después Docker)
- tutorial de instalación de docker
Instalación de docker versión de escritorio en Mac
2. Comandos habituales de docker
docker -v # Ver la versión de docker y comprobar si la instalación se realizó correctamente
docker ps # Ver los contenedores en ejecución
docker ps -a # Ver todos los contenedores
docker images # Ver las imágenes locales
docker info # Ver la información de nivel de sistema de docker
docker pull [image] # Descargar una imagen
docker run [image] # Ejecutar un contenedor
docker restart [container] # Reiniciar un contenedor
docker stop [container] # Detener un contenedor
docker stats [container] # Ver el uso de recursos de un contenedor
docker inspect [container] # Ver los metadatos de un contenedor
docker logs -n 1000 [container] # Ver las primeras 1000 líneas de logs de un contenedor
docker exec -it [container] /bin/bash # Entrar en el interior de un contenedor en ejecución
docker save nginx:latest > nginx.tar # Guardar una sola imagen
docker load -i nginx.tar # Cargar una imagen desde un archivo tar
docker network create -d bridge fastbee-bridge # Crear una nueva red con el nombre fastbee-bridge
docker network ls # Mostrar todas las redes
docker network connect fastbee-bridge test # Añadir el contenedor test a la red personalizada
docker inspect fastbee-bridge # Ver los contenedores de la red fastbee-bridge3. Modos de red de docker
Docker tiene 5 modos de red, que pueden especificarse con --net=*** para el contenedor.
Modo bridge # Predeterminado; para acceder a los servicios dentro del contenedor desde el exterior es necesario usar la IP del host y el puerto port del host
Modo host # La dirección IP del contenedor es la dirección IP del host
Modo container # El contenedor comparte el entorno de red de otro contenedor
Modo overlay # Comunicación entre hosts
Modo none # No se construye ningún entorno de red para el contenedor; solo puede usar la red local 127.0.0.14. Puentes de red de docker
El puente de red se utiliza para la comunicación entre contenedores; si los contenedores se ejecutan de forma independiente, es necesario crear un puente de red con el siguiente comando
docker network create -d bridge fastbee-bridge5. Comandos habituales de docker-compose
docker-compose -v # Ver la versión de docker-compose y comprobar si la instalación se realizó correctamente
docker-compose up -d # Construir e iniciar los contenedores de los servicios
docker-compose down # Detener y eliminar los contenedores de los servicios
docker-compose ps # Listar todos los contenedores de los servicios
docker-compose start # Iniciar los contenedores de los servicios
docker-compose stop # Detener los contenedores en ejecución de los servicios
docker-compose restart # Reiniciar los contenedores de los servicios
docker-compose logs # Ver la salida de los contenedores de los servicios
docker-compose pull # Descargar las imágenes de las que dependen los servicios
docker-compose config # Validar y ver la configuración del archivo compose