[ 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)¶
Kunjungi halaman Gerrit OpenStack <https://review.opendev.org> _ dan klik tautan sign in
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¶
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.
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.
Dalam Gerrit's settings klik tautan New Contributor Agreement dan tandatangani perjanjian.
Majikan dengan hak penandatanganan yang sesuai dari perusahaan atau organisasi perlu menandatangani Corporate Contributor License Agreement.
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¶
Paste the public key into the New SSH Key text box.
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.
