Dev Tunnels kullanarak aracıları test etmek

Dev Tunnels kullanarak, Agent 365 aracınızı Microsoft 365 uygulamalarıyla (Teams, Outlook veya Word gibi), aracınız geliştirme makinenizde yerel olarak çalışırken test edebilirsiniz. Bu yaklaşım, yerel geliştirme ile gerçek dünya testleri arasında bir köprü kurar; böylece, buluta dağıtmadan önce aracı davranışını gerçek Microsoft 365 ortamlarında doğrulayabilirsiniz.

Ön koşullar

Dev Tunnels'i kullanmadan önce, Dev Tunnels komut satırı aracını yüklediğinizden emin olun.

Dev Tunnel'i Kur

Yerel aracı uç noktanızı Microsoft 365 hizmetlerine açığa çıkarmak için bir Dev Tunnel yapılandırın.

Bir tünel oluşturun ve başlatın

  1. Dev Tunnel'a oturum açın:

    devtunnel user login

  2. Kalıcı bir tünel oluşturun:

    devtunnel create --allow-anonymous

    Bu komut bir tünel kimliği döndürür. Bu tanımlayıcıyı gelecekte kullanmak üzere kaydedin.

  3. Tünel portunu yapılandırın:

    Aracı sunucunuzun kullandığı portu (genellikle 3978) atayın:

    devtunnel port create <tunnel-id> -p <port-number>

  4. Tüneli başlatın:

    devtunnel host <tunnel-id>

    Komut, tünel URL'nizi gösterir (örneğin, https://abc123xyz.devtunnels.ms:3978). Bir sonraki adım için bu URL'yi kopyalayın.

İpucu

Tüm tünellerinizi görüntülemek için devtunnel list'i ve artık ihtiyacınız olmayan tünelleri kaldırmak için devtunnel delete <tunnel-id>'yi kullanın.

Aracı mesajlaşma uç noktasını yapılandırma

Microsoft 365'in mesajları doğru şekilde yönlendirebilmesi için Dev Tunnel URL'nizi (örneğin, https://abc123xyz.devtunnels.ms:3978/api/messages) aracı mesajlaşma uç noktası olarak kaydedin. Uç noktaya /api/messages ekini eklemeyi unutmayın.

Lütfen bkz. Aracı mesajlaşma uç noktası ayarlama

Microsoft 365 ile test yapın

Dev Tunnel'iniz aktif ve uç noktanız kayıtlı olduğunda, aracınızı Microsoft 365 uygulamalarında test edin.

Microsoft Teams'te test et

  1. Yerel aracınızı başlatın, Install dependencies and start the agent application server bölümündeki talimatlarla.

  2. Tünel bağlantısını doğrulayın:

    devtunnel list

    Tünelinizin aktif host bağlantılarını gösterdiğini kontrol edin. "Host Connections" sütunu 0'dan büyük bir sayı göstermelidir.

  3. Teams'te aracınızla etkileşim kurun:

    • Microsoft Teams'i açın (web veya masaüstü)
    • Teams arama çubuğunda, aracınızı isimle veya e-posta adresiyle arayın
    • Aracı ile bir konuşma başlatın
    • Bir mesaj gönderin ve yanıtı gözlemleyin
    • Yerel konsolunuzda gelen istekleri ve aracı etkinliklerini kontrol edin.

E-posta bildirimleri test etme

Aracınız e-posta bildirimleri için yapılandırılmışsa:

  1. Aracınızın e-posta adresine bir e-posta gönderin
  2. Aracınızı bir e-posta zincirinde CC edin
  3. Yerel konsolunuzu bildirim webhook'u için gözlemleyin.
  4. Aracınızın gelen e-postayı işleyip yanıtladığını doğrulayın

Word entegrasyonunu test edin

Word yorumlarına yanıt veren aracılar için:

  1. Aracınızın erişebileceği bir Word belgesi açın.
  2. Aracınızden bahseden bir yorum ekleyin.
  3. Yerel konsolunuzda bildirimi kontrol edin.
  4. Aracınızın yanıtının Word'de göründüğünü doğrulayın.

Tünel aktivitesini izleyin

Dev Tunnels, bağlantı sorunlarını hata ayıklamak ve istek akışını anlamak için trafik incelemesi sağlar:

devtunnel show <tunnel-id>

Bu komut şunları gösterir:

  • Aktif bağlantılar ve oturum detayları.
  • İstek ve yanıt bilgileri.
  • Trafik hacmi istatistikleri.
  • Bağlantı hataları ve uyarıları.

Ayrıca devtunnel host komutunun çıktısını izleyerek tünel etkinliğini gerçek zamanlı olarak izleyebilirsiniz.

Tünel bağlantılarını sürdürmek

Dev Tunnels, devtunnel host işleminin çalışmaya devam etmesini gerektirir. Bağlantı, aktivitetsizlik, ağ sorunları veya bilgisayarınızın uykuya geçmesi nedeniyle koparsa, onu yeniden başlatmanız gerekir.

Tünel durumunu kontrol etmek

Tünelinizin aktif olup olmadığını doğrulayın:

devtunnel list

Çıktı şunları gösterir:

  • Tünel ID: Tünel kimliğiniz
  • Host Bağlantıları: Aktif bağlantıların sayısı (devtunnel host çalışırken bir veya daha fazla olmalıdır)
  • Portlar: Yapılandırılmış portlar
  • Son Kullanma Zamanı: Tünelin son kullanma zamanı

Eğer Host Connections 0 ise, tünel mevcut ancak şu anda barındırılmıyor.

Bağlantısı kesilen bir tüneli yeniden başlatmak

Tünel bağlantınız kesilirse, aynı tünel kimliğini kullanarak yeniden başlatın.

devtunnel host <tunnel-id>

Tünel URL'si aynı kalır, bu nedenle aracı mesajlaşma uç nokta yapılandırmanızı güncellemenize gerek yoktur.

Geliştirme sırasında tünelleri aktif tutmak

Bağlantıların stabil olmasını sağlamak için:

  • Terminal penceresini açık tutun - Çalışan terminali kapatmayındevtunnel host.
  • Bilgisayarın uyku moduna geçmesini engelleyin - Sisteminizi test oturumları sırasında uyanık kalacak şekilde ayarlayın.
  • Bağlantı hatalarını izleyin - Bağlantı kopma mesajları için devtunnel hostterminal çıktısını gözlemleyin.
  • Ağ değişikliklerinden sonra yeniden başlat - Ağ değiştirirseniz veya VPN'e yeniden bağlanırsanız, tüneli yeniden başlatın.

İpucu

Tüneliniz sık sık bağlantı kesiliyorsa, ağ ayarlarınızı ve güvenlik duvarı kurallarınızı kontrol ederek bağlantının engellenmediğinden emin olun.

Temizleme

Dev Tunnels ile testleri bitirdiğinizde:

Tüneli durdurun

Tüneli durdurmak için, terminalde Ctrl+C tuşuna, devtunnel host çalışırken basın.

Bu komut, aracınızın mesajlaşma uç noktasından Dev Tunnel URL'sini kaldırır. Üretime geçirdiğinizde, bulutta barındırılan uç nokta URL'sini ayarlayın.

Not

Tünel, devtunnel delete <tunnel-id> kullanılarak açıkça silinene kadar gelecekte kullanım için erişilebilir durumda kalır.

Sınırlamalar

Dev Tunnels ile test yaparken şu sınırlamaları göz önünde bulundurun:

  • Yalnızca geliştirme amaçlı: Dev Tunnels'ı geliştirme ve test için kullanın, üretimde kullanmayın.
  • Performans: Ağ yönlendirmesi nedeniyle bulutta barındırılan aracılara kıyasla daha yüksek gecikme bekleyebilirsiniz.
  • Bağlantı kararlılığı: Tünel bağlantıları zaman zaman kopabilir ve manuel olarak yeniden başlatılması gerekebilir.
  • Güvenlik endişeleri: --allow-anonymous bayrağı test için kullanışlıdır ancak hassas verilerle kullanmayın.
  • Oturum yönetimi: Oturum sürenize bağlı olarak periyodik olarak yeniden kimlik doğrulaması yapmanız gerekebilir.

Sonraki adımlar

Başarılı Dev Tunnel testinden sonra:

Sorun giderme

Dev Tunnels üzerinden test yaparken sorunlarla karşılaşıyorsanız, yaygın tünel, bağlantı ve uç nokta sorunlarının çözümleri için buradan başlayın. Daha kapsamlı Agent 365 sorun giderme (kurulum, kimlik doğrulama ve mesajlaşma) için Sorun Giderme bölümüne bakın.

Tünel bağlantısı başarısız

Belirtiler: Dev Tunnel başlamaz veya bağlantıyı hemen keser.

Çözümler:

  • Oturum açtığınızı doğrulayın: devtunnel user login
  • Başka bir işlemin aynı portu kullanıp kullanmadığını kontrol edin
  • Güvenlik duvarınızın Dev Tunnel bağlantılarına izin verdiğini doğrulayın
  • Tüneli silin ve yeniden oluşturun: devtunnel delete <tunnel-id> ardından yeni bir tane oluşturun

Mesajlar yerel aracıya ulaşmıyor

Belirtiler: Microsoft 365 mesajın gönderildiğini gösteriyor, ancak yerel aracınız mesajı almıyor.

Çözümler:

  • Aracınızın yerel olarak çalıştığını doğrulayın
  • Tünelin aktif olduğundan emin olun: devtunnel list 'Bağlı' olarak görünmelidir
  • a365.config.json içindeki uç nokta yapılandırmasını kontrol edin ve Dev Tunnel URL'nizin mesajlaşma uç noktası olarak ayarlandığını doğrulayın.
  • Terminalde çalışan devtunnel host'in Dev Tunnel loglarını bağlantı hataları açısından inceleyin.
  • Yerel portunuzun tünel portuyla aynı olduğundan emin olun (her ikisi de varsayılan olarak 3978 olmalıdır).

Dev Tunnel'da kimlik doğrulama hataları

Belirtiler: Dev Tunnel'da test sırasında 401 veya 403 hataları.

Çözümler:

  • Aracı kimlik doğrulamasının yapılandırıldığını doğrulayın (taşıyıcı token doğrulama, Microsoft 365 entegrasyonu için Dev Tunnels ile çalışmaz).
  • Aracı şablonu kimlik bilgilerini a365.generated.config.json adresinde kontrol edin.
  • Aracınızın test etmekte olduğunuz işlemler için gerekli izinlere sahip olduğunu doğrulayın.
  • Kimlik doğrulama tokenlerinizin süresi dolmadığından emin olun.

Tünel URL'si değişti veya süresi doldu

Belirtiler: Daha önce çalışan tünel URL'si artık aracınize yönlendirilmiyor.

Çözümler:

  • Tünel durumunu devtunnel list ile kontrol et.
  • Tüneli devtunnel host <tunnel-id> kullanarak yeniden başlatın.
  • URL değiştiyse, mesajlaşma uç noktasını a365 setup blueprint --endpoint-only kullanarak güncelleyin.
  • Last updated on