Latihan - Menambahkan lencana build

  • 7 menit

Penting bagi anggota tim untuk mengetahui status build. Cara mudah untuk menentukan status build secara cepat adalah dengan menambahkan lencana build ke file README.md di GitHub. Mari kita lihat tim untuk mengetahui cara melakukannya.

Andy sedang memilah-milah email di mejanya. Dia menjawab email ketiga yang terkait dengan status build untuk situs web Space Game .

Andy: Pasti ada cara untuk mengotomatiskan pesan status. Kita memiliki alur, jadi kita seharusnya bisa menempatkan status di sana. Mungkin Mara tahu bagaimana kita bisa melakukannya.

Andy menjumpai Mara yang sedang berbicara dengan Amita di ruang istirahat.

Andy: Hai, Amita. Boleh saya pinjam Mara sebentar?

Amita: Saya juga harus ikut rapat. Jadi pinjam saja.

Mara: Hai Andy. Ada apa?

Andy: Saya sangat menyukai perubahan yang telah kami buat pada alur build kami dengan menggunakan Azure Pipelines, dan Git adalah sistem kontrol versi yang bagus. Saya bertanya-tanya, apakah ada cara untuk memberi tahu orang-orang tentang status build?

Mara: Ya, sebenarnya ada. Kita bisa menggunakan lencana build.

Apa itu lencana build?

Lencana adalah bagian dari Microsoft Azure Pipelines. Lencana memiliki metode yang dapat Anda gunakan untuk menambahkan gambar SVG yang menunjukkan status build di repositori GitHub.

Sebagian besar repositori GitHub menyertakan file bernama README.md, yang merupakan file Markdown yang menyertakan detail dan dokumentasi penting tentang proyek. GitHub merender file ini di beranda proyek Anda.

Berikut ini contoh lencana build:

Screenshot of GitHub showing the build badge. The status shows that the most recent build succeeded.

Untuk latihan ini, Anda membuat lencana build Anda terlihat oleh semua orang. Ini mungkin bukan ide yang baik untuk proyek privat Anda, karena informasi build Anda akan tersedia untuk publik.

Untuk memeriksa apakah lencana build Anda terlihat:

  1. Di Azure DevOps, navigasikan ke organisasi Anda.

  2. Pilih Pengaturan organisasi dari pojok bawah.

  3. Di bawah Alur, pilih Pengaturan.

  4. Matikan Nonaktifkan akses anonim ke lencana.

    Screenshot Azure DevOps showing how to disable anonymous access to badges.

Anda perlu membuat perubahan serupa pada proyek Anda:

  1. Buka proyek Anda.
  2. Navigasikan ke Pengaturan proyek dari pojok bawah.
  3. Di bawah Alur, pilih Pengaturan.
  4. Matikan Nonaktifkan akses anonim ke lencana.

Menambahkan lencana build

Sampai saat ini, Anda membuat cabang Git secara lokal untuk membuat perubahan pada proyek Space Game. Anda juga dapat mengusulkan perubahan secara langsung melalui GitHub. Di bagian ini, Anda melakukannya untuk mengatur lencana status.

  1. Di Azure DevOps, di panel kiri, pilih Alur, lalu pilih alur Anda.

  2. Pilih elipsis (...) di kanan atas, lalu pilih Lencana status.

    Screenshot of Azure Pipelines showing the options menu to set the build badge.

  3. Di bawah Markdown Sampel, pilih tombol Salin untuk menyalin kode Markdown ke clipboard.

  4. Di GitHub, buka proyek Anda.

  5. Pastikan Anda berada di cabang main. Di area file, buka file README.md.

  6. Pilih Edit file ini (ikon pensil) untuk membuka file di editor.

  7. Di bagian atas halaman, tambahkan baris kosong, lalu tempel konten papan klip.

  8. Pilih tab Pratinjau untuk melihat perubahan yang Anda usulkan.

    GitHub merender file Markdown dan menunjukkan lencana build kepada Anda.

    Screenshot of GitHub showing a preview of the build badge.

Menerapkan perubahan Anda ke utama

Di bagian ini, Anda melakukan perubahan ke cabang main di GitHub.

  1. Pilih Terapkan perubahan.

  2. Di area Terapkan pesan, tentukan pesan penerapan, seperti "Tambahkan lencana build".

    Screenshot of GitHub showing the commit message.

  3. Biarkan opsi Terapkan langsung ke main cabang dipilih, lalu pilih Terapkan perubahan untuk menerapkan perubahan Anda ke main cabang.

    Lencana Anda ditampilkan di halaman README.md.

    Screenshot of the final build badge as it appears on the README page.

    Proses ini adalah cara yang lebih mendasar untuk menggabungkan kode ke dalam GitHub. Alih-alih melakukan penerapan secara langsung, Anda bisa membuat permintaan pull dengan perubahan Anda agar ditinjau orang lain.

    Dalam praktiknya, Anda akan beralih ke main cabang dan menarik perubahan terbaru dari GitHub saat berikutnya Anda perlu menambahkan fitur atau mengatasi bug.

Andy: Mara, Anda baru saja melakukan perubahan langsung ke main. Mengapa Anda tidak menggunakan alur yang Anda ajarkan kepada saya? Maksudnya, dengan cabang fitur.

Kita bisa melakukannya. Namun terkadang ketika orang hanya mengubah file README atau file dokumentasi lainnya, mereka menerapkan ke main saat itu juga. Selain itu, kita bisa memverifikasi pekerjaan bersama-sama sebelum menggabungkan perubahan.

Namun ini memunculkan poin yang bagus. Jika kita semua bisa menerapkan ke main kapan pun kita mau, kita bisa membiarkan masalah dalam kode masuk ke cabang main kita.

Andy: Saya ingin berbicara dengan Anda tentang hal itu.

Andy dan Mara melanjutkan percakapan ini sambil berjalan kembali ke ruangan mereka.