Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thejaxon/jenkins-config-as-code
The purpose is to locally spin up a pre-configured Jenkins instance that uses Jenkins Kubernetes Plugin to dynamically create containers on specific namespaces for CI builds.
https://github.com/thejaxon/jenkins-config-as-code
jenkins jenkins-configuration-as-code kubernetes
Last synced: about 2 months ago
JSON representation
The purpose is to locally spin up a pre-configured Jenkins instance that uses Jenkins Kubernetes Plugin to dynamically create containers on specific namespaces for CI builds.
- Host: GitHub
- URL: https://github.com/thejaxon/jenkins-config-as-code
- Owner: theJaxon
- Created: 2021-08-28T18:18:16.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-12T08:57:05.000Z (3 months ago)
- Last Synced: 2024-11-12T09:38:31.079Z (3 months ago)
- Topics: jenkins, jenkins-configuration-as-code, kubernetes
- Language: Dockerfile
- Homepage:
- Size: 26.4 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# jenkins-config-as-code
**Table of Contents** *generated with [DocToc](https://github.com/thlorenz/doctoc)*
- [Using the project](#using-the-project)
- [Integration with Kubernetes](#integration-with-kubernetes)
- [Jenkins Kubernetes cloud configuration](#jenkins-kubernetes-cloud-configuration)
- [Sample Pipeline that relies on Kubernetes Plugin](#sample-pipeline-that-relies-on-kubernetes-plugin)
The purpose is to locally spin up a pre-configured Jenkins instance that uses [`Jenkins Kubernetes Plugin`](https://plugins.jenkins.io/kubernetes/) to dynamically create containers on specific namespaces for CI builds.
### Using the project
- Dockerfile is used to handle the installation of all the required Plugins.
- Instructions below are for building on [Kontainer8](https://github.com/theJaxon/Kontainer8) Worker node
```bash
vagrant ssh worker
git clone https://github.com/theJaxon/jenkins-config-as-code.git
cd jenkins-config-as-code
# Create new image with plugins specified in Dockerfile pre-installed
podman build --tag jenkins-local .
# Save the image into tar file
podman save jenkins-local -o jenkins-local.tar
# Use ctr to import the image
sudo ctr -n=k8s.io images import jenkins-local.tar
# Apply resources inside Deployment directory via Kustomize
kustomize build Manifests | kubectl apply -f -
# Login username and password are admin
```
---
#### Integration with Kubernetes
- The current cluster setup is the same as [`Kontainter8 project setup`](https://github.com/theJaxon/Kontainer8)
- To give Jenkins access to Spin up pods in any namespace there's a [service account](https://github.com/theJaxon/jcasc/blob/main/Deployment/service-account.yaml) created, this SA gets tied to the cluster role [`cluster-admin`](https://github.com/theJaxon/jcasc/blob/main/Deployment/cluster-role-binding.yaml)
- All this is handled via [`kustomization.yaml`](https://github.com/theJaxon/jcasc/blob/main/Deployment/kustomization.yaml)
- Kustomize [generates a configMap](https://github.com/theJaxon/jcasc/blob/main/Deployment/kustomization.yaml#L20) from `JCasC.yaml` file then the file gets mounted at `/var/jenkins_home/casc_configs/JCasC.yaml`
- Configuration as code file is loaded via the environment variable [`CASC_JENKINS_CONFIG`](https://github.com/theJaxon/jenkins-config-as-code/blob/main/Manifests/statefulset.yaml#L41)
- Persistent Volume is created Via local-path provisioner with is the default storage class for Kontainer8
---
#### Jenkins Kubernetes cloud configuration
- The connection between dynamic pods and jenkins is handled via [`jnlp-slave`](https://hub.docker.com/r/jenkinsci/jnlp-slave/)
- For this a Pod template is created where the container name is **jnlp**, when the name changed it caused errors so it's kept as jnlp and the Pod template name is also **jnlp**
- The template is pre-configured via jcasc
---
#### Sample Pipeline that relies on Kubernetes Plugin
```yaml
podTemplate(containers: [
containerTemplate(name: 'buildah', image: 'quay.io/buildah/stable', command: 'sleep', args: '99d', privileged: true),
containerTemplate(name: 'maven', image: 'maven:3.8.6-jdk-11', command: 'sleep', args: '99d')]
) {
node(POD_LABEL) {
stage('Compile') {
container('maven') {
git url: 'https://github.com/quarkusio/quarkus-quickstarts.git', branch: 'main'
dir("getting-started"){
sh "mvn package"
}
}
}
stage('Image Build'){
container('buildah'){
// https://github.com/quarkusio/quarkus-quickstarts/tree/main/getting-started
dir("getting-started"){
sh"""
container=\$(buildah from --name "quarkus-container" docker.io/amazoncorretto:11)
buildah copy \$container target/quarkus-app/lib/ /deployments/lib/
buildah copy \$container target/quarkus-app/*.jar /deployments/
buildah copy \$container target/quarkus-app/app/ /deployments/app/
buildah copy \$container target/quarkus-app/quarkus/ /deployments/quarkus/
buildah config --entrypoint "java -jar /deployments/quarkus-run.jar -Dquarkus.http.host=0.0.0.0" \$container
buildah commit \$container 723178642448.dkr.ecr.us-east-1.amazonaws.com/quarkus:latest
buildah images
buildah login -u AWS -p ${LOGIN_TOKEN} 723178642448.dkr.ecr.us-east-1.amazonaws.com
buildah push 723178642448.dkr.ecr.us-east-1.amazonaws.com/quarkus:latest
"""
}
}
}
}
}
```