Description:

The AWS-Jenkins-Pipeline repository provides a robust solution for implementing a CI/CD pipeline by integrating Jenkins with AWS services such as CodeBuild and CodeDeploy. This setup enables automatic deployment of code changes from GitHub, leveraging a fully managed build and deployment workflow to streamline the delivery process. By incorporating AWS CloudFormation, the repository also facilitates infrastructure setup and automation.

Features:

1. Integrated CI/CD Workflow:

   • Automatic pipeline triggered by code changes in a GitHub repository.
   • Uses AWS CodeBuild for compiling source code and producing artifacts.
   • Deploys artifacts to production using AWS CodeDeploy.

2. Infrastructure as Code:

   • AWS CloudFormation template for resource provisioning, including:
     • S3 bucket for storing application artifacts.
     • IAM roles and policies for CodeBuild, CodeDeploy, and Jenkins.
     • EC2 instances for Jenkins and CodeDeploy agents.
     • Auto Scaling group for managing deployment instances.
     • Elastic Load Balancer for high availability.

3. Jenkins Integration:

   • Jenkins configured as the CI/CD orchestrator.
   • Supports plugins for seamless CodeBuild and CodeDeploy operations.
   • Trigger-based execution for real-time deployments.

4. Comprehensive Deployment Support:

   • AppSpec.yml for CodeDeploy lifecycle event management.
   • BuildSpec.yml for CodeBuild build instructions.
   • Scripts for deployment lifecycle hooks.

5. Scalable and Secure Design:

   • Auto Scaling group with EC2 instances running Apache and CodeDeploy agents.
   • Security groups for controlling access to Jenkins, EC2 instances, and the Load Balancer.

6. End-to-End Testing:

   • Automated deployment verification through CodeDeploy and Jenkins console logs.
   • Access to deployment logs for debugging and monitoring.

Requirements:

• AWS Services:

  • AWS CodeBuild, CodeDeploy, and CloudFormation.
  • S3 bucket for artifact storage.
  • EC2 instances for Jenkins server and deployment agents.

• Jenkins:

  • Pre-installed Jenkins server with necessary plugins for AWS integration.
  • Access to the Jenkins dashboard via browser.

• Development Environment:

  • GitHub repository containing the application code.
  • Valid AppSpec.yml and BuildSpec.yml files.

• Credentials and Keys:

  • SSH key pair for accessing EC2 instances.
  • IAM roles for Jenkins, CodeBuild, and CodeDeploy.

Instructions:

Setup Infrastructure

• Launch the AWS CloudFormation template to create:
  • S3 bucket, IAM roles, EC2 instances, Auto Scaling group, and Load Balancer.
• Note the JenkinsServerDNSName and ELBDNSName from the CloudFormation outputs.

2. Access and Unlock Jenkins

• Use the JenkinsServerDNSName to access the Jenkins dashboard in your browser.
• Unlock Jenkins:
  • SSH into the Jenkins server using the provided key pair.
  • Retrieve the password from /var/log/jenkins/jenkins.log.
  • Paste the password into the Jenkins unlock page.

3. Configure Jenkins

• Install and configure CodeDeploy and CodeBuild plugins in Jenkins.
• Create a new Jenkins project and link it to your GitHub repository.
• Set up the project to trigger builds on code changes.

4. Prepare Application Code

• Ensure your GitHub repository includes the following:
  • AppSpec.yml: Defines deployment steps and lifecycle hooks.
  • BuildSpec.yml: Specifies build commands for CodeBuild.
  • Scripts Folder: Contains scripts for deployment lifecycle hooks.

5. Test CI/CD Pipeline

• Push application code to your GitHub repository:

  bash

  Copy code

  git add -A git commit -m "Initial commit" git push

• Monitor Jenkins for triggered builds and review logs for deployment details.
• Verify the deployment by accessing the application via the ELBDNSName.