Semaphore UI ve GitLab CI/CD

GitLab.com Git barındırmayı, CI/CD'yi ve çevresindeki platformu yönetilen hizmet olarak sunar. Self-Managed GitLab için Linux paketleri, Docker ve Kubernetes kurulumları PostgreSQL, Redis ve arka plan worker'ları gibi birlikte çalışan çeşitli hizmetler içerir. GitLab'ı zaten işleten ekip başka web hizmeti eklemeden bu kurulumu otomasyon için kullanabilir.

Semaphore UI uygulama hizmeti ve veritabanıyla bağımsız ikili dosya, yerel Linux paketi, Docker konteyneri veya Kubernetes dağıtımı olarak çalışabilir. Yerel sunucu ikili dosyaları macOS, Windows ve FreeBSD'yi de kapsar. Böylece yalnızca otomasyon arayüzüne ihtiyaç duyan ekip mevcut Git hizmetinin yanına daha küçük bir uygulama kurabilir.

Sunucu ve worker platformları farklı seçimlerdir. Desteklenen Self-Managed GitLab sunucusu Linux'ta çalışsa da GitLab Runner Windows ve macOS dahil işletim sistemlerinde çalışabilir. Semaphore UI web hizmeti Windows'ta çalıştığında bile Ansible yürütmesi Linux, WSL veya Linux runner gibi desteklenen bir kontrol ortamına ihtiyaç duyar.

GitLab job'ları pipeline YAML içinde tanımlanan komutları runner'da yüklü veya konteyner imajının sağladığı araçlarla çalıştırır. Böylece Ansible, Terraform/OpenTofu ve Terragrunt test ve dağıtımla aynı pipeline'da veya bağımsız bakım pipeline'ında yer alabilir. GitLab merge request'lerle incelenen değişiklikler için OpenTofu bileşenleri ve altyapı iş akışlarını da belgeler.

Semaphore UI Ansible, Terraform/OpenTofu, Terragrunt, Bash, PowerShell ve Python için ayrı görev şablonları sunar. Mühendisler arayüzde depoyu, araç ayarlarını, kimlik bilgilerini ve ortak değişkenleri seçerken otomasyon kodu Git'te kalır. Terraform kaynak sağlama görevi veya Python hazırlık kontrolü bağımsız, zamanlanmış veya iş akışı içinde çalışabilir. Bu model, ortak başlatma ayarlarını Semaphore UI'da yönetmek ve hazırlanmış işlemleri arayüzden sunmak isteyen ekiplere uygundur. İş sırası ve yapılandırma dahil orkestrasyondaki değişikliklerin kod incelemesi ve sürüm geçmişi gerektirdiği durumlarda Pipeline YAML yararlıdır.

Kaynak sağlama için Semaphore UI Pro workspace'ler, sürüm geçmişi ve arayüz yönetimi içeren HTTP state backend ekler. Paylaşılan Terraform/OpenTofu state başka hizmet gerektirmeden hazırlanmış IaC işlemlerinin yanında kalabilir. GitLab tarafından yönetilen Terraform/OpenTofu state Free'de mevcuttur ve HTTP backend ile kilitlemeyi de destekler. İki üründe de mevcut harici backend'ler kullanılabilir. Semaphore UI'ın varsayılan plan ve apply komutları üzerine yazılmadıkça kilitlemeyi devre dışı bırakır, dolayısıyla yalnızca backend desteği bu çalıştırmalarda kilitlemeyi etkinleştirmez.

Semaphore UI kullanmaya başlamak için depoları taşımak gerekmez. Bir proje kendi URL, dal ve kimlik bilgilerine sahip birden fazla Git deposu kaydedip her şablonda uygun olanı seçebilir. GitLab CI/CD de harici Git hizmetleriyle çalışır: Premium ve Ultimate harici depo entegrasyonu yansıtılmış GitLab projesi oluşturur. Pipeline yapılandırması alternatif yolda, başka projede veya harici YAML URL'sinde bulunabilir, job da başka depoyu açıkça klonlayabilir. GitLab pipeline'ları yine bir GitLab projesine aittir. Dolayısıyla Semaphore UI operasyon projesi mevcut Git hizmetlerinin yanında yer alabilir, GitLab da teslimat ve bakım pipeline'ları için seçenek olmaya devam eder.

GitLab job'ları pipeline YAML içinde tanımlar. Pipeline düzenleyicisi yapılandırmayı doğrulayıp görselleştirir, Pipeline Wizard ise depoya commit edilen yapılandırma dosyası oluşturur. Semaphore UI görev şablonu formu, CI/CD YAML tanımı olmadan araç, depo, envanter ve değişken gruplarını seçerek işlemi kaydeder. Bu, mühendislerin kayıtlı işlemi nasıl yönettiğiyle ilgilidir. Her iki ürün de her çalıştırmada yeni commit gerektirmeden mevcut job'ları girdilerle elle veya zamanlanmış olarak başlatabilir.

GitLab pipeline girdileri YAML içinde varsayılan değerler, izin verilen seçenekler ve regex doğrulamasıyla tanımlanan tür belirtilmiş parametrelerdir. Grup ve proje CI/CD değişkenleri ortam kapsamları dahil yeniden kullanılabilir yapılandırma sağlar. Ekip arkadaşı hazırlanmış pipeline'ı başlatırken bu girdileri verir, pipeline zamanlaması ise gözetimsiz çalıştırmalar için yapılandırmayı sağlar.

Semaphore UI yeniden kullanılabilir yapılandırmayı görev şablonunda, seçilen envanterde ve değişken gruplarında tutar. Formlar zorunlu alanlar, tam sayı kontrolleri ve önceden tanımlanmış seçeneklerle başlatma değerlerini sunar. GitLab'ın yapılandırılabilir regex kurallarını sağlamazlar. Örneğin mühendis hizmet adı, istenen durum ve ortam seçenekleriyle bir hizmet işlemi hazırlayabilir. Ekip arkadaşı formu doldurur, görevi başlatır ve durumuyla çıktısını okur. Playbook istenen eylemi uygular, paylaşılan kaynaklar ise depoyu, host'ları ve bağlantı ayrıntılarını sağlar.

Semaphore UI Build ve Deploy şablonlarını da bağlar. Derleme bir sürüm kaydeder, dağıtım başarılı derleme sürümünü seçer veya başarılı derlemeden sonra otomatik başlar. Otomasyon paketi veya imajı ekibin seçtiği depolamaya yükler ve oradan alır. GitLab bu sürümü pipeline job'ları, artifact referansları ve dağıtım ortamlarıyla, entegre test ve teslimat kanıtlarıyla temsil eder.

Aynı kurulum gözetimsiz işleri de destekler. Sertifika kontrolü şablonu her gece ortamın envanterinde çalışabilir ve playbook süresi dolmak üzere olan sertifika bulduğunda hata bildirebilir. 0 2 * * * gibi bir cron ifadesi bunu yapılandırılmış zamanlayıcı saat diliminde her gün 02:00'ye planlar, varsayılan saat dilimi UTC'dir. Tek seferlik zamanlamalar planlı bakım penceresini kapsar. GitLab da pipeline zamanlaması ve yapılandırılmış girdilerle aynı playbook'u zamanlayabilir.

Semaphore UI envanteri, şablonların paylaşabildiği adlandırılmış bir proje kaynağına dönüştürür. Düzenlenebilir INI/YAML içerebilir, Git'teki bir dosyaya başvurabilir veya Ansible'ın dinamik envanter eklentilerini kullanabilir. Seçilen envanter host ve isteğe bağlı sudo kimlik bilgisi referanslarını da tutar, dolayısıyla hedef yapılandırmasını değiştirmek her bakım işlemini düzenlemeyi gerektirmez.

GitLab aynı Ansible dosyalarını ve keşif eklentilerini kullanabilir. Job envanteri deposundan veya yapılandırılmış başka kaynaktan alır, gerekli keşif eklentisini yükler ve seçilen girdileri Ansible'a iletir. Her ikisi de bulut API'lerinden veya yüklü Ansible eklentilerinin desteklediği diğer sistemlerden host keşfedebilir. Semaphore UI'ın farkı operasyon arayüzündeki yeniden kullanılabilir envanter nesnesi ve bağlantı ayarlarıdır.

Tek sunucudaki bir kurtarma görevi için izin verilen bir Ansible limit, yeni envanter oluşturmadan çalıştırmayı daraltır. Bu, filoyu otomatik olarak bağımsız job'lara bölmek yerine tek görev içindeki host'ları seçer. Değişikliklerinin incelenmesi gerektiğinde Git'teki envanter her iki üründe de yararlıdır.

GitLab Runner'lar job'ları shell, Docker veya Kubernetes yürütücüleriyle çalıştırır. Semaphore UI uygulama sunucusunda veya yönetilen sistemlere yakın runner'da çalışabilir. Her ikisi de paylaşılan arayüz başka yerde dururken yürütmeyi özel ağ içine yerleştirmeye izin verir.

GitLab projeye özel runner'ları ve etiket tabanlı job yönlendirmesini destekler. Semaphore UI Pro projeye atanmış runner'lar, etiket tabanlı yönlendirme ve görev başına Docker yürütmesi ekler. Enterprise Kubernetes görev yürütmesi sunar. Bu ayarlar ekibin gerekli bağlantı ve bağımlılıklara sahip yürütme kapasitesini seçmesini sağlar. Uygulama sunucusunu konteynerde kurmak, her job için konteyner çalışma zamanı seçmekten ayrı kalır.

İşlem birden fazla araç kullandığında Semaphore UI iş akışları kayıtlı operasyonları bağlar. OpenTofu görevi ortam oluşturabilir, Ansible görevi host'ları yapılandırabilir ve Python görevi ortamı başka sisteme kaydedebilir. Başarı ve hata dalları sonraki adımı yönlendirir, onay ise değişiklikten önce sırayı duraklatabilir. Şablonlar sonraki bakım için ayrı ayrı da kullanılabilir, dolayısıyla teşhis çalıştırmak tüm kaynak sağlama işlemini yeniden yürütmeyi gerektirmez.

Semaphore UI iş akışı düzenleyicisi, mühendisin kayıtlı şablonları bağlamasına ve başarı ya da hata yollarını grafik üzerinde yapılandırmasına izin verir. GitLab pipeline düzenleyicisi YAML'ı düzenleyip doğrular, ardından oluşan job'ları ve needs bağımlılıklarını görselleştirir. Görselleştirme işlemi incelemeye yardımcı olurken bağlantı değişiklikleri pipeline yapılandırmasında yapılır. Operatör mevcut işlemleri YAML orkestrasyonu yönetmek yerine görsel olarak birleştirmek istediğinde bu fark önemlidir.

GitLab, dağıtılan sürüm veya ortam URL'si gibi hesaplanmış değerleri dotenv rapor artifact'larıyla sonraki job'lara aktarabilir. Karmaşık JSON veya çok satırlı veri için normal dosya artifact'ı kullanılır. Kaynak sağlama ve yapılandırma, Semaphore UI görevleri arasında yapılandırılmış değerler aktarabilir. Örneğin yeni host adresini içeren Terraform/OpenTofu çıktısı sonraki işlemin girdisi olabilir. 2.20'de çıktı toplama, sunucuda veya uzak runner'da yerel yürütücü kullanılarak Ansible set_stats, Terraform/OpenTofu/Terragrunt çıktıları ve Bash, PowerShell veya Python'dan JSON'u kapsar. Docker ve Kubernetes görev yürütücüleri bu iş akışı çıktılarını üretmez. Alıcı şablon girdiyi tanımlar, playbook'u veya envanter yapılandırması bu girdiyi yeni host'u hedeflemek için kullanır.

GitLab her planda bloklayan manuel job ile pipeline'ı duraklatabilir. İsteğe bağlı manuel job'lar pipeline'ı engellemediğinden when: manual ile allow_failure: false birlikte ayarlanmalıdır. Premium ve Ultimate dağıtım onayları korumalı ortamlar için bağımsız atanmış onay gereksinimleri ekler. Semaphore UI 2.20 iş akışı onayı proje görevlerini çalıştırma iznine bağlıdır, ayrı onaylayıcı rolü 2.21 için duyurulmuştur. Bağımsız yönetilen onay sınırı gerektiğinde GitLab'ın korumalı ortam onayları kullanılmalıdır.

Dosyalar farklı bir yol gerektirir. Derlenmiş paket veya kaydedilmiş Terraform planı sonraki işlemin alabileceği yerde saklanmalı ya da açıkça aktarılmalıdır. GitLab job artifact'ları teslimat pipeline'ının bu parçasını zaten karşılar. Dağıtımı Semaphore UI yürüttüğünde otomasyonu CI'ın sağladığı sürüm veya digest ile yayımlanmış artifact'ı alabilir. Böylece GitLab'ın derleme kanıtı korunurken sonraki host işlemleri Semaphore UI envanterlerini, kimlik bilgilerini ve çalıştırma geçmişini kullanabilir.

GitLab CI/CD bileşenleri job dizileri dahil sürümlenmiş ve yeniden kullanılabilir pipeline yapılandırmasını paketler. Semaphore UI tek tek görev şablonlarını yeniden kullanır, işlem sırası ise her iş akışında tanımlanır ve tek bir iç içe iş akışı olarak eklenemez. Birçok teslimat pipeline'ının bakımı yapılan çok adımlı süreç paylaşması gerektiğinde bileşenler değerlidir. Ekipler esas olarak temel işlemleri yeniden kullanıp kaynak sağlama, dağıtım veya kurtarma için farklı biçimlerde bağladığında Semaphore UI modeli yararlıdır.

GitLab grup ve proje rolleriyle birlikte korumalı dal ve ortamlar için ek kontroller kullanır. Standart Developer rolü pipeline çalıştırabilir ve korumalı olmayan dallara kod gönderebilir. Bu kod katkısı izinleri olmadan yalnızca dağıtım erişimi için Premium ve Ultimate, korumalı ortama erişimi olan davetli Reporter rolündeki grupları destekler. GitLab üzerinden operasyon devreden ekipler bu dağıtım sınırını açıkça yapılandırır.

Semaphore UI operasyon ekibine şablonlar, envanterler, depolar, kimlik bilgileri ve değişken grupları etrafında kendi proje sınırını verir. Community proje yönetimini yürütmeden zaten ayırır: Task Runner'lar proje şablonlarını çalıştırabilir ve diğer kaynaklara salt okunur erişir. Mühendisler hazırlanmış yapılandırmayı yönetirken ekip arkadaşları projenin sunduğu işlemleri çalıştırabilir.

Enterprise özel rolleri ve şablon düzeyinde izinler bu kapsamı daraltır. Destek çalışanı proje çapında Task Runner erişimi yerine belirli yeniden başlatma şablonunda yürütme izni veren özel role sahip Guest temel rolü alabilir. Envanteri, kimlik bilgileri ve başlatma seçenekleri mühendis tarafından hazırlanır. Devredilen eylem tüm operasyon projesine üyelikten daha belirliyse bu yararlıdır.

Form, işlemin arayüzüdür, erişim kurallarının yerine geçmez. Otomasyon kodu ve izin verilen başlatma geçersiz kılmaları işlemi amaçlanan hedeflerle sınırlı tutmalıdır. Semaphore UI şablon izinleri, kaynakların keyfî birleşimleri için ayrı envanter ve kimlik bilgisi izinleri sağlamaz.

GitLab Self-Managed LDAP ve OpenID Connect'i destekler, GitLab ayrıca hesap düzeyinde iki faktörlü kimlik doğrulama sunar. Semaphore UI Pro yerel TOTP sağlar, LDAP ve OIDC'yi destekler. Merkezi kimlik giriş yapan kişiyi doğrular, hangi işlemleri çalıştırabileceğini ise yine proje rolleri ve şablon izinleri belirler.

GitLab job'ları maskelenebilen veya gizlenebilen CI/CD değişkenlerini kullanır. Premium harici secret entegrasyonları HashiCorp Vault, AWS Secrets Manager, Azure Key Vault ve Google Cloud Secret Manager gibi hizmetlerden değer ister. GitLab 19.5 ayrıca Premium ve Ultimate için OpenBao tabanlı Secrets Manager sunar. Çevrimiçi lisanslarda GitLab Credits ile ücretlendirilir, çevrimdışı Self-Managed lisanslarda eklenti olarak sağlanır. Job'lar secret'ları açıkça ister, erişim yapılandırılmış izinlerle yönetilir ve denetim olaylarında kaydedilir.

Semaphore UI anahtar deposu SSH anahtarlarını parola ve erişim token'ları dahil kullanıcı adı/parola kimlik bilgilerinden ayırır. Depo kod çekme kimlik bilgisini seçer, Ansible envanteri host ve isteğe bağlı sudo kimlik bilgilerini seçer, şablon ise Ansible Vault parolası kullanabilir. Bu ilişkiler kayıtlı işlemin parçasıdır, dolayısıyla sertifika yenileme veya hizmet görevi başlatan kişinin her bağlantı secret'ını forma yapıştırması gerekmez.

Zaten secret deposu işleten ekip için Semaphore UI Pro HashiCorp Vault ve OpenBao entegrasyonları sağlar. Enterprise AWS Secrets Manager, Azure Key Vault ve Devolutions Server ekler. Aynı dağıtım için GitLab secret'ları job değişkenleri veya yapılandırılmış secret entegrasyonları üzerinden sağlar. Semaphore UI kimlik bilgisi referanslarını depolara, envanterlere ve şablonlara bağladığından operatörler başlatma sırasında hazır bağlantıları yeniden kullanır. Yerel entegrasyon gereken hizmeti kapsamıyorsa komut doğrudan secret alabilir, bu alma işlemini ekip yapılandırır ve yönetir.

Semaphore UI OpenBao ve Devolutions Server için sırasıyla Pro ve Enterprise'da adlandırılmış anahtar deposu entegrasyonları sunar. GitLab job'ları OpenBao değerini CLI veya Devolutions Credentials girdisini API üzerinden alabilir. Ekip, kayıtlı anahtar deposu bağlantısı seçmek yerine kimlik doğrulama, alma ve ekleme işlemlerini job içinde yönetir. Mevcut secret deposu ve job kodu süreci zaten kapsıyorsa bu uygulanabilir bir yoldur.

Semaphore UI Enterprise CyberArk ile PVWA REST API üzerinden entegre olur. Ansible çalıştıran GitLab job'ı cyberark.pas koleksiyonu ve Central Credential Provider üzerinden CyberArk kimlik bilgilerini alabilir. Koleksiyon ve uygulama kimlik doğrulaması job çalışma ortamında yapılandırılır. Bunlar farklı CyberArk arayüzleri kullandığından entegrasyon ekibin işlettiği CyberArk hizmetiyle eşleşmelidir.

Semaphore UI görev durumunu, başlatma ayrıntılarını, depo revizyonunu ve çıktıyı tutar. Pro entegre Ansible host/görev özeti ekleyerek filo çapındaki başarısız kontrolden etkilenen host'lara ulaşmayı kolaylaştırır. GitLab job loglarını saklar ve Ansible sonuçlarını yapılandırılmış JUnit rapor artifact'ları üzerinden gösterebilir. Test raporları merge request ve pipeline görünümlerine de yansır, bu da altyapı kontrolleri kod incelemesinin parçası olduğunda yararlıdır.

Semaphore UI erişim incelemeleri ve olay araştırmaları için denetim kaydı açıkken kimlik doğrulama, kaynak değişiklikleri ve görev etkinliğini kaydeder. Yönetici denetim görünümü tüm sürümlerde projeler arasıdır. GitLab Premium ve Ultimate grup ve proje denetim sayfaları sunar, Free hesap geçmişi ise başarılı oturum açmaları kapsar. GitLab denetim izinleri ve olay türleri grup, proje ve instance kapsamına bağlıdır.

Semaphore UI Pro filtreleme, CSV veya JSONL dışa aktarma ve TLS Syslog veya Splunk HEC ile iletme ekler. GitLab Ultimate grup denetim olaylarını JSON olarak harici hedeflere aktarır. Her ikisi de güvenlik bilgileri ve olay yönetimi (SIEM) sistemini besleyebilir, ancak olaylar ve kapsam sıradan job çıktısından farklıdır.

Semaphore UI kimlik doğrulamalı görev API'si ve gelen entegrasyon endpoint'leri sunar. Eşleştiriciler isteği filtreler, çıkarıcılar başlık veya gövde alanlarını görev girdilerine eşler. GitLab bir dal veya etiket için pipeline başlatan pipeline tetikleme API'leri ve webhook URL'leri sağlar. Proje entegrasyonları teslimat olaylarını issue takip sistemlerine ve harici hizmetlere de bağlar. Böylece izleme uyarısı yeni kod commit'i olmadan hazırlanmış teşhis başlatabilir.

Semaphore UI e-posta, Slack, Microsoft Teams, Telegram, Rocket.Chat, DingTalk ve Gotify bildirim kanallarını içerir. Şablonlar ve proje uyarıları sonuçların nereye gideceğini seçer. GitLab Microsoft Teams bildirimleri, pipeline durum e-postaları ve Slack uygulaması gibi proje entegrasyonları sağlar. Bildirim bağlantısı ekip arkadaşlarının çalıştırmayı incelemesine yardım eder, kendi başına sohbet içinden onay değildir.

Her iki ürün de Claude Code ve Codex gibi asistanların yapılandırma hazırlarken veya job çıktısını incelerken başvurabileceği herkese açık dokümantasyon ve API'ler sağlar. GitLab pipeline YAML asistana teslimat yapılandırmasını verir, Semaphore UI API'si ise kayıtlı işlemi ve proje kaynaklarını sunar. Bu, oluşturulan değişiklikleri otomatik olarak doğru kılmadan kurulum ve sorun gidermeyi destekler.

GitLab 19.5 genel kullanıma açık MCP sunucusu içerir, kullanılabilir araçlar erişime ve lisanslı özelliklere bağlıdır. Semaphore UI'ın API'si için topluluk MCP bağlayıcısı vardır ve Pro için 2.21.0 sürümünde resmî MCP desteği duyurulmuştur. Bağlayıcı erişimi kendisine sağlanan hesap ve kimlik bilgilerine bağlı olduğundan asistana işleme uygun kapsam verilmelidir.