spinifex

module
v1.22.0-30-gc861642d-dev Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2026 License: AGPL-3.0

README

Go Go Reference License mulgadc.com docs.mulgadc.com

Live Demo · Services · Deploy · Install · Architecture


Spinifex: the open, AWS-compatible cloud you run yourself

Spinifex, built by Mulga, recreates the AWS services your software already uses on infrastructure you control. Move workloads off the hyperscalers, run AI at a fraction of the cost, or take the cloud to the edge, without rewriting a line.

  • Your AWS tooling, unchanged. The AWS CLI, SDKs, and Terraform work as they are.
  • Full control of the stack. Your hardware, data, and keys, with no external control plane, running through disconnection.
  • Open core under AGPL-3.0. Auditable, yours to keep, with no lock-in.

You change where your software runs, not what it is.

Try It Live

Get a real Spinifex endpoint in under a minute, with no card and no install. The sandbox is yours for 72 hours, with access keys, the web console, and EC2, EBS, S3, VPC, IAM, EKS, and RDS ready to call. Point your existing AWS CLI or Terraform straight at it.

Create your sandbox →

Same Commands, Your Cloud

export AWS_PROFILE=spinifex
aws ec2 describe-images
aws ec2 run-instances --image-id ami-xxxxxxxx --instance-type t3.micro
aws s3 mb s3://my-bucket

For Terraform, start from the example workbooks.

Why Not LocalStack or Floci?

LocalStack and Floci are emulators for local development and CI testing. An emulator returns a plausible response; Spinifex boots the machine. A call launches a real KVM guest, attaches a replicated Viperblock volume, or writes an erasure-coded object into Predastore, so Spinifex can run your production workloads on hardware you own. Test against an emulator, then run in production on Spinifex.

Services

The platform serves 392 AWS API operations across the services below. See exactly which ones in the coverage report.

Service What it is Built on Status
EC2 Compute QEMU/KVM, with spot instances and GPU passthrough Available
EBS Block storage Viperblock: replicated, with a WAL on local NVMe Available
S3 Object storage Predastore: Reed-Solomon erasure coding Available
VPC Networking OVN, with security groups Available
IAM Identity & auth SigV4 across every service Available
ALB / NLB Load balancers HAProxy (L7), nginx stream (L4), with ACM certificates Available
EKS Kubernetes k3s, with HA control planes and managed node groups Available
ECR Container registry Predastore, deduplicated per account Available
ECS Container service Spinifex instances Available
RDS Databases PostgreSQL and MariaDB, with automated backups Available
Bedrock AI deployment Q4 2026

Roadmap services ship under the same AWS API surface, so code written for AWS today works the moment they land. Track what's shipped in the release notes.

Deploy Anywhere

  • Neocloud: lift and shift onto partner GPU capacity (H100 / H200 / B200). Change an endpoint, keep the software.
  • On-premise: a multi-node HA cluster in your own data centre, so the stack, the data, and the jurisdiction stay yours.
  • Edge: air-gapped sites, vehicles, vessels, factories, and clinics, with compute next to the data.

Install

Spinifex runs on Ubuntu 26.04 or Debian 13. The full guides are at docs.mulgadc.com.

Prerequisite: Spinifex requires a Linux bridge configured on the host for VM networking. See the single-node install guide for setup details.

Bare metal (recommended): download the bootable x86 installer and follow the USB install guide.

curl -fLO https://iso.mulgadc.com/spinifex.iso

Single node:

curl -fsSL https://install.mulgadc.com | bash
sudo /usr/local/share/spinifex/setup-ovn.sh --management
sudo spx admin init --node node1 --nodes 1
sudo systemctl start spinifex.target
export AWS_PROFILE=spinifex
aws ec2 describe-instance-types

From source: see the Source Install guide.

Web Console

Spinifex web console dashboard

Spinifex ships with a built-in web console for your instances, volumes, buckets, networks, and IAM. See Launching the Web UI.

Architecture

Every AWS API call is authenticated at the gateway, published to a NATS subject, and answered by whichever daemon claims it. Daemons are stateless, so you scale horizontally by starting more. Deep dive: docs/DESIGN.md.

How We Build Spinifex

Spinifex is built by infrastructure engineers with deep AWS experience, including former AWS team members, drawing on decades of combined work across AWS, enterprise infrastructure, and edge computing. Engineers architect and implement it, with Claude Code accelerating parts of the work.

Claude Code assists with Engineers own
Boilerplate AWS API structures and handlers Architecture and scalability decisions
Development guides and API documentation Authentication, encryption, and threat modelling
Test case generation and validation scenarios Real-world performance tuning and benchmarking
Large-scale restructuring and refactoring Deployment strategy and production operations

Trademarks

"AWS", "Amazon Web Services", and all related service names (EC2, EBS, S3, VPC, IAM, and others) are trademarks of Amazon.com, Inc. or its affiliates. Mulga Defense Corporation and Spinifex are independent and not affiliated with, endorsed by, or sponsored by Amazon.com, Inc. or Amazon Web Services, Inc. References to AWS services describe interoperability and compatibility only.

License

Spinifex is open source under the GNU Affero General Public License v3.0, with a commercial license available.

Directories

Path Synopsis
cmd
dhcptest command
dhcptest is a diagnostic tool that runs a DHCP DORA handshake using the same nclient4 library and options that spinifex-vpcd uses for gateway pool leases.
dhcptest is a diagnostic tool that runs a DHCP DORA handshake using the same nclient4 library and options that spinifex-vpcd uses for gateway pool leases.
ecr-credential-provider command
ecr-credential-provider is a kubelet exec credential provider that lets a Spinifex EKS worker node pull images from the internal Spinifex ECR registry.
ecr-credential-provider is a kubelet exec credential provider that lets a Spinifex EKS worker node pull images from the internal Spinifex ECR registry.
ecs-agent command
ecs-agent runs inside a Spinifex ECS container instance (a guest VM booted from the ECS-AMI, with containerd baked in).
ecs-agent runs inside a Spinifex ECS container instance (a guest VM booted from the ECS-AMI, with containerd baked in).
ecs-agent/credentials
Package credentials supplies AWS SigV4 credentials to the ecs-agent.
Package credentials supplies AWS SigV4 credentials to the ecs-agent.
ecs-agent/runtime
Package runtime is the ecs-agent's container-runtime seam.
Package runtime is the ecs-agent's container-runtime seam.
eks-gateway-fetch command
eks-gateway-fetch runs inside the EKS K3s control-plane VM and fetches a control-plane resource from the host through the AWS gateway, instead of dialing core NATS directly.
eks-gateway-fetch runs inside the EKS K3s control-plane VM and fetches a control-plane resource from the host through the AWS gateway, instead of dialing core NATS directly.
eks-gateway-publish command
eks-gateway-publish runs inside the EKS K3s control-plane VM and relays a single publication to the host through the AWS gateway, instead of dialing core NATS directly.
eks-gateway-publish runs inside the EKS K3s control-plane VM and relays a single publication to the host through the AWS gateway, instead of dialing core NATS directly.
eks-konnectivity-cert command
Command eks-konnectivity-cert mints, then reuses, an ECDSA-P256 serving certificate for the on-node konnectivity-server, signed by the K3s cluster CA.
Command eks-konnectivity-cert mints, then reuses, an ECDSA-P256 serving certificate for the on-node konnectivity-server, signed by the K3s cluster CA.
eks-token-webhook command
eks-token-webhook is the K8s TokenReview webhook authenticator baked into the eks-server AMI.
eks-token-webhook is the K8s TokenReview webhook authenticator baked into the eks-server AMI.
eks-webhook-cert command
Command eks-webhook-cert mints, then reuses, a self-signed ECDSA-P256 serving certificate for an in-cluster admission webhook and prints its base64 PEM so the addon renderer can embed it as the webhook Secret + each caBundle.
Command eks-webhook-cert mints, then reuses, a self-signed ECDSA-P256 serving certificate for an in-cluster admission webhook and prints its base64 PEM so the addon renderer can embed it as the webhook Secret + each caBundle.
installer command
installer/autoinstall
Package autoinstall reads headless install parameters from environment variables exported by spinifex-init.sh from the kernel cmdline.
Package autoinstall reads headless install parameters from environment variables exported by spinifex-init.sh from the kernel cmdline.
installer/branding
Package branding centralises Mulga/Spinifex visual identity constants used by the installer TUI.
Package branding centralises Mulga/Spinifex visual identity constants used by the installer TUI.
installer/firstboot
Package firstboot writes the oneshot systemd service and configuration that completes Spinifex provisioning on the first real boot after installation.
Package firstboot writes the oneshot systemd service and configuration that completes Spinifex provisioning on the first real boot after installation.
installer/install
Package install performs the disk installation steps after the UI has collected configuration.
Package install performs the disk installation steps after the UI has collected configuration.
installer/netprobe
Package netprobe identifies physical network interfaces by hardware rather than kernel name, so an operator choosing between eno1, ens1f0np0 and ens1f1np1 can tell the 1gbe Broadcom from the 25gbe Mellanox.
Package netprobe identifies physical network interfaces by hardware rather than kernel name, so an operator choosing between eno1, ens1f0np0 and ens1f1np1 can tell the 1gbe Broadcom from the 25gbe Mellanox.
installer/systemd
Package systemd writes systemd unit files and drop-ins into an installed system root during the Spinifex ISO installation process.
Package systemd writes systemd unit files and drop-ins into an installed system root during the Spinifex ISO installation process.
installer/ui
Package ui presents the interactive installer TUI using bubbletea and lipgloss.
Package ui presents the interactive installer TUI using bubbletea and lipgloss.
lb-agent command
lb-agent runs inside load balancer VMs and manages HAProxy configuration.
lb-agent runs inside load balancer VMs and manages HAProxy configuration.
rds-agent command
rds-agent runs inside a Spinifex RDS instance.
rds-agent runs inside a Spinifex RDS instance.
spinifex command
spinifex/cmd
Package cmd defines the spx command-line interface: the cobra commands that install, configure, start and administer a Spinifex node and its cluster.
Package cmd defines the spx command-line interface: the cobra commands that install, configure, start and administer a Spinifex node and its cluster.
spx-loadgen command
spx-loadgen drives a measured request load at a Spinifex control plane and reports per-operation latency distributions as JSON and as a summary.
spx-loadgen drives a measured request load at a Spinifex control plane and reports per-operation latency distributions as JSON and as a summary.
docs
security/network-connections
Package networkconnections embeds the inbound-listener inventory doc that lives alongside it, so test binaries can read it on nodes with no Go toolchain.
Package networkconnections embeds the inbound-listener inventory doc that lives alongside it, so test binaries can read it on nodes with no Go toolchain.
internal
awsmodel
Package awsmodel loads the AWS Smithy service models used by the conformance suite and translates them into the api-2.json shaped structs its validators read.
Package awsmodel loads the AWS Smithy service models used by the conformance suite and translates them into the api-2.json shaped structs its validators read.
ecrauth
Package ecrauth mints ECR registry credentials by SigV4-signing GetAuthorizationToken against the Spinifex AWS gateway's ECR endpoint and decoding the returned AWS:<jwt> token into Basic-auth parts.
Package ecrauth mints ECR registry credentials by SigV4-signing GetAuthorizationToken against the Spinifex AWS gateway's ECR endpoint and decoding the returned AWS:<jwt> token into Basic-auth parts.
ecsgw
Package ecsgw is the on-VM SigV4 client the ecs-agent uses to reach the AWS gateway over HTTPS instead of connecting to NATS directly.
Package ecsgw is the on-VM SigV4 client the ecs-agent uses to reach the AWS gateway over HTTPS instead of connecting to NATS directly.
eksgw
Package eksgw is the on-VM SigV4 client used by EKS helpers (eks-gateway-publish, eks-token-webhook) to POST over HTTPS to the AWS gateway instead of NATS.
Package eksgw is the on-VM SigV4 client used by EKS helpers (eks-gateway-publish, eks-token-webhook) to POST over HTTPS to the AWS gateway instead of NATS.
guestenv
Package guestenv reads the static settings an in-guest binary is configured with at launch.
Package guestenv reads the static settings an in-guest binary is configured with at launch.
gwsign
Package gwsign SigV4-signs on-VM requests to the AWS gateway.
Package gwsign SigV4-signs on-VM requests to the AWS gateway.
imdscreds
Package imdscreds fetches AWS instance-role credentials from the in-guest IMDS endpoint (169.254.169.254) using IMDSv2.
Package imdscreds fetches AWS instance-role credentials from the in-guest IMDS endpoint (169.254.169.254) using IMDSv2.
rdsgw
Package rdsgw is the on-VM SigV4 client the rds-agent uses to reach the AWS gateway over HTTPS, keeping NATS host-internal.
Package rdsgw is the on-VM SigV4 client the rds-agent uses to reach the AWS gateway over HTTPS, keeping NATS host-internal.
stsauth
Package stsauth mints task-role credentials by SigV4-signing sts:AssumeRole against the Spinifex AWS gateway.
Package stsauth mints task-role credentials by SigV4-signing sts:AssumeRole against the Spinifex AWS gateway.
spinifex
accountteardown
Package accountteardown removes everything an account owns, in dependency order, and then the account itself.
Package accountteardown removes everything an account owns, in dependency order, and then the account itself.
admin
Package admin holds the node administration helpers behind spx admin: config and certificate generation, credential bootstrap, image import and host network discovery.
Package admin holds the node administration helpers behind spx admin: config and certificate generation, credential bootstrap, image import and host network discovery.
arn
Package arn builds AWS resource ARNs.
Package arn builds AWS resource ARNs.
awsec2query
Package awsec2query decodes AWS EC2 Query-protocol request parameters into aws-sdk-go input structs.
Package awsec2query decodes AWS EC2 Query-protocol request parameters into aws-sdk-go input structs.
awserrors
Package awserrors defines the AWS error codes Spinifex returns, their HTTP status and default message, and helpers to attach a code to an error and resolve it again at the API boundary.
Package awserrors defines the AWS error codes Spinifex returns, their HTTP status and default message, and helpers to attach a code to an error and resolve it again at the API boundary.
cloud/exoscale
Package exoscale is the narrow slice of the Exoscale API the external allocator needs, driven through the exo CLI rather than the Go SDK.
Package exoscale is the narrow slice of the Exoscale API the external allocator needs, driven through the exo CLI rather than the Go SDK.
cloud/oci
Package oci wraps the subset of the Oracle Cloud API that Spinifex needs to hand out publicly reachable addresses on an OCI instance.
Package oci wraps the subset of the Oracle Cloud API that Spinifex needs to hand out publicly reachable addresses on an OCI instance.
clustersize
Package clustersize holds one fact and the one number derived from it: how many nodes this process believes the cluster has, and therefore how many nodes each of its JetStream streams is replicated across.
Package clustersize holds one fact and the one number derived from it: how many nodes this process believes the cluster has, and therefore how many nodes each of its JetStream streams is replicated across.
config
Package config defines spinifex.toml, the cluster and per-node configuration every Spinifex service is started from, and loads it via LoadConfig.
Package config defines spinifex.toml, the cluster and per-node configuration every Spinifex service is started from, and loads it via LoadConfig.
daemon
Package daemon is the per-node Spinifex daemon: it wires the AWS service handlers to their NATS topics and owns this node's VMs, volumes, ENIs and the reconcilers that keep them converged.
Package daemon is the per-node Spinifex daemon: it wires the AWS service handlers to their NATS topics and owns this node's VMs, volumes, ENIs and the reconcilers that keep them converged.
ebsmetadata
Package ebsmetadata owns Spinifex's control-plane view of EBS resources.
Package ebsmetadata owns Spinifex's control-plane view of EBS resources.
ebsprovider
Package ebsprovider defines Spinifex's provider-neutral block-storage contract.
Package ebsprovider defines Spinifex's provider-neutral block-storage contract.
ebsprovider/conformance
Package conformance exercises the ebsprovider.EBSProvider contract itself, not any one implementation's internals, so it can run unmodified against every implementation of the interface; no assertion here has changed from the original suite it was moved out of.
Package conformance exercises the ebsprovider.EBSProvider contract itself, not any one implementation's internals, so it can run unmodified against every implementation of the interface; no assertion here has changed from the original suite it was moved out of.
ebsprovider/hostile
Package hostile wraps any EBSProvider in one that misbehaves on purpose.
Package hostile wraps any EBSProvider in one that misbehaves on purpose.
ebsprovider/natsserve
Package natsserve is the provider-neutral NATS server for the ebs.provider.v1.* wire contract defined by spinifex/ebsprovider.
Package natsserve is the provider-neutral NATS server for the ebs.provider.v1.* wire contract defined by spinifex/ebsprovider.
ebsprovider/nullprovider
Package nullprovider serves the EBSProvider contract without any storage behind it.
Package nullprovider serves the EBSProvider contract without any storage behind it.
filterutil
Package filterutil parses and evaluates EC2 Describe* filters, including tag filters and wildcard matching.
Package filterutil parses and evaluates EC2 Describe* filters, including tag filters and wildcard matching.
formation
Package formation coordinates cluster formation: an HTTPS server that nodes join with a token, which hands each the shared credentials and the topology of the formed cluster.
Package formation coordinates cluster formation: an HTTPS server that nodes join with a token, which hands each the shared credentials and the topology of the formed cluster.
gateway
Package gateway provides the AWS-compatible API gateway for the Spinifex platform.
Package gateway provides the AWS-compatible API gateway for the Spinifex platform.
gateway/acm
Package gateway_acm is the HTTP-side glue between awsgw and the ACM handlers.
Package gateway_acm is the HTTP-side glue between awsgw and the ACM handlers.
gateway/bedrock
Package gateway_bedrock is the HTTP-side glue between awsgw and the Ochre (bedrock / bedrock-runtime) handlers.
Package gateway_bedrock is the HTTP-side glue between awsgw and the Ochre (bedrock / bedrock-runtime) handlers.
gateway/bedrock/hfhub
Package hfhub is a minimal Hugging Face Hub client: resolve a repo revision to an immutable commit SHA, list its file tree, and stream individual files.
Package hfhub is a minimal Hugging Face Hub client: resolve a repo revision to an immutable commit SHA, list its file tree, and stream individual files.
gateway/bodyscope
Package bodyscope reads the handful of identifier fields a policy scope resolver needs out of a JSON request body, without deserialising the typed input the handler will build from the same bytes.
Package bodyscope reads the handful of identifier fields a policy scope resolver needs out of a JSON request body, without deserialising the typed input the handler will build from the same bytes.
gateway/ec2
Package gateway_ec2 resolves the resource ARNs an EC2 request authorizes against.
Package gateway_ec2 resolves the resource ARNs an EC2 request authorizes against.
gateway/ec2/account
Package gateway_ec2_account implements the EC2 account-level actions: it answers DescribeAccountAttributes itself and forwards the EBS-encryption and serial-console defaults to the account settings service over NATS.
Package gateway_ec2_account implements the EC2 account-level actions: it answers DescribeAccountAttributes itself and forwards the EBS-encryption and serial-console defaults to the account settings service over NATS.
gateway/ec2/capacityreservation
Package gateway_ec2_capacityreservation implements the EC2 capacity reservation actions: Create pins a reservation to a node chosen from a census of free capacity, and Describe and Cancel fan out to every node.
Package gateway_ec2_capacityreservation implements the EC2 capacity reservation actions: Create pins a reservation to a node chosen from a census of free capacity, and Describe and Cancel fan out to every node.
gateway/ec2/eigw
Package gateway_ec2_eigw implements the EC2 egress-only internet gateway actions: it validates each request and forwards it to the EIGW service over NATS.
Package gateway_ec2_eigw implements the EC2 egress-only internet gateway actions: it validates each request and forwards it to the EIGW service over NATS.
gateway/ec2/eip
Package gateway_ec2_eip implements the EC2 Elastic IP actions: it validates each request and forwards it to the EIP service over NATS.
Package gateway_ec2_eip implements the EC2 Elastic IP actions: it validates each request and forwards it to the EIP service over NATS.
gateway/ec2/idem
Package gateway_ec2_idem holds the client-token plumbing shared by the EC2 gateway: the KV bucket every EC2 action's token records live in, and the extraction of a token and parameter hash from an SDK input struct.
Package gateway_ec2_idem holds the client-token plumbing shared by the EC2 gateway: the KV bucket every EC2 action's token records live in, and the extraction of a token and parameter hash from an SDK input struct.
gateway/ec2/igw
Package gateway_ec2_igw implements the EC2 internet gateway actions: it validates each request and forwards it to the IGW service over NATS.
Package gateway_ec2_igw implements the EC2 internet gateway actions: it validates each request and forwards it to the IGW service over NATS.
gateway/ec2/image
Package gateway_ec2_image implements the EC2 AMI actions: it validates each request and forwards it to the image service over NATS.
Package gateway_ec2_image implements the EC2 AMI actions: it validates each request and forwards it to the image service over NATS.
gateway/ec2/instance
Package gateway_ec2_instance implements the EC2 instance actions: it places launches on nodes, fans lifecycle and Describe calls out across the cluster, and authorizes the IAM instance profiles attached to instances.
Package gateway_ec2_instance implements the EC2 instance actions: it places launches on nodes, fans lifecycle and Describe calls out across the cluster, and authorizes the IAM instance profiles attached to instances.
gateway/ec2/key
Package gateway_ec2_key implements the EC2 key pair actions: it validates each request and forwards it to the key pair service over NATS.
Package gateway_ec2_key implements the EC2 key pair actions: it validates each request and forwards it to the key pair service over NATS.
gateway/ec2/launchtemplate
Package gateway_ec2_launchtemplate implements the EC2 launch template actions: it validates each request and forwards it to the launch template service over NATS.
Package gateway_ec2_launchtemplate implements the EC2 launch template actions: it validates each request and forwards it to the launch template service over NATS.
gateway/ec2/natgw
Package gateway_ec2_natgw implements the EC2 NAT gateway actions: it validates each request and forwards it to the NAT gateway service over NATS.
Package gateway_ec2_natgw implements the EC2 NAT gateway actions: it validates each request and forwards it to the NAT gateway service over NATS.
gateway/ec2/placementgroup
Package gateway_ec2_placementgroup implements the EC2 placement group actions: it validates each request and forwards it to the placement group service over NATS.
Package gateway_ec2_placementgroup implements the EC2 placement group actions: it validates each request and forwards it to the placement group service over NATS.
gateway/ec2/routetable
Package gateway_ec2_routetable implements the EC2 route table actions: it validates each request and forwards it to the route table service over NATS.
Package gateway_ec2_routetable implements the EC2 route table actions: it validates each request and forwards it to the route table service over NATS.
gateway/ec2/snapshot
Package gateway_ec2_snapshot implements the EC2 EBS snapshot actions: it validates each request and forwards it to the snapshot service over NATS.
Package gateway_ec2_snapshot implements the EC2 EBS snapshot actions: it validates each request and forwards it to the snapshot service over NATS.
gateway/ec2/spotinstance
Package gateway_ec2_spotinstance provides the gateway-side orchestration for AWS-compatible Spot Instance Requests.
Package gateway_ec2_spotinstance provides the gateway-side orchestration for AWS-compatible Spot Instance Requests.
gateway/ec2/tags
Package gateway_ec2_tags implements the EC2 tagging actions: it validates each request and forwards it to the tag service over NATS.
Package gateway_ec2_tags implements the EC2 tagging actions: it validates each request and forwards it to the tag service over NATS.
gateway/ec2/volume
Package gateway_ec2_volume implements the EC2 EBS volume actions: it validates each request and forwards it to the volume service over NATS.
Package gateway_ec2_volume implements the EC2 EBS volume actions: it validates each request and forwards it to the volume service over NATS.
gateway/ec2/vpc
Package gateway_ec2_vpc implements the EC2 VPC, subnet, security group and network interface actions: it validates each request and forwards it to the VPC service over NATS.
Package gateway_ec2_vpc implements the EC2 VPC, subnet, security group and network interface actions: it validates each request and forwards it to the VPC service over NATS.
gateway/ec2/zone
Package gateway_ec2_zone implements DescribeAvailabilityZones and DescribeRegions, answered from the node's configured region and zone with AWS's filter rules.
Package gateway_ec2_zone implements DescribeAvailabilityZones and DescribeRegions, answered from the node's configured region and zone with AWS's filter rules.
gateway/ecr
Package gateway_ecr is the HTTP-side glue for the OCI Distribution Spec v2 registry surface (/v2/*) served by awsgw.
Package gateway_ecr is the HTTP-side glue for the OCI Distribution Spec v2 registry surface (/v2/*) served by awsgw.
gateway/ecrapi
Package gateway_ecrapi is the HTTP-side glue for the ECR control plane: the AWS JSON 1.1 surface dispatched by X-Amz-Target (AmazonEC2ContainerRegistry_V20150921.<Action>), matching aws-sdk-go's service/ecr request shape.
Package gateway_ecrapi is the HTTP-side glue for the ECR control plane: the AWS JSON 1.1 surface dispatched by X-Amz-Target (AmazonEC2ContainerRegistry_V20150921.<Action>), matching aws-sdk-go's service/ecr request shape.
gateway/ecrauth
Package gateway_ecrauth implements the ECR auth bridge: it mints and verifies the self-contained ES256 JWT that GetAuthorizationToken issues and the /v2/* registry surface accepts (Authorization: Bearer | Basic AWS:<jwt>).
Package gateway_ecrauth implements the ECR auth bridge: it mints and verifies the self-contained ES256 JWT that GetAuthorizationToken issues and the /v2/* registry surface accepts (Authorization: Bearer | Basic AWS:<jwt>).
gateway/ecs
Package gateway_ecs is the HTTP-side glue for the ECS control plane: the AWS JSON 1.1 surface dispatched by X-Amz-Target (AmazonEC2ContainerServiceV20141113.<Action>), matching aws-sdk-go's service/ecs request shape.
Package gateway_ecs is the HTTP-side glue for the ECS control plane: the AWS JSON 1.1 surface dispatched by X-Amz-Target (AmazonEC2ContainerServiceV20141113.<Action>), matching aws-sdk-go's service/ecs request shape.
gateway/eks
Package gateway_eks is the HTTP-side glue between awsgw and the EKS handlers.
Package gateway_eks is the HTTP-side glue between awsgw and the EKS handlers.
gateway/elbv2
Package gateway_elbv2 implements the ELBv2 actions: it validates each request, resolves the resource ARNs it authorizes against, and forwards it to the ELBv2 service over NATS.
Package gateway_elbv2 implements the ELBv2 actions: it validates each request, resolves the resource ARNs it authorizes against, and forwards it to the ELBv2 service over NATS.
gateway/iam
Package gateway_iam contains IAM request validation and authorization helpers.
Package gateway_iam contains IAM request validation and authorization helpers.
gateway/policy
Package policy formats a service and action as the IAM action string an AWS-shaped policy names, mapping wire service names to their IAM namespace.
Package policy formats a service and action as the IAM action string an AWS-shaped policy names, mapping wire service names to their IAM namespace.
gateway/rds
Package gateway_rds implements the RDS surface on awsgw.
Package gateway_rds implements the RDS surface on awsgw.
gateway/spx
Package spx implements spinifex platform-level gateway handlers (version, node status, VM inventory) that are distinct from the AWS-compatible APIs.
Package spx implements spinifex platform-level gateway handlers (version, node status, VM inventory) that are distinct from the AWS-compatible APIs.
gateway/sts
Package gateway_sts implements the STS actions: it validates each request and delegates it to the STS service, which owns trust-policy checks and credential issuance.
Package gateway_sts implements the STS actions: it validates each request and delegates it to the STS service, which owns trust-policy checks and credential issuance.
gateway/tagging
Package gateway_tagging is the HTTP-side glue between awsgw and the Resource Groups Tagging API.
Package gateway_tagging is the HTTP-side glue between awsgw and the Resource Groups Tagging API.
gpu
Package gpu discovers host GPUs, binds them to vfio-pci, manages NVIDIA MIG partitions and tracks which instance holds each device for passthrough.
Package gpu discovers host GPUs, binds them to vfio-pci, manages NVIDIA MIG partitions and tracks which instance holds each device for passthrough.
handlers/acm
Package handlers_acm is the daemon-side ACM service: certificate records in JetStream KV with sealed private keys, issuance from the tenant private CA, and the worker that renews those certificates before they expire.
Package handlers_acm is the daemon-side ACM service: certificate records in JetStream KV with sealed private keys, issuance from the tenant private CA, and the worker that renews those certificates before they expire.
handlers/bedrock
Package handlers_bedrock owns placement and lifecycle of self-hosted vLLM serving VMs: it decides where a model's endpoint runs, launches and probes the VM, and persists the result as the single source of truth other components (the gateway's inference path) read over NATS.
Package handlers_bedrock owns placement and lifecycle of self-hosted vLLM serving VMs: it decides where a model's endpoint runs, launches and probes the VM, and persists the result as the single source of truth other components (the gateway's inference path) read over NATS.
handlers/dns
Package dns is the control-plane DNS record writer.
Package dns is the control-plane DNS record writer.
handlers/ec2/account
Package handlers_ec2_account implements the EC2 account-settings actions (EBS encryption by default, serial console access): the AccountSettingsService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_account implements the EC2 account-settings actions (EBS encryption by default, serial console access): the AccountSettingsService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/eigw
Package handlers_ec2_eigw implements the EC2 egress-only internet gateway actions: the EgressOnlyIGWService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_eigw implements the EC2 egress-only internet gateway actions: the EgressOnlyIGWService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/eip
Package handlers_ec2_eip implements the EC2 Elastic IP actions: the EIPService contract, its daemon-side JetStream KV implementation that draws addresses from the external IPAM pools, and its NATS client.
Package handlers_ec2_eip implements the EC2 Elastic IP actions: the EIPService contract, its daemon-side JetStream KV implementation that draws addresses from the external IPAM pools, and its NATS client.
handlers/ec2/igw
Package handlers_ec2_igw implements the EC2 internet gateway actions: the IGWService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_igw implements the EC2 internet gateway actions: the IGWService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/image
Package handlers_ec2_image implements the EC2 AMI actions: the ImageService contract, its daemon-side implementation over the object store and its NATS client.
Package handlers_ec2_image implements the EC2 AMI actions: the ImageService contract, its daemon-side implementation over the object store and its NATS client.
handlers/ec2/instance
Package handlers_ec2_instance implements the EC2 instance actions: the InstanceService contract, its daemon-side implementation that launches and describes instances on this node, and its NATS client.
Package handlers_ec2_instance implements the EC2 instance actions: the InstanceService contract, its daemon-side implementation that launches and describes instances on this node, and its NATS client.
handlers/ec2/key
Package handlers_ec2_key implements the EC2 key pair actions: the KeyService contract, its daemon-side implementation over the object store, and the NATS client and IMDS lookup that serve a key's public material.
Package handlers_ec2_key implements the EC2 key pair actions: the KeyService contract, its daemon-side implementation over the object store, and the NATS client and IMDS lookup that serve a key's public material.
handlers/ec2/launchtemplate
Package handlers_ec2_launchtemplate implements the EC2 launch template actions: the LaunchTemplateService contract, its daemon-side JetStream KV implementation with immutable versions, and its NATS client.
Package handlers_ec2_launchtemplate implements the EC2 launch template actions: the LaunchTemplateService contract, its daemon-side JetStream KV implementation with immutable versions, and its NATS client.
handlers/ec2/natgw
Package handlers_ec2_natgw implements the EC2 NAT gateway actions: the NatGatewayService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_natgw implements the EC2 NAT gateway actions: the NatGatewayService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/placementgroup
Package handlers_ec2_placementgroup implements the EC2 placement group actions: the PlacementGroupService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_placementgroup implements the EC2 placement group actions: the PlacementGroupService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/routetable
Package handlers_ec2_routetable implements the EC2 route table actions: the RouteTableService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_routetable implements the EC2 route table actions: the RouteTableService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/snapshot
Package handlers_ec2_snapshot implements the EC2 EBS snapshot actions: the SnapshotService contract, its daemon-side implementation over the object store and JetStream KV, and its NATS client.
Package handlers_ec2_snapshot implements the EC2 EBS snapshot actions: the SnapshotService contract, its daemon-side implementation over the object store and JetStream KV, and its NATS client.
handlers/ec2/spotinstance
Package handlers_ec2_spotinstance implements the EC2 Spot Instance Request actions: the SpotInstanceService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_spotinstance implements the EC2 Spot Instance Request actions: the SpotInstanceService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/tags
Package handlers_ec2_tags implements the EC2 tagging actions: the TagsService contract, its daemon-side JetStream KV implementation and its NATS client.
Package handlers_ec2_tags implements the EC2 tagging actions: the TagsService contract, its daemon-side JetStream KV implementation and its NATS client.
handlers/ec2/volume
Package handlers_ec2_volume implements the EC2 EBS volume actions: the VolumeService contract, its daemon-side implementation over the object store and JetStream KV, its NATS client, and the reaper for leaked volumes.
Package handlers_ec2_volume implements the EC2 EBS volume actions: the VolumeService contract, its daemon-side implementation over the object store and JetStream KV, its NATS client, and the reaper for leaked volumes.
handlers/ec2/volumestate
Package volumestate reads and writes the control-plane-owned attachment state for an EBS volume, persisted to a per-volume state.json object.
Package volumestate reads and writes the control-plane-owned attachment state for an EBS volume, persisted to a per-volume state.json object.
handlers/ec2/vpc
Package handlers_ec2_vpc implements the EC2 VPC, subnet, network interface and security group actions: the VPCService contract, its daemon-side JetStream KV implementation with the internal and external IPAM, and its NATS client.
Package handlers_ec2_vpc implements the EC2 VPC, subnet, network interface and security group actions: the VPCService contract, its daemon-side JetStream KV implementation with the internal and external IPAM, and its NATS client.
handlers/ecr
Package ecr holds the ECR registry handlers and the predastore storage layout that backs them.
Package ecr holds the ECR registry handlers and the predastore storage layout that backs them.
handlers/ecs
Package handlers_ecs is the ECS control plane: the ECSService contract, its daemon-side JetStream KV implementation and NATS client, and the leader-elected scheduler that converges services and drains silent container instances.
Package handlers_ecs is the ECS control plane: the ECSService contract, its daemon-side JetStream KV implementation and NATS client, and the leader-elected scheduler that converges services and drains silent container instances.
handlers/ecs/bus
Package bus defines the Layer-2 internal scheduler↔agent NATS subjects and wire payloads for the ECS control plane (ecs-v1.md Q14).
Package bus defines the Layer-2 internal scheduler↔agent NATS subjects and wire payloads for the ECS control plane (ecs-v1.md Q14).
handlers/eks
Package handlers_eks implements the EKS control-plane API surface for Spinifex.
Package handlers_eks implements the EKS control-plane API surface for Spinifex.
handlers/elbv2
Package handlers_elbv2 implements the ELBv2 actions for application and network load balancers: the daemon-side JetStream KV implementation, its NATS client, and the HAProxy and nginx configs rendered for the LB VMs.
Package handlers_elbv2 implements the ELBv2 actions for application and network load balancers: the daemon-side JetStream KV implementation, its NATS client, and the HAProxy and nginx configs rendered for the LB VMs.
handlers/iam
Package handlers_iam implements IAM: users, groups, roles, policies, access keys, instance profiles and OIDC providers, persisted in JetStream KV with secrets sealed under the deployment master key.
Package handlers_iam implements IAM: users, groups, roles, policies, access keys, instance profiles and OIDC providers, persisted in JetStream KV with secrets sealed under the deployment master key.
handlers/iam/mock
Package mock provides an in-memory implementation of handlers_iam.SystemInstanceRoleEnsurer for tests.
Package mock provides an in-memory implementation of handlers_iam.SystemInstanceRoleEnsurer for tests.
handlers/imds
Package handlers_imds is the EC2 Instance Metadata Service that vpcd serves at 169.254.169.254: one responder per local instance tap, IMDSv2 tokens, instance-role credentials minted through STS, and the guest DNS forwarder.
Package handlers_imds is the EC2 Instance Metadata Service that vpcd serves at 169.254.169.254: one responder per local instance tap, IMDSv2 tokens, instance-role credentials minted through STS, and the guest DNS forwarder.
handlers/ochrevector
Package handlers_ochrevector holds Ochre's tenant vector store: the pgvector backend, the KV index registry, and the create/delete/list/ reconcile orchestration over both.
Package handlers_ochrevector holds Ochre's tenant vector store: the pgvector backend, the KV index registry, and the create/delete/list/ reconcile orchestration over both.
handlers/quota
Package handlers_quota enforces per-account service quotas in the AWS gateway.
Package handlers_quota enforces per-account service quotas in the AWS gateway.
handlers/rds
Package handlers_rds holds the RDS control plane: the KV state layout, the ARN and lifecycle-status models, and the db.* instance-class facade over the platform's EC2 sizing table.
Package handlers_rds holds the RDS control plane: the KV state layout, the ARN and lifecycle-status models, and the db.* instance-class facade over the platform's EC2 sizing table.
handlers/sts
Package handlers_sts implements STS for the gateway: role assumption, web identity federation and session tokens, with session credentials persisted in JetStream KV under the master key shared with IAM.
Package handlers_sts implements STS for the gateway: role assumption, web identity federation and session tokens, with session credentials persisted in JetStream KV under the master key shared with IAM.
handlers/sysinstance
Package sysinstance holds the boot-agnostic contract for system-managed VMs.
Package sysinstance holds the boot-agnostic contract for system-managed VMs.
handlers/systemvpc
Package handlers_systemvpc builds the managed VPCs Spinifex platform components run their own VMs in — the analogue of AWS's hidden managed-account VPCs.
Package handlers_systemvpc builds the managed VPCs Spinifex platform components run their own VMs in — the analogue of AWS's hidden managed-account VPCs.
hostdns
Package hostdns points the node's own host resolver at the local northstar listener so the Spinifex authoritative zones (ELB/EKS names in the base zone and the AWS-parity private zone) resolve from the node itself, not just from guest VMs handed northstar over DHCP.
Package hostdns points the node's own host resolver at the local northstar listener so the Spinifex authoritative zones (ELB/EKS names in the base zone and the AWS-parity private zone) resolve from the node itself, not just from guest VMs handed northstar over DHCP.
idempotency
Package idempotency implements request idempotency over a TTL KV bucket: the first caller to present a token owns the work, and duplicates replay its result or wait for it.
Package idempotency implements request idempotency over a TTL KV bucket: the first caller to present a token owns the work, and duplicates replay its result or wait for it.
instancecache
Package instancecache is a read-only informer over the live instance record space: a cache of *vm.VM projections kept current by a JetStream KV watch and backstopped by a periodic whole-set resync.
Package instancecache is a read-only informer over the live instance record space: a cache of *vm.VM projections kept current by a JetStream KV watch and backstopped by a periodic whole-set resync.
instancetypes
Package instancetypes generates the EC2 instance types a node offers from its CPU and GPUs and answers per-type questions such as vCPUs, memory, GPU count and ENI limits.
Package instancetypes generates the EC2 instance types a node offers from its CPU and GPUs and answers per-type questions such as vCPUs, memory, GPU count and ENI limits.
kvlease
Package kvlease elects a single holder of a JetStream KV key.
Package kvlease elects a single holder of a JetStream KV key.
kvstore
Package kvstore provides a typed store over a single JetStream KV bucket: one memoised get-or-create accessor and a JSON codec for the record type, replacing the accessor each caller used to hand-roll.
Package kvstore provides a typed store over a single JetStream KV bucket: one memoised get-or-create accessor and a JSON codec for the record type, replacing the accessor each caller used to hand-roll.
kvutil
Package kvutil holds the shared NATS KeyValue helpers: bucket get-or-create at the cluster's replica count, bucket enumeration, and schema-version stamping.
Package kvutil holds the shared NATS KeyValue helpers: bucket get-or-create at the cluster's replica count, bucket enumeration, and schema-version stamping.
lbagent
Package lbagent implements the LB config agent that runs inside load balancer VMs.
Package lbagent implements the LB config agent that runs inside load balancer VMs.
loadgen
Package loadgen drives a measured request load at the control plane and reports per-operation latency distributions.
Package loadgen drives a measured request load at the control plane and reports per-operation latency distributions.
migrate
Package migrate runs versioned migrations over NATS KV buckets, on-disk config files and object-store data, recording each target's schema version.
Package migrate runs versioned migrations over NATS KV buckets, on-disk config files and object-store data, recording each target's schema version.
nbd
Package nbd launches nbdkit processes that serve viperblock volumes as NBD exports.
Package nbd launches nbdkit processes that serve viperblock volumes as NBD exports.
network/external
Package external is L5 of the spinifex network stack: VPC-facing external connectivity (IGW, EIP, NAT Gateway).
Package external is L5 of the spinifex network stack: VPC-facing external connectivity (IGW, EIP, NAT Gateway).
network/external/dhcp
Package dhcp provides an in-process DHCPv4 client (spinifex-vpcd) for single-attempt DORA/RENEW/RELEASE with KV-persisted leases.
Package dhcp provides an in-process DHCPv4 client (spinifex-vpcd) for single-attempt DORA/RENEW/RELEASE with KV-persisted leases.
network/external/exonet
Package exonet implements external.Allocator against Exoscale Elastic IPs.
Package exonet implements external.Allocator against Exoscale Elastic IPs.
network/external/ocinet
Package ocinet implements external.Allocator against the Oracle Cloud API.
Package ocinet implements external.Allocator against the Oracle Cloud API.
network/host
Package host is L0 of the spinifex network stack: OVS bridges (br-int, br-ext), uplink port, and external CIDR.
Package host is L0 of the spinifex network stack: OVS bridges (br-int, br-ext), uplink port, and external CIDR.
network/invariants
Package invariants holds executable tests that pin the spinifex network layer tree to the safety and liveness invariants declared in ADR-0006 (docs/development/proposals/region-local-architecture/0006-spinifex-network-layer-contract.md).
Package invariants holds executable tests that pin the spinifex network layer tree to the safety and liveness invariants declared in ADR-0006 (docs/development/proposals/region-local-architecture/0006-spinifex-network-layer-contract.md).
network/listenerinventory
Package listenerinventory parses the "## 1.
Package listenerinventory parses the "## 1.
network/ovn
Package ovn is L1 of the spinifex network stack: the OVN Northbound DB client interface and implementations.
Package ovn is L1 of the spinifex network stack: the OVN Northbound DB client interface and implementations.
network/ovn/mock
Package mock provides an in-memory implementation of ovn.Client for tests.
Package mock provides an in-memory implementation of ovn.Client for tests.
network/ovn/nbdb
Package nbdb contains libovsdb model structs for the OVN Northbound tables used by Spinifex VPC networking.
Package nbdb contains libovsdb model structs for the OVN Northbound tables used by Spinifex VPC networking.
network/ovn/ovntest
Package ovntest boots an in-process OVN Northbound database for tests.
Package ovntest boots an in-process OVN Northbound database for tests.
network/policy
Package policy (L3) attaches data-plane policy — ACLs, NAT, routes — to L2 logical objects.
Package policy (L3) attaches data-plane policy — ACLs, NAT, routes — to L2 logical objects.
network/reconcile
Package reconcile is the network stack's intent-actual reconciliation layer.
Package reconcile is the network stack's intent-actual reconciliation layer.
network/subscribers
Package subscribers translates VPC lifecycle NATS events into calls against the network/{topology,policy,external} managers.
Package subscribers translates VPC lifecycle NATS events into calls against the network/{topology,policy,external} managers.
network/topology
Package topology is L2 of the spinifex network stack.
Package topology is L2 of the spinifex network stack.
objectstore
Package objectstore provides a common S3-like storage abstraction used by handlers to work with real backends (Predastore) or in-memory stores for testing.
Package objectstore provides a common S3-like storage abstraction used by handlers to work with real backends (Predastore) or in-memory stores for testing.
otelsetup
Package otelsetup carries spinifex's request instrumentation: the request counter/duration histogram, and a thin binding of the shared HTTP middleware to those instruments.
Package otelsetup carries spinifex's request instrumentation: the request counter/duration histogram, and a thin binding of the shared HTTP middleware to those instruments.
paging
Package paging pages a listing with opaque resume tokens.
Package paging pages a listing with opaque resume tokens.
preflight
Package preflight verifies a host's managed helper scripts and sudoers grants — which a binary-swap deploy does not ship — against what this build of spinifex expects, comparing content so a stale asset is caught.
Package preflight verifies a host's managed helper scripts and sudoers grants — which a binary-swap deploy does not ship — against what this build of spinifex expects, comparing content so a stale asset is caught.
qmp
Package qmp is a client for the QEMU Machine Protocol and the typed responses of the QMP commands Spinifex issues.
Package qmp is a client for the QEMU Machine Protocol and the typed responses of the QMP commands Spinifex issues.
reconciler
Package reconciler runs a reconcile function on change rather than on a timer: it watches the KV buckets the function reads, coalesces a burst of updates into one pass, and falls back to a periodic resync so a gap in the watch cannot leave the world unconverged.
Package reconciler runs a reconcile function on change rather than on a timer: it watches the KV buckets the function reads, coalesces a burst of updates into one pass, and falls back to a periodic resync so a gap in the watch cannot leave the world unconverged.
resource
Package resource is the envelope a persisted control-plane record lives in: what an operator asked for, what a node observed, and the identity and lifecycle bookkeeping that is common to both.
Package resource is the envelope a persisted control-plane record lives in: what an operator asked for, what a node observed, and the identity and lifecycle bookkeeping that is common to both.
service
Package service maps a service name to the Spinifex component the CLI launches for it.
Package service maps a service name to the Spinifex component the CLI launches for it.
services/awsgw
Package awsgw runs the AWS gateway service: the TLS, SigV4-authenticated endpoint that routes AWS API calls to the service handlers over NATS.
Package awsgw runs the AWS gateway service: the TLS, SigV4-authenticated endpoint that routes AWS API calls to the service handlers over NATS.
services/nats
Package nats runs the embedded NATS server Spinifex components talk over, including the JetStream store reserve that keeps a full disk recoverable.
Package nats runs the embedded NATS server Spinifex components talk over, including the JetStream store reserve that keeps a full disk recoverable.
services/northstar
Package northstar runs the northstar DNS server as a Spinifex service and bootstraps the cluster's base zone.
Package northstar runs the northstar DNS server as a Spinifex service and bootstraps the cluster's base zone.
services/predastore
Package predastore runs one predastore S3 storage host as a Spinifex service.
Package predastore runs one predastore S3 storage host as a Spinifex service.
services/qemunbdd
Package qemunbdd implements ebsprovider.EBSProvider over qcow2 files and qemu-nbd.
Package qemunbdd implements ebsprovider.EBSProvider over qcow2 files and qemu-nbd.
services/qmpcollector
Package qmpcollector is the per-node guest-metrics producer: it discovers running VMs via their qmp-telemetry-*.json sidecar files, polls each VM's dedicated telemetry QMP socket (never the manager's control socket) plus host tap counters, and publishes CloudWatch-mappable series to NATS metrics.ec2.<instance-id>.
Package qmpcollector is the per-node guest-metrics producer: it discovers running VMs via their qmp-telemetry-*.json sidecar files, polls each VM's dedicated telemetry QMP socket (never the manager's control socket) plus host tap counters, and publishes CloudWatch-mappable series to NATS metrics.ec2.<instance-id>.
services/spinifex
Package spinifex runs the per-node Spinifex daemon as a Spinifex service.
Package spinifex runs the per-node Spinifex daemon as a Spinifex service.
services/spinifexui
Package spinifexui serves the embedded Spinifex web console and reverse proxies its API calls to the cluster's backend services.
Package spinifexui serves the embedded Spinifex web console and reverse proxies its API calls to the cluster's backend services.
services/viperblockd
Package viperblockd runs the EBS volume service: it serves viperblock volumes through nbdkit and answers the ebs.* NATS topics.
Package viperblockd runs the EBS volume service: it serves viperblock volumes through nbdkit and answers the ebs.* NATS topics.
services/viperblockd/vbwire
Package vbwire is the contract between viperblockd and everything that has to read what it publishes: the NATS subjects it addresses, the shapes it puts on them, and the KV bucket recording which node holds a volume's only current copy.
Package vbwire is the contract between viperblockd and everything that has to read what it publishes: the NATS subjects it addresses, the shapes it puts on them, and the KV bucket recording which node holds a volume's only current copy.
systemd
Package systemd installs the embedded Spinifex systemd units and reconciles them against the copies already on the host.
Package systemd installs the embedded Spinifex systemd units and reconciles them against the copies already on the host.
tags
Package tags defines tag keys for Spinifex system-owned resources.
Package tags defines tag keys for Spinifex system-owned resources.
testutil
Package testutil provides test helpers shared across Spinifex packages: embedded NATS and JetStream servers, stub responders and span recorders.
Package testutil provides test helpers shared across Spinifex packages: embedded NATS and JetStream servers, stub responders and span recorders.
testutil/ebsfake
Package ebsfake provides an in-memory EBS provider for tests that also deletes a volume's objects from the store, as viperblockd does.
Package ebsfake provides an in-memory EBS provider for tests that also deletes a volume's objects from the store, as viperblockd does.
testutil/pagedstore
Package pagedstore provides an objectstore.ObjectStore fake that serves ListObjectsV2 across multiple deterministic pages, honouring ContinuationToken and IsTruncated the way a real paginating S3-compatible store does.
Package pagedstore provides an objectstore.ObjectStore fake that serves ListObjectsV2 across multiple deterministic pages, honouring ContinuationToken and IsTruncated the way a real paginating S3-compatible store does.
testutil/recordingstore
Package recordingstore provides an objectstore.ObjectStore fake that records every key it is asked to read and every prefix it is asked to list.
Package recordingstore provides an objectstore.ObjectStore fake that records every key it is asked to read and every prefix it is asked to list.
testutil/segscanoracle
Package segscanoracle is a storage-state oracle that runs the mulga umbrella repo's scripts/segscan against a copy of a real predastore node data dir, reporting live / dead-tombstoned / dead-orphan bytes per the on-disk .seg segments.
Package segscanoracle is a storage-state oracle that runs the mulga umbrella repo's scripts/segscan against a copy of a real predastore node data dir, reporting live / dead-tombstoned / dead-orphan bytes per the on-disk .seg segments.
testutil/vbscan
Package vbscan is a read-only storage-state oracle for viperblock volumes, driven directly over S3 rather than through any spinifex handler.
Package vbscan is a read-only storage-state oracle for viperblock volumes, driven directly over S3 rather than through any spinifex handler.
types
Package types holds the request, response and event types shared across Spinifex components over NATS.
Package types holds the request, response and event types shared across Spinifex components over NATS.
utils
Package utils holds shared helpers for Spinifex services: resource IDs, AWS response encoding, NATS and account plumbing, images and process control.
Package utils holds shared helpers for Spinifex services: resource IDs, AWS response encoding, NATS and account plumbing, images and process control.
vm
Package vm manages the QEMU virtual machines on a node: their lifecycle, devices, volumes and ENIs, plus the crash recovery and reapers that clean up after them.
Package vm manages the QEMU virtual machines on a node: their lifecycle, devices, volumes and ENIs, plus the crash recovery and reapers that clean up after them.
vm/mock
Package mock provides a single shared in-memory fake for vm.StateStore, reused by every package that stands up a stopped/terminated instance store in its tests.
Package mock provides a single shared in-memory fake for vm.StateStore, reused by every package that stands up a stopped/terminated instance store in its tests.
vpcd
Package vpcd runs the VPC daemon, which translates VPC events from NATS into OVN topology, security groups, NAT, EIPs and DHCP on this node.
Package vpcd runs the VPC daemon, which translates VPC events from NATS into OVN topology, security groups, NAT, EIPs and DHCP on this node.
tests
bench/ebsctl
Package ebsctl benchmarks EC2 control-plane volume-operation latency against a live Spinifex cluster under both [ebs] provider settings (embedded vs viperblockd), isolating API round-trip latency from time-to-desired-state settle time and tallying the error surface each provider produces.
Package ebsctl benchmarks EC2 control-plane volume-operation latency against a live Spinifex cluster under both [ebs] provider settings (embedded vs viperblockd), isolating API round-trip latency from time-to-desired-state settle time and tallying the error surface each provider produces.
bench/ebsctl/cmd/ebsctl-compare command
Command ebsctl-compare reads two ebsctl-bench result JSON files and emits a markdown comparison table (medians, p95s, deltas, sample counts, error rates, and a bootstrap-CI significance signal per operation).
Command ebsctl-compare reads two ebsctl-bench result JSON files and emits a markdown comparison table (medians, p95s, deltas, sample counts, error rates, and a bootstrap-CI significance signal per operation).
e2e/ddil
Package ddil is the root of the DDIL (Denied, Disrupted, Intermittent, Limited) E2E test harness.
Package ddil is the root of the DDIL (Denied, Disrupted, Intermittent, Limited) E2E test harness.
e2e/manifest-check
Package manifestcheck loads and validates spinifex/docs/service-interfaces.yaml.
Package manifestcheck loads and validates spinifex/docs/service-interfaces.yaml.
e2e/manifest-check/cmd/manifest-check command
Command manifest-check validates spinifex/docs/service-interfaces.yaml.
Command manifest-check validates spinifex/docs/service-interfaces.yaml.
e2e/manifest-lint
Package manifestlint implements the e2e manifest drift guards:
Package manifestlint implements the e2e manifest drift guards:
e2e/manifest-lint/cmd/manifest-lint command
Command manifest-lint runs the e2e manifest drift guards: fixture-create lint + NATS subject lint, both ratcheted against a checked-in baseline.
Command manifest-lint runs the e2e manifest drift guards: fixture-create lint + NATS subject lint, both ratcheted against a checked-in baseline.
e2e/select-suites
Package selectsuites derives the set of e2e suites a diff must exercise.
Package selectsuites derives the set of e2e suites a diff must exercise.
e2e/select-suites/cmd/select-suites command
Command select-suites prints the e2e suites a diff must run.
Command select-suites prints the e2e suites a diff must run.
fixtures/predastore
Package predastore starts a real predastore cluster for tests that need to exercise an actual S3-compatible backend rather than a mock.
Package predastore starts a real predastore cluster for tests that need to exercise an actual S3-compatible backend rather than a mock.
fixtures/scratch
Package scratch reclaims test scratch directories stranded in the system temp directory by earlier runs.
Package scratch reclaims test scratch directories stranded in the system temp directory by earlier runs.
fixtures/vpcd
Package vpcd builds the network managers a live vpcd runs, wired against a real in-process OVN Northbound DB (network/ovn/ovntest).
Package vpcd builds the network managers a live vpcd runs, wired against a real in-process OVN Northbound DB (network/ovn/ovntest).

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL