regions

regions list

Note

The region is specified for each profile in the Configuration file.

The region for specific actions can be overridden using the --region argument to list or deploy resources in that region.

List all available regions.

Usage: croud regions list [-h] [--org-id ORG_ID] [--region REGION]
                          [--output-fmt {table,wide,json,yaml}] [--sudo]

Optional Arguments

--org-id

The organization ID to use.

--region, -r

Temporarily use the specified region that command will be run in.

--output-fmt, --format, -o

Possible choices: table, wide, json, yaml

Change the formatting of the output.

--sudo

Run the given command as superuser.

Default: False

Example

sh$ croud regions list
+-----------------------+---------------------------------------+--------------------------------------+
| name                  | description                           | organization_id                      |
|---------------------------------------+-----------------------|--------------------------------------|
| aks1.eastus2.azure    | Azure East US 2                       |                                      |
| aks1.westeurope.azure | Azure West Europe                     |                                      |
| eks1.eu-west-1.aws    | AWS West Europe (Ireland)             |                                      |
| my-edge-region        | 055be5e4a8f744b9bfac25f507496d16.edge | 70b56aab-2ba1-4378-88b9-5b6123513e47 |
+-----------------------+---------------------------------------+--------------------------------------+

regions create

Warning

An Edge region allows you to host CrateDB instances in your own infrastructure however this feature is not maintained anymore. It is not recommended to use it.

Note

Organization admins can create Edge regions that belong to an organization.

Create a new Edge region.

Usage: croud regions create [-h] [--aws-bucket AWS_BUCKET]
                            [--aws-region AWS_REGION] --description
                            DESCRIPTION --org-id ORG_ID [-y] [--region REGION]
                            [--output-fmt {table,wide,json,yaml}] [--sudo]

Required Arguments

--description

The description of the new region.

--org-id

The organization ID to use.

Optional Arguments

--aws-bucket

The AWS S3 bucket where cluster backups will be stored.

--aws-region

The AWS region where the S3 bucket for cluster backups is expected to be.

-y, --yes

Default: False

--region, -r

Temporarily use the specified region that command will be run in.

--output-fmt, --format, -o

Possible choices: table, wide, json, yaml

Change the formatting of the output.

--sudo

Run the given command as superuser.

Default: False

Example

sh$ croud regions create --org-id 11111111-1111-1111-1111-111111111111 --description "Edge region"
+---------------+---------------------------------------------------+
| description   | name                                              |
|---------------+---------------------------------------------------|
| Edge region   | 2c0d0e22b0e846b2a7acdcbf092e54a3.edge.cratedb.net |
+---------------+---------------------------------------------------+
==> Success: You have successfully created a region.

To install the edge region run the following command:

$ bash <( wget -qO- https://console.cratedb.cloud/edge/cratedb-cloud-edge.sh) <install-token>

regions delete

Warning

Edge regions allow you to host CrateDB instances in your own infrastructure however this feature is not maintained anymore. It is not recommended to use it.

Note

Only organization admins can delete Edge regions that belong to their organizations. Deleting a region does not imply that all the Kubernetes resources will be automatically deleted. This command only unregisters the region from Crate Cloud.

Delete an existing Edge region.

Usage: croud regions delete [-h] --name NAME [-y] [--region REGION]
                            [--output-fmt {table,wide,json,yaml}] [--sudo]

Required Arguments

--name

The name of the region that will be deleted.

Optional Arguments

-y, --yes

Default: False

--region, -r

Temporarily use the specified region that command will be run in.

--output-fmt, --format, -o

Possible choices: table, wide, json, yaml

Change the formatting of the output.

--sudo

Run the given command as superuser.

Default: False

Example

sh$ croud regions delete --name 2c0d0e22b0e846b2a7acdcbf092e54a3.edge.cratedb.net
==> Success: You have successfully deleted a region.