Jenkins Slave

Jenkins Slave

The Jenkins Slave is a machine that is set up to run build projects scheduled from the master. Slave runs a dedicated program called a slave agent spawned from the master, thus there is no need to install Jenkins itself on a slave.


There are few ways to setup Jenkins master-slave connection, however in our infra currently we use only one of them. In general, the Jenkins master SSH-key is to be placed in authorized_keys file for the jenkins user on a slave machine. Then via the Jenkins Master’s WebUI create a node manually by specifying slave’s node FQDN. After, the Jenkins master will connect to the slave via SSH to the jenkins user, upload slave.jar file and spawn it on slave using jenkins user.

In order to deploy Jenkins Slave please look at already existing hiera role for an example of jenkins slave instance. Check if ssh public key authentication is properly configured.

  1. Ensure that in jenkins master hiera role the following two parameters are set:

       - '::fuel_project::jenkins::master'
    jenkins::master::jenkins_ssh_private_key_contents: |
      -----BEGIN RSA PRIVATE KEY-----
      -----END RSA PRIVATE KEY-----
    jenkins::master::jenkins_ssh_public_key_contents: |
      'ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDNWgMf6IisSY0HK0mpHkgVhRxHs \
      Dom81PJ6W3jAgcSBWY1Kz/2vL98SK91ppgYmnDa2uLbchY2Xk9ciefMpm7Qq5EO6oS \
      KnV7lP1g5dfY1rm6bum7P+Jwf2tdTOa0b5ucK/+iWVbyPO4Z2afPpblh4Vynfe2wMz \
  2. In the jenkins slave role ensure to set proper ‘authorized_keys’ parameter

      - fuel_project::jenkins::slave
        type: ssh-rsa
    # optional - if you wish to use also password authentication, set to true:
    ssh::sshd::password_authentication: true

The above configuration is mandatory to be set in order to get proper master-to-slave connection.

Other case, if the slaves running the particular hiera role are suppose to be able to buid the ISO, it is required to enable ‘build_fuel_iso’ parameter in the ‘slave’ class.

fuel_project::jenkins::slave::build_fuel_iso: true

To deploy Jenkins slave, complete the following steps:

  1. Install base Ubuntu 14.04 with SSH service and set appropriate FQDN.

  2. Install puppet agent package:

    apt-get update; apt-get install -y puppet
  3. Enable puppet agent:

    puppet agent --enable
  4. Run the Jenkins Master deployment.

    FACTER_ROLE=jenkins_slave FACTER_LOCATION=us1 puppet agent -tvd \
    --server puppet-master.test.local --waitforcert 60

The last action requests the client’s certificate. To continue the puppet run, the certificate should be signed from the Puppet Master.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.