GoCD服务器容器镜像

概述和主要用途

基于Wolfi的GoCD服务器容器镜像，用于部署和运行GoCD持续集成/持续部署（CI/CD）服务器。GoCD是一款功能强大的CI/CD工具，支持复杂部署流程、并行执行和可视化流水线管理。

问题反馈

如有问题或反馈，请在GitHub仓库提交：[***]

使用方法

通过以下命令启动容器，暴露8153端口（HTTP）：

docker run -d -p8153:8153 gocd/gocd-server:v25.3.0

启动后可通过http://localhost:8153访问GoCD服务器。

配置选项

挂载卷

GoCD服务器将配置、流水线历史数据库、制品、插件和日志存储在/godata目录；如需提供安全凭证（如SSH私钥），可挂载/home/go目录：

docker run -v /path/to/godata:/godata -v /path/to/home-dir:/home/go gocd/gocd-server:v25.3.0

注意：确保/path/to/home-dir和/path/to/godata可被容器内go用户（uid 1000）访问。

安装插件

所有插件需安装在/godata/plugins目录下，支持以下两种方式：

环境变量安装

通过前缀为GOCD_PLUGIN_INSTALL_的环境变量指定插件下载URL，插件仅在不存在时下载：

docker run \
  -e GOCD_PLUGIN_INSTALL_docker-elastic-agents=[***] \
  gocd/gocd-server:v25.3.0

安装多个插件可添加多个-e参数：

docker run \
  -e GOCD_PLUGIN_INSTALL_a-plugin=[***] \
  -e GOCD_PLUGIN_INSTALL_b-plugin=[***] \
  gocd/gocd-server:v25.3.0

自定义入口脚本安装

通过挂载目录手动放置插件：

mkdir -p /godata/plugins/external
curl --location --fail [***] > /path/to/godata/plugins/external/plugin.jar
chown -R 1000 /godata/plugins/external

从Git仓库加载配置

通过环境变量CONFIG_GIT_REPO指定Git仓库URL加载配置，支持私有仓库认证（使用令牌）和分支指定（CONFIG_GIT_BRANCH）。若/godata/config已为Git仓库，则CONFIG_GIT_REPO会被忽略。克隆的仓库必须包含/godata/config目录下所有文件：

docker run \
  -e CONFIG_GIT_REPO=[***]<password_or_auth_token>/config.git \
  -e CONFIG_GIT_BRANCH=branch_with_config \
  gocd/gocd-server:v25.3.0

检出内容会覆盖/godata/config/目录下文件。

运行自定义入口脚本

如需在服务器启动前执行自定义脚本，将脚本挂载到/docker-entrypoint.d/目录：

# 单脚本
docker run -v /path/to/your/script.sh:/docker-entrypoint.d/your-script.sh ... gocd/gocd-server:v25.3.0

# 多脚本目录
docker run -v /path/to/script-dir:/docker-entrypoint.d ... gocd/gocd-server:v25.3.0

注意：确保脚本具有可执行权限（chmod a+x），容器已预装bash，其他脚本语言需自行确保解释器存在。

调整JVM选项

通过GOCD_SERVER_JVM_OPTS环境变量调整JVM参数（如内存、堆大小）：

docker run -e GOCD_SERVER_JVM_OPTS="-Xmx4096mb -Dfoo=bar" gocd/gocd-server:v25.3.0

内部目录说明

GoCD服务器以go用户（uid 1000）运行，关键目录功能如下：

确定主机上的服务器IP和端口

GoCD代理需通过容器IP和端口连接服务器，若通过以下命令启动容器：

docker run --name server -it -p8153:8153 gocd/gocd-server:v25.3.0

可通过以下命令获取IP和端口：

# 获取服务器IP
docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' server

# 获取主机映射端口
docker inspect --format='{{(index (index .NetworkSettings.Ports "8153/tcp") 0).HostPort}}' server

故障排除

GoCD服务器无法启动

• 检查容器状态：docker ps -a
• 查看容器输出日志：docker logs CONTAINER_ID
• 检查服务器日志：docker exec -it CONTAINER_ID tail -f /godata/logs/go-server.log（或直接查看卷挂载目录中的日志文件）

许可证

Copyright Thoughtworks, Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    [***]

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.