工单系统ferry 02--本地运行ferry实例
- 1 介绍
- 2 操作
- 3 注意事项
- 4 说明
1 介绍
工单系统ferry 01–docker部署ferry 已经介绍了如何使用docker部署ferry，本文继上文介绍如何在本地通过源码运行ferry实例，包括前端和后端服务。
2 操作
前置条件：
参考 工单系统ferry 01–docker部署ferry 启动一个mysql 和redis 实例，并将host 信息更新到 config/settings.dev.yml 中。
运行后端：
git clone https://github.com/lanyulei/ferry.git
git clone https://gitee.com/yllan/ferry.git
cd ferry
go get
go run main.go server -c=config/settings.dev.yml
交叉编译：
env GOOS=linux GOARCH=amd64 go build
实际使用的时候根据Dockerfile的方式build，否则生成的可执行文件替换docker中二进制文件后不能正常执行：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o ferry .
运行前端：
git clone https://github.com/lanyulei/ferry_web.git
git clone https://gitee.com/yllan/ferry_web.git
cd ferry_web
npm config set registry https://registry.npm.taobao.org
npm install
# 若npm install安装失败，可尝试使用一下命令安装
npm install --unsafe-perm --force
npm run dev
输出日志如下：
xghome:~/files/code/github/ferry_web$ npm install --unsafe-perm --force
npm WARN using --force I sure hope you know what you are doing.
npm WARN @babel/helper-define-polyfill-provider@0.3.1 requires a peer of @babel/core@^7.4.0-0 but none is installed. You must install peer dependencies yourself.
npm WARN ferry_web@1.0.0 No repository field.
up to date in 7.847s
81 packages are looking for funding
run `npm fund` for
启动后进入登录界面：
http://localhost:9527/#/login?redirect=%2Fdashboard
3 注意事项
git 报错处理：
npm install --unsafe-perm --force 时候会使用git拉数据，而git当前已经提高了其安全性，因此正常情况会报错：
4537 error The unauthenticated git protocol on port 9418 is no longer supported.
4537 error Please see https://github.blog/2021-09-01-improving-git-protocol-security-github/ for more information.
解决方法：
git config --global --edit
追加如下内容，然后重新npm install 即可：
[url "https://"]
insteadOf = ssh://
[url "https://"]
insteadOf = git://
参考文档：
[The unauthenticated git protocol on port 9418 is no longer supported.的解决方法](javascript:void(0))
执行python报错
npm install --unsafe-perm --force 过程中会使用 python脚本，默认使用的是python2，因此需要 apt install
4 说明
软件环境：
ubuntu 20.04.1 LTS Desktop
Docker 20.10.7
go version go1.18 linux/amd64
node v14.13.1(笔者用16.13.1 编译报错)
参考文档：
主页/ ferry 教程文档/ 手动部署The unauthenticated git protocol on port 9418 is no longer supported.的解决方法
