koalaops/Determine Image Tag
Generates consistent image tags for builds and releases. Supports multiple tag formats and handles duplicate prevention.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Oct 20, 2025
- License
- MIT
Pinned Snippet
uses: koalaops/determine-image-tag@d55c821085590f7b0e9210f7de16ba55a9ee0e53 # v1.1.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| service_name | Service name to include in tag (optional) | no | "" |
| custom_tag | Custom tag to use instead of auto-generation | no | "" |
| tag_format | Tag format: 'service-date-branch-counter' (default), 'service-branch-date-counter', 'branch-date-counter', 'branch-date', or 'date-branch'. All formats support underscore aliases (e.g., 'branch_date_counter') | no | service-date-branch-counter |
| max_length | Maximum tag length (default: 63 for Kubernetes compatibility) | no | 63 |
| include_counter | Whether to include counter for duplicate prevention | no | true |
| branch_ref | Git branch reference (defaults to github.ref) | no | "" |
| pull_request_ref | Pull request head ref (defaults to github.event.pull_request.head.ref) | no | "" |
| working_directory | Working directory where the git repository is located | no | . |
| branch_separator | Character to replace special characters in branch names | no | - |
Outputs
| name | description |
|---|---|
| tag | Generated image tag |
| commit_hash | Current commit hash |
| branch | Normalized branch name |