hubble-ventures/pgroll Action
GitHub Action wrapper for the pgroll CLI - PostgreSQL zero-downtime migrations by Xata
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Jan 25, 2026
- License
- Apache 2.0
Pinned Snippet
uses: hubble-ventures/actions-pgroll@b319216c07909d585e51008947c334a0058b495e # v0.0.1tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| command | pgroll command: init, start, complete, rollback, status, validate, migrate, baseline | yes | — |
| version | pgroll version to install (e.g., "0.16.0" or "latest") | no | latest |
| verify-checksum | Verify binary checksum (recommended for security) | no | true |
| postgres-url | PostgreSQL connection URL | no | — |
| migration-file | Path to migration file (for start, validate) | no | — |
| migrations-dir | Path to migrations directory (for migrate, baseline) | no | — |
| migration-name | Migration name (for baseline) | no | — |
| schema | Target schema | no | public |
| pgroll-schema | Schema name for pgroll internal state | no | pgroll |
| lock-timeout | Lock timeout in milliseconds | no | 500 |
| role | PostgreSQL role for DDL operations | no | — |
| complete | Complete migration after start (for start command) | no | false |
| backfill-batch-size | Number of rows per backfill batch | no | 1000 |
| backfill-batch-delay | Delay between backfill batches (e.g., "100ms", "1s") | no | 0s |
Outputs
| name | description |
|---|---|
| version | Schema version (context-dependent) |
| status | Migration status (for status command) |
| json | Full JSON output (for status command) |
| valid | Validation result (for validate command) |
| errors | Validation errors (for validate command) |
| applied-count | Number of migrations applied (for migrate command) |
| file | Generated file path (for baseline command) |
| pgroll-version | Installed pgroll version |
| pgroll-path | Path to pgroll binary |