ACY.Docker 1.0.0

ACY.Docker

ACY.Docker, .NET 10 uygulamalarınızdan Docker komutlarını kolayca yönetmenizi ve Docker Engine ile etkileşime girmenizi sağlayan kapsamlı bir NuGet paketidir. Process tabanlı çalışarak standart Docker CLI araçlarını sarmalar ve C# ortamında nesne yönelimli, asenkron bir API sunar.

Özellikler

• Container Yönetimi: Container listeleme, başlatma, durdurma ve silme işlemleri.
• Asenkron API: Tamamen async/await mimarisine uygun yüksek performanslı işlemler.
• Kolay Kullanım: Docker komutlarını basit metod çağrılarına dönüştürür.
• Tip Güvenliği: JSON tabanlı formatlamalar aracılığıyla Docker çıktılarını C# modellerine dönüştürür.

Kurulum

Paketi projenize eklemek için NuGet Paket Yöneticisi Konsolu'nu kullanabilirsiniz:

dotnet add package ACY.Docker

(Not: Paket şu an yerel geliştirme aşamasındadır, kendi NuGet sunucunuza veya yerel kaynağa publish edebilirsiniz.)

Başlangıç ve Örnek Kullanım

DockerClient sınıfını kullanarak hemen işlemlere başlayabilirsiniz.

using System;
using System.Threading.Tasks;
using ACY.Docker.Client;

namespace ACY.Docker.Examples
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var docker = new DockerClient();

            // 1. Yeni bir Container başlat (Nginx örneği)
            Console.WriteLine("Nginx container başlatılıyor...");
            var containerId = await docker.RunContainerAsync("nginx", "-p 8080:80");
            Console.WriteLine($"Başlatıldı! ID: {containerId}");

            // 2. Çalışan Container'ları listele
            Console.WriteLine("\nÇalışan Container'lar:");
            var containers = await docker.GetContainersAsync();
            foreach (var container in containers)
            {
                Console.WriteLine($"- {container.Names} ({container.Image}) - {container.Status}");
            }

            // 3. Container'ı durdur
            Console.WriteLine($"\nContainer durduruluyor: {containerId}");
            await docker.StopContainerAsync(containerId.Trim());
            Console.WriteLine("Durduruldu.");

            // 4. Container'ı sil
            Console.WriteLine($"\nContainer siliniyor: {containerId}");
            await docker.RemoveContainerAsync(containerId.Trim());
            Console.WriteLine("Silindi.");
        }
    }
}

Sistem Gereksinimleri

• Projenin çalıştığı makinede Docker Engine'in kurulu olması ve sistem PATH değişkenine eklenmiş olması gerekmektedir (komut satırından docker komutu erişilebilir olmalıdır).
• .NET 10 veya daha yeni bir sürüm.

Katkıda Bulunma

Hata bildirimleri ve çekme istekleri (pull requests) için lütfen projenin GitHub deposunu ziyaret edin.