Location

Available geographical locations across AWS, GCP, Azure, and OCI that can be enabled or disabled for GVC workload deployment.

Overview

Locations show the available geographical locations for each of the following cloud providers:

• Amazon Web Services (AWS)
• Google Cloud Platform (GCP)
• Microsoft Azure
• Oracle Cloud Infrastructure (OCI)

Locations are scoped to an org, and an org administrator enables or disables the ones a GVC may select.

A new org is seeded with a working subset of the built-in catalog, and every location present in an org starts enabled. Disabling a location removes the workloads running in it; enabling one provisions every workload whose GVC selects it.

If a company is restricted for legal or compliance reasons to only use certain cloud providers, disabling those providers will ensure that workloads will not be deployed to those providers.

Locations

Control Plane can enable any cloud provider location.

If a location is not shown, email [e-mail] with the provider and location and it will be provisioned.

Custom Locations

CPLN BYOK enables you to add new locations by registering your own Kubernetes clusters as locations in the Control Plane platform. For a guide on how to create new BYOK locations and further details, refer to the BYOK documentation.

Built-in Tags

Each location has the following built-in tags:

• cpln/city=VALUE
• cpln/state=VALUE
• cpln/country=VALUE
• cpln/continent=VALUE

These are set from the location’s geographic coordinates, so a GVC can select locations with a query on them instead of naming each one.

Public IPs

The list of public IPs for each cloud provider and region can be obtained.

Console UI

Navigate to the Locations list page from the main navigation bar. Select a location to view the IP ranges listed on the Info page.

CLI

Use the command below to view the IP ranges of all locations.

cpln location get -o json

The output can also be formatted as YAML by using the flag -o yaml instead of -o json.

To view a single location, name it:

cpln location get aws-us-west-2 -o json

See the CLI location command reference for more details.

API

The location list endpoint and location-specific endpoint return the location object with the ipRanges property.

See the Get All Locations API endpoint for details.

The list of IPs may be required by external services that restrict which IPs are allowed to access them.

The IPs may change when underlying infrastructure changes. Control Plane recommends automating location API checks and updating external services’ allowed IP address lists when changes occur.

Permissions

The permissions below are used to define policies together with one or more of the four principal types:

Permission	Description	Implies
create	Create new locations
delete	Delete BYOK locations
edit	Modify existing locations	view
manage	Full access	create, delete, edit, use, view
use	Use this location for workload placement	view
view	Read-only access

Access Report

Displays the permissions granted to principals for the location.

CLI

To view the CLI documentation for locations, see the Location CLI reference.