mirror of
https://github.com/peter-evans/dockerhub-description.git
synced 2024-11-25 13:39:33 +01:00
docs: update readme
This commit is contained in:
parent
03c1121463
commit
63eba8b40c
1 changed files with 30 additions and 25 deletions
55
README.md
55
README.md
|
@ -10,36 +10,39 @@ This is useful if you `docker push` your images to Docker Hub. It provides an ea
|
||||||
```yml
|
```yml
|
||||||
- name: Docker Hub Description
|
- name: Docker Hub Description
|
||||||
uses: peter-evans/dockerhub-description@v2
|
uses: peter-evans/dockerhub-description@v2
|
||||||
env:
|
with:
|
||||||
DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
|
username: ${{ secrets.DOCKERHUB_USERNAME }}
|
||||||
DOCKERHUB_PASSWORD: ${{ secrets.DOCKERHUB_PASSWORD }}
|
password: ${{ secrets.DOCKERHUB_PASSWORD }}
|
||||||
DOCKERHUB_REPOSITORY: peterevans/dockerhub-description
|
repository: peterevans/dockerhub-description
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Required environment variables
|
### Action inputs
|
||||||
|
|
||||||
- `DOCKERHUB_USERNAME` - Docker Hub username. If updating a Docker Hub repository belonging to an organization, this user must have `Admin` permissions for the repository. Aliases: `DOCKER_USERNAME`
|
**Note**: Docker Hub [Personal Access Tokens](https://docs.docker.com/docker-hub/access-tokens/) cannot be used as they are not supported by the API. See [here](https://github.com/docker/hub-feedback/issues/1927) and [here](https://github.com/docker/hub-feedback/issues/1914) for further details. Unfortunately, this means that enabling 2FA on Docker Hub will prevent the action from working.
|
||||||
- `DOCKERHUB_PASSWORD` - Docker Hub password. Fallback to `DOCKER_PASSWORD` if set. Aliases: `DOCKER_PASSWORD`
|
|
||||||
- `DOCKERHUB_REPOSITORY` - The Docker Hub repository to update in the format `<namespace>/<name>`. May also be passed as a secret if considered sensitive. Aliases: `DOCKER_REPOSITORY`, `GITHUB_REPOSITORY`
|
|
||||||
|
|
||||||
**Note**: Docker Hub [Personal Access Tokens](https://docs.docker.com/docker-hub/access-tokens/) cannot be used as they are not supported by the API. See [here](https://github.com/docker/hub-feedback/issues/1927) and [here](https://github.com/docker/hub-feedback/issues/1914) for further details. Unfortunately, this means that enabling the new 2FA feature on Docker Hub will prevent the action from working.
|
| 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 | |
|
||||||
|
| `repository` | (**required**) Docker Hub repository in the format `<namespace>/<name>` | |
|
||||||
|
| `readme-filepath` | Path to the repository readme. | `./README.md` |
|
||||||
|
|
||||||
#### Optionally specifying the file path
|
#### Optionally specifying the file path
|
||||||
|
|
||||||
The action assumes that there is a file called `README.md` located at the root of the repository.
|
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 overridden with an environment variable.
|
If this is not the case the path can be specified with the `readme-filepath` input.
|
||||||
|
|
||||||
```yml
|
```yml
|
||||||
- name: Docker Hub Description
|
- name: Docker Hub Description
|
||||||
uses: peter-evans/dockerhub-description@v2
|
uses: peter-evans/dockerhub-description@v2
|
||||||
env:
|
with:
|
||||||
DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
|
username: ${{ secrets.DOCKERHUB_USERNAME }}
|
||||||
DOCKERHUB_PASSWORD: ${{ secrets.DOCKERHUB_PASSWORD }}
|
password: ${{ secrets.DOCKERHUB_PASSWORD }}
|
||||||
DOCKERHUB_REPOSITORY: peterevans/dockerhub-description
|
repository: peterevans/dockerhub-description
|
||||||
README_FILEPATH: ./some-path/README.md
|
readme-filepath: ./path/to/README.md
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Examples
|
### Examples
|
||||||
|
|
||||||
The following workflow updates the Docker Hub repository description whenever there are changes to `README.md` and the workflow file itself on the `master` branch. This workflow assumes its location to be `.github/workflows/dockerhub-description.yml`.
|
The following workflow updates the Docker Hub repository description whenever there are changes to `README.md` and the workflow file itself on the `master` branch. This workflow assumes its location to be `.github/workflows/dockerhub-description.yml`.
|
||||||
|
|
||||||
|
@ -57,12 +60,13 @@ jobs:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Docker Hub Description
|
- name: Docker Hub Description
|
||||||
uses: peter-evans/dockerhub-description@v2
|
uses: peter-evans/dockerhub-description@v2
|
||||||
env:
|
with:
|
||||||
DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
|
username: ${{ secrets.DOCKERHUB_USERNAME }}
|
||||||
DOCKERHUB_PASSWORD: ${{ secrets.DOCKERHUB_PASSWORD }}
|
password: ${{ secrets.DOCKERHUB_PASSWORD }}
|
||||||
DOCKERHUB_REPOSITORY: peterevans/dockerhub-description
|
repository: peterevans/dockerhub-description
|
||||||
```
|
```
|
||||||
|
|
||||||
Updates the Docker Hub repository description whenever a new release is created.
|
Updates the Docker Hub repository description whenever a new release is created.
|
||||||
|
@ -75,12 +79,13 @@ jobs:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v2
|
||||||
|
|
||||||
- name: Docker Hub Description
|
- name: Docker Hub Description
|
||||||
uses: peter-evans/dockerhub-description@v2
|
uses: peter-evans/dockerhub-description@v2
|
||||||
env:
|
with:
|
||||||
DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
|
username: ${{ secrets.DOCKERHUB_USERNAME }}
|
||||||
DOCKERHUB_PASSWORD: ${{ secrets.DOCKERHUB_PASSWORD }}
|
password: ${{ secrets.DOCKERHUB_PASSWORD }}
|
||||||
DOCKERHUB_REPOSITORY: peterevans/dockerhub-description
|
repository: peterevans/dockerhub-description
|
||||||
```
|
```
|
||||||
|
|
||||||
## Using the Docker image independently of GitHub Actions
|
## Using the Docker image independently of GitHub Actions
|
||||||
|
@ -94,7 +99,7 @@ docker run -v $PWD:/workspace \
|
||||||
-e DOCKERHUB_PASSWORD='xxxxx' \
|
-e DOCKERHUB_PASSWORD='xxxxx' \
|
||||||
-e DOCKERHUB_REPOSITORY='user1/my-docker-image' \
|
-e DOCKERHUB_REPOSITORY='user1/my-docker-image' \
|
||||||
-e README_FILEPATH='/workspace/README.md' \
|
-e README_FILEPATH='/workspace/README.md' \
|
||||||
peterevans/dockerhub-description:2.3
|
peterevans/dockerhub-description:2
|
||||||
```
|
```
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
Loading…
Reference in a new issue