Cozystack Platform
@magistr/cozystack-platformv2026.05.25.1
01README
Cozystack platform management — install operator, deploy packages, manage apps/tenants, bootstrap CNI, and verify platform health
02Release Notes
Merge pull request #4 from umag/extensions/magistr-grade-a-workspace
extensions: stage 15 @magistr extensions as Grade A workspace dirs + wire CI
03Models
@magistr/cozystack-platformv2026.05.25.1cozystack.ts
fn getOperatorStatus()
Check if Cozystack operator deployment exists and its rollout status
fn getFluxTenantsStatus()
Check flux-tenants deployment state (hostNetwork, tolerations)
fn getNodePodCIDRs()
Get current PodCIDR assignments on all nodes
fn getPlatformPackage()
Check if Platform Package CR exists and its status
fn listAppDefinitions()
List available application definitions (what can be deployed)
fn listApps(namespace: string)
List application instances in a namespace (tenant)
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) to list apps in |
fn getApp(namespace: string, kind: string, name: string)
Get a specific application instance
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| kind | string | App kind (e.g. postgres, kubernetes, redis) |
| name | string | App instance name |
fn createApp(namespace: string, kind: string, name: string)
Create a Cozystack application (Kubernetes cluster, database, VM, etc.)
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) to deploy in |
| kind | string | App kind (e.g. Postgres, Kubernetes, Redis, VirtualMachine) |
| name | string | Name for the app instance |
fn deleteApp(namespace: string, kind: string, name: string)
Delete a Cozystack application instance
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| kind | string | App kind (e.g. postgres, kubernetes) |
| name | string | App instance name |
fn listTenants()
List Cozystack tenants
fn createTenant(name: string)
Create a new Cozystack tenant
| Argument | Type | Description |
|---|---|---|
| name | string | Tenant name |
fn listPackages()
List installed Cozystack platform packages
fn listWorkloads()
List workloads and their resource usage across namespaces
fn getAppSecret(namespace: string, name: string)
Get credentials/secrets for an application (e.g. database passwords)
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| name | string | Secret name (usually matches app name) |
fn getTenantKubeconfig()
Get kubeconfig for a tenant (to access the tenant's Kubernetes API)
fn updateApp(namespace: string, kind: string, name: string)
Update an existing Cozystack application spec
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| kind | string | App kind (e.g. postgres, kubernetes) |
| name | string | App instance name |
fn install()
Install Cozystack operator via Helm and apply platform ConfigMap (idempotent)
fn waitReady()
Wait for Cozystack operator deployment to be ready
fn applyPackage(host: string, podCIDR: string, podGateway: string, serviceCIDR: string, joinCIDR: string)
Create or update the Platform Package CR that triggers full platform deployment
| Argument | Type | Description |
|---|---|---|
| host | string | Root host domain (e.g. cluster.example) |
| podCIDR | string | Pod CIDR |
| podGateway | string | Pod gateway |
| serviceCIDR | string | Service CIDR |
| joinCIDR | string | Join CIDR |
fn patchFluxTenants()
Patch flux-tenants deployment with hostNetwork and tolerations for bootstrap (needed before CNI is ready)
fn assignPodCIDRs()
Assign PodCIDRs to nodes (needed for Cilium IPAM=kubernetes when allocate-node-cidrs=false)
fn listHelmReleases(readyOnly: boolean, notReadyOnly: boolean)
List HelmRelease status across all namespaces
| Argument | Type | Description |
|---|---|---|
| readyOnly | boolean | Only show ready releases |
| notReadyOnly | boolean | Only show not-ready releases |
fn configurePlatform()
Idempotent platform configuration (enable ingress, monitoring, etcd on root tenant)
Resources
appDef(infinite)— Cozystack application definition
app(infinite)— Cozystack application instance
workload(infinite)— Cozystack workload status
package(infinite)— Cozystack platform package
tenant(infinite)— Cozystack tenant
result(infinite)— Operation result
secret(infinite)— Application secret (credentials)
04Previous Versions
2026.03.13.1Mar 13, 2026
05Stats
A
100 / 100
Downloads
1
Archive size
21.9 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
Repository
https://github.com/umag/swamp-workspace06Platforms
07Labels