Integrasi Asana untuk GitHub tersedia untuk semua pelanggan Asana Premium, Business, dan Enterprise. Integrasi ini tidak mendukung GitHub Enterprise Server.
Ikhtisar
Dengan integrasi Asana untuk GitHub, Anda dapat menyinkronkan pembaruan status permintaan perubahan GitHub dengan tugas Asana secara otomatis untuk meningkatkan kolaborasi lintas fungsi.
Integrasi ini membantu meningkatkan visibilitas dan transparansi seputar pekerjaan teknik antara tim teknis dan non - teknis. Dengan integrasi baru ini, pengembang dapat berkomunikasi dengan mudah melalui Asana untuk menjaga agar tim dan pemangku kepentingan lintas fungsi tetap mengetahui dan mencegah pekerjaan luput.
Instalasi untuk Tindakan Asana dan GitHub
Hubungkan Asana dan GitHub untuk menyinkronkan status pull request Anda. Untuk memanfaatkan integrasi, konfigurasi diatur di Asana dan untuk fitur tambahan, di dalam GitHub juga.
Cara mengonfigurasi di Asana:
- Buka proyek Asana yang Anda ingin instal integrasi Asana untuk GitHub. Klik tombol Sesuaikan di sudut kanan atas.
- Gulir ke bawah ke Aplikasi, lalu pilih + Tambahkan app
- Pilih GitHub
- Ikuti instruksi untuk memberi otorisasi pada akun GitHub Anda.
- Integrasi Asana untuk GitHub akan diinstal di level proyek.
Selamat, kini Anda dapat menghubungkan permintaan perubahan GitHub dengan tugas Asana. Jika Anda ingin mengaktifkan fungsi tambahan dengan integrasi, silakan tinjau bagian berikutnya. Jika tidak, harap lewati ke fungsionalitas Kunci di bawah ini.
Cara mengonfigurasi Tindakan GitHub:
Bagian ini mengasumsikan keakraban dasar dengan rahasia repositori git dan GitHub. Jika Anda tidak memiliki akses untuk mengatur rahasia repositori, silakan hubungi pemilik repositori.
Kami mendukung dua jenis Tindakan GitHub:
- Otomatiskan pemberitahuan permintaan perubahan GitHub di Asana: Tindakan ini mengomentari status permintaan perubahan pada tugas Asana. Ini termasuk judul pull request dengan tautan ke tugas Asana terkait. Untuk mengatur ini, kunjungi halaman GitHub Action.
- Sambungkan lampiran permintaan perubahan dari deskripsi permintaan perubahan GitHub dengan Asana: Tindakan ini secara otomatis menghubungkan permintaan perubahan GitHub dengan tugas Asana, dengan menambahkan url tugas Asana ke deskripsi permintaan perubahan. Untuk mengatur ini, kunjungi halaman GitHub Action.
Mirip dengan Tindakan GitHub lainnya, tindakan tersebut hanya akan berjalan ketika suatu peristiwa terjadi di repositori yang telah Anda siapkan tindakannya. Contoh, Anda dapat menyiapkan tindakan untuk dijalankan setiap kali seseorang menggabungkan atau mengomentari permintaan penarikan.
Setiap Tindakan GitHub ini harus disiapkan secara individual, kecuali ada beberapa tindakan identik di repositori yang sama. Misalnya, Anda dapat menyiapkan tindakan untuk mengomentari tugas dalam deskripsi permintaan tarik saat tes selesai dan tindakan lain untuk menambahkan komentar yang berbeda ke tugas saat permintaan tarik digabungkan.
Tindakan GitHub juga dapat ditambahkan sebagai bagian dari alur kerja yang ada. Lihat panduan sumber daya Tindakan GitHub untuk mempelajari selengkapnya.
Mencabut token rahasia
Jika Anda menyiapkan Tindakan Github di bagian sebelumnya, Anda dapat mencabut token rahasia. Kunjungi halaman pengaturan ini, dan pilih Cabut semua.
Ini akan mencabut semua token rahasia GitHub Actions yang ada.
Anda masih akan dapat melihat informasi permintaan penarikan di proyek Asana yang ada tempat Anda telah menambahkan integrasi ini.
Fungsi utama
Cara melampirkan pull request ke tugas Asana (di Asana):
Setelah menginstal integrasi GitHub di Asana, Anda akan dapat melihat bidang GitHub di setiap tugas di proyek terkait.
Untuk melampirkan pull request ke tugas Asana, ambil URL pull request dan tempelkan di bidang GitHub yang kosong. Widget dengan detail berikut sekarang akan muncul di tugas Asana: Tinjau status, status Build, status PR, perubahan Baris, dan jumlah percakapan di dalam GitHub.
Cara melampirkan pull request ke tugas Asana (di GitHub):
Setelah menginstal integrasi GitHub di Asana dan mengatur GitHub Actions, Anda sekarang dapat secara otomatis melampirkan pull request ke tugas Asana dari deskripsi pull request GitHub.
Di deskripsi permintaan tarik GitHub Anda, ambil URL tugas Asana dan tempelkan ke deskripsi. Widget dengan detail berikut akan muncul saat melihat tugas di Asana: Tinjau status, status Build, status PR, dan perubahan Baris.
Kesalahan apa pun harus terlihat di tab Tindakan GitHub di dalam GitHub.
Cara menerima penggabungan permintaan perubahan dan penutupan pembaruan:
Permintaan penarikan dapat ditutup di GitHub setelah tim yang sesuai meninjau dan menggabungkan perubahan. Status di widget Asana akan diperbarui secara otomatis.
Jika ingin melampirkan permintaan tarik GitHub baru, Anda dapat menambahkan URL tugas Asana ke deskripsi permintaan tarik GitHub baru dan widget akan otomatis diganti atau Anda dapat menghapus permintaan tarik tertutup di Asana dengan mengeklik menu di kanan atas. Setelah dihapus, Anda dapat memasukkan url permintaan perubahan GitHub yang baru.
Setelah menginstal integrasi GitHub di Asana dan mengatur GitHub Actions, Anda sekarang akan menerima komentar tentang tugas Asana dengan permintaan tarik terbuka terlampir. Ini akan mencakup pembaruan apakah permintaan penarikan telah digabungkan atau ditutup.
Pertanyaan Umum
Dapatkah rahasia yang dihasilkan sama digunakan di beberapa repositori?
Ya
Dapatkah rekan tim saya melihat informasi tentang pull request yang saya lampirkan pada tugas Asana, meskipun mereka tidak memiliki akses ke pull request?
Ya. Saat Anda melampirkan permintaan tarik ke tugas, semua orang yang dapat melihat tugas tersebut dapat melihat informasi di widget.
Apakah membuat token baru menonaktifkan token rahasia lama saya?
Tidak, token rahasia lama Anda masih akan berfungsi. Jika ingin menonaktifkan token rahasia yang ada, Anda dapat melakukannya di sini.
Dapatkah rahasia yang dihasilkan sama digunakan di beberapa repositori?
Ya
Saat mencoba mendorong file alur kerja, git mengatakan bahwa token saya tidak memiliki akses untuk membuat alur kerja. Apa yang harus saya lakukan?
Jika Anda menggunakan autentikasi dua faktor dan berinteraksi dengan GitHub di baris perintah, GitHub mengharuskan Anda menggunakan token akses pribadi Anda sebagai kata sandi. Harap buat token akses pribadi GitHub baru dengan ruang lingkup alur kerja.
Mengapa kami meminta izin GitHub ini?
Kami hanya membaca dan menulis dari permintaan perubahan dalam integrasi ini. Izin di halaman autentikasi adalah izin yang paling membatasi yang dapat kami minta dari GitHub untuk mengakses permintaan penarikan.
Apa yang terjadi jika Tindakan GitHub melampirkan permintaan tarik ke tugas dalam proyek yang tidak mengaktifkan integrasi?
Lampiran yang menautkan ke pull request akan terlihat di bagian komentar tugas, tetapi widget yang menyinkronkan status pull request tidak akan muncul.
Suka dengan apa yang Anda lihat? Mulai dengan uji coba Asana 30 hari gratis sekarang. Coba gratis