DevOps Actions

Reusable composite actions for Forgejo Actions.

Actions

deploy

Deploy a service via SSH using docker compose.

Inputs

Input	Required	Description
host	yes	Remote host (user@hostname)
remote_dir	yes	Directory on the remote host
ssh_key	yes	SSH private key

Usage

- name: Deploy
  uses: actions/devops/deploy@main
  with:
    ssh_key: ${{ secrets.INFRA_SSH_KEY }}
    host: riblee@infra.lan
    remote_dir: /home/riblee/my-service

---

test

Validate a docker compose file without resolving environment variables.

Inputs

Input	Required	Default	Description
compose_file	no	compose.yaml	Path to the compose file

Usage

- name: Validate compose file
  uses: actions/devops/test@main

With a custom path:

- name: Validate compose file
  uses: actions/devops/test@main
  with:
    compose_file: docker/compose.prod.yaml

Full workflow example

jobs:
  test-compose-file:
    runs-on: docker
    container: docker:29.6.1-dind-alpine3.24
    steps:
      - name: Setup node
        run: apk add --update nodejs npm
      - uses: actions/checkout@v7
      - uses: actions/devops/test@main

  deploy:
    runs-on: docker
    needs: test-compose-file
    steps:
      - uses: actions/checkout@v7
      - uses: actions/devops/deploy@main
        with:
          ssh_key: ${{ secrets.INFRA_SSH_KEY }}
          host: riblee@infra.lan
          remote_dir: /home/riblee/my-service