I have been setting up a few Jenkins nodes lately and decided that I should write up the configuration that I’m using to share with others.<\/p>\n\n\n\n
The first thing to do is to create the node in Jenkins. Start by logging into your Jenkins host, then visit the “Manage Jenkins” link. Once there, visit “Manage Nodes” and then click “New Node” on the left.<\/p>\n\n\n\n
Give your node a name. It’s a good idea to avoid spaces and special characters. I use letters, numbers, underscores and hyphens. Select “Permanent Agent” and then “OK”.<\/p>\n\n\n\n
Here you need to specify the working directory, labels and the usage. I usually set the usage to only build jobs with a matching label expression. This is useful when setting up nodes per job to make sure that the node doesn’t get used for other random jobs. You may also want to specify an email address to notify when the node goes online and\/or offline.<\/p>\n\n\n\n
Once you have saved the configuration you will see a page specifying that the agent is offline and how to launch it. The important piece of information here is the secret. This will be a very long string of letters and numbers. <\/p>\n\n\n\n
First create a user in Linux that the node will run as. This user should not have any special privileges.<\/p>\n\n\n\n
sudo adduser JENKINS_BUILD_USER<\/code><\/pre>\n\n\n\nReplace “JENKINS_BUILD_USER” with the username that you are using. By default this user has a locked password so no one can login as this user.<\/p>\n\n\n\n
In “\/home\/JENKINS_BUILD_USER” create the file “start-jenkins-node.sh” to start the node<\/p>\n\n\n\n
#!\/bin\/sh\n\ndebug() { ! \"${log_debug-false}\" || log \"DEBUG: $*\" >&2; }\nlog() { printf '%s\\n' \"$*\"; }\nwarn() { log \"WARNING: $*\" >&2; }\nerror() { log \"ERROR: $*\" >&2; }\nfatal() { error \"$*\"; exit 1; }\ntry() { \"$@\" || fatal \"'$@' failed\"; }\n\nmydir=$(cd \"$(dirname \"$0\")\" && pwd -L) || fatal \"Unable to determine script directory\"\n\njenkins_host=JENKINS_HOST\njenkins_node_name=NODE_NAME\njenkins_node_secret=SECRET\n\ncd \"${mydir}\"\n# --no-check-certificate is needed if the certificate store does not recognize the jenkins host certificate\ntry wget https:\/\/${jenkins_host}\/jnlpJars\/agent.jar -O agent.jar\n\n# -noCertificateCheck is needed if the certificate isn't recognized\nnohup java -jar agent.jar -jnlpUrl https:\/\/${jenkins_host}\/computer\/${jenkins_node_name}\/slave-agent.jnlp -secret ${jenkins_node_secret} -workDir \"${HOME}\" > \"${HOME}\"\/jenkins-node.log 2>&1\n<\/code><\/pre>\n\n\n\nReplace JENKINS_HOST with the hostname that Jenkins is running on. This script assumes that Jenkins is running at hte root of your server. If that’s not the case you’ll want to append the base path to the end of JENKINS_HOST. Replace NODE_NAME with the name of the node and SECRET with the secret from the node configuration on the Jenkins host.<\/p>\n\n\n\n
Mark the file executable.<\/p>\n\n\n\n
chmod +x \/home\/JENKINS_BUILD_USER\/start-jenkins-node.sh<\/code><\/pre>\n\n\n\nCreate “\/etc\/systemd\/system\/jenkins_node.service”<\/p>\n\n\n\n
[Service]\nType=simple\nExecStart=\/home\/JENKINS_BUILD_USER\/start-jenkins-node.sh\nWorkingDirectory=\/home\/JENKINS_BUILD_USER\nRestart=always\nRestartSec=60\nUser=JENKINS_BUILD_USER\n\n[Unit]\nAfter=network-online.target\nWants=network-online.target\n\n[Install]\nWantedBy=default.target\n<\/code><\/pre>\n\n\n\nReplace JENKINS_BUILD_USER with the user that you created. Then you can enable and start the service with<\/p>\n\n\n\n
sudo systemctl daemon-reload\nsudo systemctl enable jenkins_node\nsudo systemctl start jenkins_node<\/code><\/pre>\n\n\n\nAt this point you should see your node online in Jenkins and you are ready to use it for jobs.<\/p>\n","protected":false},"excerpt":{"rendered":"
I have been setting up a few Jenkins nodes lately and decided that I should write up the configuration that I’m using to share with others. Create the node in Jenkins The first thing to do is to create the node in Jenkins. Start by logging into your Jenkins host, then visit the “Manage Jenkins” … Continue reading Configure Linux Jenkins node<\/span>