Slack ile Azure Pipelines

Azure DevOps Services

Slack kullanıyorsanız, işlemhatlarınızın olaylarını kolayca izlemek için Slack için Azure Pipelines uygulamasını kullanabilirsiniz. Uygulamadan derlemeler, yayınlar, YAML işlem hatları, bekleyen onaylar ve daha fazlası için abonelikleri ayarlayın ve yönetin ve Slack kanallarınızda bu olaylar için bildirimler alın.

Notifications image

Not

Bu özellik yalnızca Azure DevOps Services'te 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.

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

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ğıda gösterildiği gibi bir karşılama iletisi görürsünüz. /azpipelines Uygulamayla etkileşim kurmaya başlamak için tutamacı kullanın.

Welcome message image

Azure Pipelines uygulamasını işlem hatlarınıza bağlama

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

Sign in prompt image

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 (işlem hatlarının URL'leri dışında) olabilir.

Örneğin:

/azpipelines subscribe 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ızın içinde VEYA buildId/releaseId URL'sine sahip definitionId olan herhangi bir sayfaya olabilir.

Örneğin:

/azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123

veya:

/azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

Subscribe komutu, varsayılan olarak birkaç abonelikle çalışmaya başlamanızı sağlar. Derleme işlem hatları için kanal, Derleme tamamlandı bildirimine abone olur. Yayın işlem hatları için kanal Yayın dağıtımı başlatıldı, Yayın dağıtımı tamamlandı ve Yayın dağıtımıonayı bekleniyor bildirimlerini almaya başlar. YAML işlem hatları için, çalışma aşaması durumu değişti ve Çalıştırma aşaması onay bildirimlerini bekliyor için abonelikler oluşturulur.

Subscriptions added image

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 yeni abonelikler eklemenize olanak sağlar.

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

Subscriptions list image

Abonelikleri özelleştirmek için filtreleri etkili bir şekilde kullanma

Bir kullanıcı herhangi bir işlem hattına abone olduğunda, filtre uygulanmadan varsayılan olarak birkaç abonelik oluşturulur. Kullanıcıların genellikle bu abonelikleri özelleştirmesi gerekir. Örneğin, kullanıcılar yalnızca başarısız derlemeler hakkında bilgi almak veya yalnızca dağıtımlar üretime gönderildiğinde bildirim almak isteyebilir. Azure Pipelines uygulaması, kanalınızda gördüklerinizi özelleştirmek için filtreleri destekler.

  1. /azpipelines subscriptions komutunu çalıştırın
  2. Abonelik listesinde, istenmeyen veya değiştirilmesi gereken bir abonelik varsa (Örnek: kanalda gürültü oluşturma), Kaldır düğmesini seçin
  3. Abonelik ekle düğmesini seçin
  4. Gerekli işlem hattını ve istenen olayı seçin
  5. Aboneliğinizi özelleştirmek için uygun filtreleri seçin

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

Build Filters

Örnek: Yalnızca dağıtımlar üretim ortamına gönderiliyorsa bildirim alma

Release Filters

Kanalınızdan dağıtımları onaylama

Klasik Sürümler için Yayın dağıtımı onayı beklemede bildirimine veya YAML işlem hatları için onay bildirimi bekleyen Çalıştırma aşamasına abone olarak Azure Pipelines portalına gitmeden, kanalınızın içinden dağıtımları onaylayabilirsiniz. bu aboneliklerin her ikisi de işlem hattına abone olduğunuzda varsayılan olarak oluşturulur.

Ready for approval

Bir aşamanın çalışması onay için beklemede olduğunda, isteği onaylama veya reddetme seçeneklerini içeren bir bildirim kartı kanala gönderilir. Onaylayanlar bildirimdeki isteğin ayrıntılarını gözden geçirebilir ve uygun eylemi gerçekleştirebilir. Aşağıdaki örnekte dağıtım onaylandı ve onay durumu kartta görüntüleniyor.

Screenshot showing approved notification.

Uygulama, Azure Pipelines portalında tek onaylayan, birden çok onaylayan (tek bir kullanıcı, herhangi bir sipariş, sıralı) ve onaylayan ekipler gibi tüm denetim ve onay senaryolarını destekler. İstekleri bir kişi olarak veya ekip adına onaylayabilirsiniz.

İşlem hattı URL'lerinin önizlemeleri

Kullanıcı işlem hattı URL'sini yapıştırdığında, aşağıdaki görüntüde gösterilene benzer bir önizleme gösterilir. Bu işlem hattıyla ilgili konuşmaların ilgili ve doğru tutulmasına yardımcı olur.

Build URL unfurling.

Release URL unfurling.

Bu özelliğin çalışması için kullanıcıların oturum açmış olması gerekir. Oturum açtıktan sonra bu özellik çalışma alanında tüm kanallarda çalışır.

Kanaldan abonelikleri ve işlem hatlarını kaldırma

Kanalınızı temizlemek istiyorsanız, projedeki tüm işlem hatlarının aboneliğini kaldırmak için aşağıdaki komutları kullanın.

/azpipelines unsubscribe all [project url]

Örneğin:

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

Bu komut, projedeki herhangi bir işlem hattıyla ilgili tüm abonelikleri siler ve işlem hatlarını kanaldan kaldırır.

Önemli

Bu komutu yalnızca proje yöneticileri çalıştırabilir.

Komut başvurusu

Azure Pipelines uygulaması tarafından desteklenen tüm komutlar şunlardır:

Slash 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 kanallardaki 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. Bunu gönderdiğinizde, bildirimlerinizi genel bir kanalda yaptığınız gibi ayarlayabilir ve yönetebilirsiniz.

Not

  • 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ğrulama' ilkesi uygulanmış dağıtım onayları desteklenmez
  • Azure DevOps'ta kuruluşun bildirimlerini 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.

Ne yazık ki bir sorun oluştu. Lütfen tekrar deneyin.

Azure Pipelines 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İlkeler'e>> gidin ve kuruluş için OAuth aracılığıyla üçüncü taraf uygulama erişiminiAçık olarak ayarlayın.

Enable the Third-party application access via OAuth for the organization setting

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

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

In private veya gizli tarayıcı penceresini açın ve adresine gidin https://aex.dev.azure.com/me ve oturum açın. Soldaki profil simgesinin altındaki açılan listede, abone olmak istediğiniz işlem hattını içeren kuruluşu içeren dizini seçin.

Select the directory that contains the organization that contains the pipeline

Aynı tarayıcıda yeni bir sekme başlatın, adresine gidin https://slack.comve çalışma alanınızda oturum açın (web istemcisini kullanın). /azpipelines signout komutunu ve ardından /azpipelines signin komutunu çalıştırın.

Düğmeyi Sign in 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.

Consent to the requested app permissions

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