Skip to content
Johannes Klein edited this page Mar 31, 2025 · 7 revisions

The PullPreview action allows various options to be specified in the with section of the workflow:

app_path:
  description: "The path to your application containing a docker-compose file"
  default: "/github/workspace"
  required: false
always_on:
  description: "List of always-on branches, irrespective of whether they correspond to an open Pull Request, comma-separated"
  default: ""
dns:
  description: "Which DNS suffix to use"
  default: "my.preview.run"
max_domain_length:
  description: "Maximum length of fully qualified domain name. Note that it cannot be greater than 62 characters due to LetsEncrypt restrictions."
  default: "62"
label:
  description: "Label to use for triggering preview deployments"
  default: "pullpreview"
github_token:
  description: "The GitHub access token used to perform GitHub API operations. A custom token is only required for auto-cleanup of GitHub environment objects."
  default: "${{ github.token }}"
admins:
  description: "Logins of GitHub users that will have their SSH key installed on the instance, comma-separated"
  required: false
  default: "@collaborators/push"
ports:
  description: "Ports to open for external access on the preview server (port 22 is always open), comma-separated"
  required: false
  default: "80/tcp,443/tcp"
cidrs:
  description: "The IP address, or range of IP addresses in CIDR notation, that are allowed to connect to the instance"
  required: false
  default: "0.0.0.0/0"
default_port:
  description: "The port to use when building the preview URL"
  required: false
  default: "80"
compose_files:
  description: "Compose files to use when running docker-compose up, comma-separated"
  required: false
  default: "docker-compose.yml"
compose_options:
  description: "Additional options to pass to docker-compose up, comma-separated"
  required: false
  default: "--build"
license:
  description: "PullPreview license"
  required: false
  default: ""
instance_type:
  description: "Instance type to use"
  required: false
  default: "small"
deployment_variant:
  description: "Deployment variant, which allows launching multiple deployments per PR (4 chars max)"
  required: false
  default: ""
provider:
  description: "Cloud provider to use: lightsail"
  required: false
  default: "lightsail"
registries:
  description: "Names of private registries to authenticate against. E.g. docker://username:password@ghcr.io"
  required: false
  default: ""
pre_script:
  description: "Path to a bash script to run on the instance, before calling docker compose, relative to the app_path"
  required: false
  default: ""
ttl:
  description: "Maximum time to live for deployments (e.g. 10h, 5d, infinite)"
  required: false
  default: "infinite"
Clone this wiki locally