Hubungkan GitLab ke Notion
GitLab membantu tim mengelola kode, berkolaborasi mengembangkan software, dan melacak rilis. Sinkronkan proyek, issue, merge request, pipeline, dan rilis GitLab ke Notion agar kerja dev selaras dengan rencana & dokumen tim.
Kami mengganti sinkronisasi GitLab terkelola yang ada dengan sinkronisasi khusus yang didukung oleh Notion Workers. Anda dapat menyesuaikan data apa yang disinkronkan dan bagaimana data tersebut diatur di Notion. Data Anda yang sudah disinkronkan tetap ada di Notion; ikuti panduan ini untuk menyiapkan penggantinya. Pelajari lebih lanjut tentang Notion Workers →
Sinkronisasi GitLab yang ada akan berhenti berfungsi pada 30 Oktober 2026. Sinkronisasi tersebut akan tetap berfungsi seperti biasa hingga saat itu, tetapi tidak akan berpindah dengan sendirinya. Kami menyarankan untuk menyiapkan sinkronisasi pengganti Anda sebelum tanggal tersebut.
Workers menjalankan sinkronisasi Anda di infrastruktur Notion. Untuk menyiapkan pengganti Anda, @-sebutkan database tersinkronisasi Anda yang ada dalam obrolan dengan Notion AI dan sertakan skill sinkronisasi GitLab.
Siapkan hal-hal berikut:
Database tersinkronisasi GitLab Anda yang ada di Notion. Pastikan Notion AI dapat mengaksesnya.
Daftar lengkap proyek GitLab yang akan disertakan. Anda dapat memberikan URL proyek, ID numerik, atau jalur seperti my-team/my-project. Pelajari cara melihat proyek di GitLab →
Token akses pribadi atau proyek GitLab dengan read_api dan akses ke setiap proyek yang dipilih.
Akses ke Workers dan alat yang diperlukan Notion AI untuk membuat dan menerapkan Worker di ruang kerja Anda.
Halaman skill ini, yang akan Anda salin ke akun Notion Anda: GitLab Guide: Worker Sync. Skill ini ditujukan untuk GitLab.com. Jika Anda menggunakan instans GitLab yang dikelola sendiri, beri tahu Notion AI sebelum penyiapan. Alamat API dan konfigurasi kredensial panduan tersebut memerlukan adaptasi dan validasi untuk instans Anda.
Catatan: Panduan ini membuat database pengganti. Database Anda yang ada tetap tersedia saat Anda memeriksanya. Tautan halaman, tampilan, relasi, dan informasi khusus Notion-nya tidak berpindah secara otomatis.
Buka obrolan dengan Notion AI di ruang kerja yang berisi database tersinkronisasi Anda saat ini.
Salin perintah di bawah ini. Ganti @Existing GitLab sync database dengan mengetik @ dan memilih database yang sebenarnya dari menu sebutan. Jika masalah dan permintaan penggabungan berada di database tersinkronisasi yang terpisah, sebutkan keduanya.
Ganti sinkronisasi GitLab saya saat ini, @Existing GitLab sync database, dengan Worker menggunakan GitLab Guide: Worker Sync.
Periksa database yang ada dan konfirmasikan daftar proyek GitLab yang lengkap dengan saya. Ikuti skill tersebut untuk membuat sinkronisasi per jam, lima database terkait, tampilan, dan dasbor di bawah halaman GitLab Sync pribadi. Jika Worker pengganti sudah ada, periksa dan gunakan kembali jika sesuai.
Biarkan database saya yang ada tetap utuh. Identifikasi properti kustom, nilai khusus Notion, tampilan, relasi, dan tautan yang memerlukan penanganan terpisah. Minta token GitLab saya melalui input kredensial yang aman, bukan di obrolan.
Pratinjau setiap proyek dan jenis data yang dipilih, selesaikan sinkronisasi pertama, dan periksa catatan serta relasi proyek. Tunjukkan kepada saya database pengganti, perbedaan apa pun, dan langkah-langkah untuk beralih sebelum mengubah sinkronisasi lama.
Pilih sebutan database yang sebenarnya di dalam perintah. Mengetik nama database saja tidak memberikan tautan kepada Notion AI untuk diperiksa.
Konfirmasikan daftar proyek yang lengkap, termasuk proyek yang disembunyikan oleh filter tampilan Notion Anda saat ini. Token yang dibatasi untuk satu proyek tidak akan cukup untuk sinkronisasi yang juga memerlukan akses ke proyek lain.
Ikuti Instruksi Notion AI untuk memberikan token GitLab Anda melalui input kredensial yang aman. Token tersebut memerlukan read_api dan akses ke proyek yang dipilih.
Jangan tempel token ke dalam obrolan, halaman Notion, atau properti database. Worker menggunakan kredensial yang diperantarai sehingga kodenya tidak perlu membaca token mentah.
Pengaturan ini menggunakan kredensial Worker baru. Koneksi GitLab Anda yang sudah ada tidak menyediakannya secara otomatis.
Jika Notion AI tidak dapat mengakses skill atau alat Worker, selesaikan akses tersebut terlebih dahulu. Panduan yang ditautkan juga berisi instruksi pengaturan bagi seseorang di tim Anda yang dapat menggunakan Notion CLI.
Skill ini membuat halaman GitLab Sync pribadi yang berisi lima database yang disinkronkan dan sebuah dasbor:
Database | Apa saja yang disertakan |
|---|---|
GitLab Projects | Nama proyek, jalur, deskripsi, status arsip, visibilitas, cabang default, tautan, dan tanggal aktivitas. |
GitLab Issues | Masalah di seluruh status, dengan penanggung jawab, label, tonggak pencapaian, tingkat keparahan, tanggal jatuh tempo, dan relasi proyek. |
GitLab Merge Requests | Merge requests di seluruh status, dengan status draf, penulis, penanggung jawab, cabang, status merge, dan relasi proyek. |
GitLab Pipelines | Status pipeline, referensi, sumber, tanggal, tautan, dan relasi proyek. |
GitLab Releases | Nama rilis, tag, deskripsi, tanggal rilis, tautan, dan relasi proyek. |
GitLab Dashboard menyatukan catatan-catatan ini dalam bagan dan antrean kerja. Ini mencakup issue terbuka, merge request terbuka, pipeline yang gagal, rilis terbaru, dan aktivitas proyek.
Kelima database yang disinkronkan tersebut berisi catatan-catatan itu. Dasbor menampilkan tampilan catatan-catatan tersebut. Database Issues atau Merge Requests lama Anda mungkin mencakup lebih sedikit jenis data daripada pengaturan default skill ini.
Periksa perbedaan-perbedaan ini sebelum beralih:
Orang dan label: Penulis, penanggung jawab, dan label disimpan sebagai teks dalam panduan ini. Mereka bukan properti orang atau multi-pilih Notion.
Relasi proyek: Masalah, permintaan penggabungan, pipeline, dan rilis harus ditautkan ke catatan proyek yang dipilih.
Identitas catatan: Catatan dari proyek yang berbeda harus tetap berbeda meskipun menggunakan nomor masalah atau permintaan penggabungan lokal proyek yang sama.
Konten tambahan: Panduan ini tidak menyinkronkan komentar masalah, diskusi permintaan penggabungan, file repositori, atau log pekerjaan. Minta Notion AI untuk menilai bidang tambahan apa pun yang dibutuhkan alur kerja Anda saat ini.
Tunggu hingga Notion AI mengonfirmasi bahwa kelima sinkronisasi dalam kondisi sehat dan impor awal telah selesai.
Bandingkan setiap proyek yang dipilih dengan GitLab. Periksa sampel masalah terbuka dan tertutup, permintaan penggabungan, pipeline, dan rilis.
Konfirmasikan bahwa relasi proyek dan tampilan dasbor menunjukkan catatan yang diharapkan.
Periksa apakah perubahan GitLab terbaru mencapai pengganti setelah penyegaran yang berhasil.
Tinjau properti kustom database lama dan nilai khusus Notion dengan Notion AI. Transfer apa yang Anda butuhkan menggunakan ID catatan GitLab yang stabil.
Perbarui tautan, tampilan database tertaut, relasi, dan otomatisasi yang harus menggunakan pengganti. Tinjau izin berbagi halaman baru.
Setelah tim Anda menggunakan pengganti, minta Notion AI untuk membantu menghentikan sinkronisasi lama sambil tetap menyediakan database lama untuk referensi.
Anda tidak perlu Hapus database lama untuk menggunakan Worker. Simpan hingga Anda memastikan bahwa informasi dan alur kerja tim Anda sudah diperhitungkan.
Skill ini menyiapkan lima sinkronisasi per jam, satu untuk setiap jenis data. Proyek disinkronkan terlebih dahulu selama penyiapan agar database lain dapat menghubungkan catatan mereka ke proyek yang tepat.
Setiap penyegaran yang berhasil membaca semua halaman hasil untuk proyek yang dikonfigurasi dan memperbarui database Notion yang cocok. Worker terus berjalan saat Notion ditutup.
Pembaruan mengalir dari GitLab ke Notion. Buat perubahan pada nilai yang disinkronkan di GitLab; perubahan di Notion tidak ditulis kembali.
Per jam adalah Jadwal, bukan jaminan bahwa setiap penyegaran selesai dalam waktu yang ditentukan. Riwayat proyek yang besar dan batas permintaan GitLab dapat menunda penyelesaian.
Tip: Pertahankan daftar proyek yang lengkap. Sinkronisasi ini menggunakan mode ganti: catatan yang hilang dari penyegaran yang selesai akan dihapus dari database yang disinkronkan. Menghapus proyek dari konfigurasi dapat menghapus catatan yang disinkronkannya, termasuk informasi khusus Notion pada halaman tersebut. Minta Notion AI untuk mempratinjau setiap proyek dan jenis data yang dipilih sebelum menerapkan perubahan.
Skill ini dimulai dengan halaman GitLab Sync pribadi. Bagikan hanya kepada orang-orang yang seharusnya melihat catatan yang diimpor.
Izin Notion mengontrol akses ke data yang disinkronkan. Properti Visibility proyek GitLab atau properti Confidential masalah tidak memberlakukan izin sumber tersebut di Notion. Tinjau data yang disertakan oleh token sebelum membagikan halaman.
Proyek tidak ditemukan
Konfirmasi daftar proyek lengkap dan akses token. Berikan URL atau ID numerik proyek kepada Notion AI jika jalurnya telah berubah. Jangan menjalankan penyegaran dengan daftar yang dipersingkat hanya untuk mengatasi kesalahan akses.
Masalah atau permintaan penggabungan tidak ditemukan
Minta Notion AI untuk memeriksa pemilihan proyek, apakah ia memeriksa masalah dan permintaan penggabungan di setiap status, dan setiap halaman hasil. Periksa juga filter tampilan Notion.
Dasbor kosong
Minta Notion AI untuk memeriksa database sumber, hasil sinkronisasi terbaru, dan relasi proyek sebelum membangun ulang dasbor. Dasbor bisa kosong saat impor awal masih berjalan.
Saya melihat database duplikat
Minta Notion AI untuk memeriksa Worker yang ada, URL database, dan struktur halaman sebelum membuat hal lain. skill ini memerlukan lima database yang disinkronkan secara aktual dan satu dasbor di bawah GitLab Sync. Minta Notion AI untuk mengidentifikasi duplikat apa pun sebelum menghapusnya.
Pembaruan telah berhenti
Minta Notion AI untuk memeriksa proses terbaru Worker, kedaluwarsa token, izin token, dan akses ke setiap proyek yang dipilih. Untuk instans yang dikelola sendiri, periksa juga host GitLab yang dikonfigurasi. Batas permintaan dapat menunda pembaruan.
