puppet-teamcity

KO | EN

gitlite — search

#javascript #python #llm #golang #machine-learning #rust #macos #nodejs #java #windows #cli #awesome-list #pytorch #security

puppet-teamcity

(★ 9)

Teamcity module for puppet

puppet-teamcity Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Build Status](https://travis-ci.org/grundic/puppet-teamcity.svg?branch=master)](https://travis-ci.org/grundic/puppet-teamcity)

## NOT MAINTAINED ANYMORE
This project is not maintained anymore by the author.
If you're interested in updating/volunteering, please let me know.

## Overview
![Transformation](https://raw.githubusercontent.com/grundic/puppet-teamcity/master/puppet-teamcity.gif?raw=true)
This Puppet module installs and configures TeamCity build agent (https://www.jetbrains.com/teamcity).

A TeamCity Build Agent is a piece of software which listens for the commands from the TeamCity
server and starts the actual build processes. It is installed and configured separately from the
TeamCity server. An agent can be installed on the same computer as the server or on a different
machine (the latter is a preferred setup for server performance reasons).

## Usage
Here is an example how to use this module:
```puppet
include '::teamcity'
```
Here is sample of usage with some parameters:
```puppet
class {'::teamcity':
  agent_name            => 'sample-build-agent',
  manage_user           => true,
  manage_group          => true,
  custom_properties     => {
      'system.teamcity.idea.home' => '%system.agent.home.dir%/tools/idea'
  },
  launcher_wrapper_conf => {
    'wrapper.app.parameter.11' => '-Dfile.encoding=UTF-8'
  }
}
```

Also you can parametrize class from hiera:
```yaml
teamcity::agent_name: sample-build-agent
teamcity::agent_dir: /var/tainted/build-agent
teamcity::custom_properties:
  "system.teamcity.idea.home": "%system.agent.home.dir%/tools/idea"
```

##Reference

##Classes

* teamcity::params: Default configuration parameters
* teamcity::agent: Main class for installation and configuration.
* teamcity::agent::config: Internal class for managing configuration
* teamcity::agent::install: Handles package installation.
* teamcity::agent::service: Handles service status.

###Parameters

####`agent_name`
Build agent name, that will be displayed on Teamcity server. By defaults set to hostname.

####`agent_user`
User name, which will be used to run and configure build agent. Defaults to `teamcity`.

####`agent_user_home`
If user is managed, set it's home dir. Defaults to $agent_dir.

####`manage_agent_user_home`
Manage whether to create home dir for user. Defaults to `false`.

####`agent_group`
Name of group to be used for build agent. Defaults to `teamcity`.

####`manage_user`
Whether to create user for build agent. Defaults to `false`.

####`manage_group`
Whether to create group for build agent. Defaults to `false`.

####`server_url`
Root url of Teamcity server. It will be used in agent's config. Defaults to `http://builder`.

####`archive_name`
Name of archive that should be downloaded from `server_url`. Defaults to `buildAgent.zip`.

####`download_url`
Calculated parameter, that is used to download build agent distributive.
Defaults to `${server_url}/update/${archive_name}`.

####`agent_dir`
Installation path, where build agent will reside.
Defaults to `/opt/build-agent`.

####`service_ensure`
Required service status. Defaults to `running`.

####`service_enable`
Should the service be enabled. Defaults to `true`.

####`service_provider`
This parameter determines how service would be executed. Depending on operating
system there could be one or more choices.
For modern Linux distributions `systemd` would be used (Ubuntu 15, CentOS 7),
for more old ones `init` would be set.
For Windows you can select two possibilities for agent run: `service`
or `standalone`. If set to `service`, then agent is executed as regular windows
service. In standalone mode the shortcut is created in Startup folder of
specified user. This mode is required in some cases to overcome service's
shortcomings (it could interact with desktop, so, it could not for
example create Direct3d device).

####`teamcity_agent_mem_opts`
String for configuring additional java parameters for build agent.

####`custom_properties`
Hash of custom properties, that will be applied to conf/buildAgent.properties

####`launcher_wrapper_conf`
Hash of custom properties, that will be applied to launcher/conf/wrapper.conf

## Development

Clean host
```
sudo service build-agent stop; sudo userdel --force --remove teamcity; sudo rm -rf /etc/init.d/build-agent /lib/systemd/system/build-agent.service /opt/build-agent/
```

puppet-teamcity

puppet-teamcity Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

puppet-teamcity

puppet-teamcity Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README