五分钟用Docker快速搭建Go开发环境

挺早以前在我写过一篇用 Docker搭建LNMP开发环境的文章：用Docker搭建Laravel开发环境，里面详细介绍了将 nginx、 mysql和 php三个容器用 docker-compose编排成 LNMP开发环境的步骤，今天来说说怎么用 Docker快速搭建 Go语言项目的开发环境。

因为靠Go 本身自带的标准库就能实现高性能的 HTTP服务器，不熟悉的同学买它，呃说错了，看它：深入学习用Go编写HTTP服务器。所以用 Docker 构建 Go的开发环境比构建 LNMP 开发环境要简单很多，如果没有太多定制化要求甚至都不用写 Dockerfile自己构建镜像，直接使用官方的 golang镜像即可。

获取Docker镜像

我们使用官方最新稳定版的镜像 golang:latest， 获取镜像前先得确保你电脑上运行了 Docker 客户端，没有的去官网下载一下吧这里就不多说了。

下载dockerHub上的镜像直接使用命令：

1. docker pull golang

下载完镜像后用镜像运行一个容器：

1. docker run --rm -it --name go-http-demo golang bash

上面这个命令用镜像 golang创建了一个名为 go-http-demo的容器，在容器中创建了一个 Bash会话。--rm选项指定容器退出后自动移除容器。

运行完上面的命令后我们就进入了运行的容器中，运行 go version 查看以下 go的版本：

1. root@965425c5bdcf:/go# go version

2. go version go1.13.6 linux/amd64

3. root@965425c5bdcf:/go#

你可以根据自己的需要在https://hub.docker.com/_/golang 中查找自己需要的版本的 golang镜像运行容器。

在容器中运行Go项目

我们使用《深入学习用Go编写HTTP服务器》中最后写的支持优雅关停服务的 HTTPServer的源码，将它放到 Docker容器里伺服宿主机的请求。HTTP Server的源码如下，想探究代码具体怎么实现的看链接里的文章就好了。

1. package main

2. import (

3. "context"

4. "fmt"

5. "log"

6. "net/http"

7. "os"

8. "os/signal"

9. "syscall"

10. )

11. func main() {

12. mux := http.NewServeMux()

13. mux.Handle("/", &helloHandler{})

14. server := &http.Server{

15. Addr: ":8080",

16. Handler: mux,

17. }

18. // 创建系统信号接收器

19. done := make(chan os.Signal)

20. signal.Notify(done, os.Interrupt, syscall.SIGINT, syscall.SIGTERM)

21. go func() {

22. <-done

23. if err := server.Shutdown(context.Background()); err != nil {

24. log.Fatal("Shutdown server:", err)

25. }

26. }()

27. log.Println("Starting HTTP server...")

28. err := server.ListenAndServe()

29. if err != nil {

30. if err == http.ErrServerClosed {

31. log.Print("Server closed under request")

32. } else {

33. log.Fatal("Server closed unexpected")

34. }

35. }

36. }

37. type helloHandler struct{}

38. func (*helloHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {

39. fmt.Fprintf(w, "Hello World")

40. }

把源码放在本地电脑的 /Code/go/src/example.com/http-demo/main.go中，文件目录你们做的时候根据自己的情况写路径。

接下来就要把这个代码放到容器里去运行了，切到代码目录里执行如下命令：

1. docker run --rm -it --name go-http-demo \

2. -v $PWD:/go/src/example.com/go-http-demo \

3. -p 8000:8080

4. golang

-v选项允许我们挂载多个本地目录或者数据卷到容器中，更改会在容器内外相互同步，上面的命令将 /Code/go/src/example.com/go-http-demo/挂载到了容器的 /go/src/example.com/go-http-demo。

-p指定主机和容器的端口映射，因为代码里 HTTP服务是监听 8080端口的，所以我们将主机的 8000端口和容器的 8080端口做了映射。

执行完上面的命令，我们切换到到容器里的 Bash会话，切到代码目录运行 go run main.go后，在自己的电脑上打开浏览器访问 http:localhost:8080看到下图中的页面就证明服务器在容器里已经正常运行起来了。

用docker-compose管理容器

通过上面的内容我们已经用 Docker构建好了一个 Go的开发环境，不过每次打那堆命令，还要进容器执行 go命令启动程序太费事了，我们用 docker-compose把上面那些流程自动化一下。

在项目代码根目录创建 docker-compose.yml：

1. version: '3'

2. services:

3. app:

4. image: golang:latest

5. volumes:

6. - $PWD:/go/src/examplecom/http_demo

7. ports:

8. - "8000:8080"

9. command: go run /go/src/examplecom/http_demo/main.go

如果你们项目里不允许就找个目录放这个文件，我自己就是单独有个目录里面放了好几个项目的 Docker配置文件，有 PHP项目的也有 Go项目的。

上面的编排文件里只定义了一个叫 app的服务，其他的也很容易理解我就不说了，唯一要注意的一点就是如果 yml文件在项目外 volumes里的配置就换成绝对路径不要用 $PWD。关注公众号私信我可以获取安装指南。

接下来启动 docker-compose:

1. docker-compose up -d

如果启动不成功先不要在 daemon模式下运行把 -d去掉，就能看到具体什么错误，等调试正常了再后台启动。

代码有修改后，需要重新编译项目，针对我们的容器执行下面的命令即可

1. docker-compose restart

想要进入运行的容器中执行操作使用命令：

1. docker exec -it <container name> bash

给我们创建的 app发送 go test命令让它在容器内执行：

1. docker-compose exec app go test

最近想尝试把老项目换成用 go mod管理，项目还是在用 go1.12所以我就先用 Docker搭环境，容器隔离的环境怎么瞎折腾也没事。今天做的这个开发环境还是很简单的，没有用 Dockerfile自己创建镜像， docker-compose配置文件里的设置也很简单，后面用着不顺手有更新了我再推送。下面的两篇老文章对 Docker镜像和 docker-compose讲的都比较深入，例子也多，感兴趣的可以看看。

如果按照文章里说的步骤自己搭建环境的时候遇到什么问题了，可以在文章下方留言， 喜欢我的文章欢迎点在看和转发支持。也欢迎去我新建的知识星球（不收费）一起共建一个 Go语言互助团。