porter.yaml
.
- autoscaling - the autoscaling configuration for the service.
- enabled - whether autoscaling is enabled or not.
- minInstances - the minimum number of instances to run.
- maxInstances - the maximum number of instances to run.
- cpuThresholdPercent - the CPU threshold percentage to trigger autoscaling at.
- memoryThresholdPercent - the memory threshold percentage to trigger autoscaling at.
- domains - the list of custom domains for the service, if the service is exposed publicly.
- name - the name of the domain.
- private - whether the service is private or not.
- serviceMeshEnabled - If ‘true’, enables enhanced communication between your services with improved performance, reliability, and monitoring. Recommended for applications with multiple services that communicate with each other, especially those using gRPC or WebSockets.
- ingressAnnotations - the ingress annotations to apply for the service.
- pathRouting - the list of URL paths to service port mappings, if path-based routing is enabled.
Note that a path must be specified for the default port (set in services.port).
If routing to a port on a different service, the port must be exposed on that service (either as the default port or through a path routing rule).
- path - the URL path.
- port - the port to route to.
- appName - (optional) the name of the application to route to (as it appears in the dashboard). Defaults to the application of the current service.
- serviceName - (optional) the name of the service to route to (as it appears in the dashboard). Defaults to the current service. Must be specified if appName is set.
- pathRoutingConfig - optional configuration options for path-based routing.
- rewriteMode - mode for rewriting URL paths. If the path set in pathRouting is
/api/v1
, thenapi/v1/subpath
will be rewritten as follows:rewrite-all
- (default) rewrite the entire path to the root path —>/
.rewrite-prefix
- rewrite the path for the URL path prefix only —>/subpath
.rewrite-off
- disable path rewriting —>/api/v1/subpath
.
- rewriteMode - mode for rewriting URL paths. If the path set in pathRouting is
- healthCheck - the health check configuration for the service. This will configure both the liveness and readiness checks.
- enabled - whether the health check is enabled or not.
- httpPath - the path to check for the health check.
- timeoutSeconds - the timeout for the health check requests. Minimum value is 1.
- initialDelaySeconds - (optional) the initial delay for sending the health check requests. Minimum value is 0.
- livenessCheck - the liveness check configuration for the service. Cannot be used with healthCheck.
- enabled - whether the liveness check is enabled or not.
- httpPath - the path to check for the liveness check.
- timeoutSeconds - the timeout for the liveness check requests. Minimum value is 1.
- initialDelaySeconds - (optional) the initial delay for sending the liveness check requests. Minimum value is 0.
- readinessCheck - the readiness check configuration for the service. Cannot be used with healthCheck.
- enabled - whether the readiness check is enabled or not.
- httpPath - the path to check for the readiness check.
- timeoutSeconds - the timeout for the readiness check requests. Minimum value is 1.
- initialDelaySeconds - (optional) the initial delay for sending the readiness check requests. Minimum value is 0.
- startupCheck - the startup check configuration for the service. Cannot be used with healthCheck.
- enabled - whether the startup check is enabled or not.
- httpPath - the path to check for the startup check.
- timeoutSeconds - the timeout for the startup check requests. Minimum value is 1.
- initialDelaySeconds - (optional) the initial delay for sending the startup check requests. Minimum value is 0.
autoscaling
object
- optional
All fields are optional.
domains
array
- optional
private
boolean
- optional
ingressAnnotations
object
- optional
pathRouting
array
- optional
pathRoutingConfig
object
- optional
healthCheck
object
- optional
Advanced Health Checks
Advanced health checks allow you to separately configure liveness, readiness, and startup health checks for your service. These cannot be enabled at the same time as the healthCheck field.livenessCheck
object
- optional
readinessCheck
object
- optional
startupCheck
object
- optional