Sandbox

JSON Schema reference for sandbox configuration

Sandbox

Properties

Property	Description	Values	Example
terraform_version string	Terraform version Version of Terraform to use for deployments	✅ Required	"1.5.0", "1.6.0", "latest"
connected_repo ConnectedRepoConfig	connected repository configuration Configuration for a private repository connected to the Nuon platform	Optional	-
public_repo PublicRepoConfig	public repository configuration Configuration for a public repository accessible without authentication	Optional	-
drift_schedule string	drift detection schedule Cron expression for periodic drift detection. If not set, drift detection is disabled	Optional	"0 2 * * *", "*/10 * * * *"
env_vars object	environment variables Map of environment variables passed to Terraform as key-value pairs	Optional	-
vars object	Terraform variables Map of Terraform input variables as key-value pairs. Supports templating	Optional	-
var_file array	Terraform variable files Array of external Terraform variable files to load. Each file contents support templating and external file sources: HTTP(S) URLs (https://example.com/vars.tfvars), git rep…	Optional	-
operation_roles array	operation-specific IAM role assignments Map of sandbox operations to IAM role names. Allows using different roles for different operations (provision, deprovision, reprovision). Roles must be defin…	Optional	-

connected_repo

Property	Description	Values	Example
repo string	repository identifier Identifier of the connected repository configured in the Nuon platform	✅ Required	"my-repo", "production-infrastructure"
directory string	directory path Path within the repository to the configuration files	✅ Required	"terraform", "infra/terraform"
branch string	Git branch Git branch to checkout and use for deployments	✅ Required	"main", "develop", "production"

public_repo

Property	Description	Values	Example
repo string	repository URL HTTPS URL to the public Git repository	✅ Required	"https://github.com/user/repo.git", "https://github.com/user/terraform-modules.git"
directory string	directory path Path within the repository to the configuration files	✅ Required	"terraform", "infra/terraform"
branch string	Git branch Git branch to checkout and use for deployments	✅ Required	"main", "develop", "production"

var_file

Property	Description	Values	Example
contents string	variable file contents Contents of a Terraform .tfvars file. Supports Nuon templating and external file sources: HTTP(S) URLs (https://example.com/vars.tfvars), git repositories (git::https://githu…	Optional	"./sandbox.tfvars", "./variables/production.tfvars"

operation_roles

Property	Description	Values	Example
operation string	operation type Type of operation: provision, deprovision, update, reprovision, or trigger	✅ Required	"provision", "deploy", "deprovision"
role string	IAM role name Name of the IAM role to use for this operation (not ARN). Role must exist in install stack outputs	✅ Required	"{{.nuon.install.id}}-maintenance", "{{.nuon.install.id}}-provision"