docker-push-action/README.md

Table of Contents

• Docker Push Action
• Tag Logic
• Usage
• Inputs
• Outputs

Docker Push Action

A composite action to tag and push Docker images based on git context.

Tag Logic

Event	Condition	Tags Pushed
push	Tag v*.*.*	latest, <version> (without v prefix)
push	Branch main	latest
push	Branch develop	develop
pull_request	Any	pr<number>

Usage

- name: Load Docker image
  run: docker load < my-image.tar.gz

- name: Push Docker tags
  uses: https://labs.phundrak.com/phundrak/docker-push-action@v1
  with:
    registry: labs.phundrak.com
    registry-username: ${{ secrets.DOCKER_USERNAME }}
    registry-password: ${{ secrets.DOCKER_PASSWORD }}
    image-name: phundrak/my-app
    local-image: my-app:latest
    event-name: ${{ github.event_name }}
    ref: ${{ github.ref }}
    ref-type: ${{ github.ref_type }}
    ref-name: ${{ github.ref_name }}
    pr-number: ${{ github.event.pull_request.number }}

Inputs

Input	Required	Description
registry	Yes	Docker registry URL
registry-username	Yes	Docker registry username
registry-password	Yes	Docker registry password
image-name	Yes	Full image name (e.g., phundrak/my-app)
local-image	Yes	Local image to tag and push
event-name	Yes	Pass ${{ github.event_name }}
ref	Yes	Pass ${{ github.ref }}
ref-type	Yes	Pass ${{ github.ref_type }}
ref-name	Yes	Pass ${{ github.ref_name }}
pr-number	No	Pass ${{ github.event.pull_request.number }}

Outputs

Output	Description
pushed-tags	Space-separated list of tags that were pushed