Menangani masalah dan permintaan pull

Halaman ini menjelaskan cara menggunakan masalah dan permintaan pull di antarmuka web Secure Source Manager.

Untuk mengakses instance Secure Source Manager melalui antarmuka web-nya, salin URL berikut ke kolom URL browser Anda.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Ganti kode berikut:

  • INSTANCE_ID dengan nama instance.
  • PROJECT_NUMBER dengan nomor project Google Cloud instance. Untuk mengetahui informasi tentang cara mengidentifikasi project, lihat Mengidentifikasi project.
  • LOCATION dengan region instance.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan masalah dan pull request, minta administrator untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi tentang cara memberikan peran Secure Source Manager, lihat Kontrol akses dengan IAM dan Memberi pengguna akses instance.

Melihat permintaan pull

Anda dapat melihat semua permintaan pull yang dapat Anda akses, atau permintaan pull untuk repositori tertentu.

Repositori kosong tidak memiliki tab Pull requests. Setelah melakukan push ke repositori, Anda dapat melihat tab permintaan pull.

Untuk melihat permintaan pull atau masalah yang ditetapkan kepada Anda, buka tab Secure Source Manager Issues atau Pull requests, lalu klik Assigned to me.

Untuk melihat permintaan pull untuk repositori:

  1. Di antarmuka web Secure Source Manager, pilih repositori Anda.
  2. Dari halaman repositori Anda, klik tab Pull requests.
  3. Anda dapat memfilter atau mengurutkan permintaan pull menggunakan menu drop-down untuk Penerima tugas, Jenis, atau Urutkan.

Untuk melihat semua permintaan pull:

  1. Di antarmuka web Secure Source Manager, klik tab Pull requests.

  2. Anda dapat memfilter atau mengurutkan pull request menggunakan menu drop-down untuk Penerima Tugas, Jenis, atau Urutkan.

Membuat permintaan pull

  1. Di antarmuka web Secure Source Manager, pilih repositori yang ingin Anda buatkan permintaan pull.
  2. Dari halaman repositori, klik tab Pull requests.
  3. Klik New pull request.
  4. Di menu merge into, pilih cabang yang ingin Anda gabungkan permintaan tarikannya.
  5. Di menu pull dari, pilih cabang yang akan ditarik.
  6. Klik New pull request.
  7. Beri judul dan deskripsi permintaan pull, lalu lampirkan file yang relevan.

  8. Klik Create pull request.

    Anda akan diarahkan ke halaman permintaan pull tempat Anda dapat menambahkan peninjau, label, tonggak pencapaian, dan penerima tugas.

Mengedit detail permintaan pull

Anda dapat menambahkan Peninjau, Label, Tonggak pencapaian, Penerima tugas, dan Tanggal jatuh tempo ke permintaan pull.

Untuk menambahkan Peninjau, Label, Tonggak Pencapaian, Penerima Tugas:

Dari halaman permintaan pull, klik ikon roda gigi ikon roda gigi di samping detail yang ingin Anda edit.

Hasil edit akan otomatis disimpan.

Untuk memperbarui Batas waktu:

  1. Klik ikon kalender di bagian Batas waktu, lalu pilih tanggal.
  2. Klik ikon plus ikon plus untuk menyimpan tanggal jatuh tempo.

Meninjau permintaan pull

Peninjau dapat menambahkan komentar, meminta perubahan, dan menyetujui permintaan penarikan.

Untuk meninjau permintaan penarikan yang ditetapkan kepada Anda:

  1. Di antarmuka web Secure Source Manager, klik tab Pull requests.
  2. Klik Ditugaskan kepada Anda.

  3. Klik permintaan pull yang ingin Anda tinjau.

    Halaman Percakapan akan terbuka. Anda dapat melihat komentar apa pun yang diberikan oleh pembuat permintaan pull, atau peninjau lainnya.

  4. Untuk melihat dan mengomentari file yang diubah, klik tab File yang diubah. Anda dapat mengubah perilaku visibilitas ruang kosong, opsi tampilan, dan opsi perbedaan dengan mengklik menu drop-down Ruang kosong, Tampilan terpisah/Tampilan gabungan, dan opsi perbedaan.

  5. Untuk memberikan komentar, klik ikon plus di samping baris yang ingin Anda komentari.

  6. Klik Mulai peninjauan.

  7. Tulis komentar tambahan dengan mengklik ikon plus pada baris yang ingin Anda komentari, lalu klik Tambahkan komentar.

    Komentar mendukung penataan gaya dengan markdown.

  8. Untuk mengirim komentar, menyetujui permintaan pull, atau meminta perubahan, klik Tinjau.

  9. Berikan komentar untuk merangkum perubahan Anda atau biarkan ruang komentar kosong dan pilih dari opsi berikut:

    • Setujui: menyetujui perubahan.
    • Komentar: mengirim komentar tanpa menyetujui permintaan pull.

    • Minta perubahan: meminta perubahan pada permintaan pull.

Menggabungkan permintaan pull

  1. Dari halaman repositori, klik tab Pull requests.
  2. Pilih permintaan pull yang ingin Anda gabungkan.
  3. Jika tidak ada konflik, klik Gabungkan permintaan pull.

Lihat masalah

  1. Di antarmuka web Secure Source Manager, pilih repositori Anda.
  2. Dari halaman repositori Anda, klik tab Masalah.
  3. Anda dapat memfilter atau mengurutkan masalah menggunakan menu untuk Penerima Tugas, Jenis, atau Urutkan.

Membuat masalah

  1. Di antarmuka web Secure Source Manager, pilih repositori Anda.
  2. Dari halaman repositori, klik tab Masalah.
  3. Klik New Issue.
  4. Masukkan judul dan deskripsi Masalah, lalu klik Buat Masalah.

  5. Di halaman Detail masalah, Anda dapat menetapkan Label, Tonggak pencapaian, Penerima tugas, dan menentukan cabang, atau tag.

Menambahkan diagram dengan Mermaid

Secure Source Manager mendukung rendering diagram Mermaid dalam file Markdown (seperti README.md), deskripsi permintaan pull, masalah, dan komentar.

Untuk menambahkan diagram, gunakan blok kode yang dibatasi mermaid:

```mermaid
graph TD
    A[Write Markdown] --> B(Click Preview Tab)
    B --> C{Does it render?}
    C -- Yes --> D[Success]
    C -- No --> E[Check Syntax]
```

Klik tab Pratinjau di editor Markdown untuk memverifikasi bahwa diagram Anda dirender sebelum disimpan.

Jenis diagram yang didukung

Secure Source Manager mendukung jenis diagram Mermaid berikut:

  • Diagram alir: graph atau flowchart (mendukung TD, TB, LR, BT, RL)
  • Diagram urutan: sequenceDiagram
  • Diagram kelas: classDiagram
  • Diagram hubungan entitas: erDiagram
  • Diagram status: stateDiagram atau stateDiagram-v2
  • Diagram XY: xychart-beta atau xychart

Perilaku dan batasan rendering

  • Rendering statis: Diagram dirender sebagai gambar statis. Fitur interaktif (seperti callback click dan tooltip) serta skrip eksternal dinonaktifkan demi keamanan.
  • Adaptasi tema: Diagram otomatis beradaptasi dengan tema terang dan gelap.
  • Aksesibilitas: Diagram yang dirender menyertakan teks alternatif yang diisi dengan kode sumber diagram untuk pembaca layar.
  • Jenis diagram yang tidak didukung: Jenis diagram yang tidak didukung akan menampilkan pesan error dan tidak dirender. Diagram ini mencakup Gantt, Mindmap, Pie, Gitgraph, User Journey, Requirement, C4, Timeline, Sankey, dan Block. Untuk jenis diagram yang tidak didukung, render diagram secara lokal ke gambar (PNG atau SVG) dan sematkan menggunakan sintaksis gambar Markdown standar.

Langkah berikutnya