idyl wait - IDYL Docs

Wait for a resource to reach a condition. The —for condition is required. The —timeout flag defaults to 5m. Set —timeout=0s to evaluate the current resource snapshot only and exit without watching for changes. Supported resources and conditions:

pod: started, ready, complete, deleted
sandbox: started, ready, deleted
job: started, complete, deleted
deployment: started, ready, deleted
replicaset: started, ready, deleted
daemonset: ready, deleted
hostpodset: ready, deleted
namespace: deleted
computer: deleted
fleet: ready, attached, deleted, phase=<phase>, condition=<name>
node: ready, connected, deleted, version=<version>
fleet-update: complete
fleet-lease: fulfilled, condition=<name>
cloud-account: connected, condition=<name>

Workloads are addressed by name within a namespace, and computers by name within a namespace and the subnet they live in; a namespace is addressed by name alone; fleets, fleet updates, fleet leases, and cloud accounts are addressed by the 12-digit ID the platform assigned them, and a node by its node ID. A fleet is ready once its capacity is satisfied and attached once it serves its subnet; phase=<phase> waits for the phase it reports: pending, detached, provisioning, ready, degraded, draining, or terminated. A node is ready once it can run workloads and connected once its control connection is up; version=<version> waits until it runs that idyld release, compared exactly, such as version=0.2.78. A fleet update, which ‘idyl fleet update’ and ‘idyl node update’ start and name by ID, is complete once it has completed; one that was cancelled or failed will not complete, and one that is paused or blocked is still waiting. A fleet or a node whose deletion was accepted will not reach any condition but deleted. A namespace or a computer is released asynchronously after ‘idyl namespace delete’ or ‘idyl computer delete’ accepts the deletion. Waiting for deleted blocks until the platform has finalized the release and the name no longer resolves; while it is terminating the wait reports what still holds it back. A fleet or a node is removed asynchronously after ‘idyl fleet delete’ or ‘idyl node delete’ accepts the deletion: a node drains first unless the deletion skipped it, and a fleet is removed once it has no nodes. Waiting for deleted blocks until the fleet or node no longer resolves. A deleted fleet or node that is removed leaves nothing to print, so with -o json or -o yaml a wait that reaches deleted prints nothing. Fleets, fleet leases, and cloud accounts report conditions — named properties, each with a reason from a closed set. —for=condition=<name> waits on one of them directly, for a property with no shorthand of its own: Attached, Launching, CapacitySatisfied fleet Accepted, Fulfilled fleet-lease Verified cloud-account Exit status says what happened, so a script can tell the three outcomes apart without reading any output. It means the same thing for every resource above: 0 the condition was reached 124 the deadline passed with the condition not yet reached; the resource may still reach it 125 the condition will not be reached — the workload failed or was deleted, a fleet or node is being deleted, a fleet update was cancelled or failed, or capacity reports something that has to change first: the resource’s own spec, the catalog it draws on, the cloud account it provisions into, or a host check the node failed 1 the command could not run: no session, an unknown resource, bad arguments The reason a wait ended is written to standard error whichever way it ended, so the status is what a script reads and the reason is what a person reads. A Supervisor has no name, so it is waited on with ‘idyl supervisor wait —for available|deleted’, which exits under the same contract. Resource aliases match the rest of the CLI:

deployment, deployments, deploy
replicaset, replicasets, rs
daemonset, daemonsets, ds
hostpodset, hostpodsets, hps
pod, pods
job, jobs
sandbox, sandboxes
namespace, namespaces, ns
computer, computers, ws
fleet, fleets
fleet-update, fleet-updates
fleet-lease, fleet-leases, lease, leases
cloud-account, cloud-accounts
node, nodes

Usage

idyl wait <resource> <name>|<resource>/<name> [flags]

Commands

Command	Description
`idyl wait cloud-account`	Wait for a cloud-account condition
`idyl wait computer`	Wait for a computer condition
`idyl wait daemonset`	Wait for a daemonset condition
`idyl wait deployment`	Wait for a deployment condition
`idyl wait fleet`	Wait for a fleet condition
`idyl wait fleet-lease`	Wait for a fleet-lease condition
`idyl wait fleet-update`	Wait for a fleet-update condition
`idyl wait hostpodset`	Wait for a hostpodset condition
`idyl wait job`	Wait for a job condition
`idyl wait namespace`	Wait for a namespace condition
`idyl wait node`	Wait for a node condition
`idyl wait pod`	Wait for a pod condition
`idyl wait replicaset`	Wait for a replicaset condition
`idyl wait sandbox`	Wait for a sandbox condition

Flags

Flag	Description
`--for <string>`	Required. Condition to wait for; varies by resource (started, ready, complete, deleted, attached, connected, fulfilled, phase=<phase>, version=<version>, or condition=<name>).
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.
`--timeout <duration>`	Maximum time to wait; 0s checks the current resource snapshot only. Default: `5m0s`.

Inherited flags

Flag	Description
`-a <string>, --account-id <string>`	Account ID to use, overriding the current context.
`-c <string>, --context <string>`	Use the named context for this command.
`--homedir <string>`	Override the configuration directory. Defaults to ~/.config/idyl.
`-n <string>, --namespace <string>`	Namespace to address, overriding the entered context.
`--network <string>`	Override the Network for this command.
`-p <string>, --profile <string>`	Override the access profile for this command.
`-s <string>, --subnet <string>`	Subnet to use for this command, overriding the current context.

Examples

idyl wait pod web-abc --for=ready
idyl wait sandbox/dev --for=ready --timeout=2m
idyl wait job migrate --for=complete --timeout=10m
idyl wait namespace staging --for=deleted --timeout=10m
idyl wait computer payments -n production -s 550000000002 --for=deleted
idyl wait fleet 100000000101 --for=ready --timeout=15m
idyl wait fleet 100000000101 --for=attached
idyl wait fleet 100000000101 --for=phase=degraded
idyl wait node/<node-id> --for=ready
idyl wait node <node-id> --for=version=0.2.78 --timeout=30m
idyl wait fleet-update 100000000104 --for=complete --timeout=1h
idyl wait fleet-lease 100000000102 --for=fulfilled --timeout=30m
idyl wait cloud-account 100000000103 --for=connected
idyl wait fleet 100000000101 --for=condition=Launching
idyl wait fleet 100000000101 --for=deleted --timeout=30m
idyl wait node/<node-id> --for=deleted
idyl wait sandbox dev --for=deleted --timeout=0s

Subcommand reference

`idyl wait cloud-account`

Wait for a cloud-account condition

Usage

idyl wait cloud-account <id> [flags]

Aliases

cloud-accounts

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait computer`

Wait for a computer condition

Usage

idyl wait computer <name> [flags]

Aliases

computers

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait daemonset`

Wait for a daemonset condition

Usage

idyl wait daemonset <name> [flags]

Aliases

daemonsets
ds

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait deployment`

Wait for a deployment condition

Usage

idyl wait deployment <name> [flags]

Aliases

deployments
deploy

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait fleet`

Wait for a fleet condition

Usage

idyl wait fleet <id> [flags]

Aliases

fleets

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait fleet-lease`

Wait for a fleet-lease condition

Usage

idyl wait fleet-lease <id> [flags]

Aliases

fleet-leases
lease
leases

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait fleet-update`

Wait for a fleet-update condition

Usage

idyl wait fleet-update <id> [flags]

Aliases

fleet-updates

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait hostpodset`

Wait for a hostpodset condition

Usage

idyl wait hostpodset <name> [flags]

Aliases

hostpodsets
hps

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait job`

Wait for a job condition

Usage

idyl wait job <name> [flags]

Aliases

jobs

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait namespace`

Wait for a namespace condition

Usage

idyl wait namespace <name> [flags]

Aliases

namespaces
ns

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait node`

Wait for a node condition

Usage

idyl wait node <id> [flags]

Aliases

nodes

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait pod`

Wait for a pod condition

Usage

idyl wait pod <name> [flags]

Aliases

pods

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait replicaset`

Wait for a replicaset condition

Usage

idyl wait replicaset <name> [flags]

Aliases

replicasets
rs

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

`idyl wait sandbox`

Wait for a sandbox condition

Usage

idyl wait sandbox <name> [flags]

Aliases

sandboxes

Flags

Flag	Description
`-o <string>, --output <string>`	Output format: table, json, yaml. Default: `table`.

​Usage

​Commands

​Flags

​Inherited flags

​Examples

​Subcommand reference

​idyl wait cloud-account

​Usage

​Aliases

​Flags

​idyl wait computer

​Usage

​Aliases

​Flags

​idyl wait daemonset

​Usage

​Aliases

​Flags

​idyl wait deployment

​Usage

​Aliases

​Flags

​idyl wait fleet

​Usage

​Aliases

​Flags

​idyl wait fleet-lease

​Usage

​Aliases

​Flags

​idyl wait fleet-update

​Usage

​Aliases

​Flags

​idyl wait hostpodset

​Usage

​Aliases

​Flags

​idyl wait job

​Usage

​Aliases

​Flags

​idyl wait namespace

​Usage

​Aliases

​Flags

​idyl wait node

​Usage

​Aliases

​Flags

​idyl wait pod

​Usage

​Aliases

​Flags

​idyl wait replicaset

​Usage

​Aliases

​Flags

​idyl wait sandbox

​Usage

​Aliases

​Flags

Usage

Commands

Flags

Inherited flags

Examples

Subcommand reference

`idyl wait cloud-account`

Usage

Aliases

Flags

`idyl wait computer`

Usage

Aliases

Flags

`idyl wait daemonset`

Usage

Aliases

Flags

`idyl wait deployment`

Usage

Aliases

Flags

`idyl wait fleet`

Usage

Aliases

Flags

`idyl wait fleet-lease`

Usage

Aliases

Flags

`idyl wait fleet-update`

Usage

Aliases

Flags

`idyl wait hostpodset`

Usage

Aliases

Flags

`idyl wait job`

Usage

Aliases

Flags

`idyl wait namespace`

Usage

Aliases

Flags

`idyl wait node`

Usage

Aliases

Flags

`idyl wait pod`

Usage

Aliases

Flags

`idyl wait replicaset`

Usage

Aliases

Flags

`idyl wait sandbox`

Usage

Aliases

Flags