diff --git a/.github/workflows/docker-tag-manifest-push.yml b/.github/workflows/docker-tag-manifest-push.yml index df4260eb..ced13f63 100644 --- a/.github/workflows/docker-tag-manifest-push.yml +++ b/.github/workflows/docker-tag-manifest-push.yml @@ -80,13 +80,13 @@ jobs: shell: bash - name: Login to Docker Hub 🔐 - if: github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' || github.event_name == 'schedule' + if: github.ref == 'refs/heads/main' || github.event_name == 'schedule' uses: docker/login-action@49ed152c8eca782a232dede0303416e8f356c37b # dependabot updates to latest release with: username: ${{ secrets.DOCKERHUB_USERNAME }} password: ${{ secrets.DOCKERHUB_TOKEN }} - name: Push Images to Docker Hub 📤 - if: github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' || github.event_name == 'schedule' + if: github.ref == 'refs/heads/main' || github.event_name == 'schedule' run: docker push --all-tags jupyter/${{ matrix.image }} shell: bash diff --git a/.github/workflows/docker-wiki-update.yml b/.github/workflows/docker-wiki-update.yml index a7a7b3b3..b7dbcfc1 100644 --- a/.github/workflows/docker-wiki-update.yml +++ b/.github/workflows/docker-wiki-update.yml @@ -39,7 +39,7 @@ jobs: shell: bash - name: Push Wiki to GitHub 📤 - if: github.ref == 'refs/heads/master' || github.ref == 'refs/heads/main' || github.event_name == 'schedule' + if: github.ref == github.ref == 'refs/heads/main' || github.event_name == 'schedule' uses: stefanzweifel/git-auto-commit-action@49620cd3ed21ee620a48530e81dba0d139c9cb80 # dependabot updates to latest release with: commit_message: "Automated wiki publish for ${{ github.sha }}" diff --git a/.github/workflows/docker.yml b/.github/workflows/docker.yml index 0e4729d0..2b6daf1e 100644 --- a/.github/workflows/docker.yml +++ b/.github/workflows/docker.yml @@ -34,7 +34,6 @@ on: push: branches: - main - - master paths: - ".github/workflows/docker.yml" - ".github/workflows/docker-build-test-upload.yml" diff --git a/.github/workflows/hub-overview.yml b/.github/workflows/hub-overview.yml index 0924dfa5..8a9bcc9c 100644 --- a/.github/workflows/hub-overview.yml +++ b/.github/workflows/hub-overview.yml @@ -4,7 +4,6 @@ on: push: branches: - main - - master paths: - ".github/workflows/hub-overview.yml" diff --git a/.github/workflows/pre-commit.yml b/.github/workflows/pre-commit.yml index 5fe518ed..00c29e47 100644 --- a/.github/workflows/pre-commit.yml +++ b/.github/workflows/pre-commit.yml @@ -5,7 +5,6 @@ on: push: branches: - main - - master workflow_dispatch: permissions: diff --git a/.github/workflows/sphinx.yml b/.github/workflows/sphinx.yml index b990a6bc..ef219956 100644 --- a/.github/workflows/sphinx.yml +++ b/.github/workflows/sphinx.yml @@ -15,7 +15,6 @@ on: push: branches: - main - - master paths: - ".github/workflows/sphinx.yml" diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index c2c72f8c..90401f93 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -1,3 +1,3 @@ # Project `jupyter/docker-stacks` Code of Conduct -Please see the [Project Jupyter Code of Conduct](https://github.com/jupyter/governance/blob/master/conduct/code_of_conduct.md). +Please see the [Project Jupyter Code of Conduct](https://github.com/jupyter/governance/blob/HEAD/conduct/code_of_conduct.md). diff --git a/README.md b/README.md index 03c58eba..8792b6d6 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,9 @@ [![GitHub actions badge](https://github.com/jupyter/docker-stacks/actions/workflows/docker.yml/badge.svg)](https://github.com/jupyter/docker-stacks/actions/workflows/docker.yml "Docker images build status") [![Read the Docs badge](https://img.shields.io/readthedocs/jupyter-docker-stacks.svg)](https://jupyter-docker-stacks.readthedocs.io/en/latest/ "Documentation build status") -[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/jupyter/docker-stacks/master.svg)](https://results.pre-commit.ci/latest/github/jupyter/docker-stacks/master "pre-commit.ci build status") +[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/jupyter/docker-stacks/main.svg)](https://results.pre-commit.ci/latest/github/jupyter/docker-stacks/main "pre-commit.ci build status") [![Discourse badge](https://img.shields.io/discourse/users.svg?color=%23f37626&server=https%3A%2F%2Fdiscourse.jupyter.org)](https://discourse.jupyter.org/ "Jupyter Discourse Forum") -[![Binder badge](https://static.mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter/docker-stacks/master?filepath=README.ipynb "Launch a jupyter/base-notebook container on mybinder.org") +[![Binder badge](https://static.mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/jupyter/docker-stacks/main?filepath=README.ipynb "Launch a jupyter/base-notebook container on mybinder.org") Jupyter Docker Stacks are a set of ready-to-run [Docker images](https://hub.docker.com/u/jupyter) containing Jupyter applications and interactive computing tools. You can use a stack image to do any of the following (and more): @@ -16,7 +16,7 @@ You can use a stack image to do any of the following (and more): ## Quick Start -You can try a [relatively recent build of the jupyter/base-notebook image on mybinder.org](https://mybinder.org/v2/gh/jupyter/docker-stacks/master?urlpath=lab/tree/README.ipynb) +You can try a [relatively recent build of the jupyter/base-notebook image on mybinder.org](https://mybinder.org/v2/gh/jupyter/docker-stacks/main?urlpath=lab/tree/README.ipynb) by simply clicking the preceding link. Otherwise, the examples below may help you get started if you [have Docker installed](https://docs.docker.com/install/), know [which Docker image](https://jupyter-docker-stacks.readthedocs.io/en/latest/using/selecting.html) you want to use diff --git a/docs/conf.py b/docs/conf.py index 970894d6..1f748265 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -99,7 +99,7 @@ linkcheck_ignore = [ ] linkcheck_allowed_redirects = { - r"https://results\.pre-commit\.ci/latest/github/jupyter/docker-stacks/master": r"https://results\.pre-commit\.ci/run/github/.*", # Latest master CI build + r"https://results\.pre-commit\.ci/latest/github/jupyter/docker-stacks/main": r"https://results\.pre-commit\.ci/run/github/.*", # Latest main CI build r"https://github\.com/jupyter/docker-stacks/issues/new.*": r"https://github\.com/login.*", # GitHub wants user to be logon to use this features r"https://github\.com/orgs/jupyter/teams/docker-image-maintainers/members": r"https://github\.com/login.*", } diff --git a/docs/contributing/issues.md b/docs/contributing/issues.md index fa25b0d2..0c6c34d9 100644 --- a/docs/contributing/issues.md +++ b/docs/contributing/issues.md @@ -5,7 +5,7 @@ Please review the following guidelines when reporting your problem. - If you believe you’ve found a security vulnerability in any of the Jupyter projects included in Jupyter Docker Stacks images, please report it to [security@ipython.org](mailto:security@ipython.org), **not in the issue trackers on GitHub**. - If you prefer to encrypt your security reports, you can use [this PGP public key](https://github.com/jupyter/jupyter.github.io/blob/master/assets/ipython_security.asc). + If you prefer to encrypt your security reports, you can use [this PGP public key](https://github.com/jupyter/jupyter.github.io/blob/HEAD/assets/ipython_security.asc). - If you think your problem is unique to the Jupyter Docker Stacks images, please search the [jupyter/docker-stacks issue tracker](https://github.com/jupyter/docker-stacks/issues) to see if someone else has already reported the same problem. diff --git a/docs/contributing/stacks.md b/docs/contributing/stacks.md index 77da1778..8d37c350 100644 --- a/docs/contributing/stacks.md +++ b/docs/contributing/stacks.md @@ -80,12 +80,11 @@ The cookiecutter template comes with a `.github/workflows/docker.yml` file, whic push: branches: - main - - master paths-ignore: - "*.md" ``` - This will trigger the CI pipeline whenever you push to your `main` or `master` branch and when any Pull Requests are made to your repository. + This will trigger the CI pipeline whenever you push to your `main` branch and when any Pull Requests are made to your repository. For more details on this configuration, visit the [GitHub actions documentation on triggers](https://docs.github.com/en/actions/using-workflows/events-that-trigger-workflows). 2. Commit your changes and push to GitHub. @@ -99,7 +98,7 @@ The cookiecutter template comes with a `.github/workflows/docker.yml` file, whic ## Configuring Docker Hub Now, configure Docker Hub to build your stack image and push it to Docker Hub repository whenever -you merge a GitHub pull request to the master branch of your project. +you merge a GitHub pull request to the main branch of your project. 1. Visit [https://hub.docker.com/](https://hub.docker.com/) and log in. 2. Select the account or organization matching the one you entered when prompted with `stack_org` by the cookiecutter. @@ -137,14 +136,13 @@ you merge a GitHub pull request to the master branch of your project. Make edits to the Dockerfile in your project to add third-party libraries and configure Jupyter applications. -Refer to the Dockerfiles for the core stacks (e.g., [jupyter/datascience-notebook](https://github.com/jupyter/docker-stacks/blob/master/datascience-notebook/Dockerfile)) +Refer to the Dockerfiles for the core stacks (e.g., [jupyter/datascience-notebook](https://github.com/jupyter/docker-stacks/blob/main/datascience-notebook/Dockerfile)) to get a feel for what's possible and best practices. [Submit pull requests](https://github.com/PointCloudLibrary/pcl/wiki/A-step-by-step-guide-on-preparing-and-submitting-a-pull-request) to your project repository on GitHub. -Ensure your image builds correctly on GitHub actions before merging to -master or main. -Refer to Docker Hub to build your master or main branch that you can `docker pull`. +Ensure your image builds correctly on GitHub actions before merging to main branch. +Refer to Docker Hub to build your main branch that you can `docker pull`. ## Sharing Your Image diff --git a/docs/contributing/tests.md b/docs/contributing/tests.md index 1de1d259..2c5578a6 100644 --- a/docs/contributing/tests.md +++ b/docs/contributing/tests.md @@ -4,7 +4,7 @@ We greatly appreciate pull requests that extend the automated tests that vet the ## How the Tests Work -A [GitHub Action workflow](https://github.com/jupyter/docker-stacks/blob/master/.github/workflows/docker.yml) +A [GitHub Action workflow](https://github.com/jupyter/docker-stacks/blob/main/.github/workflows/docker.yml) runs tests against pull requests submitted to the `jupyter/docker-stacks` repository. We use `pytest` module to run tests on the image. @@ -18,7 +18,7 @@ If your test is located in `tests/-notebook/`, it will be run against ``` Many tests make use of global [pytest fixtures](https://docs.pytest.org/en/latest/reference/fixtures.html) -defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/master/tests/conftest.py) file. +defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/main/tests/conftest.py) file. ## Unit tests diff --git a/docs/maintaining/tasks.md b/docs/maintaining/tasks.md index 4c84ca40..2f35ede8 100644 --- a/docs/maintaining/tasks.md +++ b/docs/maintaining/tasks.md @@ -10,10 +10,10 @@ To build new images and publish them to the Docker Hub registry, do the followin ```{note} We think GitHub Actions are quite reliable, so please, investigate if some error occurs. - Building Docker images in PRs is exactly the same after merging to master, except there is an additional `push` step. + Building Docker images in PRs is exactly the same after merging to main, except there is an additional `push` step. ``` -4. Try to avoid merging another PR to master until all pending builds are complete. +4. Try to avoid merging another PR to main branch until all pending builds are complete. This way, you will know which commit might have broken the build and also have correct tags for moving tags (like `python` version). ## Updating the Ubuntu Base Image @@ -34,10 +34,10 @@ In general, we do not add new core images and ask contributors to either create When there's a new stack definition, do the following before merging the PR with the new stack: 1. Ensure the PR includes an update to the stack overview diagram - [in the documentation](https://github.com/jupyter/docker-stacks/blob/master/docs/using/selecting.md#image-relationships). + [in the documentation](https://github.com/jupyter/docker-stacks/blob/main/docs/using/selecting.md#image-relationships). The image links to the [blockdiag source](http://interactive.blockdiag.com/) used to create it. -2. Ensure the PR updates the [Makefile](https://github.com/jupyter/docker-stacks/blob/master/Makefile), which is used to build the stacks in order on GitHub Actions. -3. Ensure necessary tags / manifests are added for the new image in the [tagging](https://github.com/jupyter/docker-stacks/tree/master/tagging) folder. +2. Ensure the PR updates the [Makefile](https://github.com/jupyter/docker-stacks/blob/main/Makefile), which is used to build the stacks in order on GitHub Actions. +3. Ensure necessary tags / manifests are added for the new image in the [tagging](https://github.com/jupyter/docker-stacks/tree/main/tagging) folder. 4. Create a new repository in the `jupyter` org on Docker Hub named after the stack folder in the git repo. 5. Grant the `stacks` team permission to write to the repo. diff --git a/docs/using/common.md b/docs/using/common.md index 6e910a30..6239168b 100644 --- a/docs/using/common.md +++ b/docs/using/common.md @@ -133,7 +133,7 @@ or executables (`chmod +x`) to be run to the paths below: - `/usr/local/bin/before-notebook.d/` - handled **after** all the standard options noted above are applied and ran right before the notebook server launches -See the `run-hooks` function in the [`jupyter/base-notebook start.sh`](https://github.com/jupyter/docker-stacks/blob/master/base-notebook/start.sh) +See the `run-hooks` function in the [`jupyter/base-notebook start.sh`](https://github.com/jupyter/docker-stacks/blob/main/base-notebook/start.sh) script for execution details. ## SSL Certificates @@ -166,10 +166,10 @@ The certificate file or PEM may contain one or more certificates (e.g., server, For additional information about using SSL, see the following: -- The [docker-stacks/examples](https://github.com/jupyter/docker-stacks/tree/master/examples) +- The [docker-stacks/examples](https://github.com/jupyter/docker-stacks/tree/main/examples) for information about how to use [Let's Encrypt](https://letsencrypt.org/) certificates when you run these stacks on a publicly visible domain. -- The [`jupyter_server_config.py`](https://github.com/jupyter/docker-stacks/blob/master/base-notebook/jupyter_server_config.py) +- The [`jupyter_server_config.py`](https://github.com/jupyter/docker-stacks/blob/main/base-notebook/jupyter_server_config.py) file for how this Docker image generates a self-signed certificate. - The [Jupyter Server documentation](https://jupyter-server.readthedocs.io/en/latest/operators/public-server.html#securing-a-jupyter-server) for best practices about securing a public notebook server in general. diff --git a/docs/using/recipes.md b/docs/using/recipes.md index 944ec78d..df5e1a23 100644 --- a/docs/using/recipes.md +++ b/docs/using/recipes.md @@ -148,7 +148,7 @@ Ref: ## Let's Encrypt a Notebook server See the README for a basic automation here - + which includes steps for requesting and renewing a Let's Encrypt certificate. Ref: diff --git a/docs/using/selecting.md b/docs/using/selecting.md index b003a7c3..fdc7bc1d 100644 --- a/docs/using/selecting.md +++ b/docs/using/selecting.md @@ -18,8 +18,8 @@ The following sections describe these images, including their contents, relation ### jupyter/base-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/base-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/base-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/base-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/base-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/base-notebook/tags/) `jupyter/base-notebook` is a small image supporting the [options common across all core stacks](common.md). @@ -40,8 +40,8 @@ It is the basis for all other stacks and contains: ### jupyter/minimal-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/minimal-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/minimal-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/minimal-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/minimal-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/minimal-notebook/tags/) `jupyter/minimal-notebook` adds command-line tools useful when working in Jupyter applications. @@ -56,8 +56,8 @@ It contains: ### jupyter/r-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/r-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/r-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/r-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/r-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/r-notebook/tags/) `jupyter/r-notebook` includes popular packages from the R ecosystem listed below: @@ -87,8 +87,8 @@ It contains: ### jupyter/scipy-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/scipy-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/scipy-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/scipy-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/scipy-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/scipy-notebook/tags/) `jupyter/scipy-notebook` includes popular packages from the scientific Python ecosystem. @@ -129,8 +129,8 @@ It contains: ### jupyter/tensorflow-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/tensorflow-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/tensorflow-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/tensorflow-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/tensorflow-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/tensorflow-notebook/tags/) `jupyter/tensorflow-notebook` includes popular Python deep learning libraries. @@ -140,8 +140,8 @@ It contains: ### jupyter/datascience-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/datascience-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/datascience-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/datascience-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/datascience-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/datascience-notebook/tags/) `jupyter/datascience-notebook` includes libraries for data analysis from the Julia, Python, and R @@ -159,8 +159,8 @@ communities. ### jupyter/pyspark-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/pyspark-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/pyspark-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/pyspark-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/pyspark-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/pyspark-notebook/tags/) `jupyter/pyspark-notebook` includes Python support for Apache Spark. @@ -171,8 +171,8 @@ communities. ### jupyter/all-spark-notebook -[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/master/all-spark-notebook) | -[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/all-spark-notebook/Dockerfile) | +[Source on GitHub](https://github.com/jupyter/docker-stacks/tree/main/all-spark-notebook) | +[Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/main/all-spark-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/all-spark-notebook/tags/) `jupyter/all-spark-notebook` includes Python and R support for Apache Spark. diff --git a/examples/source-to-image/README.md b/examples/source-to-image/README.md index f8a88bb8..1e9d3ba9 100644 --- a/examples/source-to-image/README.md +++ b/examples/source-to-image/README.md @@ -31,7 +31,7 @@ As an example of how S2I can be used to create a custom image with a bundled set ```bash s2i build \ - --scripts-url https://raw.githubusercontent.com/jupyter/docker-stacks/master/examples/source-to-image \ + --scripts-url https://raw.githubusercontent.com/jupyter/docker-stacks/main/examples/source-to-image \ --context-dir docs/source/examples/Notebook \ https://github.com/jupyter/notebook \ jupyter/minimal-notebook:latest \ @@ -127,7 +127,7 @@ Templates are provided for using the S2I build mechanism with the scripts in thi To load the templates run: ```bash -oc create -f https://raw.githubusercontent.com/jupyter/docker-stacks/master/examples/source-to-image/templates.json +oc create -f https://raw.githubusercontent.com/jupyter/docker-stacks/main/examples/source-to-image/templates.json ``` This will create the templates: diff --git a/examples/source-to-image/templates.json b/examples/source-to-image/templates.json index a057c11e..3f6817af 100644 --- a/examples/source-to-image/templates.json +++ b/examples/source-to-image/templates.json @@ -27,7 +27,7 @@ }, { "name": "BUILDER_SCRIPTS", - "value": "https://raw.githubusercontent.com/jupyter/docker-stacks/master/examples/source-to-image", + "value": "https://raw.githubusercontent.com/jupyter/docker-stacks/main/examples/source-to-image", "required": true }, { @@ -37,7 +37,7 @@ }, { "name": "GIT_REFERENCE", - "value": "master", + "value": "main", "required": true }, { @@ -130,7 +130,7 @@ }, { "name": "BUILDER_SCRIPTS", - "value": "https://raw.githubusercontent.com/jupyter/docker-stacks/master/examples/source-to-image", + "value": "https://raw.githubusercontent.com/jupyter/docker-stacks/main/examples/source-to-image", "required": true }, { @@ -140,7 +140,7 @@ }, { "name": "GIT_REFERENCE", - "value": "master", + "value": "main", "required": true }, {