GoCD服务器容器镜像

基于Wolfi的GoCD服务器容器镜像。

问题与反馈？

请通过 [***] 提交。

使用方法

通过以下命令启动容器：

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

此命令会将容器的8153端口（HTTP）暴露到主机。启动后可通过 http://localhost:8153 访问。

可用配置选项

挂载卷

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

shell
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 目录下。

使用环境变量安装插件

通过添加前缀为 GOCD_PLUGIN_INSTALL_、后缀为自定义名称的环境变量，值为插件下载URL，即可安装插件。插件仅在不存在时下载。

例如，安装Docker弹性代理插件：GOCD_PLUGIN_INSTALL_docker-elastic-agents=[***]：

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

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

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

使用自定义入口脚本安装插件（见下文）

shell
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 加载配置。私有仓库可使用认证令牌。默认克隆 master 分支，如需指定分支，可通过 CONFIG_GIT_BRANCH 环境变量设置。若 /godata/config 已为Git仓库，则 CONFIG_GIT_REPO 会被忽略。克隆的仓库必须包含 /godata/config 目录的所有文件。

shell
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/ 中的文件。

运行自定义入口脚本

如需在容器启动阶段、GoCD服务器启动前执行自定义脚本，可通过 -v /path/to/your/script.sh:/docker-entrypoint.d/your-script.sh 挂载脚本：

shell
docker run -v /path/to/your/script.sh:/docker-entrypoint.d/your-script.sh ... gocd/gocd-server:v25.3.0

若需执行多个脚本，可挂载包含脚本的目录：

shell
docker run -v /path/to/script-dir:/docker-entrypoint.d ... gocd/gocd-server:v25.3.0

注意： 确保脚本具有可执行权限（chmod a+x），容器中已安装 bash。若使用其他脚本语言（如perl、python），需确保容器中已安装相应解释器。

调整JVM选项（内存、堆等）

可通过环境变量 GOCD_SERVER_JVM_OPTS 调整JVM选项：

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

底层目录说明

GoCD服务器以 go 用户（uid 1000）运行，以下是主要目录说明：

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

GoCD服务器启动后，需确定其在容器中的IP地址及映射到主机的端口，供GoCD代理连接使用。若通过以下命令启动容器：

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

可通过以下命令获取服务器IP、服务器端口和SSL端口：

shell
docker inspect --format='{{(index (index .NetworkSettings.IPAddress))}}' server
docker inspect --format='{{(index (index .NetworkSettings.Ports "8153/tcp") 0).HostPort}}' server

故障排除

GoCD服务器无法启动

• 检查容器是否运行：docker ps -a
• 查看STDOUT输出以定位故障：docker logs CONTAINER_ID
• 检查服务器日志：docker exec -it CONTAINER_ID tail -f /godata/logs/go-server.log（若使用卷挂载，可直接查看挂载目录中的日志文件）

许可证

plain
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.