meeDamian/sync-readme

Github Action to sync README.md from Github to Docker Hub

Usage

See action.yml

Minimal

If your user-name, and the repo path (slug) are both the same on Github and Docker Hub, and README.md is located at repo's root, it's enough to:

steps:
- uses: actions/checkout@master

- uses: meeDamian/[email protected]
  with:
    pass: ${{ secrets.DOCKER_PASS }}
    description: true

All custom

If everything needs to be specified:

steps:
- uses: actions/checkout@master

- uses: meeDamian/[email protected]
  with:
    user: docker-username
    pass: ${{ secrets.DOCKER_PASS }}
    slug: organization/image-name
    readme: ./docker/description.md
    description: A must-have container, that you can't live without.

NOTE: Add Docker Hub password to "Secrets" section in your repo's settings.

NOTE_1: Docker Hub requires user, and slug to be lowercase. Conversion is done automatically for you, so that Github's meeDamian becomes meedamian when passed to Docker.

NOTE_2: description sets Docker Hub short description to its literal content in all cases, except when it's set to true, when Github repo description is used instead. When skipped, no change is made to Docker Hub description.

NOTE_3: master branch may sometimes be broken, or change behavior. It's highly recommended to always use tags.

License

The scripts and documentation in this project are released under the MIT License