VPS Üzerinde Woodpecker CI'yi Kendinize Host Etme (Tam Kılavuz)

VPS Üzerinde Woodpecker CI’yi Kendinize Host Etme (Tam Kılavuz)

Woodpecker CI, açık kaynaklı Birleştirme ve Dağıtım Süreçleri (CI/CD) sistemi. Kendinize host etmek, geliştirme hattınızı kolaylaştırırken ortamınızı kontrol etmenizi sağlar. Bu kılavuzda, Docker kullanarak VPS üzerine Woodpecker CI’yi kurma ve yapılandırma adımlarını anlatacağız.

Gereksinimler

1. VPS: Bir VPS sağlayıcısı seçin. İşte Woodpecker CI barındırmak için popüler VPS seçeneklerinin karşılaştırması:

Performans ve bütçenize uygun bir sağlayıcı seçin. Detaylı VPS karşılaştırması için tüm VPS karşılaştırması sayfasını inceleyebilirsiniz.

2. İşletim Sistemi: Uygun bir işletim sistemi kullanın, tercihen Ubuntu 20.04 veya sonrası.

3. Docker: VPS’nize Docker kurun.

Adım 1: Docker Kurulumu

Ubuntu üzerinde Docker kurmak için aşağıdaki komutları kullanın:

sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt-get update
sudo apt-get install docker-ce

Kurulumdan sonra Docker’ın çalıştığını doğrulayın:

sudo systemctl start docker
sudo systemctl enable docker
sudo systemctl status docker

Adım 2: Woodpecker CI Kurulumu

1. Woodpecker CI Docker Görüntüsünü Çekin:

Aşağıdaki komutu kullanarak Woodpecker CI görüntüsünü çekin:

docker pull woodpeckerci/woodpecker

2. Woodpecker CI Konteynerini Oluşturun ve Çalıştırın:

Görüntüyü aldıktan sonra, bir konteyner oluşturun. Yapılandırmanıza göre çeşitli ortam değişkenleri belirlemeniz gerekecek:

docker run -d \
  --name woodpecker \
  --volume /var/lib/woodpecker:/data \
  -e WOODPECKER_GITEA_SERVER=https://your-gitea-instance.com \
  -e WOODPECKER_RPC_SECRET=your-rpc-secret \
  -e WOODPECKER_SERVER=true \
  -p 8000:8000 \
  woodpeckerci/woodpecker

WOODPECKER_GITEA_SERVER ve WOODPECKER_RPC_SECRET değerlerini, kullandığınız Gitea instance veya diğer herhangi bir Git servisine göre ayarlayın.

Adım 3: Woodpecker CI’yi Yapılandırma

1. Web Arayüzüne Erişim: Web tarayıcınızı açın ve http://<vps-ip-niz>:8000 adresine gidin. Woodpecker CI arayüzünü görmelisiniz.

2. Webhooks Kayıt Edin: Gitea kullanıyorsanız, repo bağlantılarını tetiklemek için webhooks kaydettiğinizden emin olun.

3. Diğer Servislerle Entegrasyon: Proje ihtiyaçlarınıza göre bildirimler veya dağıtım adımlarını .woodpecker.yml dosyasını düzenleyerek entegre edin.

Sıkça Sorulan Sorular (SSS)

1. Woodpecker CI’yi SaaS seçeneği yerine kendim host etmenin avantajları nelerdir?

Kendinize host etmek, derleme ortamınız üzerinde tam kontrol sağlar ve proje gereksinimlerine göre yapılandırma yapmanıza imkan tanır. Üçüncü taraf hizmetlerin getirdiği sınırlamalardan (örneğin, derleme zaman kotaları ve kaynak kodu erişim eksikliği) kaçınabilirsiniz. Ayrıca, gizlilik açısından da avantaj sağlar; kodlarınız ve verileriniz tamamen sizin altyapınızda kalır.

2. Woodpecker CI örneğimi trafik taleplerine göre ölçeklendirebilir miyim?

Evet, Docker kullanmanın en büyük avantajlarından biri ölçeklenebilirliktir. CI/CD kullanımı yükseldiğinde, Woodpecker CI örneklerinin sayısını artırabilir veya VPS’nize ek kaynaklar atayabilirsiniz. Birden fazla örneği yönetmek ve etkili ölçeklendirme için Kubernetes veya Docker Compose gibi konteyner orkestrasyon araçlarını kullanmayı düşünebilirsiniz.

3. Kendinize host ettiğiniz Woodpecker CI’de yedekleme ve geri yükleme nasıl çalışır?

Woodpecker CI verilerinizin olduğu klasörü düzenli olarak yedekleyin (/var/lib/woodpecker) veri kaybını önlemek için. VPS sağlayıcınızın yedekleme çözümlerini kullanabilir veya düzenli tar komutlarıyla yedekleme yapabilirsiniz. Veri bozulması veya kaybı durumunda, yedeklediğiniz veriyi aynı dizine geri yükleyin ve Woodpecker CI konteynerinizi yeniden başlatın.

Bu adımları takip ederek, VPS üzerinde tam çalışan bir Woodpecker CI örneği kurmuş olacaksınız. Bu kurulum, daha verimli geliştirme süreçleri ve ihtiyaçlarınıza uygun özelleştirmeler sağlar. --- BİTİŞ ---