Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yunusemrenalbant/spring-ci-cd-with-jenkins
Bu proje, Jenkins kullanılarak CI ve CD süreçlerinin nasıl otomatize edileceğini göstermektedir.
https://github.com/yunusemrenalbant/spring-ci-cd-with-jenkins
cicd devops jenkins spring spring-boot
Last synced: 3 days ago
JSON representation
Bu proje, Jenkins kullanılarak CI ve CD süreçlerinin nasıl otomatize edileceğini göstermektedir.
- Host: GitHub
- URL: https://github.com/yunusemrenalbant/spring-ci-cd-with-jenkins
- Owner: YunusEmreNalbant
- Created: 2024-09-12T11:46:56.000Z (21 days ago)
- Default Branch: main
- Last Pushed: 2024-09-12T13:57:34.000Z (21 days ago)
- Last Synced: 2024-09-30T06:24:02.084Z (3 days ago)
- Topics: cicd, devops, jenkins, spring, spring-boot
- Language: Java
- Homepage:
- Size: 77.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CI/CD Pipeline With Jenkins
## Proje Hakkında
Bu proje, Spring Boot tabanlı bir uygulamanın Jenkins kullanılarak Continuous Integration (CI) ve Continuous Deployment (CD) süreçlerinin nasıl otomatize edileceğini göstermektedir. Pipeline, uygulamanın önce Maven ile derlenmesini, Docker imajının oluşturulmasını ve sonrasında Docker Hub'a gönderilmesini sağlar. Bu sayede, her yeni commit sonrası uygulamanızın en güncel versiyonu otomatik olarak Docker Hub'da yayınlanır ve dağıtıma hazır hale gelir.
### Gereksinimler
- **Jenkins** (CI/CD işlemleri için)
- **Maven** (Spring Boot uygulamasını derlemek için)
- **Docker** (Uygulamayı konteynerleştirmek ve Docker Hub'a göndermek için)
- **Docker Hub Hesabı** (Docker imajlarını paylaşmak için)
- **ngrok** (Jenkins'i dış dünyaya açmak ve webhook bağlantısını sağlamak için)
### Jenkins Webhook ile Otomatik Build
Projenizde her yeni commit yaptığınızda Jenkins pipeline'ının otomatik olarak çalışması için GitHub üzerinde bir **Webhook** eklenmiştir. Bu webhook, Jenkins'e yapılan her push işlemini haber verir ve pipeline'ın tetiklenmesini sağlar.
#### Webhook Kurulumu
1. **ngrok** kullanarak Jenkins'inize dış dünyadan erişim sağladım. Jenkins'iniz lokal ortamda çalıştığında dışarıya bir URL verebilmek için `ngrok` ile geçici bir HTTP tüneli açabilirsiniz. Aşağıdaki komut ile `ngrok` üzerinden Jenkins'inize ulaşılabilir bir URL elde edebilirsiniz:
```bash
ngrok http
```
Örneğin, Jenkins'iniz varsayılan olarak `8080` portunda çalışıyorsa:
```bash
ngrok http 8080
```
Bu komut size bir URL verecektir (örneğin: `https://abcd1234.ngrok.io`). Bu URL'yi GitHub Webhook ayarlarında kullanabilirsiniz.
2. GitHub'da proje ayarlarına gidin ve **Settings** > **Webhooks** kısmında yeni bir webhook ekleyin.
3. **Payload URL** kısmına ngrok tarafından verilen URL'yi kullanarak şu şekilde girin:
```
https://abcd1234.ngrok.io/github-webhook/
```
4. Content type olarak **application/x-www-form-urlencoded** seçebilirsiniz.
5. Son olarak, hangi eventlerde tetikleneceğini seçin. **Just the push event** seçeneği işaretlenmiş olmalı.
### Jenkins Pipeline Kodu
Aşağıdaki kod, Jenkins'te kullanılan pipeline tanımını içermektedir:
```groovy
pipeline {
agent any
tools {
maven 'maven'
}
stages {
stage('Build Maven') {
steps {
checkout scmGit(branches: [[name: '*/main']], extensions: [], userRemoteConfigs: [[url: 'https://github.com/your-username/your-repo-name']])
sh 'mvn clean install'
}
}
stage('Build Docker Image') {
steps {
script {
sh 'docker build -t your-dockerhub-username/your-app-name:0.0.1 .'
}
}
}
stage('Push image to Hub') {
steps {
script {
withCredentials([string(credentialsId: 'dockerhub-pwd', variable: 'dockerhubpwd')]) {
sh 'docker login -u your-dockerhub-username -p ${dockerhubpwd}'
}
sh 'docker push your-dockerhub-username/your-app-name:0.0.1'
}
}
}
}
}
```
### Bu koddaki alanları kendinize göre güncelleyebilirsiniz:
* **your-username**: GitHub kullanıcı adınız.
* **your-repo-name**: GitHub repo adınız.
* **your-dockerhub-username**: Docker Hub kullanıcı adınız.
* **your-app-name**: Docker imajınıza vermek istediğiniz ad.
### Kimlik Bilgilerinin Yönetimi
Pipeline'da kullanılan Docker Hub kimlik bilgileri, Jenkins'in `withCredentials` bloğu içerisinde güvenli bir şekilde yönetilmektedir. `dockerhub-pwd` olarak tanımlanan kimlik bilgileri, Jenkins'in **Credentials** bölümüne eklenmeli ve burada güvenli bir şekilde saklanmalıdır. Bu sayede, Docker Hub'a giriş yapmak için şifrenizi doğrudan kodda belirtmenize gerek kalmaz.
### Pipeline'ın Çalıştırılması
1. Jenkins'te yeni bir pipeline projesi oluşturun.
2. Yukarıdaki pipeline kodunu Jenkins'e yapıştırın.
3. `dockerhub-pwd` kimlik bilgilerini Jenkins'te ekleyin.
4. Pipeline'ı çalıştırın. Jenkins, projenizi otomatik olarak derleyecek, Docker imajını oluşturacak ve Docker Hub'a gönderecektir.
## Özetle
Bu proje, Spring Boot uygulamalarınız için CI/CD süreçlerini otomatize ederek, geliştirme döngüsünü hızlandırmayı amaçlamaktadır. Her main branch'ine yapılan yeni push ile birlikte uygulamanızın en güncel versiyonu Docker Hub'da yayınlanacak ve dağıtıma hazır hale gelecektir. Pipeline'da kullanılan her adım, geliştirme ve devops süreçlerini daha verimli ve sorunsuz hale getirmek için tasarlanmıştır.
