Panduan FreeBSD untuk Penggunaan Github GH CLI

GitHub adalah penyedia hosting kode, yang dapat digunakan untuk kontrol versi dan kolaborasi. Dengan Github, Anda dapat bekerja sama dalam satu tim atau dengan orang lain dalam proyek yang sama dengan lebih mudah. Selain itu, GitHub dapat menjadi repositori hosting Git yang menyediakan alat bagi pengembang untuk mengirimkan kode yang lebih baik menggunakan fitur baris perintah, masalah (diskusi berulir), permintaan penarikan, tinjauan kode, atau menggunakan pilihan aplikasi gratis dan berbayar di GitHub Marketplace.

Jika Anda sudah familier dengan perintah-perintah Git FreeBSD, sekarang saatnya beralih ke perintah-perintah CLI peramban web untuk melakukan berbagai tindakan pada repositori GitHub Anda. Dengan alat GitHub GH CLI yang baru, Anda dapat menjalankan banyak perintah tanpa meninggalkan antarmuka baris perintah.

GH CLI adalah produk Github yang merupakan alat baris perintah Github yang membawa permintaan penarikan, masalah, dan konsep GitHub lainnya ke terminal di samping tempat Anda bekerja dengan git dan kode Anda. GH akan mengurangi peralihan konteks, membantu Anda fokus, dan memungkinkan Anda membuat skrip dan alur kerja Anda sendiri dengan lebih mudah, cepat, dan efisien.

Panduan dalam artikel ini akan menjelaskan langkah-langkah untuk menginstal GitHub GH CLI pada server FreeBSD. GitHub CLI (GH) adalah alat fitur GitHub baris perintah. Alat ini membawa permintaan penarikan, masalah, dan konsep GitHub lainnya ke terminal di samping tempat Anda bekerja dengan git dan kode Anda.

Diagram Penggunaan Github CLI

1. Cara Install GH CLI

Siapa pun dapat memasang Github CLI, bahkan jika mereka baru mengenal sistem FreeBSD. Github menyediakan kemudahan pemasangan aplikasinya sendiri, yaitu "GH". Berikut cara memasang Github GH CLI di FreeBSD.

root@ns3:~ # cd /usr/ports/devel/gh
root@ns3:/usr/ports/devel/gh # make config
root@ns3:/usr/ports/devel/gh # make install clean

Setelah memasang GitHub CLI, Anda harus memeriksa versi GH CLI dengan perintah berikut.

root@ns3:~ # gh --version
gh version 2.39.1 (2024-01-30)
https://github.com/cli/cli/releases/tag/v2.39.1

2. Cara Autentikasi Github GH CLI

Github menawarkan 2 opsi Autentikasi Github GH CLI, yaitu:

HTTPS, and
SSH

Dalam artikel ini kami akan membahas keduanya, sehingga pembaca dapat memilih salah satu dari dua metode autentikasi tersebut.

a. Autentikasi HTTPS

Langkah selanjutnya, autentikasi akun Github Anda. Jalankan perintah "gh auth login" untuk mengautentikasi akun GitHub Anda. Perintah tersebut akan meminta Anda untuk memilih jenis akun, baik akun biasa atau akun korporat. Saya akan memilih akun normal.

root@ns3:~ # gh auth login
? What account do you want to log into? GitHub.com
? What is your preferred protocol for Git operations? HTTPS
? How would you like to authenticate GitHub CLI? Login with a web browser

! First copy your one-time code: 81D1-CEE8
Press Enter to open github.com in your browser...
! Failed opening a web browser at https://github.com/login/device
  exec: "xdg-open": executable file not found in $PATH - install xdg-utils from ports(8)
  Please try entering the URL in your browser manually
? Authentication complete.
- gh config set -h github.com git_protocol https
? Configured git protocol
! Authentication credentials saved in plain text
? Logged in as iwanse1977
root@ns3:~ #

Kemudian akan muncul tampilan metode autentikasi. Anda harus memilih metode autentikasi yang Anda inginkan. Anda dapat memilih untuk melakukan autentikasi menggunakan browser atau menggunakan token autentikasi GitHub. Dalam artikel ini, kami akan menggunakan metode browser.

Kemudian akan muncul kode autentikasi. Anda harus menyalin kode tersebut di peramban web, masuk ke akun Github, dan mengetik URL berikut "https://github.com/login/device". Perhatikan tulisan biru di atas dan gambar di bawah.

b. Cara Autentikasi Github CLI dengan SSH

Syarat utama untuk Autentikasi SSH adalah Anda harus memiliki kunci publik SSH, cara melakukannya mudah, Anda dapat membaca artikel kami sebelumnya tentang membuat kunci publik untuk Github.

Menyiapkan Github dengan FreeBSD Melalui SSH untuk mengunggah repositori dari komputer lokal

Setelah Anda memiliki kunci publik SSH, Anda dapat menjalankan perintah "gh auth login" di "Apa protokol pilihan Anda untuk operasi GIT?" Anda pilih SSH.

Jika Anda memilih metode autentikasi SSH, opsi berikut akan muncul:

How would you like to authenticate GitHub CLI? [Use arrows to move, type to filter]

> Login with a web browser

Paste an authentication token

Pilih salah satu dari dua opsi, misalnya Anda akan memilih "Tempel token autentikasi". Anda harus membuat token di akun Github Anda. Metodenya:

1. Click the settings menu

2. Click "Developer settings" at the bottom right of the "Public profile" menu.

3. Click the "Personal access token" menu

4. Click "Fine-grained tokens"

5. Click generate new token

6. After you have filled in all the columns, click "Generate token"

Setelah Anda mendapatkan token seperti yang ditunjukkan di atas, salin token ke terminal Putty Anda.

3. Cara Menggunakan Github GH CLI

Struktur perintah gh berbentuk pohon, sehingga memudahkan pengguna untuk mengingatnya. Perintah GH memiliki dua level perintah dasar. Level pertama hanya terdiri dari enam perintah yaitu config, repo, issue, pr, gist, credits.

Di bawah ini kami akan memberikan beberapa contoh penggunaan dasar perintah GH CLI Github.

a. Cara Logout dari Github CLI

root@ns3:~ # gh auth logout
? Logged out of github.com account 'jhondoe123'

b. Cara Update Github GH CLI

Perbarui Kredensial Autentikasi yang saat ini aktif.

root@ns3:~ # gh auth refresh --scopes write:org,read:public_key
! Using secure storage could break installed extensions
! First copy your one-time code: C568-2A66
Press Enter to open github.com in your browser...

c. Cara Melihat Status Github GH CLI

root@ns3:~ # gh auth status
github.com
  ? Logged in to github.com as iwanse1977 (/root/.config/gh/hosts.yml)
  ? Git operations for github.com configured to use ssh protocol.
  ? Token: gho_************************************
  ? Token scopes: gist, read:public_key, repo, write:org

d. Cara Cloning Repository

root@ns3:/tmp # gh repo clone https://github.com/unixwinbsd/Go-ReverseProxy-FreeBSD.git

e. Cara Membuat Repository

root@ns3:~ # gh repo create nodejs-webcrawler --public --source=/usr/local/etc/crawling/nodejs-webcrawler

f. Cara Menghapus Repository

Sebelum Anda menjalankan perintah hapus, jalankan terlebih dahulu perintah berikut.

root@ns3:~ # gh auth refresh -h github.com -s delete_repo
! Using secure storage could break installed extensions
! First copy your one-time code: A9C7-1BDD
Press Enter to open github.com in your browser...

Perhatikan tulisan berwarna biru, buka "Google Chrome" ketik perintah berikut "https://github.com/login/device". Anda masukkan kode berwarna biru tersebut pada tampilan Google Chrome akun GitHub Anda.

Setelah itu lanjutkan perintah delete repository.

root@ns3:~ # gh repo delete nodejs-webcrawler
? Type jhondoe123/nodejs-webcrawler to confirm deletion: jhondoe123/nodejs-webcrawler
? Deleted repository jhondoe123/nodejs-webcrawler

Github GH CLI merupakan utilitas hebat yang dibuat oleh pengembang Github. Utilitas ini sangat berguna bagi administrator sistem yang gemar bekerja di terminal shell.

Warnet Dapurnet

Internet Cafe