[ English | English (United Kingdom) | 中文 (简体, 中国) | Indonesia | 한국어 (대한민국) | español (México) | Deutsch ]
Einrichten Ihres Gerrit-Kontos¶
Bemerkung
In diesem Abschnitt wird davon ausgegangen, dass Sie die Anleitung Einrichten und Erlernen von GIT abgeschlossen haben.
Was ist Gerrit?¶
Dies ist das Bewertungssystem, das die OpenStack-Community verwendet.
Gerrit ermöglicht es Ihnen, die Daten zu überprüfen:
Registrieren¶
Besuchen Sie die Gerrit-Seite von OpenStack <https://review.opendev.org>`_ und klicken Sie auf den ** sign in ** Link.
Sie werden aufgefordert, einen Benutzernamen auszuwählen. Sie können den gleichen eingeben, den Sie für Launchpad gemacht haben, oder etwas anderes.
Bemerkung
Wählen und tippen Sie Ihren Benutzernamen sorgfältig ein. Sobald es einmal eingestellt ist, können Sie den Benutzernamen nicht mehr ändern.
Bemerkung
Von nun an, wenn Sie sich bei Gerrit anmelden, werden Sie aufgefordert, Ihre Launchpad-Login-Informationen einzugeben. Das liegt daran, dass Gerrit es als OpenID Single Sign On verwendet.
Individual Contributor License Agreement (ICLA)¶
Was ist es?¶
Eine Vereinbarung zur Klärung der Rechte an geistigem Eigentum, die mit Beiträgen einer natürlichen oder juristischen Person gewährt werden. Sehen Sie sich die vollständige Vereinbarung an.
Unterzeichnung¶
Individuelle Mitwirkende¶
Klicken Sie in Gerrits settings auf den Link Neue Beitragsvereinbarung und unterschreiben Sie die Vereinbarung. Sie benötigen dies, um Code und Dokumentation beizutragen. Ohne diese Funktion können Sie keine Patches an Gerrit senden.
Mitwirkende eines Unternehmens oder einer Organisation¶
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.
In Gerrits Einstellungen <https://review.opendev.org/#/settings/agreements>`_ klicken Sie auf die ** New Contributor Agreement ** Link und unterzeichnen Sie die Vereinbarung.
Ein Arbeitgeber mit den entsprechenden Zeichnungsrechten des Unternehmens oder der Organisation muss den Corporate Contributor License Agreement unterzeichnen.
Wenn die CCLA nur erweitert werden muss, folgen Sie dieser Prozedur.
Bemerkung
Arbeitgeber können die Liste der autorisierten Mitarbeiter aktualisieren, indem sie ein Updated Schedule A Form ausfüllen und unterschreiben.
Mitwirkende der US-Regierung¶
Someone of authority needs to sign the U.S. Government Contributor License Agreement. Contact the Open Infrastructure Foundation to initiate this process.
Einrichten von SSH-Schlüsseln¶
Was ist das?¶
Um Dinge auf Gerrit zu laden, brauchen wir einen Weg, um uns selbst zu identifizieren. Wir machen das mit SSH-Schlüssel, womit wir eine Challenge-Response Authentifizierung zum Gerrit-Server aufbauen können, um Änderungen hochladen zu können.
SSH-Schlüssel werden immer paarweise generiert:
Privater Schlüssel - Nur Ihnen bekannt und sollte sicher geschützt werden.
Öffentlicher Schlüssel - Kann frei mit jedem SSH-Server geteilt werden, mit dem Sie sich verbinden möchten.
Zusammenfassend lässt sich sagen, dass Sie ein SSH-Schlüsselpaar erzeugen und den Gerrit-Server mit Ihrem öffentlichen Schlüssel versorgen. Da Ihr System den privaten Schlüssel hält, wird es kein Problem haben, Gerrit während der Challenge-Response-Authentifizierung zu antworten.
Einige Leute entscheiden sich dafür, ein SSH-Schlüsselpaar für den Zugriff auf viele Systeme zu verwenden, während andere es vorziehen, separate Schlüsselpaare zu verwenden. Beide Optionen werden in den folgenden Abschnitten behandelt.
Auf vorhandene Schlüssel prüfen¶
Öffnen Sie Ihr Terminalprogramm und geben Sie ein:
ls -la ~/.ssh
Normalerweise sehen öffentliche Schlüsseldateinamen so aus:
id_dsa.pub
id_ecdsa.pub
id_ed25519.pub
id_rsa.pub
Wenn Sie die Erweiterungsdatei .pub nicht sehen oder ein bestimmtes Set für OpenStack Gerrit generieren möchten, müssen Sie Schlüssel generieren.
SSH-Schlüsselpaare generieren¶
Bemerkung
This guide recommends using ed25519 keys because it has been found that
this type works well across all operating systems.
Generierung des Standard oder des ersten SSH-Schlüsselpaares¶
Sie können ein neues SSH-Schlüsselpaar mit der angegebenen E-Mail als Label generieren, indem Sie in Ihr Terminalprogramm gehen und: eingeben:
ssh-keygen -t ed25519 -C "your_email@example.com"
Wenn Sie aufgefordert werden, „eine Datei einzugeben, in der Sie die Taste speichern möchten“, drücken Sie die Eingabetaste. Dies akzeptiert den Standardspeicherort:
Enter a file in which to save the key (/Users/you/.ssh/id_ed25519): [Press enter]
Geben Sie an der Eingabeaufforderung eine sichere Passphrase ein, die Sie eingeben können, oder drücken Sie Enter, um keine Passphrase zu erhalten:
Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]
Generierung eines separaten Schlüsselpaares für OpenStack Gerrit (optional)¶
Sie können einen neuen SSH-Schlüssel mit der angegebenen E-Mail als Label generieren, indem Sie in Ihr Terminalprogramm gehen und: eingeben:
ssh-keygen -t ed25519 -C "your_email@example.com"
Wenn Sie aufgefordert werden, „Eine Datei einzugeben, in der der Schlüssel gespeichert werden soll“, müssen Sie den Namen des neuen Schlüsselpaares angeben und dann die Eingabetaste drücken:
Enter a file in which to save the key (/Users/you/.ssh/id_ed25519): /Users/you/.ssh/id_openstack_ed25519
Geben Sie an der Eingabeaufforderung eine sichere Passphrase ein, die Sie eingeben können, oder drücken Sie Enter, um keine Passphrase zu erhalten:
Enter passphrase (empty for no passphrase): [Type a passphrase]
Enter same passphrase again: [Type passphrase again]
Schließlich müssen Sie ssh mitteilen, mit welchem Host (welchen Hosts) SSH-Schlüssel verknüpft werden sollen. Um dies zu tun, öffnen Sie „~/.ssh/config“ in einem Editor, erstellen Sie die Datei, wenn sie nicht existiert, und fügen Sie etwas wie:
Host review.opendev.org review
Hostname review.opendev.org
Port 29418
User <your_gerrit_username>
IdentityFile ~/.ssh/id_openstack_ed25519
Öffentlichen Schlüssel kopieren¶
Mac OS & Linux¶
Von Ihrem Terminaltyp:
cat ~/.ssh/id_ed25519.pub
Oder wenn Sie ein separates Schlüsselpaar erstellt haben, wobei Sie den Beispielnamen oben annehmen:
cat ~/.ssh/id_openstack_ed25519.pub
Markieren und kopieren Sie die Ausgabe.
Öffentlichen Schlüssel in Gerrit importieren¶
Paste the public key into the New SSH Key text box.
Click the ‚ADD NEW SSH KEY‘ button.
Git Review¶
Was ist es?¶
Git Review ist ein Tool, das von der OpenStack-Community gepflegt wird. Es fügt ein zusätzliches Unterbefehl zu ‚git‘ wie folgt hinzu:
git review
Wenn Sie Änderungen in einem OpenStack Projekt Repository gemacht haben, können Sie dieses Sub-Kommando benutzen, um die Änderungen auf Gerrit zu laden, sodass sie andere überprüfen können.
Installation¶
Mac OS¶
In einem Terminal geben Sie ein:
pip install git-review
Wenn Sie pip noch nicht installiert haben, folgen Sie der Installationsdokumentation für pip.
Bemerkung
Benutzer von Mac OS X El Capitan und Mac OS Sierra sehen möglicherweise eine Fehlermeldung wie „Operation not permitted“ bei der Installation mit dem Befehl. In diesem Fall gibt es zwei Möglichkeiten, um git-review erfolgreich zu installieren.
Option 1: Installation mit Pip mit mehr Optionen:
pip install --install-option '--install-data=/usr/local' git-review
Option 2: Verwenden Sie den Paketmanager Homebrew, und geben Sie in einem Terminal ein:
brew install git-review
Linux¶
Für Distributionen wie Debian, Ubuntu oder Mint öffnen Sie ein Terminal und geben Sie ein:
sudo apt install git-review
Für Distributionen wie RedHat, Fedora 21 oder früher, oder CentOS öffnen Sie ein Terminal und geben Sie ein:
sudo yum install git-review
Für Fedora 22 oder höher öffnen Sie ein Terminal und geben Sie ein:
sudo dnf install git-review
Für SUSE-Distributionen öffnen Sie ein Terminal und geben Sie ein:
sudo zypper in python-git-review
Konfiguration¶
Die Git-Bewertung geht davon aus, dass der Benutzer, den sie ausfüht, mit seinen Gerrit-Benutzernamen identisch ist. Wenn nicht, können Sie es erkennen, indem Sie diese Git-Konfigurationseinstellung setzen:
git config --global gitreview.username <username>
Wenn Sie Ihren Gerrit Benutzernamen nicht kennen, können Sie ihn in den Gerrit Einstellungen herausfinden.
Vorbereitung zum Senden einer Rezension¶
Bevor Sie git commit auf Ihrem Patch ausführen, ist es wichtig, die Git Review zu initialisieren. Verwenden Sie den folgenden Befehl, um die erste Git-Review-Konfiguration in Ihrem Repository durchzuführen:
git review -s
Der Befehl richtet die notwendigen Remote-Hosts und Commit-Hooks ein, um Änderungen an Gerrit zu übernehmen.
Bemerkung
Git-Reviews müssen nur einmal in einem Repository initialisiert werden.
