Ana içeriğe atla

​
Gelişmiş Kuyruk Rehberi

Aşağıdaki örnekler Ziva ile karmaşık iş akışlarını nasıl düzenleyebileceğinizi gösterir:
  • süreci aşamalara bölmek ve görevleri dinamik olarak eklemek;
  • kullanıcı seçimlerine ve görev sonuçlarına tepki vermek;
  • TUI’dan çıkmadan hatalardan toparlanmak.
Tüm kod parçaları ziva paketinin herkese açık API’sini kullanır. Bunları examples paketine koyabilir ve davranışı göstermek istediğinizde çağırabilirsiniz.

​
Çok aşamalı kurulum şablonu

// DeployCluster, kullanıcının yanıtlarını toplayan, ilerlemeyi gösteren
// ve sonraki adımlar için sonuçları saklayan sıralı bir kurulumu organize eder.
func DeployCluster() error {
    summary := ziva.NewFuncTask(
        "Ön kontroller",
        runPreflightChecks,
        ziva.WithSummaryFunction(func() []string {
            return []string{"DNS: ok", "Ağ: ok"}
        }),
        ziva.WithStopOnError(true),
    )

    topology := ziva.NewSingleSelectTask(
        "Topoloji",
        []string{
            "single-node::Tek düğüm",
            "multi-node::Çok düğüm",
            "ha::Yüksek erişilebilirlik",
        },
    ).WithDefaultItem("multi-node")

    nodes := ziva.NewInputTask(
        "Düğüm sayısı",
        "Kaç işçi düğümü kurulacak?",
    ).
        WithInputType(ziva.InputTypeNumber).
        WithValidator(ziva.DefaultValidators.Range(1, 20)).
        WithTimeout(30*time.Second, "3")

    queue := ziva.NewQueue("Ziva Dağıtımı").
        WithAppName("Ziva CLI").
        WithTasksNumbered(true, "[%02d]")

    queue.AddTasks(summary, topology, nodes)
    if err := queue.Run(); err != nil {
        return err
    }

    // Seçilen topolojiye göre ek görevler ekleyelim.
    followUp := ziva.NewQueue("Takip görevleri")

    switch topology.GetSelected() {
    case "single-node":
        followUp.AddTasks(planBackupTask(), confirmMetricsTask())
    case "multi-node":
        followUp.AddTasks(configureIngressTask(), scaleOutTask(nodes))
    case "ha":
        followUp.AddTasks(haPrecheckTask(), configureQuorumTask(nodes))
    }

    return followUp.Run()
}

​
Öne çıkanlar

  • İki kuyruk çalıştırması. İlk kuyruk girişleri toplar; ikinci kuyruk çalışma zamanında oluşturulur.
  • Özet fonksiyonu. WithSummaryFunction, görevin altında kısa bir özet gösterir ve operatör geri bildirimini güçlendirir.
  • Zaman aşımı. WithTimeout, başsız oturumların sonsuza kadar askıda kalmasını engeller.

​
Kullanıcı onayıyla yeniden deneme

func RunWithRetries(label string, fn func() error, maxAttempts int) error {
    attempt := 1

    for {
        task := ziva.NewFuncTask(
            fmt.Sprintf("%s · deneme %d", label, attempt),
            fn,
            ziva.WithStopOnError(false),
        )

        queue := ziva.NewQueue(label)
        queue.AddTasks(task)

        if err := queue.Run(); err == nil {
            return nil
        }

        if attempt >= maxAttempts {
            return fmt.Errorf("deneme limiti aşıldı (%d)", maxAttempts)
        }

        retry := ziva.NewYesNoTask(
            "Tekrar dene",
            fmt.Sprintf("%d. deneme başarısız oldu. Tekrar denensin mi?", attempt),
        ).WithDefaultYesAndTimeout(10 * time.Second)

        confirmation := ziva.NewQueue("Tekrar kararı")
        confirmation.AddTasks(retry)
        confirmation.Run()

        if !retry.IsYes() {
            return fmt.Errorf("işlem %d. denemede iptal edildi", attempt)
        }

        attempt++
    }
}

​
Ne zaman gerekli?

  • kararsız altyapı çağrıları;
  • güvenilir olmayan bağlantılarda ürün yazılımı güncellemeleri;
  • insan onayıyla yeniden denenmesi gereken uzun işlemler.

​
Görevleri uçuş sırasında oluşturma

func ConfigureServers() error {
    count := ziva.NewInputTask("Sunucu sayısı", "Kaç sunucu yapılandırılacak?").
        WithInputType(ziva.InputTypeNumber).
        WithValidator(ziva.DefaultValidators.Range(1, 8))

    baseQueue := ziva.NewQueue("Yapılandırma parametreleri")
    baseQueue.AddTasks(count)
    if err := baseQueue.Run(); err != nil {
        return err
    }

    n, _ := strconv.Atoi(count.GetValue())

    var tasks []ziva.Task
    for i := 1; i <= n; i++ {
        prefix := fmt.Sprintf("Sunucu %d", i)

        host := ziva.NewInputTask(prefix+" · host", "FQDN girin")
        host.WithValidator(ziva.DefaultValidators.Domain())

        port := ziva.NewInputTask(prefix+" · port", "Port girin")
        port.WithInputType(ziva.InputTypeNumber).
            WithValidator(ziva.DefaultValidators.Port())

        tasks = append(tasks, host, port)
    }

    servers := ziva.NewQueue("Sunucu yapılandırması").
        WithTasksNumbered(true, "[%02d]")
    servers.AddTasks(tasks...)
    return servers.Run()
}
Yüzlerce görev üretebilecek bir akışınız varsa yürütmeyi birkaç kuyruğa bölün ve bellek tüketimini tahmin edilebilir tutmak için bloklar halinde çalıştırın.

​
Karmaşık akışlar için hızlı kontrol listesi

  • Sonuçlarına daha sonra ihtiyaç duyacağınız görevlerin referanslarını saklayın.
  • Farklı aşamalar için ayrı kuyruklar kullanın — bu, mantığı ve test yazmayı kolaylaştırır.
  • Ziva’un hedef sistemi otomatik ayarlaması için başlangıçta AutoConfigure() çağırın.
  • Kısıtlı cihazlarda çıktıyı kompakt tutmak için EnableEmbeddedMode() ile WithOutResultLine() kombinasyonunu tercih edin.
  • Kuyruk sırayla çalışır; sözde paralellik gerekiyorsa ek kuyrukları FuncTask içinden başlatın.
Dayanıklı formlar oluşturmayı öğrenmek için doğrulama demosuna göz atın.
⌘I