initial: action/image-build @v1

2026-05-06 08:07:13 -05:00
commit 83ecfc3176
2 changed files with 106 additions and 0 deletions
@@ -0,0 +1,59 @@
+# action/image-build
+
+Composite Gitea Action that builds a container image with buildx and optionally
+runs a smoke test. **Does not push** — pair with `action/image-push` to publish.
+
+Splitting build from push lets a PR workflow run `image-build` (no secrets, no
+side effects) for validation while `main` runs the full build → push → deploy
+chain.
+
+## Usage
+
+```yaml
+- uses: actions/checkout@v4
+- uses: https://code.fritzlab.net/action/image-build@v1
+  with:
+    image: code.fritzlab.net/fritzlab/chrony
+    smoke-test: docker run --rm --entrypoint /usr/sbin/chronyd $IMAGE -v
+```
+
+The image is built and tagged as `<image>:<github.run_number>` in the runner's
+local Docker daemon. Subsequent steps (e.g. `action/image-push`) can reference
+the same tag.
+
+## Inputs
+
+| Name | Required | Default | Description |
+|---|---|---|---|
+| `image` | yes | — | Full image name without tag (e.g. `code.fritzlab.net/fritzlab/chrony`). |
+| `context` | no | `.` | Docker build context. |
+| `build-args` | no | — | Multiline `KEY=VALUE` build args. |
+| `smoke-test` | no | — | Shell command run after build. `$IMAGE` is set to `<image>:<run_number>`. Non-zero exit fails the action. |
+
+## Outputs
+
+| Name | Description |
+|---|---|
+| `tag` | Numeric tag assigned (= `github.run_number`). |
+
+## Smoke test patterns
+
+Override entrypoint for a binary that expects no args:
+
+```yaml
+smoke-test: docker run --rm --entrypoint /usr/sbin/chronyd $IMAGE -v
+```
+
+Run a help command that returns non-zero:
+
+```yaml
+smoke-test: docker run --rm $IMAGE --help || true
+```
+
+Multiple checks chained:
+
+```yaml
+smoke-test: |
+  docker run --rm $IMAGE --version
+  docker run --rm --entrypoint /bin/sh $IMAGE -c 'test -x /usr/local/bin/myapp'
+```