Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Multiexcerpt
MultiExcerptNameEITKB Github Organization

How to access the NCAR GitHub organization

Staff members can join the NCAR GitHub organization by following these steps:

UI Steps
sizesmall


UI Step

Create a GitHub account if you don’t already have one.


UI Step

Log in to people.ucar.edu from a staff network or VPN connection.


UI Step

Go to the "Edit My Profile" section.


UI Step

Enter your username in the "GitHub username" field.

UI Step

You will receive an invitation email to join the NCAR organization to the address tied to your github account within an hour.  You must accept this invitation to be added to the organization.





Multiexcerpt
MultiExcerptNameEITKB Github 2FA

Enabling GitHub 2FA

All members and collaborators on the NCAR GitHub organization must have 2FA enabled.  Please note GitHub now considers SMS as an insecure option and no longer treats it as a valid selection - users with SMS configured will need to disable it to be considered secure after configuring a TOTP option.  Also, while

a passkey

passkeys and security keys can be configured in the same settings area and the GitHub documentation explicitly says

it

they can be used for 2FA, GitHub is

not

currently only treating

it

TOTP as a valid secure 2FA option, so the TOTP option must also be configured.

To enable 2FA on your GitHub account, follow these steps or see https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication for additional options.

UI Steps
sizesmall
UI Step

From any github.com page, click on your profile icon in the upper right corner, and select the Settings gear.

UI Step

Under the Access section of the sidebar, select Password and Authentication

UI Step

Enable Two-Factor Authentication

UI Step

Using the TOTP Application of your choice (DUO, Microsoft Authenticator, Google Authenticator, Authy, etc.), scan the QR code or manually enter the setup key provided.

Enter the six digit MFA code provided by your application to complete the GitHub setup.

UI Step

Download and save the provided recovery codes.




Multiexcerpt
MultiExcerptNameEITKB Github Actions

Enabling GitHub Actions, Codespaces, LFA, or Packages

Use of GitHub Actions requires whitelisting of the repository by the UCAR GitHub admins.  Additionally, use of self-hosted runners requires an extra validation process.

Use of Actions and Packages on public repositories are generally free, but are charged for private repositories.  GitHub Codespaces and LFA  are charged for all repositories.  See the relevant GitHub documents for pricing information.

To enable these services and set budgets for charged usage for a repository, please submit a request via https://help.ucar.edu or help@ucar.edu.





Multiexcerpt
MultiExcerptNameEITKB Github Transfer

Transferring repositories to the NCAR GitHub organization

Please read https://docs.github.com/en/repositories/creating-and-managing-repositories/transferring-a-repository before transferring a repository into the NCAR organization.

When transferring a repository into the organization, some information may not be preserved.  There is more impact when transferring a repository from another GitHub organization than from a personal account.  When you transfer a repository to another organization, the repository's stars, watchers, and teams are not transferred along with the repository.  Make sure to capture a record of all repository permissions and other user relationships prior to making the transfer. 

If you would like to preserve the state of the repository as much as possible, this will require working with EIT prior to making the transfer.  Please submit a request via https://help.ucar.edu to start this process.

When a repository has been transferred, the NCAR GitHub administration team is notified, and will re-establish admin permissions on the repository for the user making the transfer within the next business day.  If a permissions change is urgent, or there is a delay in the permissions assignment, please submit a request to https://help.ucar.edu to raise attention to the transfer.  Other user permissions assignments will be left to the repository admin.





Multiexcerpt
MultiExcerptNameEITKB Github Copilot

Use of Github Copilot

All Github users have access to github copilot via the new limited use free tier.   Use of the free tier of github copilot has different data usage, exclusion, and indemnity terms compared to the licensed version ( https://github.com/features/copilot/plans ).

UCAR Staff members can request a Github Copilot business license on the NCAR Github Organization by submitting a ticket to help@ucar.edu / https://help.ucar.edu .  There is a monthly cost associated with this license so you will need to provide a project tag and cost center for the monthly chargebacks, along with your github username.

  

  Copilot Business users are provided with a limited number of premium requests per month, usage exceeding this amount will be charged back to the provided cost center;  see https://docs.github.com/en/copilot/managing-copilot/monitoring-usage-and-entitlements/about-premium-requests for more details.

Please do not submit a request for Github Copilot through the Github interface - this method does not reliably inform the organization admins which user made the request.