hms-dbmi / avillachlab-jenkins

Overview

Welcome to the base folder of your Jenkins project. This folder contains two subfolders, each dedicated to a specific aspect of your Jenkins infrastructure: jenkins-docker and jenkins-terraform. Below, you'll find an overview of each component along with links to their respective README files for detailed information.

Jenkins Docker (jenkins-docker)

This section focuses on the Dockerization of Jenkins, incorporating additional tools and configurations to enhance its functionality. The Jenkins Docker image is extended from the official LTS image, making it a versatile and powerful solution. For more information, refer to the Jenkins Docker README.

Jenkins Terraform (jenkins-terraform)

Here, Terraform is leveraged to deploy and manage Jenkins infrastructure on AWS. The README provides insights into the variables, backend configuration, and outputs defined in the Terraform files. Detailed information about variables, Terraform backend configuration, and outputs can be found in the Jenkins Terraform README.

Feel free to explore each component to understand their configurations, usage, and any additional details you may need for managing your Jenkins environment efficiently. If you have any questions or need assistance, don't hesitate to reach out.

Table of Contents

• Jenkins Docker
• Jenkins Terraform

Feel free to dive into the respective sections for detailed information and instructions.

Jenkins Docker (jenkins-docker)

This section focuses on the Dockerization of Jenkins, incorporating additional tools and configurations to enhance its functionality. The Jenkins Docker image is extended from the official LTS image, making it a versatile and powerful solution.

Jenkins Docker README

• Features
• Prerequisites
• Building the Image
• Configuration
• Usage
• Cleanup
• Contributing
• License

Feel free to explore the Jenkins Docker README for comprehensive information on configuring, building, and using the Docker image.

Jenkins Terraform (jenkins-terraform)

Here, Terraform is leveraged to deploy and manage Jenkins infrastructure on AWS. The README provides insights into the variables, backend configuration, and outputs defined in the Terraform files.

Jenkins Terraform README

• Variables
• Terraform Backend
• Outputs

Feel free to explore the Jenkins Terraform README for detailed information on variables, Terraform backend configuration, and outputs.

Feel free to explore each component to understand their configurations, usage, and any additional details you may need for managing your Jenkins environment efficiently. If you have any questions or need assistance, don't hesitate to reach out.

avillachlab-jenkins's Issues

Jenkins LTS container no longer accepts --httpsCertificate param

As of 2.361.1 Jenkins LTS no longer accepts the --httpsCertificate param, and instead requires a PKCS12 or JKS Keystore File. This causes install-docker.sh to encounter a Java IllegalArgumentException Error:

Exception in thread "main" java.lang.IllegalArgumentException: Unrecognized option: --httpsCertificate

This generated keystore must have a password, per Oracle's technical docs:

This command prompts the user for a password. The password is required. The KeyStore fails to work with JSSE without a password. This password must also be supplied as the password for the Adapter’s KeyStore password.
https://docs.oracle.com/cd/E19509-01/820-3503/ggfhb/index.html

The commands in install-docker.sh should be modified with something resembling the following:

$pass = `openssl rand -hex 20`
openssl pkcs12 -export -in /root/jenkins.cer -inkey /root/jenkins.key -out /root/jenkins.p12 -password pass:$pass
sudo docker run -d -v /var/jenkins_home/jobs:/var/jenkins_home/jobs                     
  -v /var/jenkins_home/config.xml:/usr/share/jenkins/ref/config.xml.override              
  -v /var/jenkins_home/workspace:/var/jenkins_home/workspace                 
  -v /var/run/docker.sock:/var/run/docker.sock            
  -v /root:/root          
  -p 443:8443                   
  --restart always                   
  --name jenkins                    
  avillach-lab-dev-jenkins                 
  --httpsPort=8443                  
  --httpsKeyStore=/root/jenkins.p12
  --httpsKeyStorePassword=$pass