Terraform arayüzü: Semaphore UI ve Gaia

Gaia, Java web uygulamasını, MongoDB veritabanını ve yürütme runner’ını birbirinden ayırır. Runner, yapılandırılabilir paralel iş sınırıyla Terraform’u Docker konteynerlerinde veya Kubernetes pod’larında başlatır. Docker Compose bu hizmetleri bir araya getirir, deneysel bir Helm chart ise Kubernetes kurulumu seçeneği sunar.

Semaphore UI, ikili dosya veya yerel paket olarak, Docker’da ya da Kubernetes’te çalışır. Günlük otomasyonu mühendislerin dizüstü bilgisayarlarından taşıyan bir ekip mevcut bir sunucuyla başlayabilir ve aynı hizmeti Terraform provizyonu ile Ansible bakımı için kullanabilir. İş konteynerlerinin gerekip gerekmediğini seçilen yürütme modu belirler.

Gaia, Terraform modüllerini oluşturulan bir Terraform komut dizisiyle çalıştırır. Runner imajı veya uzak hedef gerekli araçları sağlıyorsa Terraform provisioner’ları Ansible’ı veya komut satırı programlarını çağırabilir. Böylece yeni oluşturulan bir kaynak yapılandırılabilir, ancak komut bağımsız bir Gaia işlemine dönüşmez, Terraform çalıştırmasına bağlı kalır. Standart komut oluşturma biçimi ayrı bir OpenTofu veya Terragrunt şablonu sağlamaz.

Semaphore UI, Ansible, Terraform/OpenTofu, Terragrunt, Bash, PowerShell ve Python için doğrudan şablonlar sunar. Bir ekip OpenTofu ile altyapı oluşturabilir, Ansible ile paketleri yapılandırabilir ve Python ile hazır olma kontrolü çalıştırabilir. Daha sonra Ansible yapılandırması veya PowerShell bakım işlemi, yeni bir Terraform yaşam döngüsü başlatılmadan kendi başına çalışabilir. Pro’nun yerleşik state backend’i de Terraform/OpenTofu state’ini ve geçmişini bu işlerin yanında tutar.

Gaia’da modül yazarı kaynak depoyu, Terraform sürümünü ve değişken şemasını tanımlar. Kullanıcılar modülden stack’ler oluşturur, ortamlarına uygun değerleri ve bulut kimlik bilgisini sağlar. Stack, kendi state’i ve işleri olan kalıcı bir örneğe dönüşür. Bu model, birbirinden bağımsız istenen altyapıların kataloğuna uygundur. Gaia, zorunlu değerleri ve yapılandırılabilir düzenli ifadeleri doğrular. Semaphore UI’nin girdi formları zorunlu alanları, tam sayıları ve seçenekleri doğrular, ancak eşdeğer yapılandırılabilir bir regex kuralı sunmaz.

Semaphore UI, kaydedilmiş işlemi Task Template olarak adlandırır. Bu şablon, depoyu, araç yapılandırmasını, değişkenleri ve işlemin ihtiyaç duyduğu envanter veya kimlik bilgilerini bir araya getirir. Adlandırılmış Variable Groups, ortam ayarlarını şablonlar arasında yeniden kullanırken girdi formu alanları başlatma girdilerini toplar. Örneğin hizmet yeniden başlatma şablonu, ekip arkadaşından bir komut oluşturmasını istemek yerine hizmet ve ortam seçimi sunabilir. Provizyon şablonu da ortam parametreleri için aynı deseni kullanabilir.

Gaia, stack’in yapılandırılmış modülü, girdileri ve bulut kimlik bilgileri üzerinde plan, apply ve destroy çalıştırır. Yerleşik backend stack’in state’ini tutar, stack sayfası ise çıktıları ve iş geçmişini toplar. Böylece aynı modülden türeseler bile ayrı test ortamları bağımsız state ve yürütme kayıtlarını koruyabilir.

Semaphore UI, Terraform/OpenTofu deposunu, workspace’i ve yapılandırmayı seçmek için Task Template kullanır. Variable Groups ilgili işler arasında ayarları yeniden kullanır, girdi formları ise başlatma sırasında girdileri toplar. Bir mühendis ortam provizyonu işlemini bir kez hazırlayabilir, ardından ekip arkadaşları kaydedilmiş yapılandırma üzerinden bunu isteyebilir. Her ortamın kendi değişkenlerine, kimlik bilgilerine ve backend state’ine de ihtiyacı vardır. Gaia bunları ayrı stack örnekleri olarak temsil eder. Semaphore UI’de ekip karşılık gelen şablonu, workspace’i ve backend yapılandırmasını hazırlar. Workspace izolasyonu backend’e bağlıdır. Dolayısıyla yalnızca bir workspace seçmek her backend’de state’i ayırmaz. Terragrunt ve OpenTofu da Terraform’un yanında doğrudan şablon seçenekleridir.

State, bu kurulumun ayrı bir parçasıdır. Gaia, ticari lisans gerektirmeden her stack için state backend’i içerir. Semaphore UI, Terraform/OpenTofu kodunda yapılandırılan backend’i kullanır. Pro ayrıca geçmiş ve arayüz yönetimi sunan yerleşik bir HTTP state backend’i sağlar. Bu backend’i Semaphore UI’de tutmak, yeni bir state hizmeti eklemek yerine paylaşılan state’i onu değiştiren işlerin yanına yerleştirir.

İki ürün de varsayılan olarak önceden kaydedilmiş bir plan dosyasını uygulamaz. Gaia 2.4.0 planlama sonucunu gösterir, ancak apply komutu kaydedilmiş plan dosyasını kullanmaz. Semaphore UI’nin varsayılan yürütmesi de plan ve apply işlemlerini ayrı gerçekleştirir. Onayın tam olarak önerilen değişikliği kapsaması gerekiyorsa süreç, planın açıkça saklanmasını ve yeniden kullanılmasını gerektirir.

Gaia, Terraform kaynaklarını ve çıktılarını her stack ile birlikte tutar. Bir Terraform çıktısı, provisioner’ın veya başka bir sistemin ihtiyaç duyduğu sunucu adresini sağlayabilir, ancak Gaia arayüzünde Ansible envanter kaynağı oluşturmaz. Provisioner üzerinden çağrılan Ansible’a envanteri bu otomasyonun parçası olarak iletmek veya oluşturmak gerekir.

Semaphore UI, Ansible envanterlerini yeniden kullanılabilir proje kaynakları olarak saklar. Ekipler statik bir tanımı düzenleyebilir, Git’teki bir dosyayı kullanabilir veya iş çalıştığında Ansible envanter eklentileriyle sunucuları keşfedebilir. Aynı envanter dağıtım, yama uygulama ve sertifika kontrollerinde kullanılabilir. Bu, provizyonun işin yalnızca başlangıcı olduğu ve operatörlerin mevcut sunucu filosuna yaşam döngüsü boyunca döndüğü durumlarda özellikle yararlıdır.

Gaia, uygulamayı runner’ından ayırır. Runner, bekleyen Terraform adımlarını ister ve yapılandırılabilir eşzamanlılıkla Docker konteynerlerinde veya Kubernetes pod’larında yürütür. Gaia API’sine ve modülün kullandığı hizmetlere erişebildiği sürece özel altyapının yakınında çalışabilir. Seçilen imaj Terraform’u ve provisioner’ların ihtiyaç duyduğu ek programları sağlar.

Semaphore UI, işleri uygulama sunucusunda veya hedeflerin yakınına yerleştirilmiş runner’larda çalıştırabilir. Böylece küçük bir kurulum konteyner platformu olmadan başlayabilir, daha büyük bir kurulum ise runner’larla ayrı ağlara erişebilir. Pro proje runner’larını ve Docker iş yürütmesini, Enterprise ise Kubernetes iş pod’larını ekler. Web uygulamasını Docker’a kurmak ile her işi kendi konteynerinde yürütmek ayrı tercihlerdir.

Semaphore UI, hazırlanmış şablonlara cron ve tek seferlik zamanlamalar kaydeder. Gece yedeklemesi, tekrarlanan sertifika kontrolü veya yama işi, yazarın seçtiği envanteri, kimlik bilgilerini ve başlatma ayarlarını yeniden kullanabilir. Manuel ve zamanlanmış çalıştırmalar aynı yürütme geçmişinde görünür.

Gaia 2.4.0 bir zamanlama arayüzü içermez. Harici bir zamanlayıcı POST /api/stacks/{id}/{jobType} ile RUN veya DESTROY işi oluşturabilir, ardından POST /api/jobs/{jobId}/plan ile planını başlatabilir. Değişikliği uygulamak için plan tamamlandıktan sonra /api/jobs/{jobId}/apply adresine ayrı bir POST gerekir. Zamanlayıcı, iş kimliği oluşturmayı tamamlanmış bir çalıştırma saymak yerine bu yaşam döngüsünü yönetmeli ve işin nihai sonucunu kontrol etmelidir.

Gaia, stack’i planlama ve uygulama aşamalarından geçirir. Arayüzü, stack silme işlemi dâhil, plan sonrasında ayrı bir onay sunar. Terraform provisioner’ları bu yaşam döngüsü içinde ek işlemler yapabilir ve harici bir sistem API üzerinden birden fazla işi koordine edebilir. Gaia, bağımsız olarak yeniden kullanılabilir Ansible, Terraform ve betik işlemlerinden oluşan görsel bir grafik sağlamaz.

Semaphore UI, kaydedilmiş şablonları onay, başarı ve hata yolları içeren görsel bir iş akışıyla bağlar. Bir devreye alma süreci altyapı oluşturabilir, onay bekleyebilir, sunucuları yapılandırabilir ve doğrulama adımı çalıştırabilir. Her şablon sonraki bakım için de kullanılabilir kalır. Toplanan değerler, sunucudaki veya bir runner’daki yerel yürütücü kullanılarak adımlar arasında aktarılabilir. Oluşturulan dosyalar ve kaydedilmiş Terraform planları için yine erişilebilir depolama veya açık bir aktarım gerekir. İki ürün de varsayılan olarak önceden kaydedilmiş bir Terraform planını uygulamaz.

Gaia, modülleri paylaşmak için yönetici ve kullanıcı rolleri olan organizasyonlar kullanır. Modül yazarı onaylanmış bir Terraform tanımını ekibe sunabilir, kullanıcılar ise kendi stack’lerinin yapılandırmasını sağlar. GitHub ve GitLab entegrasyonları OAuth2 oturum açmayı depo içe aktarmayla birleştirir. LDAP de desteklenir.

Semaphore UI Community, paylaşılan otomasyonu projeler içinde düzenler. Proje rolleri, proje içindeki otomasyonu kimin görüntüleyebileceğini, çalıştırabileceğini veya düzenleyebileceğini belirler. Yürütme izni olan ekip arkadaşları dağıtım, yedekleme veya bakım işini başlatıp sonucunu inceleyebilir. Mühendis işlemi hazırlar, ekip arkadaşı ise kaydedilmiş yapılandırmayı ve başlatma girdilerini kullanır.

Erişimin seçili işlemlerle sınırlanması gerektiğinde Enterprise özel roller ve şablon düzeyinde yürütme izinleri ekler. Örneğin ekip, operatöre genel proje düzenleme hakkı vermeden hizmet yeniden başlatma şablonunu devredebilir. Bu sınır yalnızca girdi formundan değil, rol izinleri ile işlem yapılandırmasının birleşiminden doğar. Pro, merkezi kimlik sağlayıcı kullanan ekipler için LDAP ve OIDC oturum açmayı ekler. Semaphore UI Pro ayrıca yerel hesaplar için TOTP iki faktörlü kimlik doğrulama sağlar.

Gaia, AWS, Google Cloud ve Azure için bulut kimlik bilgileri sağlar. İsteğe bağlı Vault entegrasyonu şifreleme için Transit motorunu kullanır ve Vault secrets engine’den dinamik AWS kimlik bilgileri isteyebilir. Bu kimlik bilgileri Terraform stack yaşam döngüsünü destekler.

Semaphore UI’nin Key Store’u, Ansible sunucularının SSH anahtarları ve parolaları dâhil ekip prosedürlerinde kullanılan kimlik bilgilerini destekler. Hazırlanmış işlem, operatörün her başlatmada kimlik bilgisi yapıştırmasını istemek yerine saklanan kayıtlara başvurur. Pro, HashiCorp Vault ve OpenBao’dan gizli bilgi sorgulamayı ekler. Enterprise ise AWS Secrets Manager, Azure Key Vault ve Devolutions Server entegrasyonlarının yanı sıra PVWA API aracılığıyla CyberArk’ı ekler.

Örneğin bir ortam, provizyon için bulut kimlik bilgisi ve sonraki Ansible yapılandırması için SSH anahtarı kullanabilir. Bunlar ilgili işleme bağlı ayrı kimlik bilgileri olarak kalır. İki platform da Vault ile çalışabilir, ancak Gaia’nın şifreleme ve dinamik kimlik bilgisi özellikleri, bir iş için saklanan gizli bilgiyi sorgulamaktan farklıdır. Gaia’nın yerleşik kimlik bilgisi türleri yukarıdaki diğer gizli bilgi depoları için bağlayıcı içermez. Terraform kodu kendi veri kaynakları veya harici komutlarıyla gizli bilgileri alabilir. Bu sorgulama Gaia’nın kimlik bilgisi arayüzünde değil, otomasyonda yapılandırılır ve sürdürülür.

Gaia, stack işinin kullanıcısını, durumunu, zamanlamasını ve plan/apply adımlarını kaydeder. Bu geçmiş, ekibin ortam provizyonundaki değişiklikleri incelemesine ve Terraform çıktısını araştırmasına yardımcı olur. Bu, Ansible sunucu raporlama veya yönetim denetimi arayüzü değil, stack işlemleri kaydıdır.

Semaphore UI, desteklenen araçlar genelinde görev geçmişi tutar. Pro Ansible özetleri sunucu ve görev sonuçlarını ekleyerek hangi sunucuların yama veya sertifika kontrolünde başarısız olduğunu bulmaya yardımcı olur. Denetim günlüğü, oturum açmaları ve desteklenen yönetim işlemlerini görev çıktısından ayrı kaydeder. Böylece hem provizyon hem sunucu bakımı yapan ekip, Terraform state’ini sunucudaki her işlemin raporu saymadan bu işlemleri aynı hizmette araştırabilir. Pro, ekibin SIEM hattı için Syslog ve Splunk HEC iletimi dâhil denetim filtreleme ve dışa aktarmayı ekler.

Gaia, GitHub veya GitLab’dan modülleri içe aktarır, stack’ler, işler ve sonuçları için API’ler sunar. Bir CI pipeline’ı veya harici istek hizmeti stack işi oluşturabilir, planlamayı başlatabilir ve ne zaman uygulanacağına karar verebilir. Webhook tabanlı kurulum, bu çağrıları yapan ve sonucu izleyen bir adaptör gerektirir. Semaphore UI, istekleri eşleştirip değerlerini hazırlanmış görev girdilerine aktaran REST API ve gelen entegrasyon webhook’ları sağlar.

Gaia’nın Terraform kataloğunu koruyan bir ekip için API entegrasyonu, provizyon tamamlandıktan sonra Semaphore UI Ansible yapılandırma veya bakım şablonunu tetikleyebilir. Ardından bu işlemin envanterini, kimlik bilgilerini ve yürütme kaydını Semaphore UI yönetir. Bu, yerleşik bir Gaia-Semaphore entegrasyonu değil, ekibin uyguladığı bir bağlantıdır. Her iki proje de bağlantıyı taslak hâline getirirken veya yapılandırma ve iş çıktısını araştırırken bir kodlama asistanının başvurabileceği belgeleri ve kaynak kodunu sunar.