initial commit

README.md

@@ -0,0 +1,58 @@
+---
+gitea: none
+include_toc: true
+---
+
+# 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
+```yaml
+- 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 |