Agent Modülü - Kullanıcılar
Genel Bakış
Agent Modülü, sisteme tanımlanan Agent servislerinin merkezi olarak yönetildiği modüldür.
Bir Agent, kullanıcının kendi sunucusunda çalışan ve sistem ile haberleşerek Docker image build işlemlerini gerçekleştiren bir servistir. Sisteme tanımlandıktan sonra Agent, build taleplerini kullanıcının kendi ortamında çalıştırır ve Docker image oluşturma işlemlerini gerçekleştirir.
Build işlemi boyunca Agent tarafından üretilen loglar anlık olarak sisteme iletilir. Böylece kullanıcılar build sürecini gerçek zamanlı olarak takip edebilir, oluşan logları görüntüleyebilir ve işlemin durumunu anlık olarak izleyebilir.
Agent Modülü altında bulunan Kullanıcılar sayfası, yöneticilerin Agent modülü üzerindeki kullanıcı yetkilerini yönetmesini sağlar.
Sayfa ilk açıldığında yalnızca Agent modülü üzerinde en az bir yetkiye sahip kullanıcılar sayfalı (paginated) olarak listelenir.
Yönetici Edit Mode seçeneğini aktif ettiğinde, sistemde bulunan tüm kullanıcılar Agent modülü üzerinde yetkileri olsun veya olmasın listelenir. Bu mod sayesinde kullanıcıların Agent modülü yetkileri eklenebilir, güncellenebilir veya kaldırılabilir.
Ön Koşullar
Agent modülü kullanıcı yetkilerini yönetebilmek için aşağıdaki koşullar sağlanmalıdır:
- Yönetici (Admin) yetkisine sahip olunmalıdır.
- Sistemde kullanıcılar oluşturulmuş olmalıdır.
- Sistemde en az bir Agent tanımlanmış olmalıdır.
Kullanıcı Listesi
Sayfa açıldığında:
- Kullanıcılar sayfalı (paginated) olarak listelenir.
- Yalnızca Agent modülü üzerinde en az bir yetkiye sahip kullanıcılar görüntülenir.
- Her kullanıcının Agent modülü üzerindeki mevcut yetkileri kendi satırında gösterilir.
Düzenleme Modu (Edit Mode)
Yönetici Edit Mode anahtarını aktif ettiğinde:
- Sistemde bulunan tüm kullanıcılar listelenir.
- Agent modülü yetkileri düzenlenebilir hale gelir.
- Yapılan değişiklikler yalnızca istemci tarafındaki (local state) geçici listede tutulur.
- Değişiklikler Kaydet butonuna basılana kadar sisteme kaydedilmez.
Erişim Gereksinimi
Bu sayfayı görüntüleyebilmek için kullanıcının Agent modülü için ACL yetkisine sahip olması gerekir.
ACL yetkisi, kullanıcılara Agent modülünün yetkilendirme ayarlarını yönetme izni verir. Bu yetkiye sahip olmayan kullanıcılar, yönetici yetkilerine sahip olmadıkları sürece bu sayfaya erişemezler.
Gerekli yetkiye sahip olmayan kullanıcılar bu sayfayı görüntüleyemez ve aşağıdaki yetkilendirme hatasını alırlar:
Erişim Reddedildi
Bu kaynağa erişim yetkiniz bulunmamaktadır.
Yetki Atama
Yetkiler, kullanıcının bulunduğu satır üzerinden atanabilir veya kaldırılabilir.
Bir yetki seçildiğinde veya kaldırıldığında:
- İlgili değişiklik anlık olarak local state'e eklenir.
- Sunucuya herhangi bir istek gönderilmez.
- Değişiklikler Kaydet butonuna basılana kadar bekletilir.
Kullanılabilir Yetkiler
Agent modülü aşağıdaki yetkileri destekler.
| Yetki | Açıklama |
|---|---|
| GÖRÜNTÜLE | Kullanıcının sistemde kayıtlı Agent listesini görüntüleyebilmesini sağlar. Bu yetkiye sahip olmayan kullanıcılar Agent modülüne erişemez ve kayıtlı Agent'ları görüntüleyemez. |
| OLUŞTURMA | Kullanıcının sisteme yeni bir Agent tanımlayabilmesini sağlar. |
| ACL | Kullanıcının Agent modülü üzerindeki diğer kullanıcıların yetkilerini yönetmesini sağlar. Bu yetkiye sahip olmayan kullanıcılar Agent modülü kullanıcı yetkilerini düzenleyemez. |
Değişiklikleri Kaydetme
Yetkilendirme işlemleri tamamlandıktan sonra:
- Yapılan değişiklikleri kontrol edin.
- Kaydet butonuna tıklayın.
- Yalnızca değiştirilen yetkiler sunucuya gönderilir.
- İşlem başarıyla tamamlandığında yeni yetkiler aktif hale gelir.
Değişiklikleri Sıfırlama
Reset butonuna basıldığında:
- Kaydedilmemiş tüm değişiklikler iptal edilir.
- Local state temizlenir.
- Liste son kaydedilmiş haline geri döner.
- Sunucuya herhangi bir istek gönderilmez.
Doğrulamalar
Sistem, değişiklikleri kaydetmeden önce tüm yetki değişikliklerini doğrular.
Yetki güncellemeleri yalnızca başarılı bir kayıt işleminden sonra kalıcı hale gelir.
Yetki Bağımlılıkları
Agent modülünde kullanıcı yetkilerini yönetebilmek için yalnızca ACL yetkisine sahip olmak yeterli değildir.
Kullanıcının ayrıca Users Modülü üzerinde de en az GÖRÜNTÜLEME yetkisine sahip olması gerekir.
Aksi halde:
- Kullanıcı listesi görüntülenemez.
- Agent modülü kullanıcı yetkilendirme işlemleri gerçekleştirilemez.
- Yetki yönetimi sırasında yetkilendirme (Authorization) hatası alınır.
Bu bağımlılık, Agent modülü kullanıcı yetkilendirme işlemlerinin Users modülündeki kullanıcı bilgilerine ihtiyaç duymasından kaynaklanmaktadır.
Notlar
- Yapılan tüm değişiklikler Kaydet butonuna basılana kadar yalnızca local state içerisinde tutulur.
- Reset butonu kaydedilmemiş tüm değişiklikleri iptal eder.
- Sunucuya yalnızca değişiklik yapılan yetkiler gönderilir.
- Performansı artırmak amacıyla kullanıcı listesi sayfalı (paginated) olarak görüntülenir.