Platform Ops
01README
All-in-one platform operations toolkit.
Included
- Infrastructure models — provision and teardown with status tracking
- Compliance scanning — automated audit with remediation
- SSH driver — remote execution on provisioned hosts
- State persistence — PostgreSQL-backed state store
- Secrets — platform credential management
- Reports — compliance and resource inventory
Depends on
@swampadmin/vault-secretsand@swampadmin/db-adapters.
02Release Notes
Highlights
This extension demonstrates every content type swamp supports:
- 2 models — infrastructure provisioning and compliance scanning
- 1 workflow — provision environment then run compliance
- 1 vault — platform secret storage
- 1 datastore — persistent state backend
- 1 driver — SSH remote execution
- 2 reports — compliance audit and resource inventory
03Models
@swampadmin/platform-ops/infrav1.0.0infra.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| environment | string | Target environment (dev, staging, prod) |
| region | string | Deployment region |
| dry_run? | boolean | Preview changes without applying |
fn provision(environment: string, size?: string, count?: number)
provision operation
| Argument | Type | Description |
|---|---|---|
| environment | string | Target environment name |
| size? | string | Instance size (small, medium, large) |
| count? | number | Number of instances |
fn teardown(name: string)
teardown operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
fn status(name: string)
status operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
Resources
infra.state(persistent)— Managed resource state
infra.lock(ephemeral)— Concurrency lock
@swampadmin/platform-ops/compliancev1.0.0compliance.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| environment | string | Target environment (dev, staging, prod) |
| region | string | Deployment region |
| dry_run? | boolean | Preview changes without applying |
fn scan(scope?: string, severity?: string)
scan operation
| Argument | Type | Description |
|---|---|---|
| scope? | string | Scan scope (all, network, storage, compute) |
| severity? | string | Minimum severity level (low, medium, high, critical) |
fn remediate(name: string)
remediate operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
fn audit(name: string)
audit operation
| Argument | Type | Description |
|---|---|---|
| name | string | Resource name |
Files
compliance.log(text/plain)— Operation audit log
compliance.json(application/json)— Structured output
04Workflows
Provision Environmentprovision-env
Provision Environment workflow
provision-env-jobExecute Provision Environment
1.Provision Infra@swampadmin/platform-ops/infra.provision— Provision Infra step
2.Run Compliance@swampadmin/platform-ops/compliance.scan— Run Compliance step
05Vaults
platform-secretsconfigurable
vault-providerplatform-secrets.ts
platform-secrets secrets provider
Config Fields
| Field | Type | Description |
|---|---|---|
| backend | string | Vault backend type (hashicorp, aws, env) |
| prefix? | string | Key prefix for secret namespacing |
06Datastores
platform-stateconfigurable
datastore-providerstate-db.ts
platform-state datastore provider
Config Fields
| Field | Type | Description |
|---|---|---|
| connection_string | string | Database connection URL |
07Drivers
ssh-executorconfigurable
driverssh.ts
ssh-executor execution driver
Config Fields
| Field | Type | Description |
|---|---|---|
| host | string | SSH target hostname or IP |
| port? | number | SSH port (default: 22) |
| user | string | SSH username |
| private_key_path? | string | Path to SSH private key |
| proxy_host? | string | Jump host / bastion for tunneling |
08Reports
compliance-reportmodel
compliance-report.ts
Aggregated compliance scan results across all provisioned infrastructure with remediation priorities
complianceauditsecurity
resource-inventoryworkflow
resource-inventory.ts
Full resource inventory collected during provisioning workflows with lifecycle status tracking
inventoryresources
09Stats
Downloads
0
Archive size
152.0 KB
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
10Platforms
11Labels