CI-CD flow using Jenkins/Terraform/Ansible/Docker
This is a demo project for provisiong server, configuring server and deploying a backend app using Jenkins + Terraform + Ansible.
Notice: Docker image of the backend application is built automatically by Github Action.
Prerequisites
1. Install Jenkins server
Guide : https://www.digitalocean.com/community/tutorials/how-to-install-jenkins-on-ubuntu-20-04
2. Install Ansible and Terraform
Install Ansible
apt-get update && apt-get install -y ansible
Install Terraform
sudo apt-get update && sudo apt-get install -y gnupg software-properties-common curl
curl -fsSL https://apt.releases.hashicorp.com/gpg | sudo apt-key add -
sudo apt-add-repository "deb [arch=amd64] https://apt.releases.hashicorp.com $(lsb_release -cs) main"
sudo apt-get update && sudo apt-get install terraform
3. Create a key for AWS Key Pair
This is a key used for connecting to AWS EC2 Instance provisioned using Terraform.
sudo su jenkins
ssh-keygen -f ~/.ssh/aws_key
4. Configure AWS credential file
This is a credential file for connecting to AWS services. This credential file is used by Terraform.
sudo su jenkins
mkdir ~/.aws
nano ~/.aws/credentials
And add the content below with the approriate values.
[default]
aws_access_key_id = <access_key>
aws_secret_access_key = <secret_key>
Configure Jenkins
Setup Ansible and Terraform tools
Install ansible
and terraform
plugins in Jenkins -> Manage Plugins -> Available
.
Confirm the installation directory for ansible/terraform binaries inside Jenkins server. Then set the tool name and the installation directory under Ansible/Terraform in Jenkins -> Manage Plugins -> Global Tool Configuration
.
Create a pipeline
Create a Pipeline job (New Item -> Pipeline
) and set Jenkinsfile under Pipeline script from SCM
.
Once a Pipeline job created, please build it. It will provision an AWS EC2 server and install everything, finally deploy the backend service.
Check Backend endpoint.
The final stage Backend Url
of the pipeline should show the backend url. Then open it on web browser.