Yapılandırma Tarifleri

Yapılandırma Tarifleri, bir Kod Akışı kapsamında Docker imajlarının nasıl oluşturulacağını tanımlayan yapılandırmaların hazırlandığı ve yönetildiği bölümdür.

Bir Yapılandırma Tarifi; oluşturulacak imajın kayıt defteri, imaj deposu, imaj etiketi ve yapılandırma adımlarını içerir.

Yapılandırma adımları Docker imajının oluşturulması sırasında uygulanacak komutları tanımlar.

Top Sellers Report Kod Akışı için beş derleme adımlı bir Yapılandırma Tarifi: FROM temel imaj, WORKDIR uygulama klasörü, RUN paket kurulumu, ENV-VAR rapor limiti, USER uygulama kullanıcısı. — Yapılandırma Tarifi: sıralı adımlar.

Hazırlanan tarif Başlat işlemi ile çalıştırıldığında imaj oluşturma işlemi başlatılır. Yapılandırma işlemi seçilen Ajan üzerinde gerçekleştirilir ve oluşturulan Docker imajı tarifte belirtilen kayıt defteri ve imaj deposuna göre hazırlanır.

Yapılandırma Tarifleri Ekranı

Yapılandırma Tarifleri ekranı, ilgili Kod Akışı kapsamında hazırlanmış Docker imaj yapılandırmalarını görüntülemek ve yönetmek için kullanılır.

Mevcut tarifler liste veya kart görünümünde görüntülenebilir.

Yeni bir yapılandırma oluşturmak için ekranın sağ üst bölümünde bulunan Tarif Ekle butonu kullanılır.

Liste Görünümü

Liste görünümünde Yapılandırma Tarifleri tablo halinde görüntülenir.

Aşağıdaki bilgiler gösterilir:

Kolon	Açıklama
Ajan	Docker imajını oluşturmak için kullanılacak Ajanı gösterir.
Adımlar	Tarifte tanımlanan yapılandırma adımlarını gösterir.
Kayıt Defteri	Oluşturulacak Docker imajının kullanılacağı kayıt defterini gösterir.
İmaj Deposu	Docker imajının depo yolunu gösterir.
İmaj Etiketi	Docker imajına atanacak etiketi gösterir.
Oluşturulma Tarihi	Tarifin oluşturulduğu tarih ve saati gösterir.
Güncellenme Tarihi	Tarifin en son güncellendiği tarih ve saati gösterir.
Durum	Tarifin mevcut durumunu gösterir.

Her kaydın sağ tarafında bulunan üç nokta menüsü üzerinden tarif ile ilgili işlemlere erişilebilir.

Kart Görünümü

Yapılandırma Tarifleri kartlar halinde de görüntülenebilir.

Her kart üzerinde tarifin temel bilgileri yer alır.

Alan	Açıklama
Ajan	İmajın oluşturulmasında kullanılacak Ajanı gösterir.
Adımlar	Tarifte tanımlanan yapılandırma adımlarını gösterir.
Kayıt Defteri	Docker imajının kayıt defterini gösterir.
İmaj Deposu	Docker imajının depo yolunu gösterir.
İmaj Etiketi	Docker imajına atanacak etiketi gösterir.
Oluşturulma Tarihi	Tarifin oluşturulduğu tarih ve saati gösterir.
Güncellenme Tarihi	Tarifin en son güncellendiği tarih ve saati gösterir.
Durum	Tarifin mevcut durumunu gösterir.

Kartın sağ üst bölümündeki üç nokta menüsü kullanılarak tarif üzerinde kullanılabilir işlemlere erişilebilir.

Görünüm Seçenekleri

Yapılandırma Tarifleri ekranı iki farklı görünüm tipini destekler:

Liste Görünümü
Kart Görünümü

Ekranın sağ üst bölümünde bulunan görünüm butonları kullanılarak iki görünüm arasında geçiş yapılabilir.

Görünümün değiştirilmesi yalnızca tariflerin ekranda nasıl gösterildiğini değiştirir.

Hızlı Arama

Ekranın sağ üst bölümünde bulunan Filtrele... alanı, Yapılandırma Tarifleri arasında hızlı arama yapmak için kullanılır.

Arama alanına bir değer girildiğinde görüntülenen kayıtlar eşleşen tariflere göre daraltılır.

Bu özellik çok sayıda tarif bulunduğunda istenilen yapılandırmaya daha hızlı ulaşılmasını sağlar.

Detaylı Filtreleme

Hızlı arama alanının yanında bulunan Filtrele butonu daha detaylı filtreleme yapmak için kullanılır.

Filtreleme seçenekleri kullanılarak belirli kriterlere uyan Yapılandırma Tarifleri görüntülenebilir.

Birden fazla filtre koşulu kullanılarak sonuçlar daha ayrıntılı şekilde daraltılabilir.

Aktif filtreler gerektiğinde temizlenerek tüm tarifler tekrar görüntülenebilir.

Tarif Ekleme

Yeni bir Docker imaj yapılandırması hazırlamak için Tarif Ekle butonu kullanılır.

Tarif oluşturma ekranında Docker imajının nasıl oluşturulacağını belirleyen temel bilgiler ve yapılandırma adımları tanımlanır.

Temel alanlar aşağıdaki gibidir:

Alan	Açıklama
Ajan	Docker imajının oluşturulacağı Ajanı belirler.
Kayıt Defteri	Oluşturulacak Docker imajının kullanılacağı kayıt defterini belirler.
İmaj Deposu	Docker imajının depo yolunu belirler.
İmaj Etiketi	Oluşturulacak Docker imajına verilecek etiketi belirler.
Aktif	Yapılandırma Tarifinin aktif olup olmadığını belirler.

Bu bilgiler tanımlandıktan sonra Yapılandırma Adımları bölümünden Docker imajının nasıl oluşturulacağı belirlenir.

Yapılandırma Adımları

Yapılandırma Adımları, Docker imajının oluşturulması sırasında uygulanacak işlemleri tanımlar.

Her adım bir Docker yapılandırma komutunu temsil eder.

Adım Ekle butonu kullanılarak tarife yeni bir yapılandırma adımı eklenebilir.

Kullanılabilecek adımlar arasında aşağıdaki komutlar bulunur:

FROM
COPY-HOST
COPY-SCRIPT
COPY-URL
ENTRYPOINT
ENV-VAR
PROXY
RUN
USER
WORKDIR

Eklenen adımlar sıralı şekilde çalıştırılır. Bu nedenle adımların sırası oluşturulacak Docker imajının yapılandırmasını doğrudan etkiler.

FROM Adımı

Bir Yapılandırma Tarifinin ilk adımı her zaman FROM olmalıdır.

FROM adımı, oluşturulacak Docker imajının temel alacağı başlangıç imajını belirler.

Örneğin Python tabanlı bir çalışma ortamı oluşturulacaksa uygun bir Python imajı başlangıç imajı olarak kullanılabilir.

Temel yapı aşağıdaki şekilde düşünülebilir:

FROM → Diğer Yapılandırma Adımları

Bu adım, sonraki yapılandırma işlemlerinin uygulanacağı temel imajı oluşturur.

COPY-SCRIPT Adımı

COPY-SCRIPT adımı, Kod Akışı altında bulunan bir Dosyayı oluşturulacak Docker imajıyla ilişkilendirmek için kullanılır.

Bu adım üzerinden ilgili Kod Akışında DataFloem'a kaydedilmiş bir Dosya seçilebilir.

Seçilen Dosya, Docker imajının oluşturulması sırasında imaj içerisine dahil edilir.

Bu sayede Jupyter Notebook üzerinde geliştirilip Save to DataFloem ile kaydedilen bir çalışma, Docker imajının bir parçası haline getirilebilir.

Temel ilişki aşağıdaki şekilde özetlenebilir:

Dosya → COPY-SCRIPT → Docker İmajı

Adımların Sıralanması

Yapılandırma adımları belirli bir sıra içerisinde uygulanır.

Her adımın yanında bulunan sıralama kontrolleri kullanılarak adımların konumu değiştirilebilir.

Bir adım yukarı veya aşağı taşınarak Docker imajının oluşturulması sırasında uygulanacağı sıra belirlenebilir.

İlk adımın FROM olması gerekir. Sonraki adımlar ise oluşturulmak istenen imajın ihtiyaçlarına göre düzenlenebilir.

Örneğin:

FROM → COPY-SCRIPT → RUN → ENTRYPOINT

Adım Silme

Tarife eklenen bir yapılandırma adımı, ilgili adımın yanında bulunan silme seçeneği kullanılarak kaldırılabilir.

Adım silindiğinde ilgili Docker yapılandırma işlemi tariften çıkarılır.

Tarifi Kaydetme

Docker imajının temel bilgileri ve yapılandırma adımları hazırlandıktan sonra Kaydet butonu kullanılarak tarif kaydedilir.

Kaydedilen tarif Yapılandırma Tarifleri ekranında görüntülenir.

İptal seçeneği kullanılarak yapılan değişiklikler kaydedilmeden tarif oluşturma ekranından çıkılabilir.

Tarif İşlemleri

Her Yapılandırma Tarifinin üç nokta menüsü üzerinden ilgili tarif için kullanılabilecek işlemlere erişilebilir.

Temel işlemler şunlardır:

İşlem	Açıklama
Düzenle	Yapılandırma Tarifini düzenlemek için kullanılır.
Sil	Yapılandırma Tarifini silmek için kullanılır.
Başlat	Tarife göre Docker imajı oluşturma işlemini başlatır.

Docker İmajı Oluşturma

Hazırlanan Yapılandırma Tarifinden Docker imajı oluşturmak için tarifin işlem menüsündeki Başlat seçeneği kullanılır.

Tarif başlatıldığında yapılandırma işlemi ilgili Ajana gönderilir.

Ajan, tarifte tanımlanan yapılandırma adımlarını sırasıyla çalıştırarak Docker imajını oluşturur.

Temel süreç aşağıdaki şekilde özetlenebilir:

Yapılandırma Tarifi → Başlat → Ajan → Yapılandırma Adımları → Docker İmajı

Eğer tarif içerisinde bir COPY-SCRIPT adımı bulunuyorsa ilgili Dosya da imaj oluşturma sürecine dahil edilir:

Dosya → COPY-SCRIPT → Yapılandırma Tarifi → Ajan → Docker İmajı

Bu yapı sayesinde Kod Akışı kapsamında geliştirilen kodlar, tanımlanan yapılandırma adımları kullanılarak çalıştırılabilir bir Docker imajına dönüştürülebilir.

Durum

Her Yapılandırma Tarifinin mevcut durumu liste ve kart görünümünde görüntülenir.

Aktif durumundaki bir tarif, sistemde etkin durumda olduğunu belirtir.

Durum bilgisi, tariflerin mevcut durumunun Yapılandırma Tarifleri ekranından hızlı bir şekilde takip edilmesini sağlar.

Sayfalama

Yapılandırma Tarifleri ekranının alt bölümünde sayfalama kontrolleri bulunur.

Sol alt bölümde toplam tarif sayısı görüntülenir.

Örneğin:

Toplam 3 kayıt

Orta bölümde bulunan sayfalama kontrolleri kullanılarak:

İlk sayfaya gidilebilir.
Önceki sayfaya geçilebilir.
Sonraki sayfaya geçilebilir.
Son sayfaya gidilebilir.
Mevcut sayfa ve toplam sayfa sayısı görüntülenebilir.

Sağ alt bölümde bulunan Sayfada satır seçeneği kullanılarak bir sayfada görüntülenecek Yapılandırma Tarifi sayısı değiştirilebilir.