Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Configuration

Key Files

FilePurpose
devenv.nixPackages, services, processes, tasks, shell configuration
devenv.yamlNix inputs configuration
.envrcdirenv integration
.envRuntime environment variables (dotenv)
scripts/kdc-init.shIdempotent KDC initialization
pyproject.tomlPython project config (dependencies, dev tools)
TiltfileTilt dev iteration config (image builds, port forwards)

Infrastructure Configuration

FilePurpose
infra/aws/tofu/variables.tfOpenTofu variable definitions
infra/aws/tofu/terraform.tfvarsShared deployment defaults
infra/aws/ansible/group_vars/all.ymlAnsible shared variables
zarf/zarf.yamlAir-gap package definition
policy/tofu/*.regoOPA policies for OpenTofu plans
policy/k8s/*.regoOPA policies for Kubernetes

Environment Variables

Kerberos

VariableDefaultPurpose
KRB5_REALMDEV.VISTA.ZNDX.ORGKerberos realm {ENV}.{LOCATION}.ZNDX.ORG (non-secret)
SIGNALS_KRB_ENVdevEnv segment → DEV in realm
SIGNALS_KRB_LOCATIONvistaLocation segment → VISTA in realm
SIGNALS_KRB_HOSTtinybox.dev.vista.zndx.orgKerberos SPN host FQDN
SIGNALS_KRB_USER_KEYTAB(optional)SecretSpec: path to signals@… keytab
POSTGRES_KRB_KEYTAB(optional)SecretSpec: path to postgres SPN keytab

See Secrets and secretspec.toml for the full declared set. | KRB5_KDC_PORT | 8848 | KDC listener port | | KRB5_CONFIG | .devenv/kdc/krb5.conf | krb5 client config (set by shell) | | KRB5_KDC_PROFILE | .devenv/kdc/kdc.conf | KDC server config (set by shell) | | KRB5CCNAME | .devenv/kdc/krb5cc | Credential cache (set by shell) |

AWS / Cloudflare (set for deployment)

VariablePurpose
AWS_REGIONAWS region for provisioning
CLOUDFLARE_TUNNEL_TOKENTunnel credentials (from tofu output)
CLOUDFLARE_TUNNEL_IDTunnel identifier (from tofu output)

Project Structure

signals-360/
├── components/          # ASF submodules (atlas, ranger, kudu, ...)
├── docs/
│   ├── current/         # mdbook documentation
│   └── scratch/         # Work notes
├── features/            # BDD feature specifications
│   ├── agent/           # S01-S03 scenarios
│   ├── analytics/       # S04-S06 scenarios
│   └── platform/        # Infrastructure scenarios
├── infra/               # Deployment infrastructure
│   └── aws/             # OpenTofu + Ansible
├── policy/              # OPA Rego policies
├── scripts/             # Shell scripts (kdc-init)
├── tilt/                # Tilt dev overlays
├── zarf/                # Air-gap packaging
├── devenv.nix           # Development environment
├── pyproject.toml       # Python project config
└── Tiltfile             # Tilt configuration