spinifex

module
v1.22.0-78-g36949804e-dev Latest Latest
Warning

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

Go to latest
Published: Oct 19, 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 vLLM for text generation and Hugging Face TEI for embeddings and reranking Q4 2026
Lambda Serverless functions Q1 2027

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 the kubelet exec credential provider for Spinifex EKS worker nodes; the implementation is in agents/eks/credentialprovider.
ecr-credential-provider is the kubelet exec credential provider for Spinifex EKS worker nodes; the implementation is in agents/eks/credentialprovider.
ecs-agent command
Command ecs-agent runs inside a Spinifex ECS container instance; the implementation is in agents/ecs/agent.
Command ecs-agent runs inside a Spinifex ECS container instance; the implementation is in agents/ecs/agent.
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, writing it to stdout as TSV; the implementation is in agents/eks/gatewayfetch.
eks-gateway-fetch runs inside the EKS K3s control-plane VM and fetches a control-plane resource from the host through the AWS gateway, writing it to stdout as TSV; the implementation is in agents/eks/gatewayfetch.
eks-gateway-publish command
eks-gateway-publish runs inside the EKS K3s control-plane VM and relays a single JSON publication from stdin to the host through the AWS gateway; the implementation is in agents/eks/gatewaypublish.
eks-gateway-publish runs inside the EKS K3s control-plane VM and relays a single JSON publication from stdin to the host through the AWS gateway; the implementation is in agents/eks/gatewaypublish.
eks-konnectivity-cert command
Command eks-konnectivity-cert mints, then reuses, a K3s-CA-signed serving certificate for the on-node konnectivity-server; the implementation is in agents/eks/konnectivitycert.
Command eks-konnectivity-cert mints, then reuses, a K3s-CA-signed serving certificate for the on-node konnectivity-server; the implementation is in agents/eks/konnectivitycert.
eks-token-webhook command
Command eks-token-webhook is the K8s TokenReview webhook authenticator baked into the eks-server AMI; the implementation is in agents/eks/tokenwebhook.
Command eks-token-webhook is the K8s TokenReview webhook authenticator baked into the eks-server AMI; the implementation is in agents/eks/tokenwebhook.
eks-webhook-cert command
Command eks-webhook-cert mints, then reuses, a self-signed serving certificate for an in-cluster admission webhook and prints its base64 PEM; the implementation is in agents/eks/webhookcert.
Command eks-webhook-cert mints, then reuses, a self-signed serving certificate for an in-cluster admission webhook and prints its base64 PEM; the implementation is in agents/eks/webhookcert.
installer command
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
Command rds-agent runs inside a Spinifex RDS instance; the implementation is in agents/rds/agent.
Command rds-agent runs inside a Spinifex RDS instance; the implementation is in agents/rds/agent.
spinifex command
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.
contracts
cluster/v1
Package clusterv1 defines version 1 of the cluster control-plane contract.
Package clusterv1 defines version 1 of the cluster control-plane contract.
ec2/v1
Package ec2v1 defines version 1 of the cross-process EC2 instance-command contract.
Package ec2v1 defines version 1 of the cross-process EC2 instance-command contract.
ecs/v1
Package ecsv1 defines version 1 of the ECS scheduler-agent NATS subjects and wire payloads.
Package ecsv1 defines version 1 of the ECS scheduler-agent NATS subjects and wire payloads.
eks/v1
Package eksv1 defines version 1 of the EKS add-on contract between the control-plane guest and the host.
Package eksv1 defines version 1 of the EKS add-on contract between the control-plane guest and the host.
network/v1
Package networkv1 is the versioned wire vocabulary for the vpc.* control-plane-to-network-realisation boundary.
Package networkv1 is the versioned wire vocabulary for the vpc.* control-plane-to-network-realisation boundary.
operator/v1
Package operatorv1 defines version 1 of cross-process operator-plane contracts.
Package operatorv1 defines version 1 of cross-process operator-plane contracts.
telemetry/v1
Package telemetryv1 defines version 1 of cross-process telemetry contracts.
Package telemetryv1 defines version 1 of cross-process telemetry contracts.
viperblockd/legacy/v1
Package viperblocklegacyv1 contains the versioned, transitional wire contracts between Spinifex's legacy control-plane routes and viperblockd.
Package viperblocklegacyv1 contains the versioned, transitional wire contracts between Spinifex's legacy control-plane routes and viperblockd.
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.
testkit
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.
testkit/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.
testkit/listenerinventory
Package listenerinventory parses the "## 1.
Package listenerinventory parses the "## 1.
testkit/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.
testkit/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.
testkit/readonlystore
Package readonlystore wraps an object store or a JetStream KV bucket so that any write fails the test.
Package readonlystore wraps an object store or a JetStream KV bucket so that any write fails the test.
testkit/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.
testkit/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.
testkit/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.
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.
agents/ecs/agent
Package agent implements ecs-agent, which runs inside a Spinifex ECS container instance (a guest VM booted from the ECS-AMI, with containerd baked in).
Package agent implements ecs-agent, which runs inside a Spinifex ECS container instance (a guest VM booted from the ECS-AMI, with containerd baked in).
agents/ecs/credentials
Package credentials supplies AWS SigV4 credentials to the ecs-agent.
Package credentials supplies AWS SigV4 credentials to the ecs-agent.
agents/ecs/runtime
Package runtime is the ecs-agent's container-runtime seam.
Package runtime is the ecs-agent's container-runtime seam.
agents/eks/credentialprovider
Package credentialprovider implements ecr-credential-provider, a kubelet exec credential provider that lets a Spinifex EKS worker node pull images from the internal Spinifex ECR registry.
Package credentialprovider implements ecr-credential-provider, a kubelet exec credential provider that lets a Spinifex EKS worker node pull images from the internal Spinifex ECR registry.
agents/eks/gatewayfetch
Package gatewayfetch implements eks-gateway-fetch, which 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.
Package gatewayfetch implements eks-gateway-fetch, which 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.
agents/eks/gatewaypublish
Package gatewaypublish implements eks-gateway-publish, which 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.
Package gatewaypublish implements eks-gateway-publish, which 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.
agents/eks/konnectivitycert
Package konnectivitycert implements eks-konnectivity-cert, which mints, then reuses, an ECDSA-P256 serving certificate for the on-node konnectivity-server, signed by the K3s cluster CA.
Package konnectivitycert implements eks-konnectivity-cert, which mints, then reuses, an ECDSA-P256 serving certificate for the on-node konnectivity-server, signed by the K3s cluster CA.
agents/eks/tokenwebhook
Package tokenwebhook implements eks-token-webhook, the K8s TokenReview webhook authenticator baked into the eks-server AMI.
Package tokenwebhook implements eks-token-webhook, the K8s TokenReview webhook authenticator baked into the eks-server AMI.
agents/eks/webhookcert
Package webhookcert implements eks-webhook-cert, which 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.
Package webhookcert implements eks-webhook-cert, which 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.
agents/rds/agent
Package agent implements rds-agent, which runs inside a Spinifex RDS instance.
Package agent implements rds-agent, which runs inside a Spinifex RDS instance.
bootstrap/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.
bootstrap/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.
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.
domains/acm
Package acm owns ACM certificate state, issuance, renewal and AWS action adapters.
Package acm owns ACM certificate state, issuance, renewal and AWS action adapters.
domains/acm/awsapi
Package awsapi adapts ACM's AWS JSON 1.1 actions to the ACM domain's NATS-backed service contract.
Package awsapi adapts ACM's AWS JSON 1.1 actions to the ACM domain's NATS-backed service contract.
domains/admission/quota
Package quota enforces per-account service quotas in the AWS gateway.
Package quota enforces per-account service quotas in the AWS gateway.
domains/dns
Package dns is the control-plane DNS record writer.
Package dns is the control-plane DNS record writer.
domains/ec2/account
Package 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 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.
domains/ec2/accountcleanup
Package accountcleanup deletes the proven-safe subset of one account's EC2 platform resources through the owners' own delete paths: placement groups with no members that no instance, spot request or live launch-template version names; key pairs none of those name; and launch-template residue no header owns.
Package accountcleanup deletes the proven-safe subset of one account's EC2 platform resources through the owners' own delete paths: placement groups with no members that no instance, spot request or live launch-template version names; key pairs none of those name; and launch-template residue no header owns.
domains/ec2/accountinventory
Package accountinventory reports one account's EC2 key pairs, placement groups and launch templates from their owners' stores.
Package accountinventory reports one account's EC2 key pairs, placement groups and launch templates from their owners' stores.
domains/ec2/awsapi
Package awsapi resolves the resource ARNs an EC2 request authorizes against.
Package awsapi resolves the resource ARNs an EC2 request authorizes against.
domains/ec2/awsapi/account
Package 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 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.
domains/ec2/awsapi/capacityreservation
Package 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 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.
domains/ec2/awsapi/eigw
Package eigw implements the EC2 egress-only internet gateway actions: it validates each request and forwards it to the EIGW service over NATS.
Package eigw implements the EC2 egress-only internet gateway actions: it validates each request and forwards it to the EIGW service over NATS.
domains/ec2/awsapi/eip
Package eip implements the EC2 Elastic IP actions: it validates each request and forwards it to the EIP service over NATS.
Package eip implements the EC2 Elastic IP actions: it validates each request and forwards it to the EIP service over NATS.
domains/ec2/awsapi/idem
Package 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 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.
domains/ec2/awsapi/igw
Package igw implements the EC2 internet gateway actions: it validates each request and forwards it to the IGW service over NATS.
Package igw implements the EC2 internet gateway actions: it validates each request and forwards it to the IGW service over NATS.
domains/ec2/awsapi/image
Package image implements the EC2 AMI actions: it validates each request and forwards it to the image service over NATS.
Package image implements the EC2 AMI actions: it validates each request and forwards it to the image service over NATS.
domains/ec2/awsapi/instance
Package 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 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.
domains/ec2/awsapi/key
Package key implements the EC2 key pair actions: it validates each request and forwards it to the key pair service over NATS.
Package key implements the EC2 key pair actions: it validates each request and forwards it to the key pair service over NATS.
domains/ec2/awsapi/launchtemplate
Package launchtemplate implements the EC2 launch template actions: it validates each request and forwards it to the launch template service over NATS.
Package launchtemplate implements the EC2 launch template actions: it validates each request and forwards it to the launch template service over NATS.
domains/ec2/awsapi/natgw
Package natgw implements the EC2 NAT gateway actions: it validates each request and forwards it to the NAT gateway service over NATS.
Package natgw implements the EC2 NAT gateway actions: it validates each request and forwards it to the NAT gateway service over NATS.
domains/ec2/awsapi/placementgroup
Package placementgroup implements the EC2 placement group actions: it validates each request and forwards it to the placement group service over NATS.
Package placementgroup implements the EC2 placement group actions: it validates each request and forwards it to the placement group service over NATS.
domains/ec2/awsapi/routetable
Package routetable implements the EC2 route table actions: it validates each request and forwards it to the route table service over NATS.
Package routetable implements the EC2 route table actions: it validates each request and forwards it to the route table service over NATS.
domains/ec2/awsapi/snapshot
Package snapshot implements the EC2 EBS snapshot actions: it validates each request and forwards it to the snapshot service over NATS.
Package snapshot implements the EC2 EBS snapshot actions: it validates each request and forwards it to the snapshot service over NATS.
domains/ec2/awsapi/spotinstance
Package spotinstance provides the gateway-side orchestration for AWS-compatible Spot Instance Requests.
Package spotinstance provides the gateway-side orchestration for AWS-compatible Spot Instance Requests.
domains/ec2/awsapi/tags
Package tags implements the EC2 tagging actions: it validates each request and forwards it to the tag service over NATS.
Package tags implements the EC2 tagging actions: it validates each request and forwards it to the tag service over NATS.
domains/ec2/awsapi/volume
Package volume implements the EC2 EBS volume actions: it validates each request and forwards it to the volume service over NATS.
Package volume implements the EC2 EBS volume actions: it validates each request and forwards it to the volume service over NATS.
domains/ec2/awsapi/vpc
Package 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 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.
domains/ec2/awsapi/zone
Package zone implements DescribeAvailabilityZones and DescribeRegions, answered from the node's configured region and zone with AWS's filter rules.
Package zone implements DescribeAvailabilityZones and DescribeRegions, answered from the node's configured region and zone with AWS's filter rules.
domains/ec2/ebs/encryption
Package ebsencryption owns EC2's AWS-visible EBS encryption posture: whether a volume the control plane reports is Encrypted.
Package ebsencryption owns EC2's AWS-visible EBS encryption posture: whether a volume the control plane reports is Encrypted.
domains/ec2/ebs/metadata
Package ebsmetadata owns Spinifex's control-plane view of EBS resources.
Package ebsmetadata owns Spinifex's control-plane view of EBS resources.
domains/ec2/ebs/policy
Package ebspolicy owns EC2 EBS product policy that the control plane exposes.
Package ebspolicy owns EC2 EBS product policy that the control plane exposes.
domains/ec2/eigw
Package eigw implements the EC2 egress-only internet gateway actions: the EgressOnlyIGWService contract, its daemon-side JetStream KV implementation and its NATS client.
Package eigw implements the EC2 egress-only internet gateway actions: the EgressOnlyIGWService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/eip
Package 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 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.
domains/ec2/guestmetadata
Package guestmetadata 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 guestmetadata 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.
domains/ec2/igw
Package igw implements the EC2 internet gateway actions: the IGWService contract, its daemon-side JetStream KV implementation and its NATS client.
Package igw implements the EC2 internet gateway actions: the IGWService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/image
Package image implements the EC2 AMI actions: the ImageService contract, its daemon-side implementation over the object store and its NATS client.
Package image implements the EC2 AMI actions: the ImageService contract, its daemon-side implementation over the object store and its NATS client.
domains/ec2/instance
Package 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 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.
domains/ec2/instance/state
Package state provides EC2-domain readers for persisted instance state.
Package state provides EC2-domain readers for persisted instance state.
domains/ec2/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.
domains/ec2/key
Package 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 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.
domains/ec2/launchtemplate
Package launchtemplate implements the EC2 launch template actions: the LaunchTemplateService contract, its daemon-side JetStream KV implementation with immutable versions, and its NATS client.
Package launchtemplate implements the EC2 launch template actions: the LaunchTemplateService contract, its daemon-side JetStream KV implementation with immutable versions, and its NATS client.
domains/ec2/natgw
Package natgw implements the EC2 NAT gateway actions: the NatGatewayService contract, its daemon-side JetStream KV implementation and its NATS client.
Package natgw implements the EC2 NAT gateway actions: the NatGatewayService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/placementgroup
Package placementgroup implements the EC2 placement group actions: the PlacementGroupService contract, its daemon-side JetStream KV implementation and its NATS client.
Package placementgroup implements the EC2 placement group actions: the PlacementGroupService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/platform
Package platform defines EC2-compatible platform and billing metadata.
Package platform defines EC2-compatible platform and billing metadata.
domains/ec2/routetable
Package routetable implements the EC2 route table actions: the RouteTableService contract, its daemon-side JetStream KV implementation and its NATS client.
Package routetable implements the EC2 route table actions: the RouteTableService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/snapshot
Package 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 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.
domains/ec2/spotinstance
Package spotinstance implements the EC2 Spot Instance Request actions: the SpotInstanceService contract, its daemon-side JetStream KV implementation and its NATS client.
Package spotinstance implements the EC2 Spot Instance Request actions: the SpotInstanceService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/systeminstance
Package systeminstance holds the boot-agnostic contract for system-managed VMs.
Package systeminstance holds the boot-agnostic contract for system-managed VMs.
domains/ec2/tagmirror
Package tagmirror applies EC2 CreateTags and DeleteTags changes to the tag maps mirrored on resource records in JetStream KV.
Package tagmirror applies EC2 CreateTags and DeleteTags changes to the tag maps mirrored on resource records in JetStream KV.
domains/ec2/tags
Package tags implements the EC2 tagging actions: the TagsService contract, its daemon-side JetStream KV implementation and its NATS client.
Package tags implements the EC2 tagging actions: the TagsService contract, its daemon-side JetStream KV implementation and its NATS client.
domains/ec2/volume
Package 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 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.
domains/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.
domains/ec2/vpc
Package 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 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.
domains/ecr
Package ecr owns ECR repository and blob semantics, including the S3-compatible storage layout that backs registry data.
Package ecr owns ECR repository and blob semantics, including the S3-compatible storage layout that backs registry data.
domains/ecr/auth
Package 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 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>).
domains/ecr/awsapi
Package awsapi owns ECR's AWS JSON 1.1 action surface: the X-Amz-Target action inventory, request validation, resource-scope derivation and NATS-backed action handlers.
Package awsapi owns ECR's AWS JSON 1.1 action surface: the X-Amz-Target action inventory, request validation, resource-scope derivation and NATS-backed action handlers.
domains/ecr/registry
Package ecrregistry implements ECR's OCI Distribution Spec v2 data-plane adapter (/v2/*).
Package ecrregistry implements ECR's OCI Distribution Spec v2 data-plane adapter (/v2/*).
domains/ecs/taskdefinition
Package taskdefinition owns the ECS task definition: its revision records, revision allocation, reference resolution and deregistration.
Package taskdefinition owns the ECS task definition: its revision records, revision allocation, reference resolution and deregistration.
domains/eks/access
Package access owns the EKS API-mode AccessEntry: its persisted record shape, KV storage, and the supported managed access-policy catalogue.
Package access owns the EKS API-mode AccessEntry: its persisted record shape, KV storage, and the supported managed access-policy catalogue.
domains/eks/addon
Package addon owns the EKS managed add-on: its persisted record and staged manifest, the bundled catalogue, the status transitions and manifest staging.
Package addon owns the EKS managed add-on: its persisted record and staged manifest, the bundled catalogue, the status transitions and manifest staging.
domains/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).
domains/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.
domains/network/external/exonet
Package exonet implements external.Allocator against Exoscale Elastic IPs.
Package exonet implements external.Allocator against Exoscale Elastic IPs.
domains/network/external/ocinet
Package ocinet implements external.Allocator against the Oracle Cloud API.
Package ocinet implements external.Allocator against the Oracle Cloud API.
domains/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.
domains/network/identifiers
Package identifiers derives stable network identifiers from resource IDs.
Package identifiers derives stable network identifiers from resource IDs.
domains/network/invariants
Package invariants holds executable tests that pin the spinifex network layer tree to the safety and liveness invariants declared in the historical, unaccepted PROP-REGIONLOCAL-006 (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 the historical, unaccepted PROP-REGIONLOCAL-006 (docs/development/proposals/region-local-architecture/0006-spinifex-network-layer-contract.md).
domains/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.
domains/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.
domains/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.
domains/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.
domains/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.
domains/network/projection
Package projection is network's authorised view onto the vpc.* NATS realisation boundary described by contracts/network/v1.
Package projection is network's authorised view onto the vpc.* NATS realisation boundary described by contracts/network/v1.
domains/network/reconcile
Package reconcile is the network stack's intent-actual reconciliation layer.
Package reconcile is the network stack's intent-actual reconciliation layer.
domains/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.
domains/network/systemvpc
Package systemvpc builds the managed VPCs Spinifex platform components run their own VMs in — the analogue of AWS's hidden managed-account VPCs.
Package systemvpc builds the managed VPCs Spinifex platform components run their own VMs in — the analogue of AWS's hidden managed-account VPCs.
domains/network/topology
Package topology is L2 of the spinifex network stack.
Package topology is L2 of the spinifex network stack.
domains/ochre
Package ochre 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 ochre 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.
domains/ochre/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.
domains/ochre/vector
Package vector holds Ochre's tenant vector store: the pgvector backend, the KV index registry, and the create/delete/list/ reconcile orchestration over both.
Package vector holds Ochre's tenant vector store: the pgvector backend, the KV index registry, and the create/delete/list/ reconcile orchestration over both.
domains/rds/engine
Package engine owns the RDS engine catalogue: the registry of supported engines, their parameter catalogues, and the size-derived sizing table a parameter default is evaluated against.
Package engine owns the RDS engine catalogue: the registry of supported engines, their parameter catalogues, and the size-derived sizing table a parameter default is evaluated against.
domains/rds/parametergroup
Package parametergroup owns the RDS DB parameter group: its durable record, the stored overrides that sit alongside it, and the in-use guard on its delete.
Package parametergroup owns the RDS DB parameter group: its durable record, the stored overrides that sit alongside it, and the in-use guard on its delete.
domains/rds/subnetgroup
Package subnetgroup owns the RDS DB subnet group: its durable record, the validation of its member subnets, and the in-use guard on its delete.
Package subnetgroup owns the RDS DB subnet group: its durable record, the validation of its member subnets, and the in-use guard on its delete.
domains/tagging
Package tagging owns the read-only Resource Groups Tagging aggregation capability, composed into AWSGW.
Package tagging owns the read-only Resource Groups Tagging aggregation capability, composed into AWSGW.
foundation/aws/ami
Package ami provides small AWS AMI model helpers shared by service domains.
Package ami provides small AWS AMI model helpers shared by service domains.
foundation/aws/arn
Package arn builds AWS resource ARNs.
Package arn builds AWS resource ARNs.
foundation/aws/credentials
Package awscredentials generates AWS-format access key IDs and secret keys.
Package awscredentials generates AWS-format access key IDs and secret keys.
foundation/aws/errors
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.
foundation/aws/filters
Package filters provides AWS filter parsing, tag matching and wildcard comparison primitives without owning any resource's filter semantics.
Package filters provides AWS filter parsing, tag matching and wildcard comparison primitives without owning any resource's filter semantics.
foundation/aws/identifiers
Package identifiers provides small helpers for AWS resource identifiers.
Package identifiers provides small helpers for AWS resource identifiers.
foundation/aws/paging
Package paging pages AWS listing results with opaque resume tokens.
Package paging pages AWS listing results with opaque resume tokens.
foundation/aws/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.
foundation/aws/tags
Package tags defines Spinifex system-tag vocabulary and generic AWS EC2 tag transformations.
Package tags defines Spinifex system-tag vocabulary and generic AWS EC2 tag transformations.
foundation/aws/xml
Package awsxml provides AWS XML and Query-protocol response helpers.
Package awsxml provides AWS XML and Query-protocol response helpers.
foundation/lifecycle/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.
foundation/lifecycle/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.
foundation/lifecycle/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.
foundation/messaging/nats
Package natsmsg holds the shared NATS plumbing: connecting with retry and TLS, account-scoped request/reply and fan-out gathers, and their headers.
Package natsmsg holds the shared NATS plumbing: connecting with retry and TLS, account-scoped request/reply and fan-out gathers, and their headers.
foundation/netaddr
Package netaddr normalises listener addresses for local and off-host use.
Package netaddr normalises listener addresses for local and off-host use.
foundation/pki
Package pki holds generic PEM, key and certificate primitives.
Package pki holds generic PEM, key and certificate primitives.
foundation/state/clustersize
Package clustersize holds one state-tier policy 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 state-tier policy 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.
foundation/state/kvlease
Package kvlease elects a single holder of a JetStream KV key.
Package kvlease elects a single holder of a JetStream KV key.
foundation/state/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.
foundation/state/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.
foundation/state/migrate
Package migrate applies versioned transformations to shared KV state.
Package migrate applies versioned transformations to shared KV state.
foundation/telemetry
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.
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/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/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/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.
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/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/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.
ingress/aws/bodyscope
Package bodyscope reads the identifier fields an AWS ingress policy-scope resolver needs out of a JSON request body, without deserialising the typed input an action adapter will build from the same bytes.
Package bodyscope reads the identifier fields an AWS ingress policy-scope resolver needs out of a JSON request body, without deserialising the typed input an action adapter will build from the same bytes.
ingress/aws/dispatch
Package dispatch is the AWS ingress registration contract.
Package dispatch is the AWS ingress registration contract.
ingress/aws/envelope
Package envelope renders the EC2, IAM-style and S3 XML error envelopes and the AWS JSON 1.1 error body.
Package envelope renders the EC2, IAM-style and S3 XML error envelopes and the AWS JSON 1.1 error body.
ingress/aws/query
Package query decodes AWS Query protocol parameters into SDK request shapes.
Package query decodes AWS Query protocol parameters into SDK request shapes.
ingress/aws/ratelimit
Package ratelimit locks out client addresses that repeatedly fail AWS request authentication.
Package ratelimit locks out client addresses that repeatedly fail AWS request authentication.
ingress/aws/rest
Package rest dispatches AWS REST-JSON requests: it resolves an HTTP method and escaped path to the AWS action, path parameters and handler a service registered for it.
Package rest dispatches AWS REST-JSON requests: it resolves an HTTP method and escaped path to the AWS action, path parameters and handler a service registered for it.
ingress/http
Package http provides generic HTTP ingress helpers.
Package http provides generic HTTP ingress helpers.
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.
operator/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.
operator/cli
Package cli defines the spx command-line interface: the cobra commands that install, configure, start and administer a Spinifex node and its cluster.
Package cli defines the spx command-line interface: the cobra commands that install, configure, start and administer a Spinifex node and its cluster.
operator/host/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.
operator/imagecatalog
Package imagecatalog lists the machine images an operator can import, and downloads, verifies and extracts their disk images.
Package imagecatalog lists the machine images an operator can import, and downloads, verifies and extracts their disk images.
operator/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.
operator/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.
operator/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.
operator/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.
operator/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.
operator/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.
operator/installer/ui
Package ui presents the interactive installer TUI using bubbletea and lipgloss.
Package ui presents the interactive installer TUI using bubbletea and lipgloss.
operator/progress
Package progress provides terminal progress and download helpers for operator commands.
Package progress provides terminal progress and download helpers for operator commands.
operator/upgrade
Package upgrade runs versioned migrations over NATS KV buckets, on-disk config files and object-store data, recording each target's schema version.
Package upgrade runs versioned migrations over NATS KV buckets, on-disk config files and object-store data, recording each target's schema version.
providers/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.
providers/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.
providers/ebs
Package ebsprovider defines Spinifex's provider-neutral block-storage contract.
Package ebsprovider defines Spinifex's provider-neutral block-storage contract.
providers/ebs/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.
providers/ebs/hostile
Package hostile wraps any EBSProvider in one that misbehaves on purpose.
Package hostile wraps any EBSProvider in one that misbehaves on purpose.
providers/ebs/natsserve
Package natsserve is the provider-neutral NATS server for the ebs.provider.v1.* wire contract defined by spinifex/providers/ebs.
Package natsserve is the provider-neutral NATS server for the ebs.provider.v1.* wire contract defined by spinifex/providers/ebs.
providers/ebs/nullprovider
Package nullprovider serves the EBSProvider contract without any storage behind it.
Package nullprovider serves the EBSProvider contract without any storage behind it.
providers/ebs/viperblock
Package viperblock is the Viperblock EBS provider adapter: it serves viperblock volumes through nbdkit and answers the ebs.* NATS topics.
Package viperblock is the Viperblock EBS provider adapter: it serves viperblock volumes through nbdkit and answers the ebs.* NATS topics.
providers/ebs/viperblock/dirty
Package dirty is a read-only capability over the dirty-volume bucket: which node holds a volume's only current copy.
Package dirty is a read-only capability over the dirty-volume bucket: which node holds a volume's only current copy.
providers/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.
runtime/compute/cache
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.
runtime/compute/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.
runtime/compute/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.
runtime/compute/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.
runtime/compute/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.
runtime/compute/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.
runtime/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.
runtime/host/command
Package command runs host commands and applies node-local privilege policy.
Package command runs host commands and applies node-local privilege policy.
runtime/host/dns
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.
runtime/host/process
Package process starts, signals and waits on host processes, and manages the PID files that track them.
Package process starts, signals and waits on host processes, and manages the PID files that track them.
runtime/roles/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.
runtime/roles/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.
runtime/roles/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.
runtime/roles/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.
runtime/roles/qemunbdd
Package qemunbdd implements ebsprovider.EBSProvider over qcow2 files and qemu-nbd.
Package qemunbdd implements ebsprovider.EBSProvider over qcow2 files and qemu-nbd.
runtime/roles/qmpcollector
Package qmpcollector is the per-node guest-metrics producer: it discovers running VMs via the telemetryv1 qmp-telemetry-*.json sidecar contract, 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 the telemetryv1 qmp-telemetry-*.json sidecar contract, 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>.
runtime/roles/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.
runtime/roles/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.
runtime/roles/viperblockd
Package viperblockd runs the Viperblock EBS role: process/role lifecycle and the NATS subscription wiring that starts and stops the Viperblock adapter (providers/ebs/viperblock).
Package viperblockd runs the Viperblock EBS role: process/role lifecycle and the NATS subscription wiring that starts and stops the Viperblock adapter (providers/ebs/viperblock).
runtime/roles/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.
runtime/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.
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