部署无鱼工时系统

公司一个部门是做外包的，经常要项目组报工时记录给甲方，之前一直使用excel方式，最近要使用无鱼工时系统，准备部署一个。

下面是我的部署手记-超详细的介绍了这个项目的部署流程到最后运行起来。

1.项目介绍

无鱼项目工时系统，是一款开源的轻量级项目工时管理系统，是企业进行项工时管理统计的推荐选择。

下载地址：
https://gitee.com/wy-soft/wyproject/releases

2.安装总述

文档以工程部署在ubuntu部署为例进行说明。中间件采用docker方式安装。总体需要安装：docker、mariaDB、redis5.0、nginx。

环境需要：jdk1.8

所需工具：ubuntu系统服务器一台，Xshell软件， navcat数据库链接工具。

2.0 关闭防火墙

systemctl stop ufw

2.1 更新安装源

备份原文件
cp /etc/apt/sources.list /etc/apt/sources.list.bak

修改源配置文件

vi /etc/apt/sources.list

推荐使用清华源

# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-backports main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ jammy-security main restricted universe multiverse

然后执行更新

apt update -yapt upgrade

2.1 安装jdk

apt install openjdk-8-jdk-headless

2.2 安装docker

方案1使用官方脚本

curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

方案2 使用apt

 apt install docker-ce docker-ce-cli containerd.io

这里我们使用方式1

验证是否安装成功

docker version

显示如下说明已经安装完成。

启动docker

systemctl start docker

设置docker开机自启动（可选）

systemctl enable docker

2.3 安装数据库 mariaDB，也可选择使用mysql，功能是一样的。

拉取镜像

docker pull mariadb

如果拉取太慢，可以使用ctrl +c 中断，更换一下docker的镜像源再继续。
常用源
Docker中国区官方镜像：

https://registry.docker-cn.com

网易：

http://hub-mirror.c.163.com

ustc ：

https://docker.mirrors.ustc.edu.cn

中国科技大学：

https://docker.mirrors.ustc.edu.cn

或者使用阿里云的专属Docker加速器地址

修改源

vim /etc/docker/daemon.json

添加内容

{
"registry-mirrors": ["https://registry.docker-cn.com"]
}

重启docker

systemctl restart docker

更换源之后再执行拉取

docker pull mariadb

明显速度快很多

创建容器挂载路径

mkdir -p /usr/local/wuyu/mariadb/data   &&    mkdir -p /usr/local/wuyu/mariadb/logs  &&   mkdir -p /usr/local/wuyu/mariadb/conf

启动容器，设置数据库密码为password

docker run -d -p 3306:3306 --name wuyu-mariadb  -v /usr/local/wuyu/mariadb/data:/var/lib/mysql   -v /usr/local/wuyu/mariadb/logs:/var/log/mysql   --privileged=true --restart=always   -e MYSQL_ROOT_PASSWORD=password  mariadb

使用navicat 连接数据库

创建数据库
数据库名：
wy_project
字符集
utf8mb4
排序规则
utf8mb4_general_ci

下载sql文件，并导入
码云下载地址： https://gitee.com/wy-soft/wyproject/releases/tag/wyproject_all-0.1

在 wy_project 上右键，选择运行sql，如果按钮为灰，则需要点双击一下打开数据库，再右键。

将下载的文件中的 wy_project_init.sql 导入到数据库中。

执行完后，关闭窗口，在数据库名称上右键刷新可看见新建的表。

2.5.安装redis

拉取镜像

docker pull redis:5.0.5

创建挂载路径并授权

mkdir -p /usr/local/wuyu/redis5.0/data   &&  mkdir -p /usr/local/wuyu/redis5.0/logs  &&  mkdir -p /usr/local/wuyu/redis5.0/confchmod -R 755 /usr/local/wuyu/redis5.0

编辑配置文件

vi /usr/local/wuyu/redis5.0/conf/redis.conf

粘贴内容

# 默认为yes，开启保护模式，限制为本地访问protected-mode no# 默认为no，改为yes意为以守护进程方式启动，可后台运行，除非kill进程，改为yes会使配置文件方式启动redis失败daemonize nodatabases 16# 输入本地redis数据库存放文件夹（建议在docker环境中暂时不修改）dir  ./# redis持久化（可选）appendonly yes# 设置密码requirepass password

启动redis

docker run -d -p 6380:6379  --name redis  -v /usr/local/wuyu/redis5.0/conf/redis.conf:/etc/redis/redis.conf  -v /usr/local/wuyu/redis5.0/data:/data --restart=always  redis:5.0.5 redis-server /etc/redis/redis.conf

查看镜像运行情况

docker ps

如果启动有问题，请查看log进行纠错
方法是
docker log + 镜像名称
例如 docker logs redis

2.6.安装nginx
nginx 有三种方法

编译安装，从网上下载nginx源码，进行编译后安装
使用apt-get 安装
使用docker安装。

编译安装的好处是可以自己制定nginx安装的位置和路径，缺点是需要安装一堆依赖包以及编译库，并且需要编译，过程比较慢。
使用apt-get nginx的安装位置和配置文件都是默认了，不是很方面进行管理。
docker方式是虚拟化方式，本次我们采用docker方式安装

拉取镜像

docker pull nginx

创建挂载路径

mkdir -p /usr/local/wuyu/nginx/conf  &&  mkdir -p /usr/local/wuyu/nginx/logs  &&  mkdir -p /usr/local/wuyu/nginx/www  &&  mkdir -p /usr/local/wuyu/nginx/conf.d

这里容易出现一个问题，如果直接创建容器，虽然会创建成功，但是nginx运行不起来，会报错。

因此，我们需要先把工程文件放好位置
下载nginx 配置文件，并放到nginx配置目录下

wget  https://gitee.com/wy-soft/wyproject/releases/download/wyproject_all-0.1/wy_nginx.conf
vi  wy_nginx.conf

需要修改两处地方
1/ root 路径为 /usr/share/nginx/html
2/ locahost 改成服务器的ip （容器里无法通过localhost 访问其他容器或者宿主机）

修改后，放到指定目录

mv  wy_nginx.conf /usr/local/wuyu/nginx/conf.d/default.conf

下载前端工程文件

wget  https://gitee.com/wy-soft/wyproject/releases/download/wyproject_all-0.1/wy_web.zip# 解压并移动
unzip wy_web.zip
mv  wy_web www
mv  www /usr/local/wuyu/nginx/

这时候创建容器，就不会出错了。

创建容器

docker run -d -p 80:80 --name nginx -v /usr/local/wuyu/nginx/www:/usr/share/nginx/html -v /usr/local/wuyu/nginx/conf.d:/etc/nginx/conf.d -v /usr/local/nginx/logs:/var/log/nginx   --privileged=true --restart=always nginx

访问地址，因此我们这时候没有部署后端工程，所以会报404，先不要管，继续进行部署。

部署后端程序

#创建文件目录mkdir -p /usr/local/wuyu/app  &&  mkdir -p /usr/local/wuyu/app/logs# 进入目录
cd  /usr/local/wuyu/app

下载后端程序

wget  https://gitee.com/wy-soft/wyproject/releases/download/wyproject_all-0.1/wy_project.jarchmod +x  wy_project.jar下载后端控制脚本
wget https://gitee.com/wy-soft/wyproject/releases/download/wyproject_all-0.1/wy_ctl.shchmod +x wy_ctl.sh

修改配置信息，主要是mysql和redis的密码，

修改成password （或者自己设置的）

启动

./wy_ctl.sh start

这里又会出现一个错误
提示bash: ./wy_ctl.sh: /bin/sh^M: bad interpreter: No such file or directory

这是因为脚本的编码问题，可以把文档复制出来后，使用vi 创建一个同名文件把内容复制进去。
或者下载工程里最新的文件。

wget https://gitee.com/wy-soft/wyproject/blob/master/wy_ctl.sh
chmox + wy_ctl.sh

然后修改里面的内容

也可能出现 ./wy_ctl.sh: 40: Syntax error: “(” unexpected

这是，Ubuntu 为加快开机速度，默认将root指向dash，解决办法就是将dash指向取消

# root 账号输入
dpkg-reconfigure dash# 非root 账号 输入
sudo dpkg-reconfigure dash

选择 no，之后
然后重新启动

./wy_ctl.sh start

查看启动日志

tail -f  /usr/local/wuyu/app/logs/server.log

看到最后提示工程启动成功，说明已经部署完成。

访问服务器的地址 192.168.128.129
使用admin 12345678 登录

3. 系统设置

点击管理，选择系统设置，填写公司的名称和logo

部署搞定。

下面创建角色/职位/人员之后就可以开始使用了。