Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions kits/infrastructure.application-api-service/1.1.0/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Application/API service

Reusable application/api service with domain-specific configuration, declared service surfaces, seeded objects, and pack-local integration material.

The release includes a RAES module, explicit service and identity surfaces, benign seed inventory, planning estimates, component-inventory inputs, integration guidance, and composition tests.

It is authoring content, not a runtime plugin, scenario narrative, backend qualification, or evidence claim.
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Application/API service integration material

Author parameter: `api_base_path` (default `/api`).

## Exported RAES declarations

- `nodes.application`
- `content.seed_inventory`
- `accounts.application_service`

## Composition notes

- No mandatory external authoring prerequisite; connect exported surfaces at the pack composition root as needed.
- Keep credentials and runtime-selected endpoints outside kit parameters and seed assets.
- Validate the completed ordinary pack after adding pack-level relationships.
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
schema_version: environment-kit-seed/v1
kit: infrastructure.application-api-service
configuration:
api_base_path: /api
deployment_profile: standard
service_label: application-api-service
declared_objects:
- id: api_routes
kind: infrastructure-seed
sensitivity: non-secret
- id: health_route
kind: infrastructure-seed
sensitivity: non-secret
- id: seed_records
kind: infrastructure-seed
sensitivity: non-secret
- id: service_account
kind: infrastructure-seed
sensitivity: non-secret
integration_requirements:
- No mandatory external authoring prerequisite; connect exported surfaces at the pack
composition root as needed.
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
{
"schema_version": "associated-artifact-manifest/v1",
"manifest_id": "infrastructure.application-api-service-associated-artifacts",
"manifest_version": "1.1.0",
"canonicalization_profile": "associated-artifact-set/v1",
"scope": "scenario",
"parent_ref": {
"ref_kind": "scenario-snapshot",
"ref_id": "application-api-service",
"ref_version": null,
"ref_digest": "sha256:7a1862b94da049003de43ed8261dd29cb3d35de793ca707d38a6ff3582584ccf",
"ref_path": null
},
"artifacts": {
"readme": {
"artifact_id": "readme",
"role": "documentation",
"media_type": "text/markdown",
"uri": "raes-environment-kit:/README.md",
"checksum": {
"algorithm": "sha256",
"value": "e601eec18bf601b1426a61ee43794c4173ab3673641e6f23740a0b1fec9ce7f4"
},
"size_bytes": 479,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
},
"integration-material": {
"artifact_id": "integration-material",
"role": "operator-guide",
"media_type": "text/markdown",
"uri": "raes-environment-kit:/assets/integration.md",
"checksum": {
"algorithm": "sha256",
"value": "0b5b6dea0cfa31296c5a41a23a57ed19143f5da2fc6657b6a5a14640a45b8ef4"
},
"size_bytes": 519,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
},
"seed-profile": {
"artifact_id": "seed-profile",
"role": "configuration",
"media_type": "application/yaml",
"uri": "raes-environment-kit:/assets/seed.yaml",
"checksum": {
"algorithm": "sha256",
"value": "f327d3afd9a2a5bc0852d65bdc7a3af18db5d803fdfeeffe325930b9fcc3522a"
},
"size_bytes": 646,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
},
"kit-manifest": {
"artifact_id": "kit-manifest",
"role": "manifest",
"media_type": "application/yaml",
"uri": "raes-environment-kit:/kit.yaml",
"checksum": {
"algorithm": "sha256",
"value": "edf2a18513d11f760826a3667b81d042c2d37bd0cddf6cb95444a9516f9e198a"
},
"size_bytes": 1698,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
},
"module": {
"artifact_id": "module",
"role": "configuration",
"media_type": "application/yaml",
"uri": "raes-environment-kit:/module.sdl.yaml",
"checksum": {
"algorithm": "sha256",
"value": "f22658a0f96cc0db8fef64ea253406235394f6524d8b0d1a0154b4a5007768ab"
},
"size_bytes": 2896,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
},
"composition-tests": {
"artifact_id": "composition-tests",
"role": "configuration",
"media_type": "application/yaml",
"uri": "raes-environment-kit:/tests/composition.yaml",
"checksum": {
"algorithm": "sha256",
"value": "733c5117c59c5d2dbf7cfeb0a25594f989dd1ad8f22bdfeee760ea43223cc066"
},
"size_bytes": 248,
"created_at": "2026-10-09T00:00:00Z",
"source": "infrastructure.application-api-service@1.1.0",
"satisfies_refs": [],
"sensitivity": "public",
"description": null
}
},
"set_digest": "sha256:8e34aa86384f20b90d7610a93406488b83a601a6c8a2f2d230f5a50cf4e72750"
}
49 changes: 49 additions & 0 deletions kits/infrastructure.application-api-service/1.1.0/kit.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
schema_version: environment-pack-kit/v1
id: infrastructure.application-api-service
version: 1.1.0
title: Application/API service
summary: Reusable application/api service with domain-specific configuration, declared
service surfaces, seeded objects, and pack-local integration material.
concern: network-shared
released_at: '2026-10-09T00:00:00Z'
module:
path: module.sdl.yaml
assets:
- source: assets/integration.md
target: assets/kits/application-api-service/integration.md
visibility: operator
artifact_id: integration-material
- source: assets/seed.yaml
target: assets/kits/application-api-service/seed.yaml
visibility: operator
artifact_id: seed-profile
resources:
cpu_cores: 2
memory_mib: 2048
storage_mib: 4096
notes: Planning estimates only; realization sizing remains backend-owned.
prerequisites: []
limitations:
- Declares static infrastructure, seeded state, and integration surfaces only.
- Does not claim launch, readiness, traffic attachment, credential delivery, or runtime
evidence.
- No mandatory external authoring prerequisite; connect exported surfaces at the pack
composition root as needed.
license:
expression: MIT
redistribution: open
attribution: OpenRAE contributors
tests:
- path: tests/composition.yaml
kind: validate
- path: tests/composition.yaml
kind: parameter-variation
- path: tests/composition.yaml
kind: multi-kit
component_inventory:
- scope: unresolved
authority: raes-source
ref: /nodes/application/source
description: RAES carries the declared application-service stable source; immutable
artifact selection remains unresolved until pack publication.
associated_artifact_manifest: associated-artifacts.json
110 changes: 110 additions & 0 deletions kits/infrastructure.application-api-service/1.1.0/module.sdl.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
name: application-api-service
version: 1.1.0
description: Reusable static infrastructure for Application/API service. Configures
api_base_path through the kit parameter contract.
module:
id: infrastructure/application-api-service
version: 1.1.0
parameters:
- deployment_profile
- service_label
- api_base_path
exports:
nodes:
- application
content:
- seed_inventory
accounts:
- application_service
description: Composable Application/API service infrastructure module.
variables:
deployment_profile:
type: string
default: standard
allowed_values:
- compact
- standard
service_label:
type: string
default: application-api-service
api_base_path:
type: string
default: /api
nodes:
application:
type: compute
description: '${deployment_profile} profile for ${service_label} (Application/API
service). Configuration: ${api_base_path}.'
source:
name: application-service
version: stable
resources:
cpu: 2
ram: 2 GiB
services:
- port: 8080
protocol: tcp
name: http
description: Declared http service surface.
runtime:
applications:
- application_id: application_surface
service: http
protocol: http
name: Application surface
routes:
- route_id: primary
path: ${api_base_path}
methods:
- GET
responses:
- status_code: 200
description: Declared primary response.
- route_id: health
path: /health
methods:
- GET
responses:
- status_code: 200
description: Declared health response.
content:
seed_inventory:
type: dataset
target: application
description: Benign infrastructure seed inventory for ${api_base_path}.
items:
- name: api_routes
display_name: Api Routes
tags:
- infrastructure
- seed
description: Declared api routes for this reusable service.
- name: health_route
display_name: Health Route
tags:
- infrastructure
- seed
description: Declared health route for this reusable service.
- name: seed_records
display_name: Seed Records
tags:
- infrastructure
- seed
description: Declared seed records for this reusable service.
- name: service_account
display_name: Service Account
tags:
- infrastructure
- seed
description: Declared service account for this reusable service.
accounts:
application_service:
username: application-service
node: application
password_strength: strong
description: Declared environment account; credential delivery remains backend-owned.
realization:
constraints:
- field_pointer: /nodes/application
concern: compute-substrate
posture: open
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
default:
deployment_profile: standard
service_label: application-api-service
api_base_path: /api
variation:
deployment_profile: compact
service_label: application-api-service-alternate
api_base_path: /v2
multi_kit_group: network-shared
7 changes: 7 additions & 0 deletions kits/infrastructure.postgresql-database/1.1.0/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# PostgreSQL database

Reusable postgresql database with domain-specific configuration, declared service surfaces, seeded objects, and pack-local integration material.

The release includes a RAES module, explicit service and identity surfaces, benign seed inventory, planning estimates, component-inventory inputs, integration guidance, and composition tests.

It is authoring content, not a runtime plugin, scenario narrative, backend qualification, or evidence claim.
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# PostgreSQL database integration material

Author parameter: `database_name` (default `environment`).

## Exported RAES declarations

- `nodes.database`
- `content.seed_inventory`
- `accounts.database_operator`

## Composition notes

- No mandatory external authoring prerequisite; connect exported surfaces at the pack composition root as needed.
- Keep credentials and runtime-selected endpoints outside kit parameters and seed assets.
- Validate the completed ordinary pack after adding pack-level relationships.
25 changes: 25 additions & 0 deletions kits/infrastructure.postgresql-database/1.1.0/assets/seed.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
schema_version: environment-kit-seed/v1
kit: infrastructure.postgresql-database
configuration:
database_name: environment
deployment_profile: standard
service_label: postgresql-database
declared_objects:
- id: database
kind: infrastructure-seed
sensitivity: non-secret
- id: schemas
kind: infrastructure-seed
sensitivity: non-secret
- id: tables
kind: infrastructure-seed
sensitivity: non-secret
- id: roles
kind: infrastructure-seed
sensitivity: non-secret
- id: seed_rows
kind: infrastructure-seed
sensitivity: non-secret
integration_requirements:
- No mandatory external authoring prerequisite; connect exported surfaces at the pack
composition root as needed.
Loading
Loading