Bu rehberin sonunda hangi ekranda çalışacağınızı ve bir değişikliği tasarımdan çalışan uygulamaya nasıl taşıyacağınızı bileceksiniz.
İlk kez uygulamalı deneme yapacaksanız ilk entegrasyonunuz proje oluşturmadan Monitor’da sonucu bulmaya kadar bütün adımları birlikte gösterir.
Başlamadan önce
Platform yöneticinizden Lunex adresini, geliştirme ortamını ve kullanıcı erişiminizi alın. Akış oluşturmak ve çalıştırmak için platform-developer rolü gerekir. Görüntüleme erişimi ile düzenleme erişimi farklıdır; yöneticilik rolü tek başına geliştirici yetkisi vermez. Kimlik ve yetkiler kurulum ayrıntılarını açıklar.
İlk denemeniz için gerçek sistemlere yazmayan bir örnek seçin. Örnek mesajla başlamak için simülasyon; gerçek HTTP çağrısını sınamak için yanıtı yalnızca sabit bir mesaj olan API uygundur.
1. Ekranları tanıyın
| Ekran | Burada ne yaparsınız? |
|---|---|
| Dashboard | Tasarlanan/çalışan proje ve route sayılarını, günün mesaj özetini, son projeleri ve commit’leri görürsünüz. |
| Projects | Proje oluşturur, arar, içe/dışa aktarır ve çalışma durumunu izlersiniz. |
| Proje Architecture | Route’lar, bağlantılar ve bean’ler arasındaki ilişkiyi görür, tasarım öğelerine geçersiniz. |
| Proje Source | Akış, kod, API, properties ve dağıtım dosyalarını düzenlersiniz. |
| Proje API design | Projede openapi.json varsa API sözleşmesini, operation’ları ve şemaları yönetirsiniz. |
| Proje Build, Deployment | Derleme, sürüm ve dağıtım işlemleri ile çalışan podları ve Kubernetes olaylarını incelersiniz. Altyapıya göre kullanılabilir eylemler değişir. |
| Proje Log | Çalışma zamanı günlüklerini incelersiniz. Runtime bulunmadığında bu sekme görünmez. |
| Message Monitor | Bir iş mesajının işlenmesini, çalıştırmalarını ve kaydedilmiş hata ayrıntılarını araştırırsınız. |
| Settings | Paylaşılan dosya şablonları, Kamelet’ler ve build/yapılandırma dosyaları üzerinde çalışırsınız. |
| System | Yönetici olarak altyapı durumunu ve ortak yapılandırmayı incelersiniz. |
| Artemis console | Kurulumda bağlantısı tanımlıysa broker ve kuyrukları ayrı konsolda yönetirsiniz. |
2. Bir proje seçin
Projects → Create project ile yeni bir entegrasyon projesi oluşturun. Proje kimliği; dosyaların, runtime’ın ve API adresinin ilişkilendirildiği teknik addır. Anlaşılır, küçük harfli bir kimlik seçin; örneğin order-demo. Formun doğrulama kurallarını izleyin. Ayrıntılar Proje kavramı ve dosyalar sayfasındadır.
Var olan bir projeyi açıyorsanız Source, Architecture ve runtime durumunu inceleyin. Running yalnız runtime’ın çalıştığını belirtir; her iş çağrısının başarılı olduğunu göstermez.
Architecture ekranı tasarım ilişkilerini, Deployment/Log rehberi çalışan kaynakları ve başlangıç hatalarını okumayı öğretir. Kaynak sürümünü çalışan imajla eşleştirmek için geliştirmeden üretime örneğini izleyin.
3. İlk hedefinizi seçin
| Hedef | İzlenecek rehber | Beklenen sonuç |
|---|---|---|
| Sipariş mesajını dönüştürmek | İlk simülasyonunuz | Örnek girdiden beklenen çıktı elde edilir; dış sisteme istek gönderilmez. |
| HTTP üzerinden yanıt veren API oluşturmak | İlk API’nizi oluşturma | Operation bir route’a bağlıdır; test çağrısı beklenen durum kodu ve gövdeyi döndürür. |
| Kuyruktan mesaj alıp işlemek | Artemis ve mesajlaşma | Broker bağlantısı ve hedef kuyruk doğrulanır; tüketici mesajı işler. |
Bir API geliştiriyorsanız yalnız OpenAPI dosyasını oluşturmak yeterli değildir. Çağrının ulaşacağı implementation route’unu da hazırlayın. Operation ve route ilişkisi hangi adların birbiriyle eşleşeceğini gösterir.
4. Kaydetme, deneme ve dağıtımı ayırın
| İşlem | Sonucu |
|---|---|
| Editörde kaydetme | Çalışma alanındaki dosya güncellenir. Route ve properties düzenleyicileri otomatik kaydeder; API taslağında Save kullanılır. Kaydetme hatası varsa ilerlemeden giderin. |
| Simulate | Seçilen akış bölümü örnek mesaj ve alıcı yanıtlarıyla çalışır. |
| Run / Reload | Geliştirme runtime’ı gerçek bağlantı ayarlarıyla başlar veya kodu yeniler. Dinleyiciler ve dış sistemlere yazan adımlar çalışabilir. |
| Commit | Seçilen değişiklikler kurulumun Git deposuna gönderilir. |
| Build | Commit edilmiş kaynaklardan imaj üretilir. Varsayılan Kubernetes build akışı aynı zamanda dağıtımı uygular. |
Bu işlemler birbirinin yerine geçmez. Önce Git ve çalıştırma/dağıtım sayfalarından kurulumunuzun akışını doğrulayın.
5. Sonucu doğrulayın
- Örnek mesajın çıktısını veya API’nin HTTP yanıtını kontrol edin.
- Runtime açılmıyorsa projenin Log ve Deployment ayrıntılarına bakın.
- Gerçek işleme gerçekleştiyse Message Monitor’da doğru ortamı, projeyi ve zaman aralığını seçin.
- Sipariş gibi bir iş numarası kullanıyorsanız Application ID veya iş arama alanı kaydedin; mesajı bu değerle yeniden bulun.
- Kaynakları ve bağlantıları gözden geçirip değişiklikleri Git’e gönderin.
Bir işlem görünmüyorsa
Önce ortamınızın geliştirme ortamı olduğunu ve gerekli rolünüzü kontrol edin. Bazı eylemler çalışan veya durdurulmuş container’a, API dosyasının varlığına ve altyapı türüne bağlıdır. Bir hata bildirimi varsa işlemi tekrar tekrar başlatmadan önce mesajı okuyun. Sorun giderme hangi kanıtı toplayacağınızı açıklar.