Render Blueprints
Blueprints are Render’s infrastructure-as-code model for defining, deploying, and managing multiple resources with a single YAML file
| Type | object |
|---|---|
| File match |
**/*render.yaml
|
| Schema URL | https://catalog.lintel.tools/schemas/schemastore/render-blueprints/latest.json |
| Source | https://render.com/schema/render.yaml.json |
Validate with Lintel
npx @lintel/lintel checkA JSON schema for render.yaml files. See https://render.com/docs/blueprint-spec for more information
All of
Definitions
Sets the automatic deploy behavior for a Git-based service.
File paths in the service's repo to include or ignore when determining whether to trigger an automatic build. Especially useful for monorepos.
File paths to include when determining whether to trigger a build. Uses glob syntax.
File paths to ignore when determining whether to trigger a build, even if they match a path in 'paths'. Uses glob syntax.
The disk size in GB. Must be either 1 or a multiple of 5.
Storage Autoscaling configuration for the database.
A cron job service that runs on a schedule.
The type of service. Must be 'cron' for cron jobs.
The service's name. Must be unique within the Blueprint.
The runtime environment for the service.
The schedule for running the cron job, as a cron expression.
The geographic region where the service or database will be deployed.
The instance type for the service or database.
The command that Render runs to build your service.
The command that Render runs to start your service.
The command to run when starting the Docker-based service. If omitted, uses the CMD defined in the Dockerfile.
The path to the service's Dockerfile, relative to the repo root.
The path to the service's Docker build context, relative to the repo root.
Registry credentials for accessing private Docker images.
1 nested properties
Reference to registry credentials configured in your workspace.
1 nested properties
The name of the registry credential configured in your workspace.
The URL of the GitHub/GitLab repo to use. If omitted, uses the repo containing the render.yaml file.
The branch of the linked repo to use. If omitted, uses the repo's default branch.
Configuration for pulling a prebuilt Docker image from a registry.
2 nested properties
The URL of the Docker image to pull.
Registry credentials for accessing private Docker images.
1 nested properties
Reference to registry credentials configured in your workspace.
Environment variables for the service.
File paths in the service's repo to include or ignore when determining whether to trigger an automatic build. Especially useful for monorepos.
2 nested properties
File paths to include when determining whether to trigger a build. Uses glob syntax.
File paths to ignore when determining whether to trigger a build, even if they match a path in 'paths'. Uses glob syntax.
The service's root directory within its repo. If omitted, uses the repo's root directory.
Whether to automatically deploy the service when the linked branch is updated.
Sets the automatic deploy behavior for a Git-based service.
A PostgreSQL database instance.
The PostgreSQL instance's name. Must be unique within the Blueprint.
The name of your database within the PostgreSQL instance. If omitted, Render automatically generates a name based on the instance name.
The name of the PostgreSQL user to create for your instance. If omitted, Render automatically generates a name based on the instance name.
The geographic region where the service or database will be deployed.
The instance type for the service or database.
Storage Autoscaling configuration for the database.
The instance type for the service or database.
What major version of PostgreSQL the database will use. Please refer to https://render.com/docs/postgresql-upgrading#version-support for which versions may be valid for this owner.
High availability configuration for the database.
1 nested properties
Whether to enable high availability for the database.
List of IP addresses or CIDR blocks that are allowed to access the service externally.
Read replicas for the database instance.
Persistent disk configuration for a service.
The name of the disk.
The path where the disk will be mounted in the service.
The size of the disk in GB. Defaults to 10 if omitted.
An environment containing multiple services and databases.
An environment variable definition.
An environment variable that references a property of a database.
The name of the environment variable.
Reference to a database property.
2 nested properties
The name of the database to reference.
The property of the database to reference (e.g., connectionString, host, port, user, password, database).
An environment variable with a direct value or special configuration.
The name of the environment variable.
The value of the environment variable.
Whether to generate a base64-encoded 256-bit value for this environment variable.
Whether to prompt for a value in the Render Dashboard during Blueprint creation. Set to false for secrets.
The value to use for this environment variable in preview environments.
An environment variable that references a property or environment variable of another service.
The name of the environment variable.
Reference to another service.
4 nested properties
The type of service for environment variable references.
The name of the service to reference.
The property of the service to reference (e.g., host, port, hostport, connectionString).
The environment variable key to reference from the service.
An environment variable that references an environment group.
The name of the environment group to reference.
An environment group containing multiple environment variables.
The name of the environment group.
The environment variables in this group.
HTTP response header configuration for static sites.
The path pattern for which this header should be applied.
The name of the HTTP header.
The value of the HTTP header.
Configuration for pulling a prebuilt Docker image from a registry.
The URL of the Docker image to pull.
Registry credentials for accessing private Docker images.
1 nested properties
Reference to registry credentials configured in your workspace.
1 nested properties
The name of the registry credential configured in your workspace.
A read replica configuration for a database.
The name of the read replica.
List of IP addresses or CIDR blocks that are allowed to access the service externally.
For a manually scaled service, the number of instances to scale the service to.
The instance type for the service or database.
The preview generation mode.
The project's name. Must be unique within the Blueprint.
A list of environments for this project.
Pull request preview configuration for a static site.
The preview generation mode.
Preview environment configuration at the Blueprint level.
The preview generation mode.
The number of days to retain a preview environment that receives no updates.
A Render Key Value (Redis) instance.
The type of service. Should be 'keyvalue' for Key Value instances ('redis' alias is deprecated).
The Key Value instance's name. Must be unique within the Blueprint.
List of IP addresses or CIDR blocks that are allowed to access the service externally.
The geographic region where the service or database will be deployed.
The instance type for the service or database.
The instance type for the service or database.
The Key Value instance's eviction policy for when it reaches its maximum memory limit.
The geographic region where the service or database will be deployed.
Registry credentials for accessing private Docker images.
Reference to registry credentials configured in your workspace.
1 nested properties
The name of the registry credential configured in your workspace.
A list of PostgreSQL databases to manage with the Blueprint.
A list of environment groups to manage with the Blueprint.
A list of non-PostgreSQL services to manage with the Blueprint.
Redirect or rewrite route configuration for static sites.
The type of route rule.
The source path pattern to match.
The destination path for the redirect or rewrite.
The runtime environment for the service.
A web service, private service, or background worker.
The type of service.
The service's name. Must be unique within the Blueprint.
The runtime environment for the service.
The geographic region where the service or database will be deployed.
The instance type for the service or database.
The URL of the GitHub/GitLab repo to use. If omitted, uses the repo containing the render.yaml file.
The branch of the linked repo to use. If omitted, uses the repo's default branch.
Configuration for pulling a prebuilt Docker image from a registry.
2 nested properties
The URL of the Docker image to pull.
Registry credentials for accessing private Docker images.
1 nested properties
Reference to registry credentials configured in your workspace.
The service's root directory within its repo. If omitted, uses the repo's root directory.
The command to run when starting the Docker-based service. If omitted, uses the CMD defined in the Dockerfile.
The path to the service's Docker build context, relative to the repo root.
The path to the service's Dockerfile, relative to the repo root.
For a manually scaled service, the number of instances to scale the service to.
The path of the service's health check endpoint for zero-downtime deploys.
Autoscaling configuration for the service.
4 nested properties
The minimum number of instances for autoscaling.
The maximum number of instances for autoscaling.
The target memory utilization percentage for autoscaling.
The target CPU utilization percentage for autoscaling.
The command that Render runs to build your service.
The command that Render runs to start your service.
Command that runs after the build command but before the start command. Recommended for database migrations.
Registry credentials for accessing private Docker images.
1 nested properties
Reference to registry credentials configured in your workspace.
1 nested properties
The name of the registry credential configured in your workspace.
A custom domain for the service.
A list of custom domains for the service.
Environment variables for the service.
Whether to automatically deploy the service when the linked branch is updated.
Sets the automatic deploy behavior for a Git-based service.
A command to run during the service's first deploy.
Persistent disk configuration for a service.
3 nested properties
The name of the disk.
The path where the disk will be mounted in the service.
The size of the disk in GB. Defaults to 10 if omitted.
File paths in the service's repo to include or ignore when determining whether to trigger an automatic build. Especially useful for monorepos.
2 nested properties
File paths to include when determining whether to trigger a build. Uses glob syntax.
File paths to ignore when determining whether to trigger a build, even if they match a path in 'paths'. Uses glob syntax.
Pull request preview configuration for a service.
Whether to enable pull request previews for the service. Deprecated - use previews.generation instead.
The instance type for the service or database.
The maximum time (in seconds) that Render waits for your application to exit gracefully after sending a SIGTERM signal.
List of IP addresses or CIDR blocks that are allowed to access the service externally.
Controls whether the service's Render-generated subdomain (e.g., myapp.onrender.com) is accessible. When set to 'disabled', all traffic must go through a custom domain. Only applies to web services.
The type of service for environment variable references.
A static site service.
The type of service. Must be 'web' for static sites.
The service's name. Must be unique within the Blueprint.
The runtime for the service. Must be 'static' for static sites.
The command that Render runs to build your static site.
The path to the directory that contains the static files to publish, relative to the repo root.
Pull request preview configuration for a static site.
1 nested properties
The preview generation mode.
Whether to enable pull request previews for the static site. Deprecated - use previews.generation instead.
File paths in the service's repo to include or ignore when determining whether to trigger an automatic build. Especially useful for monorepos.
2 nested properties
File paths to include when determining whether to trigger a build. Uses glob syntax.
File paths to ignore when determining whether to trigger a build, even if they match a path in 'paths'. Uses glob syntax.
HTTP response headers configuration for the static site.
Redirect and rewrite routes configuration for the static site.
Environment variables for the static site build process.
The service's root directory within its repo. If omitted, uses the repo's root directory.
The URL of the GitHub/GitLab repo to use. If omitted, uses the repo containing the render.yaml file.
The branch of the linked repo to use. If omitted, uses the repo's default branch.
A custom domain for the static site.
A list of custom domains for the static site.
Whether to automatically deploy the static site when the linked branch is updated.
Sets the automatic deploy behavior for a Git-based service.
List of IP addresses or CIDR blocks that are allowed to access the service externally.