Cloud / DevOps / Docker

Experimenting GitHub Container Registry

Recently GitHub announced public beta availability of their Container Registry and I thought I will give it a try. So in this article I will take you through the basic setup for pushing docker images to GitHub Container Registry and do a simple CI.

GitHub Container Registry is free for public images (Public repos) and for private repos, its free during the beta phase. Please keep that in mind, once the beta goes to GA charges are applicable.

The Setup
1. First we need to generate PAT token from the User Settings -> Developer Settings. The PAT token will help you to authenticate with GitHub.

2. Assign the corrections permissions to the Token. You need below permission to push the image to the registry
read:packages
write:packages 
delete:packages 
3. Save your PAT and it is recommended to store it in your environment variables in the machine
$ export CR_PAT=YOUR_TOKEN

First push to GitHub Container Registry
4. Login into GitHub Container Registry using below command in the machine
$ echo $CR_PAT | docker login ghcr.io -u USERNAME --password-stdin
5. Build the docker image and tag with following name convention
# docker build -t ghcr.io/OWNER/IMAGE_NAME:VERSION .
docker build -t ghcr.io/mysticrenji/react-netcore:1.0 .
6. Push the image to the registry
docker push ghcr.io/mysticrenji/react-netcore:1.0
7. Once you pushed the image, it will available in the packages section in GitHub Home Page

By default the images pushed to GitHub Container Registry will be in private mode by default. You may have to change it, if required.

Putting everything together into CI Process
GibHub Actions yml

name: CI
on:
push:
branches: [ master ]
pull_request:
branches: [ master ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/[email protected]
- name: Docker Push
run: |
echo ${{ secrets.CR_PAT }} | docker login ghcr.io -u $GITHUB_ACTOR --password-stdin
docker build . --tag ghcr.io/mysticrenji/react-netcore:$GITHUB_SHA
docker push ghcr.io/mysticrenji/react-netcore:$GITHUB_SHA

That’s all folks. Please try it and let me know your thoughts on this.
Github Repo

This article has been originally taken from my blog

Disclaimer: The views expressed and the content shared are those of the author and do not reflect the views of the author’s employer or techbeatly platform.

Tags: Containers · Devops · docker · GitHub · Microsoft

Comments