Skip to main content

Private Ingress

PrivateIngress​

Defines an internal-only entry point to services.

Creates internal load balancers and network endpoints for private traffic. It gives cross-project connectivity and service discovery in the private VPC, with no public exposure.

PropertyTypeDescription
apiVersionstringAPI schema version. Must be lowops.manifests.v1.
kindstringResource kind. Must be PrivateIngress.
metadatamapFree-form key/value labels. The engine reads reserved keys (for example name, project) to resolve the identity of this manifest and its parent Project.
specSpecDesired private ingress configuration. See Spec.

Spec​

User-defined configuration for the private ingress.

Covers the region, an optional custom internal domain, and the source projects with cross-project access (hub-and-spoke, Private Service Connect).

PropertyTypeDescription
descriptionstringOptional free text. AI assistants use it as context. The engine does not use it otherwise.
authorizationDatabasestringNOT YET IMPLEMENTED. The engine ignores this field, and PrivateIngress provisions no authorization services. It will name a sibling Database manifest for authorization policies.
regionstringPreferred GCP region. If empty, it inherits the region of the parent Project. The resolved value is in computed.region.
configConfigNOT YET IMPLEMENTED. The engine ignores this block. See Config.
authorizedProjectslist of SourceProjectReferenceProjects that can reach this ingress. The engine registers each one as a Private Service Connect (hub-and-spoke) spoke. See SourceProjectReference.
domainstringOptional custom internal domain. It must be a hostname. If set, the engine provisions a managed DNS zone and a managed TLS certificate for it. The operator must point DNS at the IP address of the internal load balancer. If empty, it defaults to {metadata.name}.{project.computed.domain.internal}.

Config​

Advanced backend-service tuning.

NOT YET IMPLEMENTED. The engine ignores this block.

PropertyTypeDescription
timeoutSecint64Backend response timeout in seconds.
connectionDrainingTimeoutSecint64Connection-draining timeout in seconds.
customRequestHeaderslist of stringCustom headers to add to requests to backends.
customResponseHeaderslist of stringCustom headers to add to responses to clients.
loadBalancingLoadBalancingNOT YET IMPLEMENTED. The engine ignores this field. See LoadBalancing.

LoadBalancing​

Load-balancing policy of the backend services.

NOT YET IMPLEMENTED. The engine ignores this block.

PropertyTypeDescription
balancingModestringLoad-balancing algorithm: UTILIZATION, RATE, or CONNECTION.
capacityScalerdoubleScales the advertised backend-service capacity, from 0.0 to 1.0.
descriptionstringOptional free text. The engine does not read it.
maxConnectionsint64Maximum concurrent connections per instance.
maxRateint64Maximum requests per second per instance.
maxUtilizationdoubleTarget CPU utilization (0.0-1.0) for the UTILIZATION mode.

SourceProjectReference​

Fully qualified Project reference.

NOT YET IMPLEMENTED. The engine ignores this message. It will identify a Project by name, environment and organizational_unit, because project names are not unique alone.

PropertyTypeDescription
namestringmetadata.name of the Project manifest.
environmentstringmetadata.name of the parent Environment manifest of the project. Default: the current Environment.
organizationalUnitstringmetadata.name of the parent OrganizationalUnit manifest of the environment. Default: the current OrganizationalUnit.