connecare/sacm.backend

镜像概述

connecare/sacm.backend是CONNECARE SACM系统的后端服务镜像，用于支撑SACM系统后端业务逻辑运行，包含API文档生成、容器化部署及日常维护的操作指引，助力用户快速部署和管理SACM后端组件。

核心功能

1. API文档生成：通过apidoc工具从路由代码提取并生成API文档
2. 容器化部署：提供Docker及docker-compose相关的部署、更新、重启流程
3. 运维支持：包含Docker、Mongo数据库及Git的常用操作命令，便于系统维护与故障排查

使用场景

• SACM系统后端的初始部署与版本更新
• 日常运维中的容器状态监控、日志查看、数据库查询
• API文档的生成与更新

配置说明

安装API文档工具

全局安装apidoc：

bash
npm install apidoc -g

生成API文档

从路由代码生成API文档：

bash
apidoc -i app/routes -o doc/assets/api -t doc/sections/api

部署步骤

1. 更新Sociocortex：在BitBucket为Sociocortex提交打docker-build-x标签（x为构建编号），触发容器构建。
2. 更新SACM：推送代码至GitHub仓库，通过DockerHub WebHook触发构建（POST请求至指定URL，需替换SECRET）。
3. 服务器部署：
   • 连接CONNECARE服务器（确保SSH密钥配置正确）
   • 执行部署命令：

     bash
     cd /home/ubuntu/eurecat/dockers/sociocortex
     sudo docker-compose pull # 拉取最新镜像
     sudo docker-compose stop # 停止当前容器
     sudo docker-compose up -d # 启动最新版本
     sudo docker logs sacm.backend --tail 100 -f # 查看后端日志
     sudo docker exec -it sacm.sociocortex bash # 进入容器终端
     

   • （可选）清理镜像：docker system prune -a

常用命令

Docker命令

bash
sudo docker ps # 查看运行容器
sudo docker logs <containerId> --follow # 实时查看日志
sudo docker exec -it <containerId> bash # 进入容器终端
sudo docker stats sacm.frontend sacm.backend sacm.sociocortex sacm.mongo # 查看资源使用
sudo docker update --memory 5GB sacm.mongo # 调整内存限制

Mongo命令

查询包含特定URL的文档：

bash
.find({url:{$regex : ".*humantasks/1pejs4af5xzr7/complete*"}})

Git命令

查看XML文件的提交历史：

bash
git log --all --follow '*.xml'