Fork a Tiger Data database service for testing, development or ephemeral use.

Usage Examples

Minimal Example

- name: Fork Database
  id: fork
  uses: your-org/fork-service@v1
  with:
    project_id: your-project-id
    service_id: your-service-id
    api_key: ${{ secrets.TIGERDATA_API_KEY }}
    forking-strategy: last-snapshot

Fork for Pull Request Testing

Fork a database with automatic cleanup for testing pull requests:

name: Test on Fork
on: pull_request

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Fork Database
        id: fork
        uses: timescale/fork-service@v1
        with:
          project_id: your-project-id
          service_id: your-service-id
          api_key: ${{ secrets.TIGERDATA_API_KEY }}
          forking-strategy: now
          cleanup: true
          name: fork-${{ github.event.pull_request.number }}

      - name: Run tests
        env:
          DATABASE_URL:
            postgresql://tsdbadmin:${{ steps.fork.outputs.initial_password
            }}@${{ steps.fork.outputs.host }}:${{ steps.fork.outputs.port
            }}/tsdb?sslmode=require
        run: npm test

Inputs

Input	Required	Default	Description
project_id	Yes	-	The project ID of your service
service_id	Yes	-	The service ID of your service
api_key	Yes	-	A Tiger Data API key in format publicKey:secretKey
forking-strategy	Yes	-	The forking strategy: now, last-snapshot, or timestamp
timestamp	No	-	Required when using timestamp strategy. Format: 2025-10-01T15:29:00Z
name	No	-	Custom name for the forked service (defaults to parent name with "-fork" suffix)
cpu_millis	No	-	CPU allocation in milli-cores (defaults to parent service allocation)
memory_gbs	No	-	Memory allocation in gigabytes (defaults to parent service allocation)
free	No	-	Whether to create a free tier forked service (defaults to parent service tier)
cleanup	No	false	Whether to delete the fork after the workflow completes

Outputs

Output	Description
service_id	The ID of the forked service
host	The hostname/endpoint of the forked service
port	The port number of the forked service
initial_password	The initial password for the forked service

Forking Strategies

• now: Creates a new snapshot and forks from it (most up-to-date data)
• last-snapshot: Uses the most recent existing snapshot (faster, but may be slightly behind)
• timestamp: Point-in-time recovery from a specific timestamp (requires timestamp input)