stratumctl asg
Auto Scaling Groups + Launch Templates
stratumctl asg [flags]Subcommands
Section titled “Subcommands”stratumctl asg groups: Auto scaling groupsstratumctl asg hooks: Lifecycle hooks: pause launches or terminations until answeredstratumctl asg launch-templates: Launch templates: versioned instance blueprintsstratumctl asg policies: Scaling policies: target-tracking, step, scheduledstratumctl asg refresh: Instance refreshes: roll a group to a launch-template version
stratumctl asg groups
Section titled “stratumctl asg groups”Auto scaling groups
stratumctl asg groups [flags]Aliases: group
Subcommands
Section titled “Subcommands”stratumctl asg groups attach: Attach existing instances (desired grows by the count)stratumctl asg groups create: Create an auto scaling groupstratumctl asg groups delete: Delete a group (its instances drain and terminate; the group disappears when done)stratumctl asg groups describe: Describe an auto scaling groupstratumctl asg groups detach: Detach members (they keep running; a replacement launches unless –decrement)stratumctl asg groups instances: List a group’s member instancesstratumctl asg groups list: List auto scaling groupsstratumctl asg groups protect: Protect members from scale-in (–off to clear)stratumctl asg groups resume: Resume suspended scaling processesstratumctl asg groups set-desired: Set the desired size now (bypasses cooldown)stratumctl asg groups suspend: Suspend scaling processes (Launch, Terminate, HealthCheck, ReplaceUnhealthy, AZRebalance, AlarmNotification, ScheduledActions, AddToLoadBalancer, InstanceRefresh)stratumctl asg groups update: Update an auto scaling group (only the flags given change)
stratumctl asg groups attach
Section titled “stratumctl asg groups attach”Attach existing instances (desired grows by the count)
stratumctl asg groups attach <asg-id> <instance-id>... [flags]Examples
Section titled “Examples”stratumctl asg groups attach asg-3k8m2x7q9a i-uy3ureaklqstratumctl asg groups attach asg-3k8m2x7q9a i-uy3ureaklq i-5mq8x2ab4k| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups create
Section titled “stratumctl asg groups create”Create an auto scaling group
stratumctl asg groups create <name> [flags]Examples
Section titled “Examples”stratumctl asg groups create web --launch-template lt-4k8m2x7q9a --min 2 --max 6 --subnet subnet-3k8m2x7qstratumctl asg groups create web --launch-template lt-4k8m2x7q9a --min 2 --max 6 --desired 3 --subnet subnet-3k8m2x7q --subnet subnet-6k2m8x4q \ --create-lb --lb-port 8080| Flag | Type | Default | Description |
|---|---|---|---|
--cooldown |
int | -1 |
Default cooldown in seconds (policy-driven changes) |
--create-lb |
bool | false |
Own the front door: the service creates a target group, a load balancer and a listener for the group |
--description |
string | Description | |
--desired |
int | -1 |
Desired size (default min) |
--grace |
int | -1 |
Health-check grace period in seconds |
--health-check |
string | instance | load_balancer | |
--launch-template |
string | Launch template id | |
--launch-template-version |
string | $LATEST | $DEFAULT | ltv-… (default $LATEST) | |
--lb-certificate |
string | SSL certificate id (cert-…) of this project: makes the listener HTTPS, terminated with it; a change replaces the listener | |
--lb-health-path |
string | HTTP health-check path on the members (default: the load balancer’s) | |
--lb-listener-port |
int | 0 |
The listener’s port (default: –lb-port; 443 with –lb-certificate) |
--lb-port |
int | 0 |
The port the members serve on (default 80) |
--lb-protocol |
string | HTTP | HTTPS | TCP (default HTTP) | |
--lb-scheme |
string | internet-facing | internal (default internet-facing) | |
--max |
int | 0 |
Maximum size |
--min |
int | 0 |
Minimum size |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--subnet |
stringArray | Subnet id, one VPC (repeatable) | |
--tag |
stringArray | Tag key=value (repeatable) | |
--target-group |
stringArray | Load-balancer target group id (repeatable) | |
--termination-policy |
stringArray | OldestInstance | NewestInstance | OldestLaunchTemplate | ClosestToNextInstanceHour | Default (repeatable, ordered) |
stratumctl asg groups delete
Section titled “stratumctl asg groups delete”Delete a group (its instances drain and terminate; the group disappears when done)
stratumctl asg groups delete <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg groups delete asg-3k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups describe
Section titled “stratumctl asg groups describe”Describe an auto scaling group
stratumctl asg groups describe <asg-id> [flags]Aliases: get
Examples
Section titled “Examples”stratumctl asg groups describe asg-3k8m2x7q9astratumctl asg groups describe asg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups detach
Section titled “stratumctl asg groups detach”Detach members (they keep running; a replacement launches unless –decrement)
stratumctl asg groups detach <asg-id> <instance-id>... [flags]Examples
Section titled “Examples”stratumctl asg groups detach asg-3k8m2x7q9a i-uy3ureaklqstratumctl asg groups detach asg-3k8m2x7q9a i-uy3ureaklq --decrement| Flag | Type | Default | Description |
|---|---|---|---|
--decrement |
bool | false |
Shrink desired size instead of launching replacements |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups instances
Section titled “stratumctl asg groups instances”List a group’s member instances
stratumctl asg groups instances <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg groups instances asg-3k8m2x7q9astratumctl asg groups instances asg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups list
Section titled “stratumctl asg groups list”List auto scaling groups
stratumctl asg groups list [flags]Examples
Section titled “Examples”stratumctl asg groups liststratumctl asg groups list --limit 20 --output json| Flag | Type | Default | Description |
|---|---|---|---|
--limit |
int | 0 |
Page size; setting it (or –page-token) returns one page and prints the next token instead of listing everything |
--page-token |
string | Cursor from a previous page; returns that one page | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups protect
Section titled “stratumctl asg groups protect”Protect members from scale-in (–off to clear)
stratumctl asg groups protect <asg-id> <instance-id>... [flags]Examples
Section titled “Examples”stratumctl asg groups protect asg-3k8m2x7q9a i-uy3ureaklqstratumctl asg groups protect asg-3k8m2x7q9a i-uy3ureaklq --off| Flag | Type | Default | Description |
|---|---|---|---|
--off |
bool | false |
Remove the protection |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups resume
Section titled “stratumctl asg groups resume”Resume suspended scaling processes
stratumctl asg groups resume <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg groups resume asg-3k8m2x7q9astratumctl asg groups resume asg-3k8m2x7q9a --process Launch --process Terminate| Flag | Type | Default | Description |
|---|---|---|---|
--process |
stringArray | Process name (repeatable; omit for all) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups set-desired
Section titled “stratumctl asg groups set-desired”Set the desired size now (bypasses cooldown)
stratumctl asg groups set-desired <asg-id> <n> [flags]Examples
Section titled “Examples”stratumctl asg groups set-desired asg-3k8m2x7q9a 4| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups suspend
Section titled “stratumctl asg groups suspend”Suspend scaling processes (Launch, Terminate, HealthCheck, ReplaceUnhealthy, AZRebalance, AlarmNotification, ScheduledActions, AddToLoadBalancer, InstanceRefresh)
stratumctl asg groups suspend <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg groups suspend asg-3k8m2x7q9astratumctl asg groups suspend asg-3k8m2x7q9a --process Launch --process Terminate| Flag | Type | Default | Description |
|---|---|---|---|
--process |
stringArray | Process name (repeatable; omit for all) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg groups update
Section titled “stratumctl asg groups update”Update an auto scaling group (only the flags given change)
stratumctl asg groups update <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg groups update asg-3k8m2x7q9a --min 3 --max 10stratumctl asg groups update asg-3k8m2x7q9a --launch-template lt-4k8m2x7q9a --launch-template-version '$LATEST'| Flag | Type | Default | Description |
|---|---|---|---|
--cooldown |
int | -1 |
Default cooldown in seconds (policy-driven changes) |
--create-lb |
bool | false |
Own the front door: the service creates a target group, a load balancer and a listener for the group |
--description |
string | Description | |
--desired |
int | -1 |
Desired size (default min) |
--grace |
int | -1 |
Health-check grace period in seconds |
--health-check |
string | instance | load_balancer | |
--launch-template |
string | Launch template id | |
--launch-template-version |
string | $LATEST | $DEFAULT | ltv-… (default $LATEST) | |
--lb-certificate |
string | SSL certificate id (cert-…) of this project: makes the listener HTTPS, terminated with it; a change replaces the listener | |
--lb-health-path |
string | HTTP health-check path on the members (default: the load balancer’s) | |
--lb-listener-port |
int | 0 |
The listener’s port (default: –lb-port; 443 with –lb-certificate) |
--lb-port |
int | 0 |
The port the members serve on (default 80) |
--lb-protocol |
string | HTTP | HTTPS | TCP (default HTTP) | |
--lb-scheme |
string | internet-facing | internal (default internet-facing) | |
--max |
int | 0 |
Maximum size |
--min |
int | 0 |
Minimum size |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--remove-lb |
bool | false |
Tear the owned front door down (the group keeps running) |
--subnet |
stringArray | Subnet id, one VPC (repeatable) | |
--tag |
stringArray | Tag key=value (repeatable) | |
--target-group |
stringArray | Load-balancer target group id (repeatable) | |
--termination-policy |
stringArray | OldestInstance | NewestInstance | OldestLaunchTemplate | ClosestToNextInstanceHour | Default (repeatable, ordered) |
stratumctl asg hooks
Section titled “stratumctl asg hooks”Lifecycle hooks: pause launches or terminations until answered
stratumctl asg hooks [flags]Aliases: hook
Subcommands
Section titled “Subcommands”stratumctl asg hooks complete: Complete a lifecycle action for an instance the hook holds (CONTINUE | ABANDON)stratumctl asg hooks delete: Delete a lifecycle hook (held instances continue)stratumctl asg hooks describe: Describe a lifecycle hookstratumctl asg hooks heartbeat: Extend the wait for an instance the hook holdsstratumctl asg hooks list: List a group’s lifecycle hooksstratumctl asg hooks put: Create or replace a lifecycle hook
stratumctl asg hooks complete
Section titled “stratumctl asg hooks complete”Complete a lifecycle action for an instance the hook holds (CONTINUE | ABANDON)
stratumctl asg hooks complete <asg-id> <hook-name> [flags]Examples
Section titled “Examples”stratumctl asg hooks complete asg-3k8m2x7q9a pre-boot --instance i-uy3ureaklqstratumctl asg hooks complete asg-3k8m2x7q9a drain --instance i-uy3ureaklq --result ABANDON| Flag | Type | Default | Description |
|---|---|---|---|
--instance |
string | Instance id the hook holds (required) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--result |
string | CONTINUE |
CONTINUE | ABANDON |
stratumctl asg hooks delete
Section titled “stratumctl asg hooks delete”Delete a lifecycle hook (held instances continue)
stratumctl asg hooks delete <asg-id> <name> [flags]Examples
Section titled “Examples”stratumctl asg hooks delete asg-3k8m2x7q9a pre-boot| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg hooks describe
Section titled “stratumctl asg hooks describe”Describe a lifecycle hook
stratumctl asg hooks describe <asg-id> <name> [flags]Aliases: get
Examples
Section titled “Examples”stratumctl asg hooks describe asg-3k8m2x7q9a pre-bootstratumctl asg hooks describe asg-3k8m2x7q9a pre-boot --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg hooks heartbeat
Section titled “stratumctl asg hooks heartbeat”Extend the wait for an instance the hook holds
stratumctl asg hooks heartbeat <asg-id> <hook-name> [flags]Examples
Section titled “Examples”stratumctl asg hooks heartbeat asg-3k8m2x7q9a pre-boot --instance i-uy3ureaklq| Flag | Type | Default | Description |
|---|---|---|---|
--instance |
string | Instance id the hook holds (required) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg hooks list
Section titled “stratumctl asg hooks list”List a group’s lifecycle hooks
stratumctl asg hooks list <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg hooks list asg-3k8m2x7q9astratumctl asg hooks list asg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg hooks put
Section titled “stratumctl asg hooks put”Create or replace a lifecycle hook
stratumctl asg hooks put <asg-id> <name> [flags]Examples
Section titled “Examples”stratumctl asg hooks put asg-… pre-boot --transition launching --timeout 600stratumctl asg hooks put asg-… drain --transition terminating --default-result ABANDON --timeout 120| Flag | Type | Default | Description |
|---|---|---|---|
--default-result |
string | CONTINUE | ABANDON when the hook times out (default CONTINUE) | |
--metadata |
string | Notification metadata as JSON | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--timeout |
int | 0 |
Heartbeat timeout in seconds (30-7200; default 3600) |
--transition |
string | launching | terminating (required) |
stratumctl asg launch-templates
Section titled “stratumctl asg launch-templates”Launch templates: versioned instance blueprints
stratumctl asg launch-templates [flags]Aliases: lt
Subcommands
Section titled “Subcommands”stratumctl asg launch-templates create: Create a launch template with its first versionstratumctl asg launch-templates delete: Delete a launch template (refused while a group references it)stratumctl asg launch-templates describe: Describe a launch templatestratumctl asg launch-templates list: List launch templatesstratumctl asg launch-templates set-default: Move $DEFAULT to a versionstratumctl asg launch-templates update: Update a launch template’s description and tagsstratumctl asg launch-templates version-create: Add a version ($LATEST moves to it)stratumctl asg launch-templates version-delete: Delete a version (not $DEFAULT, not the last, not one a group uses)stratumctl asg launch-templates version-describe: Describe a version (user-data included)stratumctl asg launch-templates versions: List a launch template’s versions
stratumctl asg launch-templates create
Section titled “stratumctl asg launch-templates create”Create a launch template with its first version
stratumctl asg launch-templates create <name> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates create web-lt --image img-k3m9x2abqt --type m1.mediumstratumctl asg launch-templates create web-lt --image img-k3m9x2abqt --type m1.medium --key-pair axel-laptop \ --security-group sg-3f8d2k9x --user-data-file cloud.yaml --tag-at-launch env=prod| Flag | Type | Default | Description |
|---|---|---|---|
--description |
string | Description | |
--floating-ip-pool |
string | Floating-IP pool to allocate a public address from | |
--image |
string | Image id (required) | |
--instance-profile |
string | IAM instance profile id | |
--key-pair |
string | Key pair name | |
--no-agent |
bool | false |
Launch with the instance agent disabled |
--placement-group |
string | Placement group name | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--root-size-bytes |
int64 | 0 |
Root volume size in bytes |
--root-storage-class |
string | Root volume storage class | |
--security-group |
stringArray | Security group id (repeatable) | |
--subnet |
string | Subnet id (static placement); omit to inherit the group’s subnets | |
--subnet-strategy |
string | static | inherited (defaults from –subnet) | |
--tag |
stringArray | Tag key=value on the template (repeatable) | |
--tag-at-launch |
stringArray | Tag key=value stamped on launched instances (repeatable) | |
--type |
string | Instance type name, e.g. m1.medium (required) | |
--user-data-file |
string | Path to the cloud-config user-data (or - for stdin) | |
--version-description |
string | Version description |
stratumctl asg launch-templates delete
Section titled “stratumctl asg launch-templates delete”Delete a launch template (refused while a group references it)
stratumctl asg launch-templates delete <launch-template-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates delete lt-4k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates describe
Section titled “stratumctl asg launch-templates describe”Describe a launch template
stratumctl asg launch-templates describe <launch-template-id> [flags]Aliases: get
Examples
Section titled “Examples”stratumctl asg launch-templates describe lt-4k8m2x7q9astratumctl asg launch-templates describe lt-4k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates list
Section titled “stratumctl asg launch-templates list”List launch templates
stratumctl asg launch-templates list [flags]Examples
Section titled “Examples”stratumctl asg launch-templates liststratumctl asg launch-templates list --limit 20 --output json| Flag | Type | Default | Description |
|---|---|---|---|
--limit |
int | 0 |
Page size; setting it (or –page-token) returns one page and prints the next token instead of listing everything |
--page-token |
string | Cursor from a previous page; returns that one page | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates set-default
Section titled “stratumctl asg launch-templates set-default”Move $DEFAULT to a version
stratumctl asg launch-templates set-default <launch-template-id> <version-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates set-default lt-4k8m2x7q9a ltv-5k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates update
Section titled “stratumctl asg launch-templates update”Update a launch template’s description and tags
stratumctl asg launch-templates update <launch-template-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates update lt-4k8m2x7q9a --description "web tier"stratumctl asg launch-templates update lt-4k8m2x7q9a --tag env=prod --tag team=a| Flag | Type | Default | Description |
|---|---|---|---|
--description |
string | Description (empty clears) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--tag |
stringArray | Tag key=value; the full set replaces the old (repeatable) |
stratumctl asg launch-templates version-create
Section titled “stratumctl asg launch-templates version-create”Add a version ($LATEST moves to it)
stratumctl asg launch-templates version-create <launch-template-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates version-create lt-4k8m2x7q9a --image img-5k8m2x7q9a --type m1.mediumstratumctl asg launch-templates version-create lt-4k8m2x7q9a --image img-5k8m2x7q9a --type m1.large --version-description "bigger shape"| Flag | Type | Default | Description |
|---|---|---|---|
--floating-ip-pool |
string | Floating-IP pool to allocate a public address from | |
--image |
string | Image id (required) | |
--instance-profile |
string | IAM instance profile id | |
--key-pair |
string | Key pair name | |
--no-agent |
bool | false |
Launch with the instance agent disabled |
--placement-group |
string | Placement group name | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--root-size-bytes |
int64 | 0 |
Root volume size in bytes |
--root-storage-class |
string | Root volume storage class | |
--security-group |
stringArray | Security group id (repeatable) | |
--subnet |
string | Subnet id (static placement); omit to inherit the group’s subnets | |
--subnet-strategy |
string | static | inherited (defaults from –subnet) | |
--tag-at-launch |
stringArray | Tag key=value stamped on launched instances (repeatable) | |
--type |
string | Instance type name, e.g. m1.medium (required) | |
--user-data-file |
string | Path to the cloud-config user-data (or - for stdin) | |
--version-description |
string | Version description |
stratumctl asg launch-templates version-delete
Section titled “stratumctl asg launch-templates version-delete”Delete a version (not $DEFAULT, not the last, not one a group uses)
stratumctl asg launch-templates version-delete <launch-template-id> <version-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates version-delete lt-4k8m2x7q9a ltv-5k8m2x7q9a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates version-describe
Section titled “stratumctl asg launch-templates version-describe”Describe a version (user-data included)
stratumctl asg launch-templates version-describe <launch-template-id> <version-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates version-describe lt-4k8m2x7q9a ltv-5k8m2x7q9astratumctl asg launch-templates version-describe lt-4k8m2x7q9a ltv-5k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg launch-templates versions
Section titled “stratumctl asg launch-templates versions”List a launch template’s versions
stratumctl asg launch-templates versions <launch-template-id> [flags]Examples
Section titled “Examples”stratumctl asg launch-templates versions lt-4k8m2x7q9astratumctl asg launch-templates versions lt-4k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--limit |
int | 0 |
Page size; setting it (or –page-token) returns one page and prints the next token instead of listing everything |
--page-token |
string | Cursor from a previous page; returns that one page | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg policies
Section titled “stratumctl asg policies”Scaling policies: target-tracking, step, scheduled
stratumctl asg policies [flags]Aliases: policy
Subcommands
Section titled “Subcommands”stratumctl asg policies delete: Delete a scaling policystratumctl asg policies describe: Describe a scaling policy with its last evaluationstratumctl asg policies list: List a group’s scaling policiesstratumctl asg policies put: Create or replace a scaling policy
stratumctl asg policies delete
Section titled “stratumctl asg policies delete”Delete a scaling policy
stratumctl asg policies delete <asg-id> <name> [flags]Examples
Section titled “Examples”stratumctl asg policies delete asg-3k8m2x7q9a cpu| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg policies describe
Section titled “stratumctl asg policies describe”Describe a scaling policy with its last evaluation
stratumctl asg policies describe <asg-id> <name> [flags]Aliases: get
Examples
Section titled “Examples”stratumctl asg policies describe asg-3k8m2x7q9a cpustratumctl asg policies describe asg-3k8m2x7q9a cpu --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg policies list
Section titled “stratumctl asg policies list”List a group’s scaling policies
stratumctl asg policies list <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg policies list asg-3k8m2x7q9astratumctl asg policies list asg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg policies put
Section titled “stratumctl asg policies put”Create or replace a scaling policy
stratumctl asg policies put <asg-id> <name> [flags]Examples
Section titled “Examples”stratumctl asg policies put asg-… cpu --kind target_tracking --config-json '{"metricName":"stratum_compute_instance_cpu_percent","targetValue":60}'stratumctl asg policies put asg-… nightly --kind scheduled --config-json '{"scheduleCron":"0 22 * * *","desiredSize":1}'| Flag | Type | Default | Description |
|---|---|---|---|
--config-file |
string | Path to the config JSON (or - for stdin) | |
--config-json |
string | Kind-specific config as JSON | |
--disabled |
bool | false |
Store the policy disabled |
--kind |
string | target_tracking | step | scheduled (required) | |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg refresh
Section titled “stratumctl asg refresh”Instance refreshes: roll a group to a launch-template version
stratumctl asg refresh [flags]Subcommands
Section titled “Subcommands”stratumctl asg refresh cancel: Cancel a refresh after its in-flight batchstratumctl asg refresh describe: Describe a refreshstratumctl asg refresh list: List a group’s refreshes, newest firststratumctl asg refresh start: Start a rolling replacement toward a launch-template version
stratumctl asg refresh cancel
Section titled “stratumctl asg refresh cancel”Cancel a refresh after its in-flight batch
stratumctl asg refresh cancel <asg-id> <refresh-id> [flags]Examples
Section titled “Examples”stratumctl asg refresh cancel asg-3k8m2x7q9a ir-6k2m8x4q7a| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg refresh describe
Section titled “stratumctl asg refresh describe”Describe a refresh
stratumctl asg refresh describe <asg-id> <refresh-id> [flags]Aliases: get
Examples
Section titled “Examples”stratumctl asg refresh describe asg-3k8m2x7q9a ir-6k2m8x4q7astratumctl asg refresh describe asg-3k8m2x7q9a ir-6k2m8x4q7a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg refresh list
Section titled “stratumctl asg refresh list”List a group’s refreshes, newest first
stratumctl asg refresh list <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg refresh list asg-3k8m2x7q9astratumctl asg refresh list asg-3k8m2x7q9a --output json| Flag | Type | Default | Description |
|---|---|---|---|
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) |
stratumctl asg refresh start
Section titled “stratumctl asg refresh start”Start a rolling replacement toward a launch-template version
stratumctl asg refresh start <asg-id> [flags]Examples
Section titled “Examples”stratumctl asg refresh start asg-3k8m2x7q9astratumctl asg refresh start asg-3k8m2x7q9a --target ltv-5k8m2x7q9a --max-batch 2 --min-healthy 75| Flag | Type | Default | Description |
|---|---|---|---|
--max-batch |
int | 1 |
Instances replaced per pass |
--min-healthy |
int | 90 |
Healthy floor as a percentage of desired size |
--project |
string | Project ID (defaults to STRATUM_PROJECT or profile project_id) | |
--target |
string | $LATEST | $DEFAULT | ltv-… (default: the group’s reference as it resolves now) | |
--warmup |
int | 0 |
Seconds a replacement must be InService before it counts (default: the group’s grace) |
