@magistr/cozystack-platform
v2026.03.13.1
Cozystack platform management — install operator, deploy packages, manage apps/tenants, bootstrap CNI, and verify platform health
Labels
cozystackkubernetesinfrastructureplatform
Contents
Quality score
How well-documented and verifiable this extension is.
Not yet scored.
A score will be generated the next time this extension is published. The owner can also trigger scoring manually.
Install
$ swamp extension pull @magistr/cozystack-platform@magistr/cozystack-platformv2026.03.13.1cozystack.ts
getOperatorStatusCheck if Cozystack operator deployment exists and its rollout status
getFluxTenantsStatusCheck flux-tenants deployment state (hostNetwork, tolerations)
getNodePodCIDRsGet current PodCIDR assignments on all nodes
getPlatformPackageCheck if Platform Package CR exists and its status
listAppDefinitionsList available application definitions (what can be deployed)
listAppsList application instances in a namespace (tenant)
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) to list apps in |
getAppGet 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 |
createAppCreate 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 |
deleteAppDelete a Cozystack application instance
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| kind | string | App kind (e.g. postgres, kubernetes) |
| name | string | App instance name |
listTenantsList Cozystack tenants
createTenantCreate a new Cozystack tenant
| Argument | Type | Description |
|---|---|---|
| name | string | Tenant name |
listPackagesList installed Cozystack platform packages
listWorkloadsList workloads and their resource usage across namespaces
getAppSecretGet credentials/secrets for an application (e.g. database passwords)
| Argument | Type | Description |
|---|---|---|
| namespace | string | Namespace (tenant) |
| name | string | Secret name (usually matches app name) |
getTenantKubeconfigGet kubeconfig for a tenant (to access the tenant's Kubernetes API)
updateAppUpdate 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 |
installInstall Cozystack operator via Helm and apply platform ConfigMap (idempotent)
waitReadyWait for Cozystack operator deployment to be ready
applyPackageCreate or update the Platform Package CR that triggers full platform deployment
| Argument | Type | Description |
|---|---|---|
| host | string | Root host domain (e.g. tapok.local) |
| podCIDR | string | Pod CIDR |
| podGateway | string | Pod gateway |
| serviceCIDR | string | Service CIDR |
| joinCIDR | string | Join CIDR |
patchFluxTenantsPatch flux-tenants deployment with hostNetwork and tolerations for bootstrap (needed before CNI is ready)
assignPodCIDRsAssign PodCIDRs to nodes (needed for Cilium IPAM=kubernetes when allocate-node-cidrs=false)
listHelmReleasesList HelmRelease status across all namespaces
| Argument | Type | Description |
|---|---|---|
| readyOnly | boolean | Only show ready releases |
| notReadyOnly | boolean | Only show not-ready releases |
configurePlatformIdempotent 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)