exec
) from either the console or the CLI. This can be used for troubleshooting any issues with the replica.
To connect using the console, click the Connect
link from a workload. Select the location, container, replica, and command. Click Connect
to execute the command. By default, the bash
shell will be executed.
To connect using the CLI, review the workload connect subcommand.
debug
is active and the header x-cpln-debug: true
is in the request.Options
.Debug
switch to on
.Save
.x-cpln-debug: true
is in the request:
x-cpln-location
: Location of the responding replica.x-cpln-replica
: Name of the responding replica.cpln.app
.
$workloadName-$gvcAlias.cpln.app
$workloadName-$gvcAlias.$orgEndpointPrefix.cpln.app
$workloadName-$gvcAlias.$locationName.controlplane.us
$workloadName-$gvcAlias-$replicaIndex.$locationName.controlplane.us
Example: stateful-workload-name-cry3tqvce07s4-0.aws-us-west-2.controlplane.us
replicaDirect
enabled, you may also use the replica-direct endpoint
$workloadName.$gvcName.cpln.local:$port
replica-$replicaIndex.$workloadName.$locationName.$gvcName.cpln.local:$port
foo
and bar
.foo
is running on port 4020.bar
is running on port 4030.foo
can access bar
using the URL http://bar:4030. This URL combines the name of the destination container bar
and its assigned port 4030, enabling direct communication between the two containers.
This method ensures efficient and organized networking within a multi-container workload environment.
Variable Name | Description | Format |
---|---|---|
CPLN_GLOBAL_ENDPOINT | The canonical Host header that the container will receive requests on | ${\workloadName}-${gvcAlias}.cpln.app |
CPLN_GVC | The Global Virtual Cloud (/reference/gvc) the container is running under | string |
CPLN_GVC_ALIAS | The Global Virtual Cloud Alias | 13 digit alphanumeric value |
CPLN_LOCATION | The location the container is serving the request from | aws-us-west-2, azure-eastus2, gcp-us-east1, etc. |
CPLN_NAMESPACE | The namespace of the container | Generated random string (e.g., aenhg2ec6pywt) |
CPLN_PROVIDER | The cloud provider the container is serving the request from | aws, azure, gcp, etc. |
CPLN_ORG | The org the container is running under | string |
CPLN_WORKLOAD | The workload the container is running under | string |
CPLN_WORKLOAD_VERSION | The Control Plane version of the Workload, only updated when needed to apply changes. For example, changing scaling settings will not cause this to change. | numeric |
CPLN_TOKEN | A token used to authenticate to the Control Plane CLI / API | Random authorization token |
CPLN_IMAGE | The image as defined for this container in the Control Plane api | string |
curl ${CPLN_ENDPOINT}/org/${CPLN_ORG} -H "Authorization: ${CPLN_TOKEN}"
cpln org get ${CPLN_ORG}
403 Forbidden
response will be returned. **GET
its parent Org.Date
Location
Container
Explore on Grafana
link within the console.
Refer to the logs page for additional details.
100%
is recommended.
OrderedReady
(Updates workloads in a rolling fashion, taking down old ones and bringing up new ones incrementally, ensuring that the service remains available during the update.), Parallel
(Causes all pods affected by a scaling operation to be created or destroyed simultaneously. This does not affect update operations.). Default: OrderedReady
.
2
.
[connect-failure,refused-stream,unavailable,cancelled,resource-exhausted,retriable-status-codes]
Stop
from the Actions menu.
Start
from the actions menu.
cpln-mounter
for the workload within the metrics page.
Loading
Healthy
Unhealthy
Deleting
Unknown