diff --git a/doc/source/developers.rst b/doc/source/developers.rst index b3da1b7..2f2cf1b 100644 --- a/doc/source/developers.rst +++ b/doc/source/developers.rst @@ -45,6 +45,8 @@ For further information about the use of IRC in OpenStack, see Extra Gerrit account setup steps -------------------------------- +.. _openstack-individual-contributor-license-agreement: + OpenStack Individual Contributor License Agreement ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -53,6 +55,20 @@ Individual Contributor License Agreement, see `these detailed instructions `_. +.. _gerrit-ssh-host-keys: + +Gerrit SSH Host Keys +^^^^^^^^^^^^^^^^^^^^ + +Careful users may wish to verify the SSH Host key fingerprints for the +Gerrit service the first time they connect from a new system. Depending on +which key types your client is configured to negotiate, you may see some or +all of these listed:: + + 256 SHA256:/aPoKpg+804wdezs21L9djZ4bOsLudpGF7m7779XVuQ [review.opendev.org]:29418 (ECDSA) + 2048 SHA256:RXNl/GKyDaKiIQ93BoDvrNSKUPFvA1PNeAO9QiirYZU [review.opendev.org]:29418 (RSA) + 256 SHA256:lHsyuBxtcAiZeJM+viHllq52he9JNPqg8FFKv5+/BJ8 [review.opendev.org]:29418 (ED25519) + Accessing Gerrit over HTTPS ^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/doc/source/gettingstarted.rst b/doc/source/gettingstarted.rst index 6b93b2f..1295712 100644 --- a/doc/source/gettingstarted.rst +++ b/doc/source/gettingstarted.rst @@ -113,6 +113,11 @@ Then ask git-review to configure your repository to know about Gerrit:: git review -s +Feel free to check any unknown host key fingerprints against the +:ref:`gerrit-ssh-host-keys`, and if you get an error about a missing +contributor license agreement, see the Developer's Guide section on the +:ref:`openstack-individual-contributor-license-agreement`. + Create a change in a topic branch ---------------------------------