Resources / AccessPoint

AccessPoint

A station that is the member endpoint of the VPCs without a gateway (spec 0038 section 28): a customer's member machine ends its WireGuard tunnel here, and the station attaches it to the VPC's Ethernet segment itself. Written by the cloud operator, one per station with station.access and no hub (the spec); the network controller fills the status with every member and VPC the station must serve. Root cluster only; customers see only their Account's status.accessPoint.

Overview

APInetwork.etorm.com/v1alpha1
Resourceaccesspoints (cluster-scoped inside its cluster)
Short namesap
Available inthe platform only
Statuswritten by a controller through /status

Minimal example

apiVersion: network.etorm.com/v1alpha1
kind: AccessPoint
metadata:
  name: example
spec: {}

Spec

FieldTypeRequiredDefaultAllowedDescription
publicKeystringup to 44 charactersThe station's WireGuard public key (base64 of 32 bytes), made at the station's boot: it changes when the station is replaced. Empty until the station has reported it.
endpointslist of stringup to 2 itemsThe station's public WireGuard endpoints, host:port (UDP): the IPv4 one first when it has one, then [IPv6]:port. Empty while the station is not running: members are then given another station.
regionstringup to 63 charactersThe region a customer sees (us, eu), never a provider's name.
descriptionstringup to 200 charactersWhich station this is, for people.

Status

FieldTypeRequiredDefaultAllowedDescription
phasestringPending (no key or no endpoint yet) or Ready (members may be given this station).
vtepstringThe tunnel address members' VXLAN goes to and comes from, the same on every station (fd00:e8::1).
memberCountintegerMembers in members[].
memberslist of objectEvery member the station must accept: the Accounts with a public key in the VPCs without a gateway. Removing an Account, or changing its key, changes this list at the next pass; the station follows within about a minute (spec 0038 section 17, the refresh).
members[].clusterstringThe member's project.
members[].accountstringThe Account's name.
members[].vpcstringThe VPC's name.
members[].vniintegerThe VPC's VNI: the member's VXLAN must carry exactly it.
members[].publicKeystringThe member's WireGuard public key.
members[].underlayAddressstringThe member's tunnel address (fd00:e8::/64), its one allowed IP.
members[].macAddressstringThe member's MAC: the source of every frame it sends.
vpcslist of objectThe VPCs the station serves: one segment of its switch each, with the services it answers members with (specs 0012, 0015).
vpcs[].clusterstringThe VPC's project.
vpcs[].vpcstringThe VPC's name.
vpcs[].vniintegerThe VPC's VNI.
vpcs[].ipv6PrefixstringThe VPC's IPv6 /64.
vpcs[].cidrstringThe VPC's IPv4 network, when it has one.
vpcs[].mtuintegerThe VPC's MTU (at most 1280 on a station).
vpcs[].dnsobject (free-form)The VPC's DNSService status.config (spec 0012), when it has a Ready one.
vpcs[].dhcpobject (free-form)The VPC's DHCPService status.config (spec 0012), when it has a Ready one; a station serves an Account's own address and the reservations, not the pool.
conditionslist of object
conditions[].typestring
conditions[].statusstring
conditions[].reasonstring
conditions[].messagestring

Columns in listings

ColumnFrom
Endpoint.spec.endpoints[0]
Members.status.memberCount
Phase.status.phase

All resources