# 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