Skip to content

ezgh hosted-queues clusters create

Create a cluster.

Updated View as Markdown
ezgh hosted-queues clusters create <name> --engine e --engine-version v --instance-type t --storage-size-gib n --subnet s [flags] [--wait]

Create a cluster in a subnet of your VPC. ezgh hosted-queues clusters engine-versions lists the engines (kafka, rabbitmq) and versions. --mode single (the default) is one node; --mode replicated is three that keep serving through the loss of any one, and needs a gp-1 or gs-1 instance type. The subnet needs 2 free addresses, 4 when replicated. The app user’s password is written to a new Secret in the project, which ezgh hosted-queues users get <cluster> app names. RabbitMQ’s new queues are quorum queues unless the app declares another type; Celery 5.5 and later needs task_default_queue_type = “quorum”. It takes minutes: --wait waits until it’s available and prints it.

Part of ezgh hosted-queues clusters.

Examples

ezgh hosted-queues clusters create events --engine kafka --engine-version 4.4 --mode replicated \
  --instance-type gp-1.large --storage-size-gib 100 --subnet sbn_2m9x0a7qpe4k --wait

Flags

Flag Type Default Description
--allowed-source-cidr string, repeatable an IPv4 CIDR that may connect; repeat for more, at most 20 (default the VPC’s ranges)
--deletion-protection boolean refuse deletes until it’s turned off
--description string what it’s for
--engine string kafka or rabbitmq
--engine-version string the engine’s version, from ezgh hosted-queues clusters engine-versions
--instance-type string a gp-1, gs-1 or (single node only) hp-1 instance type
--maintenance-window string when maintenance happens, ddd:HH:MM-ddd:HH:MM UTC, at least 30 minutes
--mode string single or replicated (default single)
--plaintext-port boolean also serve password over plaintext inside the VPC (Kafka 9092, RabbitMQ 5672)
--storage-size-gib int each node’s storage, in GiB (at least 10)
--subnet string the subnet it’s in (sbn_…)
--tag string, repeatable a tag, key=value; repeat for more
--unauthenticated-access string Kafka only: also serve TLS port 9091 with no authentication, readWrite or readOnly
--wait boolean wait until it’s available, and print it then
--wait-timeout duration 10m0s how long --wait waits

This command also takes the global flags.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close