在Windows上安装GoCD代理

安装

您必须作为具有管理员权限的用户登录,以便在Windows上安装GoCD代理。

  1. 下载页面下载一个go-agent版本。
  2. 双击go-agent-${version}-setup.exe安装程序文件并按照提示进行安装。
  3. 在安装期间,您将被要求为您的GoCD代理选择一个根路径。除了作为代理安装目录外,这个目录还包含另一个目录,其中您的源代码将被检出并构建。
  4. 接下来将提示您选择绑定的JRE,或者指定在您的系统上安装JRE(或JDK)的位置。
  5. 安装完文件后,安装程序将提示您输入GoCD服务器的主机名或IP地址。将此空白保留为localhost
  6. 在安装结束时,GoCD代理将自己注册为windows服务并开始自动运行。

静默(Headless)安装

如果您想要编写GoCD代理的安装,您可以使用此方法。

go-agent-${version}-setup.exe /S /START_AGENT=NO /SERVERURL="<SERVERURL>" /GO_AGENT_JAVA_HOME=<PATH_TO_JAVA_HOME> /D=<PATH_TO_AGENT_DIRECTORY>
Argument Required Description
SERVERURL No GoCD服务器的URL。默认为https://127.0.0.1:8154/go。值必须被"引号包围。如果使用powershell.exe引号必须以` 的形式转义。
START_AGENT No 代理服务是否应该在安装之后启动。设置为NO(区分大小写),以便在安装之后禁用启动服务。
GO_AGENT_JAVA_HOME No 代理应该运行的JRE(或JDK)的路径。与代理打包的jre的默认值。需要至少是Java 8(与GoCD服务器相同的版本)。
PATH_TO_AGENT_DIRECTORY No 应该安装代理的路径。默认为C:\Program Files(x86)\Go Agent

例如:

C:\> go-agent-16.1.0-1234-setup.exe /S /SERVERURL="https://10.12.20.47:8154/go" /D=C:\go\agent

以防你使用powershell.exe静默安装,SERVERURL 参数需要通过引号来传递:

C:\> go-agent-16.1.0-1234-setup.exe /S /SERVERURL=`"https://10.12.20.47:8154/go`" /D=C:\go\agent

如果您的Windows系统上启用了用户访问控制功能,则需要关闭它,以便静默安装工作。

如果您正在使用静默安装来升级GoCD,您不应该指定安装目录选项。

覆盖默认的启动参数和环境

  • 创建一个名为config/wrapper-properties.conf的文件。你在哪里安装了代理。
  • 复制任何特定属性,或者从config/wrapper-agent.conf中添加新属性到上边的文件。如果添加任何新属性,一定要增加属性索引。
  • 例如. 覆盖日志级别以进行调试,重写 wrapper.console.loglevel -

    # config/wrapper-properties.conf
    wrapper.console.loglevel=DEBUG
    
  • 将额外的JVM args附加到代理

    # config/wrapper-properties.conf
    # since the last "wrapper.java.additional" index is 2, we use the next available index.
    wrapper.java.additional.3=-Xmx512mb
    
  • 每个属性必须分别配置

    # Having a single property for multiple configurations is invalid, e.g
    wrapper.java.additional.16="-Dcruise.config.foo='bar' -Dcruise.config.other='baz'"
    
    有效的属性,
    wrapper.java.additional.16=-Dcruise.config.foo=bar
    wrapper.java.additional.17=-Dcruise.config.other=baz
    

    请注意 : 如果go-agent作为一个应用程序是由任何用户运行的,那么这个用户需要对go-agent文件夹具有这些必需的权限,即修改、读取和执行、列出文件夹内容和读取权限。

GoCD代理文件的位置

GoCD代理的所有文件都在Windows的根安装文件夹下,默认位置是 C:\Program Files\Go Agent.

在服务器上注册代理

出于安全原因,所有新安装的Go代理都需要在工作分配给它们之前在Go服务器上启用。这可以防止未经授权的人访问您的源代码。要启用新安装的Go代理,请执行以下操作:

  1. 打开Go服务器仪表板
  2. 按照这里 的说明来找到您刚刚安装在列表中的代理,并将代理添加到您的云。Go服务器现在将为该代理安排工作。

results matching ""

    No results matching ""