[ English | español (México) | 中文 (简体, 中国) | 한국어 (대한민국) | Deutsch | Indonesia | English (United Kingdom) ]

Menyiapkan Akun Gerrit Anda

Catatan

Bagian ini menganggap Anda telah menyelesaikan Siapkan dan Pelajari GIT guide.

Apa itu Gerrit?

Ini adalah sistem ulasan yang digunakan komunitas OpenStack.

Gerrit memungkinkan Anda meninjau:

Sign Up (mendaftar)

  1. Kunjungi halaman Gerrit OpenStack <https://review.opendev.org> _ dan klik tautan sign in

  2. Anda akan diminta untuk memilih nama pengguna. Anda dapat memasukkan yang sama dengan yang Anda lakukan untuk Launchpad, atau yang lainnya.

Catatan

Pilih dan ketikkan nama pengguna Anda dengan cermat. Setelah diatur, Anda tidak dapat mengubah nama pengguna.

Catatan

Mulai saat ini ketika Anda masuk ke Gerrit, Anda akan diminta untuk memasukkan info login Launchpad Anda. Ini karena Gerrit menggunakannya sebagai sistem masuk tunggal OpenID.

Individual Contributor License Agreement (perjanjian lisensi kontributor individu)

Apa itu?

Perjanjian untuk memperjelas hak kekayaan intelektual yang diberikan dengan kontribusi dari seseorang atau entitas. Preview the full agreement <https://review.opendev.org/static/cla.html> _.

Menandatanganinya

Kontributor Perorangan

  1. Dalam setelan <Gerps's <https://review.opendev.org/#/settings/agreements> _ klik tautan New Contributor Agreement dan tandatangani perjanjian. Anda memerlukan ini untuk berkontribusi kode & dokumentasi. Anda tidak akan bisa mendorong patch ke Gerrit tanpa ini.

../_images/32.png

Kontributor Dari Perusahaan atau Organisasi

Jika Anda berkontribusi atas nama perusahaan atau organisasi.

  1. Dalam Gerrit's settings klik tautan New Contributor Agreement dan tandatangani perjanjian.

    ../_images/32.png
  2. Majikan dengan hak penandatanganan yang sesuai dari perusahaan atau organisasi perlu menandatangani Corporate Contributor License Agreement.

  3. Jika CCLA hanya perlu diperpanjang, ikuti this prosedur.

Catatan

Pengusaha dapat memperbarui daftar karyawan resmi dengan mengisi dan menandatangani Updated Schedule A Form.

Kontributor Dari Pemerintah A.S.

  1. Seseorang yang berwenang harus menandatangani U.S. Government Contributor License Agreement. Hubungi OpenStack Foundation untuk memulai proses ini.

Atur Kunci SSH

Apakah mereka?

Untuk mendorong semuanya ke Gerrit <https://review.opendev.org> _ kita perlu memiliki cara untuk mengidentifikasi diri kita sendiri. Kami akan melakukan ini menggunakan kunci SSH yang memungkinkan kami untuk memiliki mesin kami, kami mendorong perubahan dari untuk melakukan challenge-response authentication <https://en.wikipedia.org/wiki/Challenge-response_authentication> _ dengan Server Gerrit.

Kunci SSH selalu dibuat berpasangan:

  • Private key - Hanya diketahui oleh Anda dan itu harus dijaga dengan aman.

  • Public key - Dapat dibagikan secara bebas dengan server SSH yang ingin Anda sambungkan.

Singkatnya, Anda akan membuat pasangan kunci SSH, dan memberikan server kunci Gerrit kepada Anda. Dengan sistem Anda yang memegang kunci privat, tidak akan ada masalah untuk membalas Gerrit selama otentikasi challenge-response.

Beberapa orang memilih untuk menggunakan satu pasangan kunci SSH untuk mengakses banyak sistem sementara yang lain lebih suka menggunakan pasangan kunci yang terpisah. Kedua opsi dibahas di bagian berikut.

Periksa Untuk Kunci Yang Ada

Buka program terminal Anda dan ketik

ls -la ~/.ssh

Biasanya nama file kunci publik akan terlihat seperti:

  • id_dsa.pub

  • id_ecdsa.pub

  • id_ed25519.pub

  • id_rsa.pub

Jika Anda tidak melihat file ekstensi .pub atau ingin membuat kumpulan spesifik untuk OpenStack Gerrit, Anda perlu membuat kunci.

Hasilkan (generate) Pasangan Kunci SSH

Generating The Default Or Initial SSH Key Pair (Pasangan Kunci SSH Atau Awal atau Default)

Anda dapat membuat pasangan kunci SSH baru menggunakan email yang disediakan sebagai label dengan masuk ke program terminal Anda dan mengetik

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Saat Anda diminta untuk "Enter a file in which to save the key" tekan Enter. Ini menerima lokasi default

Enter a file in which to save the key (/Users/you/.ssh/id_rsa): [Press enter]

Saat diminta, ketik frasa sandi yang aman, Anda dapat memasukkan satu atau tekan Enter untuk tidak memiliki frasa sandi

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

Membuat Pasangan Kunci Terpisah Untuk OpenStack Gerrit (opsional)

Anda dapat membuat kunci SSH baru menggunakan email yang disediakan sebagai label dengan masuk ke program terminal Anda dan mengetik

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Saat Anda diminta untuk "Enter a file in which to save the key" Anda harus menentukan nama pasangan kunci baru dan kemudian tekan Enter

Enter a file in which to save the key (/Users/you/.ssh/id_rsa): /Users/you/.ssh/id_openstack_rsa

Saat diminta, ketik frasa sandi yang aman, Anda dapat memasukkan satu atau tekan Enter untuk tidak memiliki frasa sandi

Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]

Terakhir, Anda perlu memberi tahu ssh host apa yang mengaitkan kunci SSH. Untuk melakukan ini buka "~/.ssh/config" di editor, buat file jika tidak ada dan tambahkan sesuatu seperti

Host review.opendev.org review
  Hostname review.opendev.org
  Port 29418
  User <your_gerrit_username>
  IdentityFile ~/.ssh/id_openstack_rsa

Salin Kunci Publik

Mac OS & Linux

Dari jenis terminal Anda

cat ~/.ssh/id_rsa.pub

Atau jika Anda membuat pasangan kunci terpisah, dengan asumsi nama contoh di atas

cat ~/.ssh/id_openstack_rsa.pub

Sorot dan salin hasilnya.

Impor Kunci Publik Ke Gerrit

  1. Pergi ke Gerrit's SSH Public Keys settings.

  2. Klik tombol 'Add Key'.

  3. Rekatkan (paste) kunci publik ke dalam kotak teks Add SSH Public Key dan klik Add.

Ulasan Git

Apa itu?

Ulasan Git adalah alat yang dikelola oleh komunitas OpenStack. Ia menambahkan sub-command tambahan ke 'git' seperti:

git review

Ketika Anda memiliki perubahan dalam repositori proyek OpenStack, Anda dapat menggunakan sub-perintah ini untuk membuat perubahan diposting ke Gerrit <https://review.opendev.org/> __ sehingga mereka dapat ditinjau.

Instalasi

Mac OS

Di terminal ketik:

pip install git-review

Jika Anda belum menginstal pip, ikuti installation documentation untuk pip.

Catatan

Pengguna Mac OS X El Capitan dan Mac OS Sierra mungkin melihat pesan kesalahan seperti "Operation not permitted" saat menginstal dengan perintah. Dalam hal ini, ada dua opsi untuk berhasil menginstal git-review.

Opsi 1: instal menggunakan pip dengan lebih banyak opsi

pip install --install-option '--install-data=/usr/local' git-review

Opsi 2: Gunakan manajer paket Homebrew <https://brew.sh> _, dan ketikkan di terminal

brew install git-review

Linux

Untuk distribusi seperti Debian, Ubuntu, atau Mint buka terminal dan ketik

sudo apt install git-review

Untuk distribusi seperti RedHat, Fedora 21 atau sebelumnya, atau CentOS buka terminal dan ketik

sudo yum install git-review

Untuk Fedora 22 atau lebih baru buka terminal dan ketik

sudo dnf install git-review

Untuk distribusi SUSE, buka terminal dan ketik

sudo zypper in python-git-review

Konfigurasi

Ulasan Git mengasumsikan pengguna yang Anda jalankan sama dengan nama pengguna Gerrit Anda. Jika tidak, Anda dapat mengetahuinya dengan mengatur pengaturan konfigurasi git ini

git config --global gitreview.username <username>

Jika Anda tidak tahu apa nama pengguna Gerrit Anda, Anda dapat memeriksa Gerrit settings.

Bersiap untuk Mengirim Ulasan

Sebelum melakukan git commit pada patch Anda, penting untuk menginisialisasi review git. Gunakan perintah berikut untuk melakukan konfigurasi git review awal di repositori Anda

git review -s

Perintah mengatur host jarak jauh yang diperlukan dan melakukan kait untuk memungkinkan mendorong perubahan ke Gerrit.

Catatan

Ulasan Git hanya perlu diinisialisasi satu kali dalam repositori.