Bu kılavuzda GitLab Runner’ın Ubuntu 22.04’e nasıl kurulacağını adım adım inceleyeceğiz.
Gitlab, yazılım kodunu barındırmak için merkezi bir konum sunan güçlü, açık kaynaklı ve zengin özelliklere sahip bir kod deposu ve işbirliğine dayalı yazılım geliştirme platformudur. GitHub için mükemmel bir alternatiftir ve büyük DevOps projelerini yönetmek için ideal bir platformdur. CI/CD yetenekleri, geliştirme ekiplerinin kodlarını sorunsuz bir şekilde otomatikleştirmesine, oluşturmasına ve test etmesine ve ayrıca sorunları takip etmesine yardımcı olur.
Gitlab runner, yerel makinenizde gitlab-ci.yml dosyasında tanımlanan işleri yürütmek için kullanılan bir aracıdır. Dosya, oluşturma, test etme ve dağıtma aşamaları da dahil olmak üzere CI/CD işlem hattınızın çeşitli aşamalarını tanımlar. Runner görevleri yürütür ve sonuçları GitLab’a aktarır.
1) Apt Depo Dizinini Güncelleyin
Çalışmaya başlamak için sunucunuzda oturum açın ve yerel APT önbelleğini güncelleyin.
$ sudo apt update
Önbellek güncellendikten sonra bir sonraki adıma geçin.
2) GitLab Runner Yükleyici Komut Dosyasını İndirin
GitLab, Ubuntu’nun varsayılan depolarında barındırılmıyor veya sağlanmıyor. Bunun yerine Gitlab, kurulum sürecini basitleştiren bir kurulum betiği sağlar. Bu nedenle, Gitlab Runner yükleyici komut dosyasını gösterildiği gibi indirip çalıştırın.
$ curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash
Betik yerel önbelleği günceller, gereken gerekli paketleri yükler ve Gitlab çalıştırıcı deposunu /etc/apt/sources.list.d olarak tanımlanan kaynaklar listesi dizinine ekler. Sistem GitLab Runner’ı yüklemek için bu depoyu kullanacaktır.
3) GitLab Runner’ı Ubuntu 22.04’e yükleyin
Depo mevcut olduğunda sistem artık Gitlab Runner’ın nereye kurulacağını biliyor. GitLab runnerı kurmak için apt paket yöneticisini aşağıdaki gibi kullanın.
$ sudo apt install gitlab-runner
Yüklenen GitLab Runner sürümünü onaylamak için şu komutu çalıştırın:
$ sudo gitlab-runner -version
Çıktıdan GitLab Runner 16.6.0 olan en son sürümü yüklediğimizi görebilirsiniz.
4) GitLab Runner’ın Durumunu Doğrulayın
Varsayılan olarak GitLab Runner yüklendikten sonra otomatik olarak başlar ve bunu gösterildiği gibi doğrulayabilirsiniz.
$ sudo gitlab-runner status
Herhangi bir nedenden dolayı hizmet çalışmıyorsa, gösterildiği gibi başlatabilirsiniz.
$ sudo gitlab-runner start
Hizmeti etkinleştirerek sistem önyüklemesinde başlayacak şekilde de ayarlayabilirsiniz.
$ sudo gitlab-runner enable
5) GitLab Runner’ı GitLab’a Kaydetme
GitLab Runner’ı yükledikten sonra Gitlab hesabınıza kaydetmeniz gerekir. Bu, Runner’ı Gitlab hesabınızdaki projelere bağlar ve CI/CD görevlerinin yürütülmesine yardımcı olur.
Ön koşul olarak, önceden var olan bir projeye ve bir Project Runner’a sahip bir GitLab hesabınızın olması gerekir.
GitLab Runner’ınızı kaydetmek için sol kenar çubuğuna gidin ve projenize tıklayın. Bizim durumumuzda ‘Epiphany’ adında bir projemiz var.
Next, head over to ‘Settings‘ –> ‘CI/CD‘.
Bir koşucunuz yoksa, onu nasıl oluşturacağınız aşağıda açıklanmıştır. ‘Runners’ bölümünde ‘Genişlet’i tıklayın.
Daha sonra, bir proje yürütücüsü oluşturmak için ‘Yeni Proje Yürütücüsü’ne tıklayın
Be sure to fill in all the necessary fields and click ‘Create Runner’
Koşucu zaten oluşturulmuş durumdayken, GitLab Runner’ı kaydetmek için kullanılacak belirteç değerini komut satırından kopyalayın.
Komut satırına geri döndüğünüzde, Runner’ı kaydetmek için aşağıdaki komutu çalıştırın; burada belirteç numarası, kopyaladığınız belirteç değeridir.
$ sudo gitlab-runner register token-number
Komut size bir dizi bilgi isteminde yol gösterir:
Öncelikle GitLab URL örneğini sağlamanız istenecektir: https://gitlab.com yazın ve ENTER tuşuna basın.
Daha sonra sizden kayıt jetonunu girmeniz istenecektir. Kopyaladığınız jeton değerini girin ve ENTER tuşuna basın.
Daha sonra bir uygulayıcı sağlayın. Ne sağlayacağınızdan emin değilseniz ‘Shell’i tercih edin.
Son olarak Runner’ın başarıyla kaydedildiğine dair bildirim alacaksınız.
Yapılandırma (kimlik doğrulama belirteciyle birlikte) /etc/gitlab-runner/config yapılandırma dosyasına kaydedilecektir.
Bu kılavuzda GitLab Runner’ın Ubuntu 22.04’e nasıl kurulacağını gösterdik. Ayrıca GitLab Runner örneğinin GitLab’a nasıl kaydedileceğini göstermek için bir adım daha ileri gittik.
Yazının orijinalini buradan okuyabilirsiniz.
Kariyerime 26 yıl önce başladım. Windows ve Linux sistemlerinin kurulumu, yapılandırılması, yönetimi ve bakımı dahil olmak üzere birden fazla sistem üzerinde uzmanlaştım.
Açık kaynak dünyasındaki en son gelişmelerden haberdar olmaktan ve Linux hakkındaki en son araçları, özellikleri ve hizmetleri denemekten hoşlanıyorum.
Son 6 yıldır sistem ve ağ yöneticisi olarak görev yapıyorum ayrıca Pardus Dönüşüm Projesini yönetiyorum ve Pardus İşletim Sisteminin yaygınlaşması adına uğraş gösteriyorum.
Boş zamanlarımda açık kaynaklı uygulamaların Türkçe çevirisine katılıyorum ve The Document Foundation üyesiyim.