CLI reference / web / edge / provision

stado web edge provision

Invocation

stado web edge provision [OPTIONS] --region <REGION> --size <SIZE> --image <IMAGE> --disk-gb <DISK_GB> --contact <CONTACT> <NAME>

Purpose

Create the edge host on Azure and record it as the fleet's edge

Required inputs and options

Input or optionContract
<NAME>Name for the VM, and the registry target name it is recorded under: lowercase letters, digits and dashes
--region <REGION>Azure region. It must be one with a pre-provisioned vnet and subnet; Azure refuses the NIC otherwise, in its own words
--size <SIZE>Azure VM size. It must match `--image`'s architecture: Azure refuses an ARM64 image on an x86-64 size, and that refusal is passed through word for word
--image <IMAGE>Image URN the edge boots, `publisher:offer:sku:version`
--disk-gb <DISK_GB>OS disk in GiB. It holds the proxy binary, its generated configuration and Caddy's certificate store
--contact <CONTACT>Address Let's Encrypt sends certificate-expiry mail to
--jsonEmit machine-readable output

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • It must be one with a pre-provisioned vnet and subnet; Azure refuses the NIC otherwise, in its own words
  • It must match `--image`'s architecture: Azure refuses an ARM64 image on an x86-64 size, and that refusal is passed through word for word
  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.