Summary and Setup

Prerequisite

Before joining Advanced Git Version Control, participants should

know the topics of the Version Control with Git lesson.
be able to navigate a UNIX shell.
Have a Git client installed.

Summary

This lesson extends the Software Carpentry’s Version Control with Git.

Callout

🚧 Under Construction 🚧

This lesson is still under construction and may change when the material was used in several workshops—please be patient.

This is a lesson built with [The Carpentries Workbench][workbench].

Installing Git

Since several Carpentries lessons rely on Git, please see this section of the workshop template for instructions on installing Git for various operating systems.

Creating an Account at a Hosting Service

You will need an account for GitHub to follow episodes 3 & 8 in this lesson.

Go to https://github.com and follow the “Sign up” link at the top-right of the window.
Follow the instructions to create an account.
Verify your email address with GitHub.
Configure multifactor authentication (see below).

Multi-factor Authentication

In 2023, GitHub introduced a requirement for all accounts to have multi-factor authentication (2FA) configured for extra security. Several options exist for setting up 2FA, which are summarised here:

set up 2FA via text message (list of countries where authentication by SMS is supported), or
use a hardware security key like YubiKey or the Google Titan key.

If you already use an authenticator app, like Google Authenticator or Duo Mobile on your smartphone for example, add GitHub to that app.
If you have access to a smartphone but do not already use an authenticator app, install one and add GitHub to the app.
If you do not have access to a smartphone or do not want to install an authenticator app, you have two options:
1. set up 2FA via text message (list of countries where authentication by SMS is supported), or
2. use a hardware security key like YubiKey or the Google Titan key.

The GitHub documentation provides more details about configuring 2FA.

Go to https://gitlab.com and follow the “Get free trial” link at the top-right
Follow the instructions to create an account
Verify your email address with Gitlab
Configure multifactor authentication (optional—see below)

Multi-factor Authentication

Multifactor authentication is currently not required, but you can set it up to increase security for your account.

Several options exist for setting up 2FA, which are summarised here:

If you already use an authenticator app, like Google Authenticator or Duo Mobile on your smartphone for example, add Gitlab to that app.
If you have access to a smartphone but do not already use an authenticator app, install one and add Gitlab to that app.
If you do not have access to a smartphone or do not want to install an authenticator app, you can use a hardware security key like YubiKey or the Google Titan key.
Save the recovery codes and store them in a secure location. You can use them to login and reconfigure should you loose access you to configured second factor.

The Gitlab documentation provides more details about configuring 2FA.

Preparing Your Working Directory

We’ll do our work in the Desktop folder so make sure you change your working directory to it with:

BASH

$ cd
$ cd Desktop