OTTR Course
Set Up
Log into GitHub or make a GitHub profile if you are new to GitHub
Go to github.com
Sign up for GitHub if you haven’t already - it’s free!
Make sure you are logged into GitHub - check at https://github.com/ - you should see your profile in the upper right corner
Create a repository from the OTTR_Template template
Go to OTTR_Template
In the upper right, click on:Make sure you don’t click on the green “Code” button instead!
Set your repo to “Public”
Enable workflow actions
In your OTTR repository, go to
Settings in the top navigation tabs
Go to Actions in the menu on
the left side
Select General just below Actions
Scroll down to Workflow permissions
Ensure Read and write permissions is selected
Check Allow GitHub Actions to create and approve pull requests
Click Save
Set up GitHub Pages
In your OTTR repository, go to Settings in
the top navigation tabs
Go to Pages in the side
navigation
In the Build and deployment section
- Under Source, select Deploy from a branch
- Under Branch, pick main and choose /docs, and click Save
at the bottom of the page, check Enforce HTTPS
Set up your GitHub personal access token
Click on your profile photo
in the upper right
Scroll down to Settings
Scroll down in the menu on the left side to
Developer Settings in the lower left side navigation
Scroll down in the left side menu on the left
side to Personal access tokens
Select Tokens (classic)
Click very light gray button that says(upper right)
Select Generate new token (classic)
Confirm your access if you have two factor authentication set up (you will be asked to submit a code or something similar)
Name your token GH_PAT in the “Note” section
Note that your token will expire based on the date that you set in the Expiration section. You will have to complete this process again when your token expires. GitHub will let you know as you will get an error about credentials. It is a good idea to use the default settings.
Underneath Select Scopes (where the check boxes are), check repo (so everything under it is checked) and workflow
Click: Copy the personal access
token
and save somewhere safe and private. Please note that you cannot
retrieve this personal access token again later from GitHub. If
you lose it, you just need to complete this process again.
Click here to see GitHub documentation on creating a personal access token.
Save the copied personal access token as a repository secret
In your OTTR repository, go to
Settings in the top navigation tabs
Note that this is different from your profile settings where you made your token.
Go to Secrets and variables
in the side navigation
Click on Actions
Under Repository secrets, click onUnder Name, enter GH_PAT
For Secret, paste your copied personal access token
Click on:Click here to see GitHub documentation on setting repository secrets.
