...
Servers connecting to Akraino Jenkins using this method must have access to the internet.
Please follow below steps to connect a slave to Akraino Jenkins.
- Create a user named Jenkins on the machine you want to connect to Akraino Jenkins and give the user sudo rights.
- Install needed software on the machine you want to connect to Akraino Jenkins as slave.
- openjdk 8
- monit
- If the slave will be used for running virtual deployments, Functest, and Yardstick, install below software and make Jenkins user the member of the groups.
- docker
- libvirt
Create slave root in Jenkins user home directory.
Code Block language bash mkdir
...
-p
...
/home/jenkins/akraino/slave_root
Clone Akraino
...
ci-management repository.
...
Code Block language bash mkdir -p
...
/home/jenkins/
...
akraino/repos
...
cd
...
/home/jenkins/
...
akraino/repos
...
git
...
clone
...
https://gerrit.akraino.org/
...
r/ci-managementContact LF by sending mail
...
to Akraino Helpdesk and request creation of a slave on Akraino Jenkins. Include below information in your mail.
Slave root (/home/jenkins/
...
akraino/slave_root)
...
- Number of executors (the number of concurrent jobs to allow on the slave
...
- Once you get confirmation from LF stating that your slave is created on Akraino Jenkins, check if the firewall on LF is open for the server you are trying to connect to Jenkins.
...
- ).
- Label(s). The label(s) define what jobs can be run on a particular slave. Each job should have a slave-label defined in its JJB definition.
- A slave name. This has generally followed the convention of "<OS>-dev-<CPUs>c-<RAM>g", though this is not a strict rule. The important thing is that the name is a unique and useful identifier. Other elements, such as "prd" or "snd" to identify the environment or numbering at the end, will be added by LF.
- You will receive a confirmation from LF containing the complete slave name and a secret token.
Run the following script in order to make sure there is no problem connecting. You should see INFO: Connected in the console log.
Code Block language bash cp /home/jenkins/akraino/repos/ci-management/utils/jenkins-jnlp-connect.sh /home/jenkins/
...
cd
...
/home/jenkins
...
sudo
...
./jenkins-jnlp-connect.sh
...
-j /home/jenkins
...
-u
...
jenkins
...
-n
...
<slave
...
name
...
on
...
Akraino
...
Jenkins>
...
-s
...
<the
...
token you
...
received
...
from
...
LF>
...
- If you receive an error, follow the steps listed on the command output.
- Run the same script with test(-t) on foreground in order to make sure no problem on connection. You should see INFO: Connected in the console log.
...
-t
If you receive a connectivity error, then you need to check your firewall and allow outgoing connections for the port.
Kill the Java slave.jar process.
Run the same script normally without test (-t) in order to get monit script created.
Code Block language bash sudo
...
./jenkins-jnlp-connect.sh
...
-j
...
/home/jenkins
...
-u
...
jenkins
...
-n
...
<slave name
...
on
...
Akraino
...
Jenkins>
...
-s
...
<the
...
token
...
you
...
received
...
from
...
LF>
Edit monit configuration and enable http interface. The file to edit is /etc/monit/monitrc on Ubuntu systems. Uncomment below lines.
Code Block # set httpd port
...
2812 and # use address localhost # only accept connection from localhost # allow localhost # allow localhost to connect to the server and
Restart monit service.
Without systemd:
...
sudo service monit restart
With systemd: you have to enable monit service first and then restart it.
sudo systemctl enable monit
sudo systemctl enable monitsudo systemctl restart monit
Check to see if
...
Jenkins comes up as managed service in monit.
...
sudo monit status
Connect slave to Akraino Jenkins using monit.
...
sudo monit start jenkins
Check slave on Akraino Jenkins to verify the slave is reported as connected.
...
The slave on Akraino Jenkins should have some executors in “Idle” state if the connection is successful
...
Notes
PGP Key Instructions
Public PGP Key can be uploaded to public key server so it can be taken from there using your mail address. Example command to upload the key to key server is
...
.
...
The Public PGP Key can also be attached to the email by storing the key in a file and then attaching it to the email.
...