Skip to content

Hub user image for the Alabama Water Institute CIROH hub

License

Notifications You must be signed in to change notification settings

AlabamaWaterInstitute/awi-ciroh-image

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

hub-user-image-template 📎

This is a template repository for creating dedicated user images for 2i2c hubs.

Overall workflow ⚙️

The overall workflow is to:

  1. Fork this repository to create your image repository

  2. Hook your image repository to quay.io

  3. Customize the image by editing repo2docker files in your image repository.

    Changes can either be done by direct commits to main on your image repository, or through a pull request from a fork of your image repository. Direct commits will build the image and push it to Quay.io. PRs will build the image and offer a link to test it using Binder. Merging the PR will cause a commit on main and therefore trigger a build and push to Quay.io.

  4. Configure your Hub to use this new image

In-depth guide

Checkout the 2i2c docs for an in-depth guide on how to use this template repository to create a custom user image and use it for your hub ➡️ https://docs.2i2c.org/en/latest/admin/howto/environment/hub-user-image-template-guide.html.

About this template repository ℹ️

This template repository enables jupyterhub/repo2docker-action. This GitHub action builds a Docker image using the contents of this repo and pushes it to the Quay.io registry.

The environment

It provides an example of a environment.yml conda configuration file for repo2docker to use. This file can be used to list all the conda packages that need to be installed by repo2docker in your environment. The repo2docker-action will update the base repo2docker conda environment with the packages listed in this environment.yml file.

Note: A complete list of possible configuration files that can be added to the repository and be used by repo2docker to build the Docker image, can be found in the repo2docker docs.

The GitHub workflows

This template repository provides two GitHub workflows that can build and push the image to quay.io when configured.

Workflows

1. Build and push container image ➡️ build.yaml

This workflow is triggered by every pushed commit on the main branch of the repo (including when a PR is merged). It builds the image and pushes it to the registry.

2. Test container image build ➡️ test.yaml

This workflow is triggerd by every Pull Request commit and it builds the image, but it doesn't push it to the registry, unless explicitly configured to do so. Checkout this section on how to enable image pushes on Pull Requests.

3. Test this PR on Binder Badge ➡️ binder.yaml

This workflow posts a comment inside a pull request, every time a pull request gets opened. The comment contains a "Test this PR on Binder" badge, which can be used to access the image defined by the PR in mybinder.org.

Test this PR on Binder

About

Hub user image for the Alabama Water Institute CIROH hub

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dockerfile 100.0%