Ginblog(我的项目已实现,欢送应用)
https://gitee.com/wejectchan/ginblog
重要更新
- 2021.2.12 为了交换不便,建设了一个 QQ 群:951736723,如果有问题,欢送进群交换。
- 2021.2.10 减少了展现页面的挪动端适配
- 2021.1.2 退出注册、登录、评论性能,后盾治理退出评论审核性能
- 2021.1.3 减少 登录、注册验证性能;减少评论数量显示;减少浏览数量显示
减少:文章页面评论数、阅读数
介绍
gin+vue 全栈制作一个博客。
这是一个分享全栈制作过程的我的项目,旨在为有趣味接触 golang web 开发的敌人分享一些制作教训。
你能够返回 B 站(https://space.bilibili.com/402177130) 观看全栈的制作过程,你也能够留言分享你的观点,十分乐意与你交换。
目录构造
├─ .gitignore
│ go.mod // 我的项目依赖
│ go.sum
│ latest_log.log
│ LICENSE
│ main.go // 主程序
│ README.md
│ tree.txt
│
├─api
├─config // 我的项目配置入口
├─database // 数据库备份文件(初始化)├─log // 我的项目日志
├─middleware // 中间件
├─model // 数据模型层
├─routes
│ router.go // 路由入口
├─static // 打包动态文件
│ ├─admin // 后盾治理页面
│ └─front // 前端展现页面
├─upload
├─utils // 我的项目专用工具库
│ │ setting.go
│ ├─errmsg
│ └─validator
└─web // 前端开发源码(VUECLI 我的项目源文件)
├─admin
└─front
运行 && 部署
-
克隆我的项目
git clone git@gitee.com:wejectchan/ginblog.git or git clone https://github.com/wejectchen/Ginblog.git
- 转到上面文件夹下
cd yourPath/ginbolg
- 装置依赖
go mod tidy
- 初始化我的项目配置 config.ini
./config/config.ini
[server]
AppMode = debug # debug 开发模式,release 生产模式
HttpPort = :3000 # 我的项目端口
JwtKey = 89js82js72 #JWT 密钥,随机字符串即可
[database]
Db = mysql #数据库类型,不能变更为其余模式
DbHost = 127.0.0.1 # 数据库地址
DbPort = 3306 # 数据库端口
DbUser = ginblog # 数据库用户名
DbPassWord = admin123 # 数据库用户明码
DbName = ginblog # 数据库名
[qiniu]
# 七牛贮存信息
AccessKey = # AK
SecretKey = # SK
Bucket =
QiniuSever =
- 在 database 中将 sql 文件导入数据库
举荐 navicat 或者其余 sql 管理工具导入
- 启动我的项目
go run main.go
此时,我的项目启动,你能够拜访页面
首页
http://localhost:3000
后盾治理页面
http://localhost:3000/admin
默认管理员:admin 明码:123456
enjoy~~~~
== 应用、二开过程中,发现问题或者有性能需要欢送提交 Iusse
或者间接 PR
==
实现性能
- 简略的用户管理权限设置
- 用户明码加密存储
- 文章分类自定义
- 列表分页
- 图片上传七牛云
- JWT 认证
- 自定义日志性能
- 跨域 cors 设置
- 文章评论性能
技术栈
-
golang
- Gin web framework
- gorm(v1 && v2)
- jwt-go
- scrypt
- logrus
- gin-contrib/cors
- go-playground/validator/v10
- go-ini
-
JavaScript
- vue
- vue cli
- vue router
- ant design vue
- vuetify
- axios
- tinymce
- moment
- MySQL version:8.0.21
我的项目预览
- 前端展现页面
- 前端展现页面
- 后盾登录页面
- 后盾治理页面
更新进度(制作视频已根本全副更新结束)
后端实现
第一节 初始化我的项目 + 配置参数
第二节 配置数据库,数据模型
第三节 构架错误处理模块和路由接口
第四节 编写用户模块接口,实现初步验证 + 分页性能
第五节 用户明码加密存储策略介绍及抉择
第六节 编写编辑用户信息 + 删除用户接口
第七节 实现博客分类接口编写
第八节 编写博客文章接口(新增、编辑、删除)
第九节 实现博客文章接口(文章和分类的关联查问)
第十节 编写登录接口,实现 JWT 中间件
第十一节 实现登录接口
第十二节 实现上传接口(GIN+ 七牛对象贮存)
第十三节 解决日志零碎(自定义日志、按工夫宰割日志、软连贯最新日志)
第十四节 后端数据验证、跨域参数配置、减少列表查问的总数返回
前端后盾治理页面实现
第一节 前端初始化,开发环境搭建及相干依赖装置
第二节 编写登录页面,实现数据双向绑定和数据验证
第三节 实现登录页面
第四节 配置路由导航守卫,搭建后盾治理页面框架
第五节 实现后盾页面菜单栏和页面路由跳转
第六节 编写用户列表页面
第七节 用户列表搜寻和删除性能
第八节 实现用户列表新增用户和编辑用户性能
第九节 修复局部 BUG
第十节 编写分类列表和文章列表页面
第十一节 实现新增文章和编辑文章页面
第十二节 自定义封装 tinymce 富文本编辑器,实现编辑器本地上传图片等性能
第十三节 后盾页面完结,vue 打包部署
前端展现页面(更新结束)
第一节 搭建我的项目框架
第二节 编写主内容区 + 集体介绍
第三节 实现个人简介更新性能
第四节 实现文章列表页面
第五节 实现文章详情页面
Docker 部署
一、如何装置 docker
官网文档:Get Docker | Docker Documentation
抉择对应的零碎进行查看,以 ubuntu 18.04 LTS 为例
- 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc
Reading package lists... Done
Building dependency tree
Reading state information... Done
Package 'docker-engine' is not installed, so not removed
Package 'docker' is not installed, so not removed
Package 'containerd' is not installed, so not removed
Package 'docker.io' is not installed, so not removed
Package 'runc' is not installed, so not removed
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.
- 增加新版本仓库
$ sudo apt-get update
$ sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common
- 获取官网 GPG key
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
- 验证 key, 如果输入的是下列内容,则阐明正确
$ sudo apt-key fingerprint 0EBFCD88
pub rsa4096 2017-02-22 [SCEA]
9DC8 5822 9FC7 DD38 854A E2D8 8D81 803C 0EBF CD88
uid [unknown] Docker Release (CE deb) <docker@docker.com>
sub rsa4096 2017-02-22 [S]
- 增加仓库地址
$ sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
#也能够用国内的仓库下载,速度较快,举荐
$ sudo add-apt-repository \
"deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/ \
$(lsb_release -cs) \
stable"
- 更新仓库和装置
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
- 进行验证,运行 hello-world
$ docker pull hello-world
$ docker run hello-world
#呈现以下信息,示意 docker 装置胜利,曾经能够失常运行
Hello from Docker!
This message shows that your installation appears to be working correctly.
To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.(amd64)
3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.
To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash
Share images, automate workflows, and more with a free Docker ID:
https://hub.docker.com/
For more examples and ideas, visit:
https://docs.docker.com/get-started/
- 额定:配置国内仓储镜像,保障拉取速度
# 这里以阿里云为例,阿里云为用户提供了私人仓库,配置有所不同。# 具体须要登录阿里云治理,进入控制台,找到 ` 镜像减速服务 ` -> ` 镜像工具 ` -> ` 镜像加速器 `
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://XXX 你的 id.mirror.aliyuncs.com"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
到此,咱们的 docker 环境就正式配置好了。
二、拉取镜像和创立镜像和容器编排
接下来,咱们就要制作运行我的项目须要的镜像了
Mysql 服务器的镜像
首先,集体十分不倡议 mysql 用 docker 来部署,有几个起因:
- 必须做数据卷的映射,
千万不能
将数据库数据放在 docker 容器中运行,否中一但删除容器数据将全副清空,所以肯定要做数据长久化!!; - 不利于 io,数据读写在容器中读写一次,在绑定的卷中还要读取一次,两倍读写压力,性能上要打折扣。
如果非要在 docker 上部署 mysql,能够这么做
# 首先确定 mysql 是否能被搜素到,这步能够跳过,也能够在 dockerhub.com 中搜寻
$ docker search mysql
#拉取镜像
docker pull mysql #这里默认是拉取的最新版本,如果须要特定版本能够在镜像前面增加 tag,具体版本信息能够在 dockerhub.com 查问
#特定版本拉取, 比方要拉取 8.0.22(版本号肯定要是官网放出的版本号,否则是查找不到的)
docker pull mysql:8.0.22
#这时能够查看下拉取的镜像
docker images
#运行镜像
docker run -d -p 3306:3306 -v /my/own/datadir:/var/lib/mysql --name ginblog-mysql -e MYSQL_ROOT_PASSWORD=admin123 mysql
# -d 示意后盾运行,并返回容器 id
# -p 3006:3306 示意端口映射,具体为 -p 主机端口:容器端口
# --name 给容器取个名字
# -e MYSQL_ROOT_PASSWORD=password 给 mysql root 管理员设置明码
# -v /my/own/datadir:/var/lib/mysql 增加数据卷 /my/own/datadir 是主机的数据库门路 /var/lib/mysql 是容器中的数据库门路,这一步十分重要
#进入容器配置
docker exec -it ginblog-mysql bash
root@ed9345077e02:/# mysql -u root -p
Enter password:
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.0.22 MySQL Community Server - GPL
Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.
Other names may be trademarks of their respective owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
# 之后就和个别状况下 mysql 的操作一样了。
制作 ginblog 我的项目镜像
- 首相要拉取咱们的 ginblog 我的项目
# 新建一个我的项目文件夹,在你认为任何适宜的中央都能够
$ cd /
$ mkdir app
# 咱们这里利用 git 来近程同步
$ git clone 我的项目地址
- 编写 Dockerfile
FROM golang:latest
RUN go env -w GO111MODULE=on
RUN go env -w GOPROXY=https://goproxy.cn,https://goproxy.io,direct
WORKDIR $GOPATH/src/ginblog
COPY . $GOPATH/src/ginblog
RUN go build .
EXPOSE 3000
ENTRYPOINT ["./ginblog"]
- 配置 ginblog 的 config
# config/config.ini
# DbHost = ginblog-mysql 是为了前面容器互通做筹备,对应的是 mysql 容器的 name
Db = mysql
DbHost = ginblog-mysql
DbPort = 3306
DbUser = ginblog
DbPassWord = admin123
DbName = ginblog
这样的话,咱们大略就配置好 docker 的 build 镜像文件了。
- 最初咱们在确定下前端
web
文件夹下的 axios 申请地址
// 在 web/admin/src/plugin/http.js 和 web/front/src/plugin/http.js 两个文件夹中, 将 baseURL 地址改为部署的服务器线上地址
axios.defaults.baseURL = 'http://localhost:3000/api/v1'
// 批改为
axios.defaults.baseURL = 'http:// 线上服务器 ip 或域名:3000/api/v1'
别忘了,批改完地址后,从新打包下
$ yarn build
$ npm run build
生成镜像
最初一步,就是生成咱们的 ginblog docker image 了,这部很简略,运行下列命令
$ docker build -t ginblog .
$ docker run -d -p 3000:3000 --name ginblog ginblog
#这样拜访服务器 IP:3000 就能够拜访网站了