actions/docker-publish-hub

ivuorinen/actions/docker-publish-hub

Docker Publish to Docker Hub

Description

Publishes a Docker image to Docker Hub with enhanced security and reliability features.

Inputs

name	description	required	default
image-name	The name of the Docker image to publish. Defaults to the repository name.	false	""
tags	Comma-separated list of tags for the Docker image.	true	""
platforms	Platforms to publish (comma-separated). Defaults to amd64 and arm64.	false	linux/amd64,linux/arm64
username	Docker Hub username	true	""
password	Docker Hub password or access token	true	""
repository-description	Update Docker Hub repository description	false	""
readme-file	Path to README file to update on Docker Hub	false	README.md
provenance	Enable SLSA provenance generation	false	true
sbom	Generate Software Bill of Materials	false	true
max-retries	Maximum number of retry attempts for publishing	false	3
retry-delay	Delay in seconds between retries	false	10

Outputs

name	description
image-name	Full image name including registry
digest	The digest of the published image
tags	List of published tags
repo-url	Docker Hub repository URL

Runs

This action is a composite action.

Usage

- uses: ivuorinen/actions/docker-publish-hub@main
  with:
    image-name:
    # The name of the Docker image to publish. Defaults to the repository name.
    #
    # Required: false
    # Default: ""

    tags:
    # Comma-separated list of tags for the Docker image.
    #
    # Required: true
    # Default: ""

    platforms:
    # Platforms to publish (comma-separated). Defaults to amd64 and arm64.
    #
    # Required: false
    # Default: linux/amd64,linux/arm64

    username:
    # Docker Hub username
    #
    # Required: true
    # Default: ""

    password:
    # Docker Hub password or access token
    #
    # Required: true
    # Default: ""

    repository-description:
    # Update Docker Hub repository description
    #
    # Required: false
    # Default: ""

    readme-file:
    # Path to README file to update on Docker Hub
    #
    # Required: false
    # Default: README.md

    provenance:
    # Enable SLSA provenance generation
    #
    # Required: false
    # Default: true

    sbom:
    # Generate Software Bill of Materials
    #
    # Required: false
    # Default: true

    max-retries:
    # Maximum number of retry attempts for publishing
    #
    # Required: false
    # Default: 3

    retry-delay:
    # Delay in seconds between retries
    #
    # Required: false
    # Default: 10