Temporal¶

Bu makalede

• Temporal. Temel Özellikler
• Çalıştırma Özellikleri
• Temporal Kurulumu Sonrası Başlangıç
• Ana Ekran ve Navigasyon
• Go ile Temporal Test Etme (Opsiyonel)
• API Aracılığıyla Temporal Sunucusu Sipariş Etme

Temporal. Temel Özellikler¶

• Workflow Orchestration: Uzun süreli iş süreçlerinin sağlam bir şekilde yürütülmesini sağlar. Hataları ve yeniden denemeleri otomatik olarak yöneterek görevlerin tamamlanmasını garanti eder.
• Distributed Transactions: Dağıtık kilitler (distributed locks) kullanmadan farklı servisler arasında tutarlı işlem yürütümü sağlar.
• Timeouts and Scheduling: Uzun süreçler için bile zamanlayıcılar ayarlamaya ve görevleri yüksek hassasiyetle planlamaya olanak tanır.
• Scalability: Yüksek yükları karşılamak için yatay ölçeklendirmeyi destekler. Bileşenler bağımsız olarak ölçeklendirilebilir.
• Historical Debugging: Süreç yürütme geçmişini koruyarak iş akışlarının analiz edilmesini ve hata ayıklanmasını sağlar.
• Versioning: Çalışan görevleri kesintiye uğratmadan güvenli iş akışı güncellemelerini destekler.
• Observability: Uygulama kontrolü için izleme ve izleme (tracing) sistemleriyle entegre olur.
• Multi-tenancy: Birden fazla ekip veya uygulama için izolasyon ve kaynak yönetimi sağlar.

Çalıştırma Özellikleri¶

Temporal Kurulumu Sonrası Başlangıç¶

Ödeme yapıldıktan sonra, sunucunun hazır olduğuna dair bir bildirim kayıtlı e-posta adresinize gönderilecektir. Bu bildirim, erişim için VPS IP adresini ve giriş bilgilerini içerecektir. Şirket müşterileri, donanımı server management panel and API — Invapi üzerinden yönetirler.

webpanel etiketi altındaki bağlantıyı takip ettikten sonra bir yetkilendirme penceresi açılacaktır.

Yetkilendirme verileri, sunucu yönetim panelindeki Configuration >> Tags sekmesinde veya gönderilen e-postada bulunabilir:

• Web arayüzü üzerinden Temporal management panel erişimi için bağlantı: webpanel etiketi içindedir;
• Sunucuyu yönetmek için Login ve Password: sunucu tesliminde e-posta ile sağlanır.

Web arayüzüne sahip ana bileşenler:

Ana Ekran ve Navigasyon¶

webpanel etiketi altındaki bağlantıyı takip ettikten sonra Temporal web arayüzü açılacaktır:

Ana ekran, seçilen namespace içindeki iş akışlarının (Workflows) bir listesini görüntüler. "No Workflows running in this Namespace" mesajı, o anda aktif süreç bulunmadığını belirtir.

Arayüzün ana öğeleri:

• Soldaki Sidebar, sistemin farklı bölümlerine erişim sağlar;
• Top bar, mevcut namespace'i gösterir (varsayılan olarak "default");
• Sağ üst köşede yeni süreçler başlatmak için Start Workflow düğmesi;
• Status, Workflow ID, Run ID, Type, Start, End sütunlarına sahip Process table.

Fonksiyonel yetenekler

1. Yeni Bir Workflow Süreci Başlatma:

   • Sağ üst köşedeki Start Workflow düğmesine tıklayın;
   • Açılan formda gerekli parametreleri doldurun;
   • Süreç oluşturmayı onaylayın.

2. Süreçleri Görüntüleme ve Filtreleme:

   • Çeşitli kriterlere göre süreçleri seçmek için Filter düğmesini kullanın;
   • Detaylı bilgi görüntülemek için tablodan herhangi bir süreci seçin.

3. Kod Örnekleri:

   • GitHub depo bağlantıları aracılığıyla entegrasyon örneklerine erişin:
   • samples-go - Go örnekleri;
   • samples-java - Java örnekleri;
   • samples-typescript - TypeScript örnekleri;
   • samples-python - Python örnekleri;
   • samples-dotnet - .NET örnekleri;
   • samples-php - PHP örnekleri.

4. Ayarları Değiştirme:

   • Zaman dilimi değişiklikleri için sağ üst köşede UTC seçicisi;
   • (Gear) düğmesi, ek arayüz ayarlarına erişim içindir.

Tipik Kullanım Durumları:

• Süreçleri İzleme: Çalışan görevlerin durumunu düzenli olarak kontrol etme;
• Hata Ayıklama: Hatalar durumunda ayrıntılı analiz yapma;
• İş Yükü Yönetimi: Süreçleri başlatma, duraklatma ve iptal etme;
• Yeni Süreçler Geliştirme: Özel iş akışları oluşturmak için kod örneklerini kullanma.

Go ile Temporal Test Etme (Opsiyonel)¶

1. Go Kurulumu¶

Testlere başlamadan önce sunucuya Go kurun:

Paket listelerini güncelleyin

apt update

apt install -y wget git curl

wget https://golang.org/dl/go1.22.1.linux-amd64.tar.gz

tar -C /usr/local -xzf go1.22.1.linux-amd64.tar.gz

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc

echo 'export GOPATH=$HOME/go' >> ~/.bashrc

echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc

source ~/.bashrc

go version

2. Temporal Örnek Deposunu Klonlayın¶

Ana dizine gidin

cd ~

git clone https://github.com/temporalio/samples-go.git

cd samples-go

3. Saga Örneği Kullanarak Test Edin¶

Saga deseni, hatalar durumunda geri alma (telafi etme) yeteneği sağlayarak dağıtık işlemleri yönetmek için kullanılır.

Saga örneğinin yapısı

saga/
├── worker/main.go     # Görevleri işleyen Worker süreci
├── start/main.go      # Worker sürecini başlatır
├── activity.go        # Aksiyon tanımları (para çekme/yatırma)
├── workflow.go        # Aksiyon dizisi tanımı
└── shared.go          # Ortak tanımlar

Testi çalıştırın:

1. Worker'ı başlatın (ilk terminalde çalıştırın):

   cd ~/samples-go
   go run saga/worker/main.go
   

   Worker, Temporal'a kaydolacak ve bir görev bekleyecektir. Görev alma girişimlerine dair log mesajları görünecektir.

2. Başlatıcıyı başlatın (ikinci terminalde çalıştırın):

   cd ~/samples-go
   go run saga/start/main.go
   

   Başlatıcı, bir hesaptan diğerine para transferi sürecini başlatır.

Beklenen sonuç:

Worker loglarında şunları göreceksiniz:

1. 001-001 hesabından para çekilmesi;
2. 002-002 hesabına para yatırılması;
3. StepWithError aktivitesinde özel olarak oluşturulmuş bir hata;
4. Hatalı aktiviteyi yürütmek için üç girişim;
5. Telafi edici işlemlerin başlatılması:
   • Fonların orijinal hesaba iadesi;
   • Para çekme işleminin iptali.

4. Sonuçları Temporal Web Arayüzü Üzerinden Doğrulayın¶

1. Tarayıcınızda Temporal web arayüzünü açın ( webpanel etiketi aracılığıyla);
2. Arayüzde transfer-money-workflow ID'sine sahip iş akışını bulun;
3. Tüm aktiviteler ve telafi edici işlemler dahil olmak üzere iş akışının tam yürütme geçmişini göreceksiniz:

API Aracılığıyla Temporal Sunucusu Sipariş Etme¶

Bu yazılımı API kullanarak kurmak için bu talimatları izleyin.