Ana içeriğe geç
Destek Çevrimiçi
MirrorLooking Glass
RabisuRabisu
Müşteri Paneli
RehberlerBilgi Bankası

CircleCI ile Otomatik Deployment Kurulumu (Ubuntu)

Bu rehberde ne öğreneceksiniz?​

Bu rehberde CircleCI kullanarak GitHub’a gönderilen kodların Ubuntu sunucuya otomatik dağıtımını öğreneceksiniz.
Node.js tabanlı basit bir uygulama ile uçtan uca CI/CD hattı kuracağız.

CI/CD Nedir ve Neden CircleCI?​

CI/CD, kodun test edilmesini ve dağıtılmasını otomatikleştirir.

oaicite:0
, hızlı kurulum ve sade pipeline yapısıyla öne çıkar.
oaicite:1
 entegrasyonu güçlüdür.

Ön Gereksinimler​

Başlamadan önce şunlar hazır olmalı:

  1. Ubuntu 18.04 yüklü bir VPS (örnek: tr1-node01)
  2. GitHub hesabı
  3. CircleCI hesabı
  4. Node.js ve npm kurulu bir ortam
  5. Temel Git bilgisi

1️⃣ Yerel Node.js Projesi Oluşturma​

Bu adımda örnek bir Node.js uygulaması hazırlıyoruz.

mkdir circleci-test
cd circleci-test
npm init -y
  • Bu komutlar proje dizini oluşturur ve npm yapılandırmasını başlatır.

Basit HTTP Sunucu​


const http = require('http');

http.createServer((req, res) => {
  res.write('Hello World!');
  res.end();
}).listen(8080, '0.0.0.0');
  • Bu kod 8080 portunda basit bir web sunucusu başlatır.

2️⃣ CircleCI Yapılandırma Dosyası​

  • CircleCI işlemleri .circleci/config.yml dosyasından okur.

mkdir .circleci
nano .circleci/config.yml

version: 2.1

jobs:
  deploy:
    docker:
      - image: arvindr226/alpine-ssh
    steps:
      - checkout
      - run: ssh -oStrictHostKeyChecking=no $USER@$IP "./deploy.sh"

workflows:
  deploy-workflow:
    jobs:
      - deploy:
          filters:
            branches:
              only: main
  • Bu yapılandırma yalnızca main dalına gelen kodları dağıtır.

3️⃣ Projeyi GitHub’a Gönderme​


git init
git add .
git commit -m "ilk commit"
git branch -M main
git remote add origin https://github.com/kullanici_adi/circleci-test
git push -u origin main
  • Bu adımlar projeyi GitHub deposuna gönderir.

4️⃣ Sunucuda Deployment Kullanıcısı Oluşturma​

  1. Güvenlik için ayrı bir kullanıcı kullanılır.

sudo useradd -m -d /home/circleci -s /bin/bash circleci
sudo ufw allow 8080
  • Bu komutlar circleci kullanıcısını oluşturur ve portu açar.

5️⃣ SSH Anahtarı Oluşturma​

  1. CircleCI’nin sunucuya bağlanması için gereklidir.

ssh-keygen -m PEM -t rsa -f ~/.ssh/circleci

  • Bu komut CircleCI uyumlu bir SSH anahtarı üretir.

  • Public key, sunucuda authorized_keys içine eklenir.

6️⃣ CircleCI Proje Ayarları​

  1. CircleCI panelinde:

  2. Projeyi GitHub’dan ekleyin

  3. Use Existing Config seçin

  4. SSH Key olarak özel anahtarı girin

  5. Environment Variables ekleyin:

  6. USER = circleci

  7. IP = sunucu_ip_adresi

7️⃣ Sunucuda deploy.sh Dosyası​

  1. Bu dosya her deploy’da çalışır.

#!/bin/bash

cd ~/circleci-test
git pull origin main
npm install
pm2 restart app

chmod +x deploy.sh
  • Bu script kodu çeker, bağımlılıkları kurar ve uygulamayı yeniden başlatır.

8️⃣ Deploy Testi​

  1. Kodda küçük bir değişiklik yapın:

res.write('Foo Bar!');

git add .
git commit -m "deploy testi"
git push origin main
  • Push sonrası CircleCI pipeline otomatik çalışır.

Sıkça Sorulan Sorular (SSS)​

** CircleCI neden SSH kullanıyor?** Sunucuya güvenli ve otomatik erişim sağlar.

2. deploy.sh zorunlu mu? Hayır, ama süreci sadeleştirir.

3. Sudo yetkisi neden verilmedi? Güvenlik riskini azaltmak için.

4. pm2 şart mı? Hayır, ama Node.js için önerilir.

Sonuç​

Artık GitHub’a gönderilen her kod otomatik olarak Ubuntu sunucunuza dağıtılıyor. Manuel deploy derdi bitti, kahveni alıp pipeline izleme zamanı ☕😄

Bu yapıyı Rabisu Bulut altyapısında kullanarak projelerinizi güvenle ölçekleyebilirsiniz 🚀