Aracılığıyla paylaş

Slack ile Azure Repos

  • Makale

Azure DevOps Services

Slackkullanıyorsanız, Azure Depolarınızı kolayca izlemek için Slack için Azure Repos uygulamasını kullanabilirsiniz. Kod gönderildiğinde veya iade edilirken ve çekme isteği (PR) oluşturulduğunda, güncelleştirildiğinde veya birleştirildiğinde kanalınızda bildirim almak için abonelikleri ayarlayın ve yönetin. Bu uygulama hem Git hem de Team Foundation Sürüm Denetimi (TFVC) olaylarını destekler.

Önkoşullar

Not

  • Slack için Azure Repos uygulamasını şu anda yalnızca Azure DevOps Services'da barındırılan bir projeye bağlayabilirsiniz.
  • Bildirimler şu anda doğrudan iletilerde desteklenmemektedir.

Azure Repos uygulamasını Slack çalışma alanınıza ekleme

  1. Azure Repos Slack uygulaması gidin ve Slack'e Ekleseçeneğini belirleyin.

    Slack uygulama dizininin ekran görüntüsü, Azure Depoları ve Slack'e Ekle düğmesi.

    Eklendikten sonra aşağıdaki karşılama iletisine benzer bir ileti alırsınız.

    Slack'ten Gelen Hoş Geldiniz iletisinin ekran görüntüsü.

  2. Uygulamayla etkileşime geçmek için /azrepos Slack tutamacını kullanın. Komut Referansı bölümünde, bu makaledeki komutların tam listesi sağlanmıştır.

Azure Repos uygulamasını depolarınıza bağlama

  1. /azrepos signin komutunu kullanarak Azure Repos'a bağlanın ve kimliğinizi doğrulayın.

    Slack için Oturum açma isteminin ekran görüntüsü.

  2. Oturum aç'ı seçin.

  3. Azure Repos'un Slack Entegrasyonunu kabul edin.

    Sonraki oturum açma ekranındaki Kabul Et düğmesinin ekran görüntüsü.

    Kimlik doğrulamasını tamamlamak için sohbet uygulamanızda kullanılmak üzere bir doğrulama kodu görüntülenir.

  4. Kimlik doğrulama kodunu kopyalayın.

    Azure Repos tarafından sağlanan doğrulama kodunun ekran görüntüsü.

  5. Kodugirin'i seçin, kodu yapıştırın ve ardından Gönder'ü seçin.

    Doğrulama kodu yapıştırıldığında ve gönder düğmesi seçildiğinde son kimlik doğrulama ekranının ekran görüntüsü.

    Sohbette oturum açma onayı görüntülenir.

    sohbette ekran görüntüsü oturum açma onayı .

Bir projedeki tüm Git depolarını izlemeye başlamak için kanal içinde aşağıdaki eğik çizgi komutunu kullanın:

/azrepos subscribe [project url]

Proje URL'si, depolar hariç, projenizdeki herhangi bir sayfaya yönlendirilebilir. Örneğin:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Aşağıdaki komutu kullanarak belirli bir depoyu da izleyebilirsiniz:

/azrepos subscribe [repository url]

Depo URL'si, deponuzun adını içeren herhangi bir sayfaya yönlenebilir. Örneğin, Git depoları için şunu kullanın:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

TFVC depoları için şunu kullanın:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Not

Yalnızca genel depolara abone olabilirsiniz.

Abone ol komutu, varsayılan aboneliği kullanmaya başlamanızı sağlar. Git depoları için kanal, olayı (hedef dal = ana ile) oluşturulan Çekme isteğine abonedir ve TFVC depoları için olayda denetlenen Koduna abonedir.

Varsayılan abonelik oluşturma iletisini gösteren ekran görüntüsü.

Abonelikleri yönetme

Bir kanalın aboneliklerini görüntülemek, eklemek veya kaldırmak için aşağıdaki subscriptions komutunu kullanın:

/azrepos subscriptions

Bu komut, kanal için tüm geçerli abonelikleri listeler ve yeni abonelikler eklemenize veya mevcut abonelikleri kaldırmanıza olanak tanır. Abonelik eklerken, aşağıdaki bölümde açıklandığı gibi çeşitli filtreler kullanarak alınan bildirimleri özelleştirebilirsiniz.

Not

Ekip yöneticileri, Project yöneticileri tarafından oluşturulan abonelikleri kaldıramaz veya değiştiremez.

Abonelikler listesinin görünümünü gösteren ekran görüntüsü.

Abonelikleri özelleştirmek için filtreleri kullanma

Kullanıcı /azrepos subscribe komutunu kullanarak bir depoya abone olduğunda varsayılan abonelik oluşturulur. Kullanıcıların genellikle bu abonelikleri özelleştirmesi gerekir. Örneğin, kullanıcılar yalnızca PR'ler belirli bir gözden geçirene sahip olduğunda bildirim almak isteyebilir.

Aşağıdaki adımlarda aboneliklerin nasıl özelleştirileceği gösterilmektedir.

  1. /azrepos subscriptions komutunu çalıştırın.
  2. Abonelik listesinde, istenmeyen veya değiştirilmesi gereken bir abonelik varsa (Örnek: kanalda kirlilik oluşturma), Kaldır düğmesini seçin.
  3. Abonelik ekle düğmesini seçin.
  4. Gerekli depoyu ve istenen olayı seçin.
  5. Uygun filtreleri seçin.

Örnek: Yalnızca ekibim bir PR için gözden geçirenler listesinde yer aldığında bildirim al

Ekran görüntüsü, gözden geçirenin benim takımıma sahip olduğunu gösteriyor.

Örnek: İlke ihlali nedeniyle birleştirme girişimlerinin başarısız olduğunu göster

İlke ihlali nedeniyle Birleştirme girişiminin başarısız olduğunu gösteren ekran görüntüsü.

Not

  • Tüm filtreler genellikle açılan menülerdir. Ancak açılan listede 100'den fazla öğe varsa, kullanıcıların değerleri el ile girmesi gerekir.
  • TFVC Kod Kontrol Edildi olayı için, altındaki filtresi biçiminde olmalıdır.

Çekme isteği URL'lerini önizleme

Kullanıcı bir PR URL'si yapıştırdığında, PR ile ilgili konuşmaları bağlamsal ve doğru tutmaya yardımcı olacak aşağıdaki görsele benzer bir önizleme görüntülenir.

Ekran görüntüsü, URL'nin açılımını göstermektedir.

Kullanıcılar oturum açtığınızda, bu özellik çalışma alanında tüm kanallar için çalışır.

Kanaldan abonelikleri ve depoları kaldırma

Depoları ve abonelikleri kaldırarak kanalınızı temizlemek için aşağıdaki komutu kullanın.

/azrepos unsubscribe all [project url]

Örneğin, aşağıdaki komut projedeki herhangi bir depoyla ilgili tüm abonelikleri siler ve depoları kanaldan kaldırır. Bu komutu yalnızca proje yöneticileri çalıştırabilir.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Komut Referansı

Aşağıdaki tabloda Slack kanalınızda kullanabileceğiniz tüm /azrepos commands listelenir.

Slash komutu İşlevsellik
/azrepos subscribe [depo url'si/ proje url'si] Bildirimler için bir depoya veya projedeki tüm depolara abone olma
/azrepos abonelikleri Bu kanal için abonelik ekleme veya kaldırma
/azrepos signin Azure Repos kuruluşunuzda oturum açın
/azrepos çıkış yap Azure Repos kuruluşunuzdan oturumu kapatmak
/azrepos geri bildirimi Sorun bildirme veya özellik önerme
/azrepos tüm abonelikten çık [proje url'si] Kanaldan tüm depoları (bir projeye ait) ve ilişkili aboneliklerini kaldırma

Özel kanallardaki bildirimler

Azure Repos uygulaması, özel kanallarınızdaki depo olaylarını izlemenize de yardımcı olabilir. /invite @azreposkullanarak botu özel kanalınıza davet edin. Ardından, bildirimlerinizi genel kanalda yaptığınız gibi yönetebilirsiniz.

Sorun giderme

Slackiçin Azure Repos Uygulamasını kullanırken aşağıdaki hatalarla karşılaşıyorsanız bu bölümdeki yordamları izleyin.

Üzgünüz, bir sorun oluştu. Lütfen yeniden deneyin.

Azure Repos uygulaması OAuth kimlik doğrulama protokolünü kullanır ve kuruluşun etkinleştirilmesi için OAuth aracılığıyla Üçüncü taraf uygulama erişimi gerektirir. Bu ayarı etkinleştirmek için Kuruluş AyarlarıGüvenlikİlkeleriadresine gidin ve kuruluş için OAuth aracılığıyla üçüncü taraf uygulama erişimini 'da olarak ayarlayın.

Kuruluş ayarı için OAuth aracılığıyla Üçüncü taraf uygulama erişimini etkinleştirme

Yapılandırma başarısız oldu. Lütfen '{organization name}' kuruluşunun mevcut olduğundan ve yeterli izinlere sahip olduğunuzdan emin olun.

Tarayıcınızı kullanarak https://aka.ms/VsSignout giderek Azure DevOps oturumunu kapatın.

Özel veya gizli tarayıcı penceresinde bir açın, gidin ve oturum açın. Soldaki profil simgesinin altındaki açılan listede, abone olmak istediğiniz depoyu içeren kuruluşu içeren dizini seçin.

Proje içeren kuruluşu içeren dizini seçin

tarayıcıyeni bir sekme başlatın, https://slack.comadresine gidin ve çalışma alanınızda oturum açın (web istemcisikullanın). /azrepos signout komutunu ve ardından /azrepos signin komutunu çalıştırın.

Sign in düğmesini seçtiğinizde aşağıdaki örnekteki gibi bir onay sayfasına yönlendirilirsiniz. E-postanın yanında gösterilen dizinin önceki adımda seçilen dizinle aynı olduğundan emin olun. Oturum açma işlemini kabul edin ve tamamlayın.

Ekran görüntüsü, istenen uygulama izinlerine onay verme işlemini gösterir.

Bu adımlar kimlik doğrulama sorununuzu çözmezse, Geliştirici Topluluğuadresinden bize ulaşın.