Gitea Actions Podman build and push

README.md

@@ -0,0 +1,54 @@
+# Gitea Actions
+
+Reusable Gitea Actions composite workflows for noctrl infrastructure automation.
+
+## Available Actions
+
+### Podman Build And Publish
+
+Builds and optionally pushes OCI container images to `registry.noctrl.eu` using Podman with isolated storage context.
+
+**Location:** [`./podman-build-publish`](./podman-build-publish)
+
+**Use in workflows:**
+```yaml
+- uses: https://gitea.noctrl.eu/noctrl/actions/podman-build-publish@v1
+  with:
+    image-name: noctrl/myapp
+    tags: |
+      latest
+      sha-${{ github.sha }}
+```
+
+See [podman-build-publish README](./podman-build-publish/README.md) for full documentation.
+
+## Usage
+
+Reference actions by absolute URL in your workflow:
+
+```yaml
+- uses: https://gitea.noctrl.eu/noctrl/actions/<action-name>@<ref>
+```
+
+**Ref Options:**
+- `@v1` — points to tag `v1`
+- `@main` — points to default branch
+- `@commit-sha` — points to specific commit
+
+## Repository Secrets
+
+Actions reference caller repository secrets. Ensure your repository has required secrets defined:
+
+- **REGISTRY_USERNAME** — registry.noctrl.eu authentication username
+- **REGISTRY_PASSWORD** — registry.noctrl.eu authentication password
+
+Set these in repository **Settings** → **Secrets**.
+
+## Contributing
+
+When adding new actions:
+1. Create action directory: `./action-name/`
+2. Include `action.yaml` (composite action definition)
+3. Include `README.md` with inputs, outputs, and usage example
+4. Tag stable versions: `git tag v1`, `git tag v2`, etc.
+5. Update this root README