GitLab

Instructions

  • Ensure that you can log in the to GitLab console through a web browser at the NoviSci GitLab website. If you are unable to log in then you may need to email ithelpdesk@targetrwe.com to have them add you as a user.

  • Ensure that you can access the repositories that you will be working with. If you try to access a particular repository and get an error message like HTTP Basic: Access denied then ask to be granted permission to access the nsResearch and nsStat groups by sending a request to the #techsupport Slack channel.

  • Optionally set up an SSH key to save yourself from having to enter a username and password each time you perform an action (taken from https://docs.gitlab.com/ee/user/ssh.html).

    • Open a terminal in your home directory.

    • Verify the SSH version is greater than or equal to 6.5 by running ssh -V`.

    • Generate an SSH key.

      • In the terminal, run ssh-keygen -t ed25519 -C <your_email_address@targetrwe.com>.

      • Click enter.

      • Specify a passphrase.

    • Adding the ssh key to GitLab (detailed instructions here)

      • Copy the contents of the .ssh file created in the step above.

      • In GitLab, go to Preferences > SSH Keys.

      • Paste the contents of the .ssh file in the "Key" box.

      • Add a description in the "Title" box.

      • Click "Add Key"

    • Verify the connection.

      • In the terminal, run ssh -T git@gitlab.example.com.

      • If an "are you sure?" message pops up,

        • Type "yes" and click "Enter".

        • Rerun ssh -T git@gitlab.example.com.

      • You should receive a welcome message.

      • If no messsage is received, troubleshoot by running ssh -Tvvv git@gitlab.example.com.

  • In your IDE, clone the desired repo.