在 Linux 上安装 GoCD 代理
使用包管理器安装 GoCD 代理需要root
对机器的访问权限。
基于RPM的发行版(例如RedHat/CentOS/Fedora)
GoCD 代理 RPM 安装程序已在 RedHat Enterprise Linux 和 CentOS 上进行了测试。它应该适用于大多数基于 RPM 的 Linux 发行版。
如果您更喜欢使用dnf/yum仓库并通过dnf/yum安装,请在您的shell中粘贴以下内容 -
sudo curl https://download.gocd.org/gocd.repo -o /etc/yum.repos.d/gocd.repo
一旦设置好仓库后,执行
sudo dnf install -y go-agent
或者,如果你有代理的 RPM已下载:
sudo rpm -i go-agent-${version}.noarch.rpm
基于Debian的发行版(例如Ubuntu)
GoCD 代理 .deb 安装程序已在 Ubuntu 上进行了测试。然而,它应该适用于大多数使用 debs 的 Linux 发行版。
如果您更喜欢使用APT仓库并通过apt-get
安装,请在您的shell中粘贴以下内容 -
sudo install -m 0755 -d /etc/apt/keyrings
curl https://download.gocd.org/GOCD-GPG-KEY.asc | sudo gpg --dearmor -o /etc/apt/keyrings/gocd.gpg
sudo chmod a+r /etc/apt/keyrings/gocd.gpg
echo "deb [signed-by=/etc/apt/keyrings/gocd.gpg] https://download.gocd.org /" | sudo tee /etc/apt/sources.list.d/gocd.list
sudo apt-get update
一旦设置好仓库后,执行
sudo apt-get install --install-recommends go-agent
或者,如果你有代理的 DEB已下载:
sudo dpkg -i go-agent-${version}.deb
推荐的依赖项默认会在大多数发行版上自动安装,因此不需要此选项,但是,如果您选择不安装这些依赖项,则需要自己安装JRE并在wrapper-properties.conf
配置目录中指定的位置进行配置。
在Docker容器上安装
若要在容器上运行GoCD,请使用我们的官方docker容器镜像
如果可以通过 rpm/deb 包进行安装,但这通常不推荐,因为 GoCD 代理包旨在通过 init 系统安装,而不是通过容器入口点管理。
管理GoCD代理进程
必须使用以下参数之一运行GoCD代理脚本:
脚本 | 描述 |
---|---|
service go-agent console | GoCD代理将在前台启动 |
service go-agent start | GoCD代理将作为后台守护程序启动 |
service go-agent stop | GoCD代理将停止 |
service go-agent restart | GoCD代理将重新启动 |
service
利用了您的操作系统使用的服务管理器(例如systemd、upstart、init.d)。
GoCD代理文件的位置
GoCD 代理会在你的文件系统中以下位置安装其文件:
位置 | 描述 |
---|---|
/var/lib/go-agent |
GoCD 代理配置和工作目录 |
/var/log/go-agent |
GoCD 代理日志文件 |
/usr/share/go-agent |
GoCD 代理二进制文件和启动脚本 |
/usr/share/go-agent/wrapper-config/wrapper-properties.conf |
用于更改 GoCD 代理属性的配置文件 |
配置GoCD代理
安装GoCD代理后,必须首先使用您的GoCD服务器的主机名(或IP地址)配置代理,为此:
- 打开
/usr/share/go-agent/wrapper-config/wrapper-properties.conf
使用您喜欢的文本编辑器。 - 按照文件中的说明配置GoCD服务器URL
- 保存文件并退出编辑器。
- 在该目录下手动运行
service go-agent [start|restart]
以启动或重新启动代理。
在服务器上注册您的代理
出于安全原因,所有新安装的GoCD代理都需要在GoCD服务器上启用,然后才能分配工作给他们。这可以防止未经授权的人访问您的源代码。要启用新安装的GoCD代理,请执行以下操作:
- 打开GoCD服务器仪表板
- 按照指示在这里在列表中找到您刚刚安装的代理,并将代理添加到您的云中。GoCD服务器现在将为此代理安排工作。