zad-actions

ZAD Actions

Reusable GitHub Actions for deploying to ZAD (Zelfservice voor Applicatie Deployment).

Available Actions

Action	Description
deploy	Deploy a container image to ZAD
cleanup	Remove a ZAD deployment and optionally clean up GitHub resources
scheduled-cleanup	Periodically find and clean up stale PR environments

Quick Start

Deploy

- name: Deploy to ZAD
  uses: RijksICTGilde/zad-actions/deploy@v3
  with:
    api-key: ${{ secrets.ZAD_API_KEY }}
    project-id: my-project
    deployment-name: my-deployment
    component: web
    image: ghcr.io/org/app:latest

Deploy (Multi-Component)

- name: Deploy to ZAD
  uses: RijksICTGilde/zad-actions/deploy@v3
  with:
    api-key: ${{ secrets.ZAD_API_KEY }}
    project-id: my-project
    deployment-name: my-deployment
    components: |
      [
        {"name": "web", "image": "ghcr.io/org/web:latest"},
        {"name": "api", "image": "ghcr.io/org/api:latest"}
      ]

Cleanup

- name: Cleanup ZAD deployment
  uses: RijksICTGilde/zad-actions/cleanup@v3
  with:
    api-key: ${{ secrets.ZAD_API_KEY }}
    project-id: my-project
    deployment-name: my-deployment
    delete-github-env: true
    delete-github-deployments: true
    delete-container: true
    container-org: my-org
    container-name: my-app
    container-tag: pr-123
    github-token: ${{ secrets.GITHUB_TOKEN }}
    github-admin-token: ${{ secrets.GITHUB_ADMIN_TOKEN }}

Cleanup (Multi-Container)

- name: Cleanup ZAD deployment
  uses: RijksICTGilde/zad-actions/cleanup@v3
  with:
    api-key: ${{ secrets.ZAD_API_KEY }}
    project-id: my-project
    deployment-name: my-deployment
    delete-container: true
    containers: |
      [
        {"org": "my-org", "name": "frontend", "tag": "pr-123"},
        {"org": "my-org", "name": "api", "tag": "pr-123"}
      ]

Scheduled Cleanup

name: Cleanup Stale Environments
on:
  schedule:
    - cron: '0 2 * * 1'
concurrency:
  group: scheduled-cleanup
  cancel-in-progress: false
jobs:
  cleanup:
    runs-on: ubuntu-latest
    permissions:
      deployments: write
      packages: write
      pull-requests: read
    steps:
      - uses: RijksICTGilde/zad-actions/scheduled-cleanup@v3
        with:
          api-key: ${{ secrets.ZAD_API_KEY }}
          project-id: my-project
          github-admin-token: ${{ secrets.GITHUB_ADMIN_TOKEN }}

Authentication

ZAD API Key

Create a ZAD API key via the Operations Manager and store it as ZAD_API_KEY in your repository secrets.

GitHub Tokens

For cleanup operations, different tokens are needed depending on what you want to clean up:

Operation	Required Token	Permissions
Delete GitHub deployments	github-token	deployments: write
Delete GitHub environment	github-admin-token	Repository admin access
Delete container image	github-token	packages: delete

The github-admin-token requires a personal access token (PAT) or GitHub App token with admin permissions on the repository. The default GITHUB_TOKEN does not have sufficient permissions to delete environments.

Complete Workflow Example

Here's a complete example of a PR preview deployment workflow:

name: Deploy

on:
  pull_request:
    types: [opened, synchronize, reopened, closed]
  push:
    branches: [main]

env:
  REGISTRY: ghcr.io
  IMAGE_NAME: ${{ github.repository }}

jobs:
  build:
    if: github.event.action != 'closed'
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: write
    outputs:
      image-tag: ${{ steps.meta.outputs.tags }}
    steps:
      - uses: actions/checkout@v4

      - name: Log in to GHCR
        uses: docker/login-action@v3
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Build and push
        uses: docker/build-push-action@v6
        with:
          context: .
          push: true
          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:pr-${{ github.event.number }}