Step-by-Step Guide to Deploy addressbook.war Application

Step 1: Set Up Version Control

1. Repository CreationCreate a repository on GitHub, GitLab, or any other version control system.Push your addressbook application code, including the .war file generation setup, to this repository.

Step 2: Set Up Jenkins

1. Install JenkinsInstall Jenkins on your CI server if it’s not already installed.Ensure Jenkins has the necessary plugins (e.g., Git plugin, Maven Integration plugin).

Step 3: Configure Jenkins Job

1. Create a Jenkins Pipeline Job
2. Pipeline Script

Example Jenkinsfile:

pipeline {

agent any

stages {

stage('Checkout') {

steps {

// Checkout the code from the repository

git 'https://github.com/Rohit2k00/addressbook.git'

}

}

stage('Build') {

steps {

// Build the .war file using Maven

sh 'mvn clean package'

}

}

stage('Test') {

steps {

// Run unit tests

sh 'mvn test'

}

}

stage('Deploy') {

steps {

// Deploy the .war file to the Tomcat server

deployToTomcat()

}

}

}

post {

success {

echo 'Deployment successful!'

}

failure {

echo 'Deployment failed!'

}

}

}

def deployToTomcat() {

// Define server details

def server = 'your-production-server'

def user = 'your-username'

def password = 'your-password'

def remotePath = '/path/to/tomcat/webapps'

// Transfer the .war file to the Tomcat server

sh """

sshpass -p ${password} scp target/addressbook.war ${user}@${server}:${remotePath}

"""

// Restart Tomcat to deploy the new .war file

sh """

sshpass -p ${password} ssh ${user}@${server} "sudo systemctl restart tomcat"

"""

}

Step 4: Configure Maven

1. pom.xml ConfigurationEnsure your pom.xml is correctly set up to package the application as a .war file.

Example pom.xml snippet:

<packaging>war</packaging>

<build>

<finalName>addressbook</finalName>

<plugins>

<plugin>

<groupId>org.apache.maven.plugins</groupId>

<artifactId>maven-war-plugin</artifactId>

<version>3.2.3</version>

</plugin>

</plugins>

</build>

Step 5: Install and Configure Tomcat Server

1. Tomcat Installation
2. Secure Tomcat

Step 6: Run Jenkins Pipeline

1. Trigger the PipelineManually trigger the Jenkins pipeline for the first deployment.Set up webhooks or polling to automatically trigger the pipeline on code changes.

Step 7: Monitor and Validate

1. Check the DeploymentValidate the deployment by accessing the application URL (e.g., https://your-production-server:8080/addressbook).Check Tomcat logs to ensure the application is running correctly.

Step 8: Implement Rollback Strategy

1. Rollback MechanismPlan for a rollback strategy in case of a failed deployment.Optionally, automate rollback steps in the Jenkins pipeline.

Additional Considerations

• Environment Variables: Use Jenkins credentials to manage sensitive information like server passwords.
• Access Control: Ensure proper permissions are set for Jenkins jobs and server access.
• Monitoring: Integrate monitoring tools (e.g., Nagios, Prometheus) to monitor application health and performance post-deployment.

By following these steps, you can set up a robust CI/CD pipeline to deploy your addressbook.war application to a production environment efficiently and reliably.