GitLab adalah salah satu kontrol sumber terkemuka dan solusi CI/CD untuk tim pengiriman perangkat lunak modern. GitLab menyediakan serangkaian fitur yang komprehensif untuk merencanakan, membangun, dan mengirimkan proyek perangkat lunak Anda. GitLab biasanya berinteraksi dengan UI web atau API-nya. Tak satu pun dari opsi ini yang menarik bagi pengembang terminal-sentris. Untungnya GitLab juga memiliki CLI yang menyediakan akses langsung ke masalah Anda, menggabungkan permintaan, jalur pipa, dan sumber daya lainnya, tepat di samping kode Anda dan perintah shell lainnya. Artikel ini akan menunjukkan kepada Anda dasar-dasarnya.

Apa Itu Glab?

Glab GitLab CLI dimulai oleh Clement Sam sebagai proyek yang dipimpin komunitas. Sejak itu telah diadopsi oleh GitLab, menerima rilis resmi pertama yang dipimpin GitLab pada Desember 2022. Ke depan, itu akan terus dipertahankan oleh GitLab dan komunitas yang lebih luas sebagai alat sumber terbuka. Glab saat ini mendukung interaksi dengan yang berikut Fitur GitLab: IssuesMerge RequestsPipelinesReleases RepositoriesLabelsSnippets Anda dapat mengambil data yang ada dari akun GitLab Anda, membuat item baru, dan melakukan tindakan seperti memeriksa status pipeline dan menyetujui permintaan penggabungan. Anda dapat mengautentikasi ke beberapa instans GitLab secara bersamaan, termasuk GitLab.com dan server yang dihosting sendiri.

Memulai Dengan Glab

Sebelum mulai menggunakan Glab, buat token akses pribadi untuk akun GitLab Anda yang mencakup cakupan api dan write_repository. Glab akan menggunakan token ini untuk melakukan tindakan atas nama Anda. Klik ikon profil Anda di kanan atas UI GitLab, lalu pilih "Token Akses" dari menu di sebelah kiri. Beri nama token Anda dan pilih lingkup api dan write_repository dari daftar. Gulir ke bawah halaman dan klik tombol "Buat token akses pribadi". Nilai token akan ditampilkan – catat ini sekarang, karena Anda tidak akan dapat mengambilnya di masa mendatang. Selanjutnya, Anda perlu menginstal Glab. Anda dapat mengunduh binari bawaan untuk sistem Windows, macOS, dan Linux dari halaman Rilis GitLab proyek. Glab juga didistribusikan untuk beberapa manajer paket populer di semua sistem operasi yang didukung. Setelah Glab terinstal, Anda dapat mengautentikasi ke instans GitLab Anda dengan menjalankan perintah auth login. Ini akan memulai serangkaian petunjuk interaktif yang memungkinkan Anda memilih antara GitLab.com atau instance yang dihosting sendiri. Setelah memberikan detail instans, Anda akan dapat memasukkan token akses pribadi yang Anda buat sebelumnya. Selanjutnya Anda akan diminta untuk mengonfirmasi protokol default yang akan digunakan untuk operasi Git. Anda biasanya dapat menerima nilai yang dipilih secara otomatis. SSH lebih disukai tetapi beberapa lingkungan mungkin memerlukan Git melalui HTTPS. Prompt berikut menanyakan apakah Glab harus mengautentikasi operasi Git menggunakan token akses pribadi yang sama yang sebelumnya Anda berikan. Ini biasanya perilaku yang diinginkan. Terakhir, jika Anda menggunakan instans GitLab yang dihosting sendiri, Anda akan diminta untuk memilih antara protokol HTTP dan HTTPS untuk mengakses GitLab API. Pilih HTTPS kecuali jika Anda mengetahui bahwa instance Anda hanya mendukung HTTP. Di akhir urutan, Anda akan menerima pesan sukses "Login". Menjalankan status autentikasi akan mengeluarkan daftar semua titik akhir yang telah Anda konfigurasikan.

Menggunakan Glab

Glab dimaksudkan untuk dijalankan dari direktori kerja proyek Anda. Mulailah dengan cd-ing ke direktori yang berisi repositori Git. Perintah Glab sekarang akan secara otomatis memilih instance GitLab dan token autentikasi yang benar, berdasarkan Git remote default proyek. Model ini memungkinkan penggunaan proyek secara mulus dari beberapa instance GitLab. Anda dapat menjalankan perintah git dan glab saat bekerja, cukup dengan memasukkan direktori proyek. Anda dapat menggunakan Glab di luar proyek, namun, dengan menyetel variabel lingkungan GITLAB_TOKEN dan GITLAB_URI (atau GITLAB_HOST) di shell Anda, lalu menentukan flag --repo dengan perintah Anda untuk mengidentifikasi proyek target (dalam format OWNER/REPO). Ini memungkinkan Anda dengan mudah menggunakan Glab dalam skrip otomatis, misalnya.

Issues

Mendaftar masalah dalam proyek Anda dengan perintah daftar masalah: $ daftar masalah glab Menampilkan 3 masalah terbuka di ilmiont/ardeidae yang cocok dengan pencarian Anda (Halaman 1) #376 ilmiont/ardeidae #376 Input Konsol memungkinkan akses string input standar penuh sekitar 1 bulan yang lalu #374 ilmiont/ardeidae#374 Konstruksi dukungan dasar melalui pengujian unit gabungan sekitar 11 bulan yang lalu #373 ilmiont/ardeidae#373 v3.1.0 pengujian unit sekitar 11 bulan ago Gunakan -- bendera halaman untuk beralih ke halaman berikutnya di set hasil. 20 item ditampilkan per halaman secara default; ini dapat diubah dengan flag --per-page. Beberapa flag pemfilteran didukung. Perintah berikut mengambil semua masalah tertutup dengan label P1, yang berada di tonggak sejarah v3.1.0 dan ditugaskan kepada Anda: $ daftar masalah glab --mine --milestone v3.1.0 --label P1 --closed Run daftar masalah glab - -membantu mempelajari semua flag yang didukung. Dapatkan informasi mendetail tentang masalah tertentu dengan tampilan masalah: $ tampilan masalah glab 376 buka • dibuka oleh ilmiont sekitar 1 bulan yang lalu Input Konsol memungkinkan akses string input standar lengkap #376 php:// masukan 0 upvotes • 0 downvotes • 0 komentar Pencapaian: v3.1.0 Untuk mengambil komentar masalah, tambahkan tanda --comments ke perintah. Komentar akan diberi halaman, seperti perintah daftar masalah. Anda dapat membuka halaman UI web untuk masalah di browser default Anda: $ glab issue view 376 --web Catatan (komentar) dapat dibuat terhadap masalah dengan perintah note. Bendera -m menentukan teks Markdown untuk catatan: $ glab issue note 376 -m "Ini tidak lagi relevan" Close dan buka kembali masalah dengan perintah tutup dan buka kembali masing-masing: $ masalah glab tutup 376 $ masalah glab buka kembali 376 To buat masalah baru, jalankan perintah buat dan berikan bendera yang sesuai: $ masalah glab buat --title "New Issue" --description "Demo issue" --milestone "v3.1.0" Anda akan diminta untuk mengonfirmasi pembuatan masalah. Anda dapat melewati ini dengan menyetel flag -y atau --yes. Lebih banyak tanda yang didukung untuk menentukan semua properti masalah. Coba jalankan glab issue create --help untuk menjelajahi options.

Merge Requests

Interaksi permintaan penggabungan dasar mirip dengan interaksi untuk masalah. Gunakan daftar dan lihat perintah untuk mengambil detail permintaan penggabungan yang ada. Perintah setujui, tutup, dan gabung menerapkan tindakan masing-masing ke perintah permintaan MR: $ glab mr gabung 100 Merge menerima ID atau cabang sumber sebagai argumennya. Anda dapat menggabungkan MR untuk cabang-demo ke dalam cabang utama Anda menggunakan perintah berikut: $ glab mr menggabungkan cabang-demo Anda dapat melihat perubahan yang terkandung dalam MR dengan perintah diff: $ glab mr diff 100 Output diff berwarna akan ditampilkan di terminal Anda dalam format Git. Ini juga memungkinkan untuk checkout secara lokal dan beralih ke cabang sumber permintaan penggabungan, tanpa menjalankan perintah Git secara manual: $ glab mr checkout 100CI Pipelines Lihat hasil pipeline untuk proyek Anda dengan menjalankan ci list: $ glab ci list Menampilkan 3 pipeline di ilmiont/ardeidae (Halaman 1) (sukses) • #734 3.1.0-rc42 (sekitar 9 hari yang lalu) (sukses) • #733 master (sekitar 9 hari yang lalu) (sukses) • #732 Dbal-store -allow-upert (sekitar 9 hari yang lalu) Perintah view memberikan akses ke hasil pekerjaan untuk pipeline terbaru baik pada default atau speci cabang fic. Layar terminal baru akan menampilkan tahapan dalam pipeline: $ glab ci view $ glab ci view -b demo-branch Untuk memicu proses pipeline baru, jalankan perintah glab run: $ glab ci run Anda dapat menentukan cabang untuk sumber pipa dari: $ glab ci run -b demo-branch Ini juga memungkinkan untuk mengatur variabel CI untuk dijalankan: $ glab ci run --variables demo-var:demo-val,another-var:another-val Anda dapat mengakses pekerjaan log dengan menjalankan perintah ci trace dan menggunakan prompt interaktif untuk memilih pekerjaan target. Artefak juga tersedia: perintah ci artifact mengunduh artefak dari pipeline terbaru, baik untuk cabang default atau cabang tertentu yang diidentifikasi oleh flag -b.Nbsp Akhirnya, Glab menyertakan linter bawaan untuk .gitlab-ci.yml file di direktori kerja Anda. Hal ini memungkinkan Anda untuk dengan mudah memeriksa validitas pipeline Anda, tanpa menyalin dan menempelkan file ke UI web GitLab. $ glab ci lint Mendapatkan konten di .gitlab-ci.yml Memvalidasi... ✓ CI yml Valid!Permintaan API Sewenang-wenang Perintah Glab adalah pembungkus di sekitar titik akhir GitLab API yang ada. Sementara beberapa API didukung secara native, masih banyak lagi yang belum diimplementasikan sebagai perintah. Memanggil API secara langsung bisa membosankan karena Anda perlu menyediakan token akses pribadi Anda dengan menyetel header permintaan secara manual. Glab menyertakan perintah utilitas untuk membuat permintaan autentikasi arbitrer terhadap API. Perintah glab api menerima URI relatif untuk diminta dalam konteks instance GitLab aktif Anda. Contoh berikut mendapatkan tag Git yang terkait dengan proyek dengan ID 1: $ glab api projects/1/repository/tags Data respons API mentah akan dipancarkan ke terminal Anda dalam format JSON. Setel metode HTTP untuk permintaan menggunakan flag -X atau --method. Anda dapat menyediakan data isi permintaan dengan flag -F atau --field: $ glab api projects/1/repository/tags -X POST --field tag_name=demo --field ref=main Anda dapat menyertakan header permintaan khusus dengan menyetel -H atau --header flag.

Menggunakan Alias

Glab mendukung alias perintah khusus sehingga Anda dapat dengan cepat mengakses fungsionalitas yang umum digunakan. Buat alias baru dengan menjalankan perintah set alias: $ glab alias set issues "issue list" - Menambahkan alias untuk masalah: daftar masalah ✓ Menambahkan alias. Sekarang Anda dapat membuat daftar masalah dalam proyek Anda dengan menjalankan masalah glab: $ masalah glab Menampilkan 3 masalah terbuka di ilmiont/ardeidae yang cocok dengan pencarian Anda (Halaman 1) #376 ilmiont/ardeidae#376 Masukan Konsol memungkinkan mengakses string input standar lengkap sekitar 1 bulan yang lalu #374 ilmiont/ardeidae#374 Basis mendukung konstruksi melalui petunjuk tipe majemuk sekitar 11 bulan yang lalu #373 ilmiont/ardeidae#373 v3.1.0 pengujian unit sekitar 11 bulan ago Mencantumkan semua ali seperti yang Anda buat dengan daftar alias: $ glab alias list ci pipeline ci co mr checkout issues issue list Hapus alias dengan menjalankan alias delete dan berikan namanya: $ glab alias delete issuesMenggunakan Glab untuk Mengelola DevOps Glab adalah GitLab CLI resmi. Ini memungkinkan Anda mengelola seluruh proses DevOps dari terminal Anda. Anda dapat membuat masalah, menetapkan tugas, meninjau permintaan penggabungan, memicu pipeline CI, dan rilis tag, tanpa harus beralih antar alat atau mempelajari GitLab API. Ini mengurangi peralihan konteks dan memfasilitasi otomatisasi alur kerja Anda yang paling umum. Memiliki akses ke data GitLab bersama dengan kode Anda dan operasi Git membuat Anda tetap fokus pada tugas yang ada. CLI juga lebih cepat digunakan daripada UI web, jika Anda nyaman bekerja di terminal. Ini adalah antarmuka ketiga yang berharga untuk instans GitLab Anda, selain UI dan API. Meskipun artikel ini telah membahas dasar-dasar penggunaan Glab untuk tugas umum, masih banyak lagi yang dapat Anda jelajahi juga. Lihat dokumentasinya atau coba jalankan glab help dan glab --help untuk mengeksplorasi semua kemampuan yang tersedia. Sekarang Glab sepenuhnya digabungkan sebagai proyek GitLab asli, pengembangan lebih lanjut dijanjikan untuk mendukung alur kerja tambahan dan mengimplementasikan permintaan komunitas. Anda dapat memberikan umpan balik Anda ke GitLab dengan membuka masalah di repositori proyek. Disadur dari HowToGeek.com.