Repetitive tasks are usually tedious and end up taking up a lot of your time and energy. Over time, multiple automation tools have been developed to help alleviate the hassle of executing repetitive jobs. When you download and configure Jenkins using docker, you have to use manual command to manage the process. It becomes quite unsafe and complicated. So, we will manage it using systemd. Actually, it is the system and service manager for Linux operating systems. It features on-demand starting, enabling, restarting, and stopping of daemons, logging, etc.
Here at LinuxAPT, as part of our Server Management Services, we regularly help our Customers to perform related Linux Systemd queries.
In this context, we shall look into how to download the Jenkins package from docker hub repository and manage it using systemd manager on any Linux distribution such as Ubuntu, centos, Debian, Redhat etc which support systemd.
For the configuration, you need to run a process we need users. So, we create a system group, add a system user to the group. As you don't need to login we provide no login shell. We have here given the name 'devops', you can give of your choice:
$ sudo groupadd --system devops
$ sudo useradd -s /sbin/nologin --system -g devops devopsDuring docker installation, a user docker was added by default. So to run our process inside docker, let’s add 'devops' user and your current login user to the docker group:
$ sudo usermod -aG docker devops
$ sudo usermod -aG docker $USERWe need a directory to map container volume to the host. So, let’s create a directory and give current user ownership in the directory:
$ sudo mkdir -p /data/jenkins
$ chown -R $USER:$USER /data/jenkinsYou can now verify user 'devops' using the following command:
$ id devopsNow it's time to create a service. The service files are stored inside /etc/systemd/system/ So, create a file ending with .service as shown below:
$ vim /etc/systemd/system/docker-jenkins.serviceAdd following content in the file. The following configuration will create a service name docker-jenkins. It will simply pull the latest version of jenkins image from docker hub and run the container. It will also map port 8080 and 50000 in the host server, which are needed to access jenkins service. As defined in the Unit section below, it requires docker.service to be executed successfully. If you have different users, mount points change accordingly:
[Unit]
Description=My Jenkins Server
Documentation=https://jenkins.io/doc/
After=docker.service
Requires=docker.service
[Service]
Type=simple
User=devops
Group=devops
TimeoutStartSec=0
Restart=on-failure
RestartSec=30s
ExecStartPre=-/usr/bin/docker kill jenkins-server
ExecStartPre=-/usr/bin/docker rm jenkins-server
ExecStartPre=/usr/bin/docker pull jenkins/jenkins
ExecStart=/usr/bin/docker run \
--name jenkins-server \
--publish 8080:8080 \
--publish 50000:50000 \
--volume /data/jenkins:/var/jenkins_home \
jenkins/jenkins
SyslogIdentifier=jenkin
ExecStop=/usr/bin/docker stop jenkins-server
[Install]
WantedBy=multi-user.targetReload the service file in the systemd daemon, using the following command:
$ sudo systemctl daemon-reloadStart the docker service using the command below:
$ sudo systemctl start docker-jenkinsSystemd also provides default logging service in syslog. You can see the log in the following location:
$ sudo tail -f /var/log/syslogNow, you can start the service after the server reboots using the 'enabling' feature of systemd manager:
$ sudo systemctl enable docker-jenkinsAlso, check by restarting the service:
$ sudo systemctl restart docker-jenkinsTo setup jenkins first visit http://yourserverip:8080. Then you need to enter the initial admin password, which is set in the following path. Copy the output and paste it in 'Administrator password'. Then click on continue:
$ cat /data/jenkins/secrets/initialAdminPasswordYou can install the required plugin and continue.
This article covers how to Run Jenkins Server in Docker Container with Systemd. Jenkins is an opensource automation server that is designed to help software developers build, test and deploy applications and thereby streamline the continuous integration and delivery process.
To create a system group for Jenkins, run the command:
$ sudo groupadd --system jenkinsThen create Jenkins system user:
$ sudo useradd -s /sbin/nologin --system -g jenkins jenkinsAnd finally add Jenkins user to docker group as shown:
$ sudo usermod -aG docker jenkinsTo confirm that Jenkins user is added to the docker group, run the id command as shown:
$ id jenkins
