Jenkins Build on EC2

Let's Setup the build environment by deploying Jenkins on EC2 as Build Server

For our build environment we’ll launch an Amazon EC2 instance using the Amazon Linux 2 AMI, install and configure the required packages. Make sure that the security group you select for your instance allows traffic on ports TCP/22 and TCP/80 so you will be able to connect to you instance via SSH and access it via browser using its DNS.

Install and configure Jenkins and required packages

Connect to your EC2 instance using your private key:

$ ssh -i "path-to-key/key.pem" ec2-user@<instance-name>.<instance-region>.compute.amazonaws.com

First, let’s update the repositories and install Docker and Git:

$ sudo yum update -y
$ sudo yum install -y docker git

Add the Jenkins repository and install Jenkins from there:

$ sudo wget -O /etc/yum.repos.d/jenkins.repo http://pkg.jenkins.io/redhat/jenkins.repo
$ sudo rpm — import https://pkg.jenkins.io/redhat/jenkins.io.key
$ sudo yum install jenkins -y
$ sudo usermod -aG root jenkins # Add jenkins to the root group

To allow Jenkins to build our Docker images, we need to add the jenkins user to the docker group:

# Add Jenkins and current user to the Docker group
$ sudo usermod -aG docker $USER
$ sudo usermod -aG docker jenkins

Add the Jenkins and Docker services to start on boot and start both services:

# Add Jenkins and Docker to startup
$ sudo chkconfig jenkins on
$ sudo chkconfig docker on
$ sudo chkconfig --list
# Start Jenkins and Docker as a service
$ sudo service jenkins start
$ sudo service docker start

As Jenkins typically uses port TCP/8080, we’ll configure iptables routing rules to redirect the traffic:

$ sudo iptables -I INPUT 1 -p tcp --dport 8080 -j ACCEPT
$ sudo iptables -I INPUT 1 -p tcp --dport 80 -j ACCEPT
$ sudo iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8080

I’m not covering the usage of SSL certificates, to use HTTPS you need to include rules to redirect traffic for port 443:

$ sudo iptables -I INPUT 1 -p tcp --dport 8443 -j ACCEPT
$ sudo iptables -I INPUT 1 -p tcp --dport 443 -j ACCEPT
$ sudo iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 8443

You can find more about SSL certificates on this article from Paul Lessing:Single-Page Apps on AWS, Part 1: Hosting a Website on S3 How to set up S3, CloudFront and CloudFlare to host a static website on S3 without a dedicated server.medium.com

At this point you should be able to see the Jenkins home page using the public DNS name of your EC2 instance(e.g. ec2–<ec2-public-ip-address>.compute-1.amazonaws.com):Jenkins Setup — Administrator password

Get the password from the indicated file:

$ sudo cat /var/lib/jenkins/secrets/initialAdminPassword

Install the recommended plugins and create an Admin account in the following steps.

At this point you should be able to login an see the following page:Jenkins home page

Install Jenkins Plugins

At the Jenkins home page on the left menu select Manage Jenkins -> Manage Plugins select the tab Available and search for the following plugins:

Last updated