lucas-labs/ploy
Gitea Action for automated Windows release preparation and deployment
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Maintainedlast commit Nov 11, 2025
- License
- None
Pinned Snippet
uses: lucas-labs/ploy@de924ecaadbdcce9596113c382862f6147955f47 # v0.0.4tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| app_name | Logical name of the application | yes | — |
| deploy_root | Root path where releases are stored | yes | — |
| repo_path | Path to the repository (defaults to current working directory) | no | ${{ github.workspace }} |
| mode | Deployment mode | no | default |
| install_cmds | Script to install dependencies (e.g., "npm install", "bun install"). Also supports multiline format. | no | — |
| build_cmds | Script to build the application (e.g., "npm run build", "bun run build"). Also supports multiline format. | no | — |
| dist_dir | Relative path to the directory containing built files to be deployed | no | — |
| pre_deploy_cmds | Script to run in the release directory before activation. Supports: single command string, JSON array ["cmd1", "cmd2"], or multiline script (one command per line). | no | — |
| post_deploy_cmds | Script to run in the release directory after activation. Supports: single command string, JSON array ["cmd1", "cmd2"], or multiline script (one command per line). | no | — |
| healthcheck_url | URL to perform a health check after deployment | no | — |
| expected_healthcheck_code_range | Acceptable HTTP status code range for health check (e.g., "200-299") | no | 200-299 |
| healthcheck_timeout | Timeout in seconds for the health check HTTP request | no | 30 |
| healthcheck_retries | Number of retries for the health check HTTP request | no | 3 |
| healthcheck_delay | Delay in seconds before performing the health check after deployment | no | 5 |
| healthcheck_interval | Interval in seconds between health check retries | no | 5 |
| current_junction_name | Name of the junction (symlink) pointing to the current release | no | current |
Outputs
| name | description |
|---|---|
| release_path | Absolute path to the new release directory |
| release_id | The release identifier (timestamp-sha format) |
| previous_release | Path to the previous release (if any) |
| deployment_time | ISO 8601 timestamp of when the deployment completed |
| healthcheck_status | Final status of the health check (passed or failed) |
| healthcheck_code | HTTP status code returned by the health check |
| healthcheck_attempts | Number of health check attempts made |
| current_junction | Path to the current junction |