Go to file
2020-10-25 03:25:14 +01:00
__tests__ Add image version output 2020-10-25 02:40:42 +01:00
.github Add workflows 2020-10-25 03:21:51 +01:00
dist Add workflows 2020-10-25 03:21:51 +01:00
src Add workflows 2020-10-25 03:21:51 +01:00
test Initial commit 2020-10-25 02:25:23 +01:00
.dockerignore Initial commit 2020-10-25 02:25:23 +01:00
.editorconfig Initial commit 2020-10-25 02:25:23 +01:00
.gitattributes Initial commit 2020-10-25 02:25:23 +01:00
.gitignore Initial commit 2020-10-25 02:25:23 +01:00
.prettierrc.json Initial commit 2020-10-25 02:25:23 +01:00
action.yml Add workflows 2020-10-25 03:21:51 +01:00
CHANGELOG.md Update CHANGELOG 2020-10-25 03:25:14 +01:00
docker-bake.hcl Initial commit 2020-10-25 02:25:23 +01:00
Dockerfile Add workflows 2020-10-25 03:21:51 +01:00
jest.config.js Initial commit 2020-10-25 02:25:23 +01:00
LICENSE Initial commit 2020-10-25 02:25:23 +01:00
package.json Initial commit 2020-10-25 02:25:23 +01:00
README.md Add workflows 2020-10-25 03:21:51 +01:00
tsconfig.json Initial commit 2020-10-25 02:25:23 +01:00
yarn.lock Initial commit 2020-10-25 02:25:23 +01:00

GitHub release GitHub marketplace Test workflow Codecov Become a sponsor Paypal Donate

About

GitHub Action to extract metadata (tags, labels) for Docker. This action is particularly useful if used with Docker Build Push action.

If you are interested, check out my other :octocat: GitHub Actions!

Screenshot


Features

Usage

Event Ref Commit SHA Docker Tag Pushed
schedule nightly Yes
pull_request refs/pull/2/merge a123b57 sha-a123b57, pr-2 No
push refs/heads/<default_branch> 676cae2 sha-676cae2, edge Yes
push refs/heads/dev cf20257 sha-cf20257, dev Yes
push refs/heads/my/branch a5df687 sha-a5df687, my-branch Yes
push tag refs/tags/v1.2.3 1.2.3, latest Yes
push tag refs/tags/mytag mytag Yes
name: ci

on:
  schedule:
    - cron: '0 10 * * *' # everyday at 10am
  push:
    branches:
      - '**'
    tags:
      - 'v*.*.*'
  pull_request:

jobs:
  docker:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v2
      -
        name: Docker meta
        id: docker_meta
        uses: crazy-max/ghaction-docker-meta@v1
        with:
          images: |
            name/app
            ghcr.io/name/app            
          tag-sha: true
      -
        name: Set up QEMU
        uses: docker/setup-qemu-action@v1
      -
        name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v1
      -
        name: Login to DockerHub
        if: github.event_name != 'pull_request'
        uses: docker/login-action@v1 
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
      -
        name: Build and push
        uses: docker/build-push-action@v2
        with:
          context: .
          file: ./Dockerfile
          platforms: linux/amd64,linux/arm64,linux/386
          push: ${{ github.event_name != 'pull_request' }}
          tags: ${{ steps.docker_meta.outputs.tags }}
          labels: ${{ steps.docker_meta.outputs.labels }}

Customizing

inputs

Following inputs can be used as step.with keys

Name Type Description
images List/CSV List of Docker images to use as base name for tags
tag-sha Bool Add git short SHA as Docker tag (default false)
tag-edge String Branch that will be tagged as edge (default repo.default_branch)
sep-tags String Separator to use for tags output (default \n)
sep-labels String Separator to use for labels output (default \n)

List/CSV type can be a newline or comma delimited string

outputs

Following outputs are available

Name Type Description
version String Generated Docker image version
tags String Generated Docker tags
labels String Generated Docker labels

Keep up-to-date with GitHub Dependabot

Since Dependabot has native GitHub Actions support, to enable it on your GitHub repo all you need to do is add the .github/dependabot.yml file:

version: 2
updates:
  # Maintain dependencies for GitHub Actions
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "daily"

How can I help?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to star 🌟 the project, or to raise issues 💬 You can also support this project by becoming a sponsor on GitHub 👏 or by making a Paypal donation to ensure this journey continues indefinitely! 🚀

Thanks again for your support, it is much appreciated! 🙏

License

MIT. See LICENSE for more details.