Menggunakan Azure Pipelines dengan Microsoft Teams

  • Artikel

Azure DevOps

Aplikasi Azure Pipelines untuk Microsoft Teams memungkinkan Anda memantau peristiwa untuk alur Anda. Anda dapat menyiapkan dan mendapatkan pemberitahuan di saluran Teams untuk rilis, persetujuan yang tertunda, build yang telah selesai, dan sebagainya. Anda juga dapat menyetujui rilis dari dalam saluran Teams Anda.

Catatan

Fitur ini hanya tersedia di Azure DevOps Services. Biasanya, fitur baru diperkenalkan di layanan cloud terlebih dahulu, dan kemudian tersedia secara lokal di versi utama berikutnya atau pembaruan Azure DevOps Server. Untuk mempelajari selengkapnya, lihat Garis Waktu Fitur Azure DevOps.

Prasyarat

  • Anda harus memiliki proyek Azure DevOps. Untuk informasi selengkapnya, lihat Membuat proyek.
  • Untuk menyiapkan langganan alur, Anda harus menjadi Administrator Proyek.

Menyiapkan aplikasi Azure Pipelines

  1. Di Microsoft Teams, buka penyimpanan Aplikasi, cari Azure Pipelines, lalu pilih Azure Pipelines.

    Cuplikan layar memilih tombol Aplikasi, lalu tombol Azure Pipelines.

  2. Pilih panah dropdown Buka , lalu pilih Tambahkan ke tim.

    Cuplikan layar memilih tombol Buka lalu Tambahkan ke tombol tim.

  3. Pilih atau masukkan nama tim Anda, lalu pilih Siapkan bot.

    Memilih tombol Siapkan bot.

  4. Di panel percakapan Teams, masukkan @azurePipelines signin.

  5. Pilih Masuk dan selesaikan autentikasi ke Azure Pipelines.

Menggunakan perintah

Gunakan perintah berikut untuk memantau semua alur dalam proyek atau hanya alur tertentu.

  • Pantau semua alur dalam proyek. URL dapat ke halaman mana pun dalam proyek Anda, kecuali URL ke alur. Contohnya,@azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]

  • Memantau alur tertentu: URL alur dapat ke halaman mana pun dalam alur Anda yang memiliki definitionId atau buildId/releaseId ada di URL. Contohnya,@azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]

    Contoh lain dari alur rilis yang berlangganan penyebaran Rilis dimulai, Penyebaran rilis selesai, dan Pemberitahuan persetujuan penyebaran rilis tertunda adalah @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Catatan

  • Kami tidak mendukung persetujuan penyebaran yang telah menerapkan Validasi ulang identitas pemberi persetujuan sebelum menyelesaikan kebijakan persetujuan .
  • Aktifkan 'Akses aplikasi pihak ketiga melalui OAuth' untuk menerima pemberitahuan untuk organisasi di Azure DevOps.

Kelola langganan

Saat Anda berlangganan alur, beberapa langganan dibuat secara default tanpa filter apa pun yang diterapkan. Anda mungkin ingin menyesuaikan langganan ini. Misalnya, Anda mungkin ingin mendapatkan pemberitahuan hanya saat build gagal atau saat penyebaran didorong ke lingkungan produksi. Aplikasi Azure Pipelines mendukung filter untuk menyesuaikan apa yang Anda lihat di saluran Anda. Untuk mengelola langganan Anda, selesaikan langkah-langkah berikut.

  1. Jalankan perintah @azure pipelines subscriptions.

  2. Pilih Tampilkan semua langganan. Dalam daftar langganan, jika ada langganan yang tidak Anda inginkan, pilih Hapus. Tampilan daftar langganan.

  3. Gulir ke bawah dan pilih Tambahkan langganan.

  4. Pilih alur dan peristiwa yang diperlukan.

  5. Pilih filter yang sesuai, lalu Simpan.

    Contoh 1: Dapatkan pemberitahuan untuk build yang gagal.

    Visual kegagalan build di Teams.

    Contoh 2: Dapatkan pemberitahuan hanya jika penyebaran didorong ke lingkungan produksi.

    Visual pemberitahuan kegagalan.

    Catatan

    • Administrator Tim tidak dapat menghapus atau mengubah langganan yang dibuat oleh Administrator Proyek.
    • Pemberitahuan tidak didukung di dalam pesan obrolan/langsung.

Menyetujui penyebaran dari saluran Anda

Anda dapat menyetujui penyebaran dari dalam saluran Anda tanpa masuk ke portal Azure Pipelines. Berlangganan pemberitahuan Persetujuan penyebaran rilis tertunda untuk Rilis klasik atau tahap Jalankan menunggu pemberitahuan persetujuan untuk alur YAML. Kedua langganan ini dibuat secara default saat Anda berlangganan alur.

Di Teams, perhatikan siap untuk disetujui.

Setiap kali eksekusi tahap tertunda untuk disetujui, kartu pemberitahuan dengan opsi untuk menyetujui atau menolak permintaan diposting di saluran. Pemberi persetujuan dapat meninjau detail permintaan dalam pemberitahuan dan mengambil tindakan yang sesuai. Dalam contoh berikut, penyebaran disetujui dan status persetujuan ditampilkan pada kartu.

Kartu memperlihatkan penyebaran yang disetujui.

Aplikasi Azure Pipelines mendukung semua skenario pemeriksaan dan persetujuan yang ada di portal Azure Pipelines. Anda dapat menyetujui permintaan sebagai individu atau untuk tim.

Cari dan bagikan informasi alur menggunakan ekstensi tulis

Untuk membantu pengguna mencari dan berbagi informasi tentang alur, aplikasi Azure Pipelines untuk Microsoft Teams mendukung ekstensi pembuatan. Sekarang Anda dapat mencari alur berdasarkan ID alur atau berdasarkan nama alur. Agar ekstensi tulis berfungsi, pengguna harus masuk ke proyek Azure Pipelines yang mereka minati baik dengan menjalankan @azure pipelines signin perintah atau dengan masuk ke ekstensi tulis secara langsung.

Buat ekstensi.

Pratinjau URL alur

Saat menambahkan URL alur ke Teams, Anda akan melihat pratinjau yang mirip dengan gambar berikut. Pratinjau ini membantu menjaga agar percakapan terkait alur tetap relevan dan terbaru. Anda dapat memilih antara kartu yang ringkas dan diperluas.

Contoh 1: Pratinjau URL Build

Membangun URL yang tidak berfungsi.

Contoh 2: Pratinjau URL Rilis

URL rilis tidak berfungsi.

Setelah Anda masuk, fitur ini berfungsi untuk semua saluran dalam tim di Microsoft Teams.

Berhenti berlangganan dari saluran alur

Gunakan perintah berikut untuk berhenti berlangganan dari semua alur dalam proyek.

@azure pipelines unsubscribe all [project url]

Contoh: Berhenti berlangganan semua dengan URL

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

Perintah ini menghapus semua langganan yang terkait dengan alur apa pun dalam proyek dan menghapus alur dari saluran.

Penting

Hanya Administrator Proyek yang dapat menjalankan perintah ini.

Semua pemberitahuan yang ditautkan ke eksekusi alur tertentu ditautkan bersama-sama.

Contoh 1: Tampilan ringkas pemberitahuan tertaut.

Utas ringkas

Contoh 2: Tampilan pemberitahuan tertaut yang diperluas.

Utas yang diperluas

Menggunakan perintah di aplikasi Azure Pipelines

Lihat perintah berikut yang didukung oleh aplikasi Azure Pipelines:

Perintah garis miring Fungsi
@azure alur berlangganan [url alur/ url proyek] Berlangganan ke alur atau semua alur dalam proyek untuk menerima pemberitahuan
@azure langganan alur Menambahkan atau menghapus langganan untuk saluran ini
@azure umpan balik alur Melaporkan masalah atau menyarankan fitur
@azure bantuan alur Mendapatkan bantuan pada perintah garis miring
@azure masuk alur Masuk ke akun Azure Pipelines Anda
@azure signout alur Keluar dari akun Azure Pipelines Anda
@azure alur berhenti berlangganan semua [url proyek] Menghapus semua alur (milik proyek) dan langganan terkait dari saluran

Koneksi multi-penyewa

Jika Anda menggunakan email atau penyewa lain untuk Microsoft Teams dan Azure DevOps, lakukan langkah-langkah berikut untuk masuk dan menyambungkan berdasarkan kasus penggunaan Anda.

Gunakan huruf besar ID email & penyewa di Microsoft Teams ID Email & penyewa di Azure DevOps Tindakan masuk
1 email1@abc.com (penyewa 1) email1@abc.com (penyewa 1) Pilih Masuk
2 email1@abc.com (penyewa 1) email2@pqr.com (penyewa 2) - Masuk ke Azure DevOps.
- Di browser yang sama, mulai tab baru dan buka https://teams.microsoft.com/.
- Jalankan sign in perintah dan pilih Masuk.
3 email1@abc.com (penyewa 1) email2@pqr.com (penyewa 2) - Pilih Masuk dengan alamat email yang berbeda.
- Di pemilih ID email, gunakan email2 untuk masuk.
4 email1@abc.com (penyewa 1) email2@pqr.com (penyewa non-default 3) Saat ini tidak didukung.

Pecahkan masalah

Di browser yang sama, mulai tab baru dan masuk ke https://teams.microsoft.com/. Jalankan @Azure Pipelines signout perintah lalu jalankan @Azure Pipelines signin perintah di saluran tempat aplikasi Azure Pipelines untuk Microsoft Teams diinstal.

Pilih tombol Sign in dan Anda akan diarahkan ke halaman persetujuan seperti yang ada dalam contoh berikut. Pastikan bahwa direktori yang ditampilkan di samping email sama dengan yang Anda pilih di langkah sebelumnya. Terima dan selesaikan proses masuk.

Persetujuan untuk izin aplikasi yang diminta

Jika langkah-langkah ini tidak mengatasi masalah autentikasi Anda, hubungi kami di Komunitas Pengembang.