使用 Docker 搭建属于你自己的 Go Playground

本篇文章将介绍如何通过容器来部署属于你自己的 Go Playground。

Go Playground 是 Golang 团队推出的在线语言工具，不论是对于初学者而言，还是对 Golang 开发者来说，它都不失为一个简单好用的神器。

但由于种种原因，国内部分用户使用这个功能可能会遇到一些网络问题，而无法使用这个服务；以及出于运行代码包含一些“隐私”，而无奈放弃这个服务。

写在前面

这个周末花了一些时间，对 Golang 官方 Go Playground 项目进行了一些调整，让项目能够轻松的在 GCE 环境之外的普通 Docker 容器环境中运行起来，让我们能够在本地快速验证各种 Golang 代码片段。

调整后的项目有哪些特点呢：

支持完全离线运行，无需“联网”，不需担心有任何信息泄漏的风险（比如包含密钥的程序）。
支持使用容器进行快速启动，不锁定任何公有云或者复杂的运行环境。
和官方程序一样，使用沙盒方式运行 Golang 程序，确保运行程序安全，无副作用。
和官方程序一样，使用 faketime “模块”，让程序能够提供确定性的输出，让程序复现和结果缓存变的更加容易。
合并了来自 go.dev 的默认示例，并进行了适当的界面“汉化”。
大幅精简程序模块和依赖，减少不必要的资源消耗。

完整的项目代码，我已经上传到了 GitHub，如果你需要的话，可以自取。

准备工作

想要使用这个项目非常简单，准备工作只有三步：准备 Docker 环境、下载容器镜像、准备容器编排文件。

准备 Docker 环境

我们需要先完成 Docker 运行环境的安装，如果你的本地环境中已经安装了 Docker，那么可以跳过这个小节，阅读后面的内容。

如果你是桌面运行环境，可以访问官网下载安装文件，如果你使用的是服务端环境，可以参考这篇文章中的“更简单的 Docker 安装”，来完成 Docker 环境的准备。

获取必要的容器镜像

在 Docker 环境就绪之后，我们需要执行下面的命令，来获取必要的容器镜像：

docker pull soulteary/golang-playground:web-1.18.4
docker pull soulteary/golang-playground:sandbox-1.18.4
docker pull soulteary/golang-playground:actuator-1.18.4
docker pull memcached:1.6.15-alpine

准备容器编排文件

在镜像文件就绪之后，我们需要先编写一个容器编排文件，来定义各种容器服务该如何运行：

version: '3'
services:

  sandbox:
    image: soulteary/golang-playground:sandbox-1.18.4
    restart: always
    command: -mode=server -listen=0.0.0.0:80 -workers=1 -untrusted-container=soulteary/golang-playground:actuator-1.18.4
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    networks:
      - playground
    depends_on:
      - memcached

  web:
    image: soulteary/golang-playground:web-1.18.4
    restart: always
    environment:
      - SANDBOX_BACKEND_URL=http://sandbox:/run
      - MEMCACHED_ADDR=memcached:11211
    ports:
      - 8080:8080
    depends_on:
      - sandbox
    networks:
      - playground

  memcached:
    image: memcached:1.6.15-alpine
    command: memcached -m 64
    networks:
      - playground
networks: 
  playground:

将上面的文件保存为 docker-compose.yml 之后，我们使用 docker-compose up -d 或 docker compose up -d（新版本 Docker）命令来启动程序。

使用程序

在启动程序之后，我们打开浏览器，访问 http://localhost:8080，就可以开始快捷的 Golang 之旅啦。

浏览器中的界面

你可以在“代码文本框”中自行输入代码，然后点击“运行”，来让代码在容器中完成自动编译、构建、链接、运行等一系列操作。

也可以使用顶部菜单栏的“内置示例”下拉框，来选择某一个例子，学习如何使用 Golang 或者这个工具，比如：启动并验证 HTTP 服务器的返回、在一个编辑器中同时使用多个 Go 程序文件、如何编写单元测试、如何使用并发来进行科学计算等等…

其他

如果你想了解 Go Playground 这个项目背后的“黑魔法”，可以阅读这篇官方博客，里面详细的介绍了项目的由来、如何模拟时钟、避免死锁、模拟文件系统、模拟网络调用等。

**这些实现，是官方应用和目前开源社区里的其他三方实现的主要差别。**换言之，如果不进行这些“tricks”，Playground 的计算结果的稳定性和结果的一致性其实存在比较大的挑战。

当然，为了避免 DDoS 攻击，官方还在实现中添加了 MemCached 组件，来缓存计算过程和结果。（支持 Sleep 这类异步输出的日志结果）

最后

关于 Go Playground 如何使用 Docker 进行本地化部署就聊到这里。

我们下一篇文章再见。

–EOF

砥砺