现状
现在的开发模式基本是微服务
开发模式,一个服务依赖N
个其它服务,一个前端
依赖N
个后端,如果本地要debug
的话,将会是一件非常头疼的事,常见的debug
模式有以下几种:
1. 叫相关开发人员将服务运行起来,然后连接调试
2. 自己将所有代码clone下来,自己在本地运行相关服务
复制代码
好像也没什么问题,也可以调试,但是弊端也很明显
先说方案1
的弊端
- 如果开发某天请假了,你没调试环境了,你还能调试吗?
- 如果开发又加了新功能,因为功能是个半成品,不稳定,导致你依赖的接口访问不了,你还能调试吗?
方案2
的弊端
- 这个要求所有开发要熟悉整个技术栈的环境创建、编译构建相关的知识,比如:前端用的是 vue ,后端开发要安装 nodejs ,要懂一些 npm,vue 啥的,后端用的是 go,前端要安装 go ,要懂 go 的依赖安装,go 编译啥的
- 因为有多个服务,服务间如果用了相同端口,就会有端口冲突,改了端口后,相关依赖的服务都要修改,这就要求相关开发要对整个架构、服务依赖非常了解,不然肯定非常折腾
上述方案都只是用一些成本比较大的方式提供了一个不太稳定的开发环境
几个工具
docker
要保证开发环境的稳定,就需要一个不可变的基础设施,说到不可变基础设施,肯定就要说一下docker
了,docker
用镜像
解决了PaaS
标准化的问题,将PaaS
变成了一个不可变基础设施,这样无论我们在什么操作系统上,创建出来的实例都可以运行起来,配置一样的情况下,提供的服务也是一样的,但docker
只保证单实例的一致性,我们的服务有N多个,如何将它们建立关联关系并运行起来呢
docker-compose
docker-compose
可以声明一组服务,指定启动镜像、启动命令、暴露服务端口,可以很好的解决服务编排的问题
我们用以下这种服务架构为例子,为每个应用创建一个开发环境
用 docker
镜像来解决服务运行环境问题,每个项目有一个Dockerfile
、build-dev-image.sh
文件,用build-dev-image.sh
来构建当前分支下的代码,并push
到docker registry
,依赖项目只需要引用相关版本的镜像就好了
用docker-compose
来解决服务依赖问题,每个项目都要有一个docker-compose.yml
文件,声明依赖服务的镜像版本,服务的端口
构建开发环境 docker 镜像
前端
Dockerfile
如下:
FROM nginx:1.19.2-alpine
COPY ./dist /usr/share/nginx/html
复制代码
build-dev-image.sh
如下:
#!/bin/bash
pwdStr=`pwd`
dirName=${pwdStr##*/}
buildTime=`date '+%Y%m%d%H%M'`
harborHost="docker registry domain"
latestTag=$harborHost/dev/${dirName}:latest
buildTimeTag=$harborHost/dev/${dirName}:${buildTime}
harborUser="dev"
harborPasswd="xxxx"
npm run build
docker build -t $latestTag -t $buildTimeTag .
docker login $harborHost -u"$harborUser" -p"$harborPasswd"
docker push $latestTag
docker push $buildTimeTag
echo "docker镜像名称: $latestTag"
echo "docker镜像名称: $buildTimeTag"
复制代码
build-dev-image.sh
主要做了:
- 构建
docker
镜像push
到docker registry
功能开发完了,要联调了,执行一下build-dev-image.sh
,镜像就构建好了,并 push
到镜像仓库了,需要的项目按需取
这里输出了两个tag
,一个是latest
,一个是用年月日
的,具体用哪个,看变更频繁度,如果很频繁就用年月日
的,否则就用latest
的,这样就不用老是修改docker-compose.yml
了
后端
Dockerfile
FROM alpine:3.11.6
COPY main /app/
EXPOSE 8000
WORKDIR /app
CMD ["/app/main"]
复制代码
build-dev-image.sh
#!/bin/bash
pwdStr=$(pwd)
dirName=${pwdStr##*/}
buildTime=$(date '+%Y%m%d%H%M')
harborHost="docker registry domain"
latestTag=$harborHost/dev/${dirName}:latest
buildTimeTag=$harborHost/dev/${dirName}:${buildTime}
harborUser="dev"
harborPasswd="xxxx"
GOOS=linux CGO_ENABLED=0 go build -o main main.go
docker build -t $latestTag -t $buildTimeTag .
docker login $harborHost -u"$harborUser" -p"$harborPasswd"
docker push $latestTag
docker push $buildTimeTag
echo "docker镜像名称: $latestTag"
echo "docker镜像名称: $buildTimeTag"
rm -f main
复制代码
服务信息
先看下项目信息
graph TD
example-front --> examplea --> exampleb
exampleb
只是简单的输出一个字符串
package main
import (
"log"
"net/http"
)
func main() {
http.HandleFunc("/b/api", func(writer http.ResponseWriter, request *http.Request) {
log.Println(request.URL.Path)
writer.Write([]byte("project b"))
})
http.ListenAndServe(":8000", nil)
}
复制代码
examplea
调用examplab
,并输出一个字符串
const (
// 从配置服务中取
PROJECT_B_DOMAIN = "http://exampleb:8000"
)
func main() {
http.HandleFunc("/a/api", func(writer http.ResponseWriter, request *http.Request) {
log.Println(request.URL.Path)
resp, _ := http.Get(PROJECT_B_DOMAIN + "/b/api")
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
writer.Header().Set("Access-Control-Allow-Origin", "*")
writer.Write([]byte("project a<br/>"))
writer.Write(result)
})
http.ListenAndServe(":8000", nil)
}
复制代码
example-front
调用examplea
<template>
<div id="app">
<h1>
Server Response: <br /><span v-html="resp" style="color: red"></span>
</h1>
</div>
</template>
<script>
import axios from "axios";
export default {
name: "App",
data() {
return {
resp: "",
};
},
mounted() {
axios.get("http://localhost:8000/a/api").then((resp) => {
this.resp = resp.data;
});
},
};
</script>
复制代码
创建开发环境
example-front
example-front
依赖examplea
,examplea
又依赖exampleb
,所以我们需要两个服务,并暴露examplea
的端口到宿主机上,供前端调用
docker-compose.yml
如下:
version: '3'
services:
examplea:
image: {{docker registry domain}}/dev/examplea:latest
ports:
- 8000:8000
exampleb:
image: {{docker registry domain}}/dev/exampleb:latest
复制代码
然后运行docker-compose up
,再执行npm run serve
,然后打开浏览器就可以看到
为了方便一些,我们可以直接修改 package.json
的scripts
,将docker-compose up -d
加到serve
上,这样我们直接npm run serve
也可以有一个开发环境
"scripts": {
"serve": "docker-compose up -d && vue-cli-service serve",
"build": "vue-cli-service build",
"lint": "vue-cli-service lint"
}
复制代码
examplea
docker-compose.yml
如下:
version: '3'
services:
exampleb:
image: {{docker registry domain}}/dev/exampleb:latest
example-front:
image: {{docker registry domain}}/dev/example-front:latest
ports:
- "8080:80"
examplea:
image: golang:1.19.5
working_dir: "/go/src/examplea"
# 调试模式,请制作一个包含go和delve的镜像
# command: [ "dlv", "debug", "--headless", "--listen=:2345", "--api-version=2", "--accept-multiclient", "main.go" ]
command: [ "go","run","main.go" ]
volumes:
- .:/go/src/examplea
depends_on:
- exampleb
- example-front
ports:
- "8000:8000"
- "2345:2345"
复制代码
这里为了有点区别,输出改成了debug project a<br/>
直接
docker-compose up
,example-front
将80
映射成8080
了,打开浏览器输入http://localhost:8080
,
exampleb
docker-compose.yml
如下:
version: '3'
services:
examplea:
image: {{docker registry domain}}/dev/examplea:latest
ports:
- "8000:8000"
example-front:
image: {{docker registry domain}}/dev/example-front:latest
ports:
- "8080:80"
exampleb:
image: golang:1.19.5
working_dir: "/go/src/exampleb"
# 调试模式,请制作一个包含go和delve的镜像
# command: [ "dlv", "debug", "--headless", "--listen=:2345", "--api-version=2", "--accept-multiclient", "main.go" ]
command: [ "go","run","main.go" ]
volumes:
- .:/go/src/exampleb
depends_on:
- examplea
- example-front
ports:
- "2345:2345"
复制代码
这里为了有点区别,输出改成了debug project b<br/>
总结
现在各项目只需要执行一下docker-compose up
或者npm run serve
就可以有一个稳定的开发环境了,再也不用因为环境的问题,折腾大半天,结果还不一定能折腾出来
go
项目也是可以启用 debug
模式,只需要找一个或者自己制作一下包含go
和delve
的镜像,然后把command
改成[ "dlv", "debug", "--headless", "--listen=:2345", "--api-version=2", "--accept-multiclient", "main.go" ]
,并将端口用ports
映射一下就好了
goland
用Go Remote
看到 API server listening at: [::]:2345
,点击dubug
就OK了
事例代码
clone
记得替换docker-compose.yml
的{{docker registry}}
,修改build-dev-image.sh
中的registry
信息