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.
| Property | Type | Description |
|---|---|---|
| apiVersion | string | API schema version. Must be lowops.manifests.v1. |
| kind | string | Resource kind. Must be PrivateIngress. |
| metadata | map | Free-form key/value labels. The engine reads reserved keys (for example name, project) to resolve the identity of this manifest and its parent Project. |
| spec | Spec | Desired 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).
| Property | Type | Description |
|---|---|---|
| description | string | Optional free text. AI assistants use it as context. The engine does not use it otherwise. |
| authorizationDatabase | string | NOT YET IMPLEMENTED. The engine ignores this field, and PrivateIngress provisions no authorization services. It will name a sibling Database manifest for authorization policies. |
| region | string | Preferred GCP region. If empty, it inherits the region of the parent Project. The resolved value is in computed.region. |
| config | Config | NOT YET IMPLEMENTED. The engine ignores this block. See Config. |
| authorizedProjects | list of SourceProjectReference | Projects that can reach this ingress. The engine registers each one as a Private Service Connect (hub-and-spoke) spoke. See SourceProjectReference. |
| domain | string | Optional 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.
| Property | Type | Description |
|---|---|---|
| timeoutSec | int64 | Backend response timeout in seconds. |
| connectionDrainingTimeoutSec | int64 | Connection-draining timeout in seconds. |
| customRequestHeaders | list of string | Custom headers to add to requests to backends. |
| customResponseHeaders | list of string | Custom headers to add to responses to clients. |
| loadBalancing | LoadBalancing | NOT 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.
| Property | Type | Description |
|---|---|---|
| balancingMode | string | Load-balancing algorithm: UTILIZATION, RATE, or CONNECTION. |
| capacityScaler | double | Scales the advertised backend-service capacity, from 0.0 to 1.0. |
| description | string | Optional free text. The engine does not read it. |
| maxConnections | int64 | Maximum concurrent connections per instance. |
| maxRate | int64 | Maximum requests per second per instance. |
| maxUtilization | double | Target 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.
| Property | Type | Description |
|---|---|---|
| name | string | metadata.name of the Project manifest. |
| environment | string | metadata.name of the parent Environment manifest of the project. Default: the current Environment. |
| organizationalUnit | string | metadata.name of the parent OrganizationalUnit manifest of the environment. Default: the current OrganizationalUnit. |