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/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. |
|
spinifex
command
|
|
|
internal
|
|
|
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. |
|
fipsboot
Package fipsboot enforces FIPS 140-3 at startup via blank import in every binary.
|
Package fipsboot enforces FIPS 140-3 at startup via blank import in every binary. |
|
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. |
|
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. |
|
tlsconfig
Package tlsconfig pins the cluster-wide TLS 1.3 curve preference list.
|
Package tlsconfig pins the cluster-wide TLS 1.3 curve preference list. |
|
spinifex
|
|
|
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/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/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/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/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. |
|
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/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/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/sysinstance
Package sysinstance holds the boot-agnostic contract for system-managed VMs.
|
Package sysinstance holds the boot-agnostic contract for system-managed VMs. |
|
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. |
|
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/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/az-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/az-local-architecture/0006-spinifex-network-layer-contract.md). |
|
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 configures OpenTelemetry tracing and metrics for Mulga services.
|
Package otelsetup configures OpenTelemetry tracing and metrics for Mulga services. |
|
services/qmpcollector
Package qmpcollector is the per-node guest-metrics producer (Goanna Phase 1): 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 (Goanna Phase 1): 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>. |
|
tags
Package tags defines tag keys for Spinifex system-owned resources.
|
Package tags defines tag keys for Spinifex system-owned resources. |
|
tests
|
|
|
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 (Bead 5): fixture-create lint + NATS subject lint, both ratcheted against a checked-in baseline.
|
Command manifest-lint runs the e2e manifest drift guards (Bead 5): 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. |
Click to show internal directories.
Click to hide internal directories.