简介

致力于打造一个集主机管理、配置部署、监控报警、异常诊断、安全审计等一系列功能的自动化运维平台。 探索创新的sysAK、ossre诊断工具及高效的LCC（Libbpf Compiler Collection）开发编译平台和netinfo网络抖动问题监控系统等， 实现系统问题的快速上报、分析与解决，提升集群的全自动运维效率，构建大规模集群运维生态链。

目标

通过社区合作，打造出一个自动化运维平台，涵盖云场景中各种典型服务场景，包括线上问题分析诊断、资源和异常事件监控、系统修复业务止血， 安全审计和CVE补丁推送等各种功能，提供强大的底层系统运维能力，融合到统一的智能运维平台，实现自动化运维。

功能

• 主机管理
• 配置中心
• 安全审计
• 监控报警
• 智能问题诊断
• 发布部署

安装部署

1. 编译部署

1.1 依赖

• nodejs >= 12.0.0
• python >= 3.6
• git
• tar
• wget

1.2 编译

• 依赖安装

  dnf module install nodejs:16 -y
  npm install -g yarn
  dnf install git tar wget -y
  

• 编译打包

  git clone https://gitee.com/anolis/sysom.git
  cd sysom
  bash package.sh
  

  输出包含如下结果表示编译成功： [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-dbTldAef-1676539163032)(https://foruda.gitee.com/images/1674977326579767317/e08cc909_643601.png "编译日志.png")]

  执行完之后使用 tree -L 1 查看当前文件夹分布如下：

  .
  ├── LICENSE
  ├── package_rpm_offline.sh
  ├── package_rpm_online.sh
  ├── package.sh
  ├── README.md
  ├── script
  ├── sysomRelease-20230129142347.tar.gz
  ├── sysom_server
  ├── sysom_web
  └── tools
  

  注意：打包出的 release 包的命名格式为 sysomRelease-xxx.tar.gz ，其中 xxx 为打包时的时间，因此每次打包时生成的压缩包名称都是不同的

1.3 热补丁编译机（builder）设置

用户需要使用热补丁中心的功能时，需要配置热补丁的编译机。

• 在单机部署的情况下，可以忽略本步骤，部署完毕即可使用

• 在多机部署的情况下，请确保builder机器与server机器在同一网段内。需要配置sysom/script/server/6_sysom_hotfix_builder下的init.sh以及sysom_server/sysom_hotfix_builder下的builder.ini

  #! /bin/bash
  SERVER_DIR="sysom_server"
  HOTFIX_BUILDER_DIR=${SERVER_DIR}/sysom_hotfix_builder
  VIRTUALENV_HOME=${SERVER_HOME}/virtualenv
  SERVICE_NAME=sysom-hotfix-builder
  NFS_SERVER_IP=${SERVER_LOCAL_IP}  # 将NFS_SEVER_IP配置为sysom主服务器的内网ip地址
  

  builder.ini

  [sysom_server]
  server_ip = http://127.0.0.1  # sysom主服务器的ip地址
  account = account             # 用于登录sysom的账户
  password = password           # 用于登录sysom的密码
  
  [cec]
  cec_url = redis://127.0.0.1:6379  # 此处指向sysom主服务器的redis地址，填写内网ip地址
  
  [builder]
  hotfix_base = /hotfix_build/hotfix                      # 此处配置hotfix构建的工作目录
  nfs_dir_home = /usr/local/sysom/server/builder/hotfix   # 此处构建与sysom主服务器共享目录的路径
  package_repo = /hotfix/packages                         # 缓存设定路径
  

注意：在多机部署的情况下，角色为builder的机器可以在/sysom/server/conf下仅使能[base]和[hotfix-builder]这两个服务即可；此外，需要修改server的redis配置文件(如/etc/redis.conf)，允许其他机器访问server的redis，否则服务会不可用 。

1.4 部署

• 解压 release 包

  注意下面压缩包的名称要替换成实际打包出的 release 包的名称

  tar -zxvf sysomRelease-20230129142347.tar.gz
  cd sysomRelease-20230129142347
  

  解压完成后，Release 包内的文件分布如下：

  .
  ├── clear.sh
  ├── deploy.sh
  ├── script
  ├── sysom_server
  ├── sysom_web
  └── tools
  

• 使用 deploy.sh 脚本进行部署

  • 首先使用 ifconfig 查看当前机器的IP => 比如：172.22.3.238

  • deploy.sh 部署脚本参数说明

    bash deploy.sh <部署目录> <内网IP> <外网IP>
    

    • arg1 : 部署目录
    • arg2 : 内网IP（主要是方便内网通讯，用户需要保证内网能通）
    • arg3 : 外网IP（浏览器可以访问到的IP地址)

  • 使用 deploy.sh 脚本进行一键部署

    如果没有公网IP，均使用内网IP即可，实际部署时可以替换成公网IP

    ./deploy.sh /usr/local/sysom 172.22.3.238 172.22.3.238
    

  • 当服务日志输出下列日志表示部署成功：

    Oct 10 12:58:51 mfeng bash[3217754]: /usr/local/sysom/init_scripts/server
    Oct 10 12:58:51 mfeng bash[3217754]: + for dir in `ls`
    Oct 10 12:58:51 mfeng bash[3217754]: + '[' -d init.sh ']'
    Oct 10 12:58:51 mfeng bash[3217754]: + for dir in `ls`
    Oct 10 12:58:51 mfeng bash[3217754]: + '[' -d stop.sh ']'
    Oct 10 12:58:51 mfeng bash[3217754]: + sed -i 's/^FIRST_INIT_DONE=0/FIRST_INIT_DONE=1/g'     /usr/local/sysom/init_scripts/server/init.sh
    

2. RPM打包部署

2.1 依赖

• nodejs >= 12.0.0
• python >= 3.6
• git
• tar
• wget
• Rpmbuild

2.2 编译

• 依赖安装

  dnf module install nodejs:16 -y
  npm install -g yarn
  dnf install git tar wget rpm-build -y
  

• 生成 RPM 包

  # 前端打包需要本地已经具备yarn环境，如不具备，需要提前部署yarn环境，然后进到 sysom_web 目录执行 yarn 命令安装依赖包。
  # mac 环境下 yarn 安装可以采用脚本：curl -o- -L https://yarnpkg.com/install.sh | bash
  # 安装yarn完成后，执行下列命令打包项目
  # 由于是制作rpm包，因此也需要打包具备制作rpm的条件，如rpmbuild，python3命令等。
  bash package_rpm_online.sh
  

  打包完成后，生成的 RPM 包被存放在 /root/rpmbuild/RPMS/x86_64 下面，使用 tree -L 1 /root/rpmbuild/RPMS/x86_64 查看的结果如下：

  /root/rpmbuild/RPMS/x86_64
  └── sysom-2.0-1.an8.x86_64.rpm
  

  注意：RPM包的名称会随 sysom 的版本、打包机器的架构和发行版本而变化，因此实际使用 RPM 包时，以实际的名称为准。

2.3 部署

• 安装 rpm 包

  rpm -ivh sysom-2.0-1.an8.x86_64.rpm
  # 或 yum install -y sysom-2.0-1.an8.x86_64.rpm
  

  • 默认安装路径为 /usr/local/sysom 下
  • 默认配置使用的nginx对外端口为80，可以通过 export SERVER_PORT=xxx 来设置
  • 默认配置的内网IP是通过 ip -4 route 命令查找的第一个IP，可以通过 export SERVER_LOCAL_IP=xxx.xxx.xxx.xxx 来设置

• 启动

  # 使用以下命令进行启动:
  bash -x /usr/local/sysom/init_scripts/server/init.sh
  

• 当服务日志输出下列日志表示部署成功：

  Oct 10 12:58:51 mfeng bash[3217754]: /usr/local/sysom/init_scripts/server
  Oct 10 12:58:51 mfeng bash[3217754]: + for dir in `ls`
  Oct 10 12:58:51 mfeng bash[3217754]: + '[' -d init.sh ']'
  Oct 10 12:58:51 mfeng bash[3217754]: + for dir in `ls`
  Oct 10 12:58:51 mfeng bash[3217754]: + '[' -d stop.sh ']'
  Oct 10 12:58:51 mfeng bash[3217754]: + sed -i 's/^FIRST_INIT_DONE=0/FIRST_INIT_DONE=1/g'     /usr/local/sysom/init_scripts/server/init.sh
  

3. 容器化部署

3.1 基础服务部署

docker build -t sysom-base -f docker/sysom_base_dockerfile .
docker run -idt --privileged --name sysom-base sysom-base

可以通过修改 docker/sysom_base_dockerfile 使能不同的微服务

4. 通过 WEB 前端访问

部署成功之后，可以通过访问部署时指定的公网/私网地址访问 SysOM前端，比如 http://172.22.3.238

• 默认的用户名密码：admin/sysom@123
• SysOM提供了 Demo 体验网站，可以访问：http://sysom.openanolis.cn/

其它问题见FAQ

https://gitee.com/anolis/sysom/wikis/SysOM%20FAQ