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

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 (ICLA)

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/3.png

Kontributor Dari Perusahaan atau Organisasi

If you are contributing on behalf of a company or organization, please make sure that you sign the ICLA AND also get added to the list of contributors on your company's Corporate Contributor License Agreement (CCLA). You will need to complete both of these steps before being able to contribute.

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

    ../_images/3.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.

Seseorang yang berwenang perlu menandatangani U.S. Government Contributor License Agreement. Contact the Open Infrastructure 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

Catatan

This guide recommends using ed25519 keys because it has been found that this type works well across all operating systems.

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 ed25519 -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_ed25519): [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 ed25519 -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_ed25519): /Users/you/.ssh/id_openstack_ed25519

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_ed25519

Salin Kunci Publik

Mac OS & Linux

Dari jenis terminal Anda

cat ~/.ssh/id_ed25519.pub

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

cat ~/.ssh/id_openstack_ed25519.pub

Select and copy the output.

Impor Kunci Publik Ke Gerrit

  1. Go to Gerrit's SSH Keys section in User Settings.

  2. Paste the public key into the New SSH Key text box.

  3. Click the 'ADD NEW SSH KEY' button.

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

For distributions like RedHat, Fedora or CentOS open a terminal and type:

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

Git review only needs to be initialized once in a repository.