docs(reuse): establish reviewed NetKingdom security capabilities
All checks were successful
CI Smoke / source-contract (push) Successful in 14s
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a137ca-5c77-7a71-b9ae-23ad9b0b5684
This commit is contained in:
codex 2026-10-14 06:42:25 +02:00
parent ef64e324b6
commit c42797a2dd
2 changed files with 60 additions and 67 deletions

View file

@ -1,9 +1,7 @@
--- ---
id: capability.railiance.infra-provisioning id: capability.railiance.infra-provisioning
name: RailianceHosts Infrastructure Provisioning name: Host convergence and security baseline
summary: Git-driven server provisioning and convergence for Hosteurope/Hetzner Cloud using Terraform, summary: Ansible inventory, firewall, SSH bootstrap and baseline verification.
cloud-init, and Ansible, with SOPS+age encrypted in-repo secrets and a servers.yaml inventory as source
of truth.
owner: railiance-infra owner: railiance-infra
status: draft status: draft
domain: financials domain: financials
@ -12,20 +10,26 @@ tags:
- terraform - terraform
- ansible - ansible
- infrastructure - infrastructure
- security
- netkingdom
- framework-reuse
maturity: maturity:
discovery: discovery:
current: D4 current: D4
target: D5 target: D5
confidence: high confidence: high
rationale: README documents a complete, concrete quickstart (clone, prerequisites, SOPS/age secrets rationale: README documents a complete, concrete quickstart (clone, prerequisites,
setup, provider setup, terraform apply, ansible convergence) with a specific inventory file (`inventory/servers.yaml`) SOPS/age secrets setup, provider setup, terraform apply, ansible convergence)
as source of truth — an unusually complete operational README among the swept repos. with a specific inventory file (`inventory/servers.yaml`) as source of truth
— an unusually complete operational README among the swept repos.
availability: availability:
current: A2 current: A2
target: A3 target: A3
confidence: high confidence: high
rationale: Real ansible playbooks, terraform config, and scripts/tools present; has `.forgejo/` CI rationale: 'Source interface assessed 2026-10-14: Ansible inventory, firewall,
already; documented as the S1 Infrastructure Substrate layer of the Railiance OAS Stack. SSH bootstrap and baseline verification. Availability describes the delivery
form, not production acceptance. Current hosts differ from the retained Hetzner
provisioning path.'
external_evidence: external_evidence:
completeness: completeness:
level: C2 level: C2
@ -42,41 +46,39 @@ external_evidence:
confidence: low confidence: low
basis: consumer_quality_signals basis: consumer_quality_signals
known_reliability_risks: known_reliability_risks:
- reproducibility not independently re-verified via a live provisioning run in this sweep - reproducibility not independently re-verified via a live provisioning run in
this sweep
discovery: discovery:
intent: Provision and manage servers on Hosteurope/Hetzner Cloud entirely from Git — Terraform for lifecycle, intent: Ansible inventory, firewall, SSH bootstrap and baseline verification
cloud-init for first boot, Ansible for convergence — as the S1 Infrastructure Substrate of the Railiance
OAS Stack.
includes: includes:
- Terraform server lifecycle management - Ansible inventory, firewall, SSH bootstrap and baseline verification
- cloud-init first-boot configuration
- Ansible convergence playbooks
- SOPS+age encrypted secrets in-repo
excludes: excludes:
- Kubernetes cluster bootstrap on top of provisioned hosts (see railiance-cluster) - Current hosts differ from the retained Hetzner provisioning path
- platform services (see railiance-platform)
assumptions: [] assumptions: []
use_cases: [] use_cases:
- 'U06: Operator or automation obtains a bounded SSH certificate and maintains private
connectivity'
- 'U10: Operator recovers identity, custody or data with independently held recovery
material'
- 'U13: Platform owner deploys and rolls back a workload with explicit substrate
and custody bindings'
research_memos: [] research_memos: []
availability: availability:
current_level: A2 current_level: A2
target_level: A3 target_level: A3
current_artifacts: current_artifacts:
- Terraform configs - SCOPE.md
- Ansible playbooks
- scripts/
- tools/
target_artifacts: [] target_artifacts: []
consumption_modes: consumption_modes:
- cli (terraform/ansible) - CLI
- gitops - source
relations: relations:
depends_on: [] depends_on: []
supports: [] supports: []
related_to: [] related_to:
- capability.security.iam-tooling-suite
evidence: evidence:
documentation: documentation:
- README.md
- SCOPE.md - SCOPE.md
tests: tests:
- sbom-tools.yaml - sbom-tools.yaml
@ -86,46 +88,36 @@ evidence:
incidents: [] incidents: []
consumer_guidance: consumer_guidance:
recommended_for: recommended_for:
- operators provisioning Railiance bare-metal/cloud hosts from Git with encrypted-secret custody - Operator or automation obtains a bounded SSH certificate and maintains private
connectivity
- Operator recovers identity, custody or data with independently held recovery material
- Platform owner deploys and rolls back a workload with explicit substrate and custody
bindings
not_recommended_for: not_recommended_for:
- needs above the OS/host substrate layer (see railiance-cluster for Kubernetes, railiance-platform - Current hosts differ from the retained Hetzner provisioning path
for shared services)
known_limitations: known_limitations:
- reproducibility not independently re-verified via a live provisioning run in this sweep - Current hosts differ from the retained Hetzner provisioning path
- 2026-10-14 architecture review estimates operational maturity separately; a registry
entry does not authorize execution or establish deployment.
promotion_history: [] promotion_history: []
--- ---
# RailianceHosts Infrastructure Provisioning # Host convergence and security baseline
## Overview Ansible inventory, firewall, SSH bootstrap and baseline verification.
`railiance-infra` (RailianceHosts) is Git-driven automation for provisioning and converging servers on Hosteurope and Hetzner Cloud — Terraform for lifecycle, cloud-init for first boot, Ansible for convergence — with secrets encrypted in-repo via SOPS/age and `inventory/servers.yaml` as the source of truth. It is the S1 Infrastructure Substrate layer of the Railiance OAS Stack. ## Reuse boundary
## Assessment notes Current hosts differ from the retained Hetzner provisioning path.
### Discovery ## Supported use cases
README documents a complete, concrete quickstart (clone, prerequisites, SOPS/age secrets setup, provider setup, terraform apply, ansible convergence) with a specific inventory file (`inventory/servers.yaml`) as source of truth — an unusually complete operational README among the swept repos. - U06: Operator or automation obtains a bounded SSH certificate and maintains private connectivity
- U10: Operator recovers identity, custody or data with independently held recovery material
- U13: Platform owner deploys and rolls back a workload with explicit substrate and custody bindings
### Availability ## Evidence and integration
Real ansible playbooks, terraform config, and scripts/tools present; has `.forgejo/` CI already; documented as the S1 Infrastructure Substrate layer of the Railiance OAS Stack. - [SCOPE.md](../../SCOPE.md)
### Completeness Assessment: CUST-WP-0081, 2026-10-14. Relations identify interfaces to compose; they do not certify native integration. Existing external evidence levels are retained where present. New entries use conservative C1/R0 until consumer assessment exists.
First-pass honest assessment from the REUSE-WP-0017 coverage campaign
(reuse-surface). No external consumer feedback exists yet; levels reflect
scope-vs-intent documentation quality, not internal code quality.
### Reliability
No production consumer telemetry exists yet; reliability level is
intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence.
## Promotion checklist
- [x] ID follows `capability.<domain>.<name>` pattern
- [x] Maturity enums match `specs/CapabilityMaturityStandard.md`
- [x] `external_evidence` is populated separately from `maturity`
- [ ] Relations reference valid capability IDs (none yet)
- [x] Index entry added in `registry/indexes/capabilities.yaml`

View file

@ -1,22 +1,23 @@
version: 1 version: 1
updated: '2026-07-06' updated: '2026-10-14'
domain: helix_forge domain: helix_forge
capabilities: capabilities:
- id: capability.railiance.infra-provisioning - id: capability.railiance.infra-provisioning
name: RailianceHosts Infrastructure Provisioning name: Host convergence and security baseline
summary: Git-driven server provisioning and convergence for Hosteurope/Hetzner Cloud using Terraform, summary: Ansible inventory, firewall, SSH bootstrap and baseline verification.
cloud-init, and Ansible, with SOPS+age encrypted in-repo secrets and a servers.yaml inventory as source
of truth.
vector: D4 / A2 / C2 / R1
domain: financials domain: financials
status: draft status: draft
owner: railiance-infra owner: railiance-infra
path: registry/capabilities/capability.railiance.infra-provisioning.md
tags: tags:
- railiance - railiance
- terraform - terraform
- ansible - ansible
- infrastructure - infrastructure
- security
- netkingdom
- framework-reuse
vector: D4 / A2 / C2 / R1
path: registry/capabilities/capability.railiance.infra-provisioning.md
consumption_modes: consumption_modes:
- cli (terraform/ansible) - CLI
- gitops - source