Manage allowed network environments
Allowed network environments control which network environments the NodeClaims in a project can use. Network environments are shared across projects, so use this to keep a project on a subset of the networks its Tenant can reach.
The allowlist narrows what the project can already see. A Tenant project only reaches environments lent to its Tenant or shared with every Tenant, whatever the allowlist contains.
Behavior​
The project field is spec.allowedNetworkEnvironments. Each entry has a name that is the exact name of a network environment.
| Value | Effect |
|---|---|
| Unset (field omitted) | All accessible network environments are allowed. This is the default. |
Empty list (allowedNetworkEnvironments: []) | No network environments are allowed. |
| One or more entries | Only the listed network environments are allowed. |
Matching rules:
- Names are case sensitive.
- Wildcards aren't supported. Network environment names can't contain dots, so the
provider.*form used for node types never matches. - The platform rejects a NodeClaim at creation time if it explicitly names a disallowed environment.
- A NodeClaim that names no environment falls back to its provider's default. Defaults the allowlist excludes are skipped.
- The allowlist can't widen what a project sees. A project is offered only environments whose provider one of its allowed node types names, or whose provider owns a Machine assigned to the project's Tenant.
The platform checks the allowlist again for existing NodeClaims, not only new ones.
If you remove an environment that claims already use, those claims fail with the reason NetworkEnvironmentNotAllowed. Their nodes keep running, but the platform stops reconciling those claims.
Move workloads to an allowed environment before you narrow the list.
Changing allowedNetworkEnvironments requires update permission on the project's spec.allowedNetworkEnvironments or spec.* subresource.
Configure allowed network environments​
- UI
- YAML
Select the project in the project selector, then click Project Config.
In the Network Environments section, select Allow only specific network environments.
Add each environment the project can use.
Click .
To lift the restriction, select Allow all network environments.
Edit the project and set spec.allowedNetworkEnvironments:
apiVersion: management.loft.sh/v1
kind: Project
metadata:
name: team-a
spec:
allowedNetworkEnvironments:
- name: team-a-network
- name: shared-gpu-network
This project can use only the team-a-network and shared-gpu-network environments.
To disallow all network environments in a project:
spec:
allowedNetworkEnvironments: []