Catalogue / Compute

Virtual machine

computevirtual-machine

A leased guest machine running an OS image on provider infrastructure.

Category
Compute
Properties
8
Components
61
Rules
1
Properties · 8 defined by this kind

A node of this kind resolves each property from its own props, then the component's defaults, then the default below.

propertytypevaluesrequireddefault
diskEncryptionboolean—no—
instancesinteger—no—
managedboolean—nofalse
memoryGibinteger—no—
osenumlinux | windows | aix | ibm-inolinux
publicIpboolean—no—
sizeVcpuinteger—no—
zoneRedundantboolean—no—
Rules for this kind · 1
stateful-node-without-zone-redundancy

A stateful compute node pinned to exactly one availability zone disappears with that zone, and its state goes with it. Nodes inside a cell are exempt, because there the cell is deliberately single-zone and redundancy comes from the other cells.

  • — all of these hold:
  • — the node's `stateless` is false
  • — the node sits inside exactly 1 availability-zone group
  • — this does not hold:
  • — the node sits inside at least one cell group
Components · 61
Source
# yaml-language-server: $schema=../schema/kind.schema.json
# A machine you lease and boot from an image, as opposed to app-server which is the process running on it. publicIp, zoneRedundant and diskEncryption carry no default so exposure and resilience rules can catch a machine that never declared them.
schemaVersion: "1"
type: "kind"
id: "virtual-machine"
category: "compute"
properties:
  os:
    type: "enum"
    values: ["linux", "windows", "aix", "ibm-i"]
    default: "linux"
  sizeVcpu:
    type: "integer"
  memoryGib:
    type: "integer"
  publicIp:
    type: "boolean"
  zoneRedundant:
    type: "boolean"
  diskEncryption:
    type: "boolean"
  instances:
    type: "integer"
  managed:
    type: "boolean"
    default: false

The same page as markdown, for an agent: /catalogue/kinds/virtual-machine.md