[ English | Indonesia | 한국어 (대한민국) | español (México) | English (United Kingdom) | 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

  1. Besuchen Sie die Gerrit-Seite von OpenStack <https://review.opendev.org>`_ und klicken Sie auf den ** sign in ** Link.

  2. 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

  1. 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.

../_images/3.png

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.

  1. In Gerrits Einstellungen <https://review.opendev.org/#/settings/agreements>`_ klicken Sie auf die ** New Contributor Agreement ** Link und unterzeichnen Sie die Vereinbarung.

    ../_images/3.png
  2. Ein Arbeitgeber mit den entsprechenden Zeichnungsrechten des Unternehmens oder der Organisation muss den Corporate Contributor License Agreement unterzeichnen.

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

Select and copy the output.

Öffentlichen Schlüssel in Gerrit importieren

  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.

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

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

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 review only needs to be initialized once in a repository.