Azure Pipelines'i Slack ile kullanma

Azure DevOps Services

Slack için Azure Pipelines uygulamasıyla Slack kullanıcıları işlem hatlarında gerçekleşen olayları kolayca izleyebilir. Uygulama, kullanıcıların derlemeler, sürümler, bekleyen onaylar ve daha fazlası gibi çeşitli işlem hattı olayları için abonelik oluşturmasına ve denetlemesine olanak tanır. Bu olaylar için bildirimler daha sonra doğrudan kullanıcıların Slack kanallarına teslim edilir

Dekont

Bu özellik yalnızca Azure DevOps Services'ta kullanılabilir. Genellikle yeni özellikler önce bulut hizmetinde kullanıma sunulur ve ardından Azure DevOps Server'ın bir sonraki ana sürümünde veya güncelleştirmesinde şirket içinde kullanılabilir hale getirilir. Daha fazla bilgi edinmek için bkz . Azure DevOps Özellik Zaman Çizelgesi.

Önkoşullar

  • Slack'te Slack çalışma alanınıza uygulama yükleme izniniz olmalıdır.
  • Azure DevOps için Slack aboneliği ayarlamak için Project Collection Yönetici istrators veya Project Yönetici istrators grubunda olmanız gerekir.

Azure Pipelines uygulamasını yükleme

Azure Pipelines uygulamasını Slack çalışma alanınıza yüklemek için Azure Pipelines Slack uygulamasına gidin. Eklendikten sonra, uygulamadan aşağıdaki gibi bir hoş geldiniz iletisi görürsünüz. /azpipelines Uygulamayla etkileşime geçmek için tutamacı kullanın.

A screenshot showing the Azure Pipelines app welcome message.

İşlem hattınıza Bağlan

Uygulama Slack çalışma alanınıza yüklendikten sonra, uygulamayı izlemek istediğiniz herhangi bir işlem hattına bağlayabilirsiniz. Komut çalıştırmadan önce Azure Pipelines'da kimlik doğrulaması yapmanız istenir.

A screenshot showing the sign-in prompt message.

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

/azpipelines subscribe [project url]

Proje URL'si projenizdeki herhangi bir sayfaya bağlanabilir (işlem hatlarına url'ler dışında). Örneğin: /azpipelines abonesi https://dev.azure.com/myorg/myproject/

Aşağıdaki komutu kullanarak belirli bir işlem hattını da izleyebilirsiniz:

/azpipelines subscribe [pipeline url]

İşlem hattı URL'si, işlem hattınızdaki URL'de veya olan herhangi bir definitionIdbuildId/releaseId sayfaya bağlanabilir. Örneğin: /azpipelines subscribehttps://dev.azure.com/myorg/myproject/_build?definitionId=123 veya: /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123& view=mine&_a=releases

Abone ol komutu, varsayılan olarak birkaç abonelikle çalışmaya başlamanızı sağlar. Aşağıdaki işlem hattı türü için etkinleştirilen varsayılan bildirimler şunlardır:

İşlem hatları oluşturma Yayın işlem hatları YAML işlem hatları
Derleme tamamlandı bildirimi Yayın dağıtımı başlatıldı, Yayın dağıtımı tamamlandı ve Yayın dağıtımı onayı bekleniyor bildirimleri Çalıştırma aşaması durumu değiştirildi ve Çalışma aşaması onay bildirimlerini bekliyor

A screenshot showing notification example.

Abonelikleri yönetme

Bir kanalın aboneliklerini yönetmek için aşağıdaki komutu kullanın: /azpipelines subscriptions

Bu komut, kanal için tüm geçerli abonelikleri listeler ve abonelik eklemenizi veya kaldırmanızı sağlar.

Dekont

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

A screenshot showing a list of subscriptions.

Abonelikleri özelleştirme

Varsayılan olarak, bir işlem hattına abone olurken, filtre uygulanmayan birkaç abonelik oluşturulur. Ancak, kullanıcıların bu abonelikleri tercihlerine göre kişiselleştirmek istemesi yaygın bir durumdur. Örneğin, kullanıcılar yalnızca başarısız derlemeler veya üretime dağıtımlar yapıldığında bildirim almak isteyebilir. Azure Pipelines uygulaması filtreleri uygulama seçeneği sunarak kullanıcıların kanallarında aldıkları iletileri özelleştirmelerini sağlar. Aboneliği özelleştirmek için:

  1. /azpipelines subscriptions Tüm aboneliklerinizi listelemek için komutunu çalıştırın.

  2. Abonelik ekle'yi seçin.

  3. Abone olmak istediğiniz olayı seçin ve ardından istediğiniz yapılandırmayı seçin.

  4. Bitirdiğinizde Kaydet'i seçin.

Örnek: Yalnızca başarısız derlemeler için bildirim alma

A screenshot showing a list how to add a custom new subscription.

Dağıtımları onaylama

Dağıtımları Azure Pipelines portalına gitmeden Slack kanalınızın içinden onaylayabilirsiniz. Bunun için Yayın dağıtımı onayı bekleyen bildirimlere (klasik sürümler) veya Onay bildirimlerini bekleyen Çalıştırma aşamasına (YAML işlem hatları) abone olabilirsiniz. bir işlem hattına abone olduğunuzda her iki abonelik de varsayılan olarak oluşturulur.

A screenshot showing pipeline approval in Slack.

Slack için Azure Pipelines uygulaması, Azure Pipelines portalında bulunan tüm denetim ve onay senaryolarını işlemenizi sağlar. Bunlar tek onaylayanı, birden çok onaylayanı ve ekip tabanlı onayı içerir. İstekleri tek tek veya bir ekip adına onaylama seçeneğiniz vardır.

A screenshot showing a predeployment pipeline approved in Slack.

Tüm abonelikleri kaldırma

Kanalınızı karmaşık hale getirmek için aşağıdaki komutlardan yararlanarak proje içindeki tüm işlem hatlarının aboneliğini kaldırabilirsiniz. Örneğin: /azpipelines aboneliğini kaldırıyor.https://dev.azure.com/myorg/myproject

/azpipelines unsubscribe all [project url]

Önemli

Bu komut yalnızca proje yöneticileri tarafından yürütülebilir.

Komut başvurusu

Slack için Azure Pipelines uygulaması tarafından desteklenen tüm komutlar şunlardır:

Eğik çizgi komutu İşlev
/azpipelines subscribe [işlem hattı url'si/ proje url'si] Bildirim almak için bir işlem hattına veya projedeki tüm işlem hatlarına abone olma
/azpipelines abonelikleri Bu kanal için abonelik ekle veya kaldır
/azpipelines geri bildirimi Sorun bildirme veya özellik önerme
/azpipelines yardımı Eğik çizgi komutları hakkında yardım alma
/azpipelines signin Azure Pipelines hesabınızda oturum açın
/azpipelines oturumu kapatma Azure Pipelines hesabınızda oturumu kapatma
/azpipelines tüm [proje url'si] aboneliğini kaldırıyor Kanaldan tüm işlem hatlarını (bir projeye ait) ve ilişkili aboneliklerini kaldırma

Özel kanallarda bildirimler

Azure Pipelines uygulaması, özel kanallarınızdaki işlem hattı etkinliğini izlemenize de yardımcı olabilir. kullanarak /invite @azpipelinesbotu özel kanalınıza davet etmeniz gerekir. Bot eklendikten sonra, bildirimlerinizi genel kanalla aynı şekilde yapılandırabilir ve denetleyebilirsiniz.

Dekont

  • Slack için Azure Pipelines uygulamasını şu anda yalnızca Azure DevOps Services üzerinde barındırılan bir projeyle kullanabilirsiniz.
  • Kullanıcının abonelikleri ayarlamak için işlem hattını içeren projenin yöneticisi olması gerekir
  • Bildirimler şu anda doğrudan iletilerde desteklenmemektedir
  • 'Onay tamamlanmadan önce onaylayan kimliğini yeniden doğrula' ilkesi uygulanmış dağıtım onayları desteklenmez
  • Azure DevOps'ta kuruluş için bildirim almak için 'OAuth aracılığıyla üçüncü taraf uygulama erişimi' etkinleştirilmelidir (Kuruluş Ayarlar -> Güvenlik -> İlkeler)

Sorun giderme

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

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

Azure Pipelines uygulaması OAuth kimlik doğrulama protokolünü kullanır ve OAuth aracılığıyla üçüncü taraf uygulama erişiminin etkinleştirilmesini gerektirir. Bu ayarı etkinleştirmek için Kuruluş Ayarlar> Güvenlik>İlkeleri'ne gidin ve kuruluş için OAuth aracılığıyla Üçüncü taraf uygulama erişimini açın.

A screenshot showing how to enable third party access via OAuth.

Yapılandırma başarısız oldu. Lütfen kuruluşun mevcut olduğundan ve yeterli izinlere sahip olduğunuzdan emin olun

Şu URL'ye giderek Azure DevOps oturumunu kapatın: https://aka.ms/VsSignout.

Özel/gizli bir tarayıcı penceresi açın ve adresine https://aex.dev.azure.com/me gidip oturum açın. Abone olmak istediğiniz işlem hattının bulunduğu kuruluşu içeren dizini seçin.

A screenshot showing how to select your pipeline directory.

Aynı tarayıcıyı kullanarak yeni bir sekme açın ve adresine https://slack.comgidin. Web istemcisini kullanarak çalışma alanınızda oturum açın ve ardından komutunu ve ardından komutunu /azpipelines signinçalıştırın/azpipelines signout.

Düğmeyi Sign in seçtiğinizde aşağıdaki örnekte gösterildiği gibi bir onay sayfasına yönlendirilirsiniz. E-posta adresinizin yanında görüntülenen dizinin önceki adımda seçilen dizinle eşleştiğinden emin olun. Oturum açma işlemini tamamlamak için Kabul Et'i seçin.

A screenshot showing how to allow pipelines slack integration.