Amazon EC2

Virtual servers launched from an AMI, with the operating system left for you to patch.

Provider: aws
Kind: Virtual machine
Category: Compute
Official docs: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html
Also known as: EC2 Spot Instances, Spot Instance, AWS Trainium, AWS Inferentia

Properties · 3 set by this component

property	type	values	required	kind default	this component
accelerator · component property	enum	none \| gpu \| trainium \| inferentia	no	none	inherited
diskEncryption	boolean	—	no	—	▸ false
instances	integer	—	no	—	inherited
interruptionBehavior · component property	enum	terminate \| stop \| hibernate	no	—	inherited
interruptionNoticeSeconds · component property	integer	—	no	—	inherited
managed	boolean	—	no	false	▸ false
maxPriceSet · component property	boolean	—	no	—	inherited
memoryGib	integer	—	no	—	inherited
metadataVersion · component property	enum	v1-or-v2 \| v2-only	no	v1-or-v2	inherited
os	enum	linux \| windows \| aix \| ibm-i	no	linux	inherited
publicIp	boolean	—	no	—	inherited
purchaseOption · component property	enum	on-demand \| reserved \| spot \| dedicated-host	no	on-demand	inherited
requestType · component property	enum	one-time \| persistent	no	—	inherited
rootVolume · component property	enum	ebs \| instance-store	no	ebs	inherited
sizeVcpu	integer	—	no	—	inherited
tenancy · component property	enum	default \| dedicated \| host	no	default	inherited
zoneRedundant	boolean	—	no	—	▸ false

Rules that apply · 1

Every rule whose selector covers this component's kind or its category. Whether a rule fires depends on the design: its properties, its edges and its groups.

Stateful node without zone redundancyerror

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

Use it in a design

nodes:
  - { id: "ec2", component: "aws-ec2" }

Other Virtual machine products · 60

and 20 more → Virtual machine page

Source

1# yaml-language-server: $schema=../../schema/component.schema.json
2# Amazon EC2 instance: a virtual server you boot from an AMI and keep patching yourself
3# ("What is Amazon EC2?"). EBS encryption by default is a Region setting you must switch on
4# ("Enable Amazon EBS encryption by default"), and an instance lives in one Availability Zone.
5#
6# Spot Instances are this component with purchaseOption: "spot", not a separate one: spare EC2
7# capacity at a discount that AWS reclaims when it needs it back ("Spot Instances",
8# https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-spot-instances.html). purchaseOption
9# already carried "spot", so it is the capacity switch here rather than a second property.
10# interruptionBehavior, requestType, interruptionNoticeSeconds and maxPriceSet mean something only
11# when purchaseOption is "spot", so none is defaulted. AWS's own defaults for a Spot Instance:
12# terminate on interruption, a one-time request, a two-minute notice, and no maximum price set
13# ("Behavior of Spot Instance interruptions").
14#
15# AWS Trainium and AWS Inferentia instances are this component too, with accelerator: "trainium" (Trn1, Trn2) or
16# "inferentia" (Inf1, Inf2): AWS's own ML chips, sold only as accelerated-computing EC2 instance types and programmed
17# through the AWS Neuron SDK ("Accelerated computing instances",
18# https://docs.aws.amazon.com/ec2/latest/instancetypes/ac.html). "gpu" is the NVIDIA and AMD GPU families (P, G).
19schemaVersion: "1"
20type: "component"
21id: "aws-ec2"
22kind: "virtual-machine"
23provider: "aws"
24docs: "https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts.html"
25aliases: ["EC2", "EC2 Spot Instances", "Spot Instance", "AWS Trainium", "AWS Inferentia"]
26defaults:
27  managed: false
28  diskEncryption: false
29  zoneRedundant: false
30properties:
31  tenancy:
32    type: "enum"
33    values: ["default", "dedicated", "host"]
34    default: "default"
35  purchaseOption:
36    type: "enum"
37    values: ["on-demand", "reserved", "spot", "dedicated-host"]
38    default: "on-demand"
39  rootVolume:
40    type: "enum"
41    values: ["ebs", "instance-store"]
42    default: "ebs"
43  metadataVersion:
44    type: "enum"
45    values: ["v1-or-v2", "v2-only"]
46    default: "v1-or-v2"
47  interruptionBehavior:
48    type: "enum"
49    values: ["terminate", "stop", "hibernate"]
50  requestType:
51    type: "enum"
52    values: ["one-time", "persistent"]
53  interruptionNoticeSeconds:
54    type: "integer"
55  maxPriceSet:
56    type: "boolean"
57  accelerator:
58    type: "enum"
59    values: ["none", "gpu", "trainium", "inferentia"]
60    default: "none"

The same page as markdown, for an agent: /catalogue/components/aws-ec2.md