Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alilotfi23/jenkins-k8s
Deployment on Kubernetes Cluster using Jenkins CI/CD Project
https://github.com/alilotfi23/jenkins-k8s
cd ci cicd jenkins jenkins-pipeline kubernetes kubernetes-cluster kubernetes-deployment
Last synced: 2 months ago
JSON representation
Deployment on Kubernetes Cluster using Jenkins CI/CD Project
- Host: GitHub
- URL: https://github.com/alilotfi23/jenkins-k8s
- Owner: alilotfi23
- Created: 2023-09-18T07:44:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-12T18:23:37.000Z (2 months ago)
- Last Synced: 2024-10-13T07:42:26.067Z (2 months ago)
- Topics: cd, ci, cicd, jenkins, jenkins-pipeline, kubernetes, kubernetes-cluster, kubernetes-deployment
- Language: Dockerfile
- Homepage:
- Size: 20.5 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Jenkins-K8s Deployment
### Overview
This project demonstrates the deployment of applications on a Kubernetes cluster using Jenkins for Continuous Integration and Continuous Deployment (CI/CD).
### BluePrint
The following diagram provides a high-level overview of the CI/CD pipeline:
1. **Source Code Push**: A developer pushes the source code to a Git repository.
2. **Webhook Trigger**: The push event triggers a webhook to Jenkins.
3. **Build Image**: Jenkins pulls the source code and builds a Docker image.
4. **Push to Docker Hub**: The built Docker image is pushed to Docker Hub.
5. **Deploy on Kubernetes**: The Docker image is deployed to a Kubernetes cluster.
### Prerequisites
Ensure you have the following installed and configured:
- Jenkins
- Docker
- Kubernetes Cluster
- Git
- Docker Hub Account
### Setup Instructions
#### 1. Jenkins Setup
- Install Jenkins on your server.
- Install the necessary plugins: Git, Docker, and Kubernetes.
#### 2. Git Repository
- Create a repository on GitHub or any Git service.
- Add your project files to the repository.
#### 3. Webhook Configuration
- In your Git repository, configure a webhook to trigger Jenkins builds on code push events.
#### 4. Jenkins Job Configuration
- **Source Code Management**: Configure Jenkins to pull the source code from your Git repository.
- **Build Triggers**: Set up the webhook to trigger the build process.
- **Build Steps**:
- Use a Jenkins pipeline to build the Docker image.
- Push the Docker image to Docker Hub.
- **Post-build Actions**: Deploy the Docker image to the Kubernetes cluster.
#### 5. Docker Hub Configuration
- Create a repository on Docker Hub to store your Docker images.
#### 6. Kubernetes Deployment
- Write Kubernetes deployment YAML files to deploy the Docker image from Docker Hub.
- Ensure your Kubernetes cluster is configured to pull images from Docker Hub.
### Jenkins Pipeline Script
sample Jenkins pipeline script:
```groovy
pipeline {
agent any
stages {
stage('Clone Repository') {
steps {
git 'https://github.com/your-repo.git'
}
}
stage('Build Docker Image') {
steps {
script {
docker.build("your-dockerhub-username/your-image-name:latest")
}
}
}
stage('Push to Docker Hub') {
steps {
script {
docker.withRegistry('https://index.docker.io/v1/', 'dockerhub-credentials-id') {
docker.image("your-dockerhub-username/your-image-name:latest").push()
}
}
}
}
stage('Deploy to Kubernetes') {
steps {
kubernetesDeploy configs: 'k8s/deployment.yaml', kubeConfig: [path: 'path/to/kubeconfig']
}
}
}
}
```
### Kubernetes Deployment YAML
Create a `deployment.yaml` file for your Kubernetes deployment:
```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
name: your-app
spec:
replicas: 3
selector:
matchLabels:
app: your-app
template:
metadata:
labels:
app: your-app
spec:
containers:
- name: your-app
image: your-dockerhub-username/your-image-name:latest
ports:
- containerPort: 80
```
### Conclusion
By following the above steps, you can set up a Jenkins pipeline to automate the deployment of your applications on a Kubernetes cluster. This ensures a smooth CI/CD process, enabling rapid development and deployment.