A GitHub action to update a Docker Hub repository description from README.md.
This is useful if you docker push your images to Docker Hub. It provides an easy, automated way to keep your Docker Hub repository description in sync with your GitHub repository README.md file.
- uses: actions/checkout@v4
- name: Docker Hub Description
uses: peter-evans/dockerhub-description@v4
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_PASSWORD }}
repository: peterevans/dockerhub-description| Name | Description | Default |
|---|---|---|
username |
(required) Docker Hub username. If updating a Docker Hub repository belonging to an organization, this user must have Admin permissions for the repository. |
|
password |
(required) Docker Hub password or Personal Access Token with read/write/delete scope. |
|
repository |
Docker Hub repository in the format <namespace>/<name>. |
github.repository |
short-description |
Docker Hub repository short description. | |
readme-filepath |
Path to the repository readme. | ./README.md |
enable-url-completion |
Enables completion of relative URLs to absolute ones. See also known Issues. | false |
image-extensions |
File extensions that will be treated as images. | bmp,gif,jpg,jpeg,png,svg,webp |
DockerHub has content limits.
The readme content is limited to 25,000 bytes, and short-description is limited to 100 bytes.
This action truncates content to prevent the request being rejected.
If the content has been truncated a warning will be issued in the run log.
The action assumes that there is a file called README.md located at the root of the repository.
If this is not the case the path can be specified with the readme-filepath input.
- name: Docker Hub Description
uses: peter-evans/dockerhub-description@v4
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_PASSWORD }}
repository: peterevans/dockerhub-description
readme-filepath: ./path/to/README.mdThe GitHub repository description can be used for the Docker Hub short-descripton by passing the description from the event context.
- name: Docker Hub Description
uses: peter-evans/dockerhub-description@v4
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_PASSWORD }}
repository: peterevans/dockerhub-description
short-description: ${{ github.event.repository.description }}The following workflow updates the Docker Hub repository description whenever there are changes to README.md and the workflow file itself on the main branch. This workflow assumes its location to be .github/workflows/dockerhub-description.yml.
name: Update Docker Hub Description
on:
push:
branches:
- main
paths:
- README.md
- .github/workflows/dockerhub-description.yml
jobs:
dockerHubDescription:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Docker Hub Description
uses: peter-evans/dockerhub-description@v4
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_PASSWORD }}
repository: peterevans/dockerhub-description
short-description: ${{ github.event.repository.description }}
enable-url-completion: trueUpdates the Docker Hub repository description whenever a new release is created.
name: Update Docker Hub Description
on: release
jobs:
dockerHubDescription:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Docker Hub Description
uses: peter-evans/dockerhub-description@v4
with:
username: ${{ secrets.DOCKERHUB_USERNAME }}
password: ${{ secrets.DOCKERHUB_PASSWORD }}
repository: peterevans/dockerhub-description
short-description: ${{ github.event.repository.description }}The completion of relative URLs has some known issues:
-
Relative markdown links in inline-code and code blocks are also converted:
[link in inline code](#table-of-content)
will be converted into
[link in inline code](https://github.com/peter-evans/dockerhub-description/blob/main/./README.md#table-of-content)
-
Links containing square brackets (
]) in the text fragment are not converted:[[link text with square brackets]](#table-of-content)
-
Reference-style links/images are not converted.
[table-of-content][toc] ... [toc]: #table-of-content "Table of content"
The image can be executed in other environments independently of GitHub Actions.
Simply volume mount the location of the README.md file to the container and set environment variables as follows.
docker run -v $PWD:/workspace \
-e DOCKERHUB_USERNAME='user1' \
-e DOCKERHUB_PASSWORD='xxxxx' \
-e DOCKERHUB_REPOSITORY='user1/my-docker-image' \
-e README_FILEPATH='/workspace/README.md' \
peterevans/dockerhub-description:3