ankra org

Manage organisations

ankra org

Commands to list, switch, create, and manage organisations.

ankra org create

Create a new organisation

ankra org create <name> [flags]

Flags

Flag	Default	Description
--country		Country code for the organisation
-o, --output		Output format: json or yaml (default: human-readable)

ankra org current

Show the currently selected organisation

ankra org current [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org dns

Manage CNAME/A/TXT records under the organisation’s own delegated DNS zone (shown by ‘ankra org dns zone’). Records are reconciled asynchronously: a new or edited record starts in state pending and turns active once it is published to the authoritative nameservers.

ankra org dns zone ankra org dns list ankra org dns add chat CNAME lb-1234.example-lb.com —ttl 300 ankra org dns update chat target.example.com ankra org dns delete chat

Creating, editing, and deleting records requires organisation admin.

ankra org dns add

Add a record to the organisation’s delegated zone. The name is the label inside the zone (the zone fqdn is appended server-side), the type is one of CNAME, A, or TXT, and the content is the record target.

ankra org dns add chat CNAME lb-1234.example-lb.com —ttl 300 ankra org dns add app A 203.0.113.10 ankra org dns add eu TXT “v=spf1 ~all”

ankra org dns add <name> <type> <content> [flags]

Flags

Flag	Default	Description
--ttl	0	TTL in seconds (30..86400); omitted means Auto

ankra org dns delete

Delete a record, referenced by its id or by its name (the label or the full fqdn). When several records share a name, disambiguate with —type.

ankra org dns delete <record> [flags]

Flags

Flag	Default	Description
--type		Record type (CNAME, A, TXT) to disambiguate a name reference
--yes	false	Skip the confirmation prompt

ankra org dns list

List the organisation’s DNS records

ankra org dns list [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org dns update

Re-point a record at new content. The record is referenced by its id or by its name (the label or the full fqdn); the name and type of a record never change - delete and re-add to rename. Pass —ttl to change the ttl at the same time.

ankra org dns update <record> <content> [flags]

Flags

Flag	Default	Description
--ttl	0	TTL in seconds (30..86400); omitted keeps the record’s current ttl
--type		Record type (CNAME, A, TXT) to disambiguate a name reference

ankra org dns zone

Show the organisation’s delegated DNS zone

ankra org dns zone [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org invite

Invite a user by email to the current organisation.

Valid roles: owner, admin, operator, member (default), viewer, read-only. owner/operator alias onto admin/member on the invite until the RBAC assignments API ships; run ‘ankra org roles’ for the full list.

Examples: ankra org invite [e-mail] ankra org invite [e-mail] —role admin ankra org invite [e-mail] —role viewer

ankra org invite <email> [flags]

Flags

Flag	Default	Description
--role	member	Role for the invited user (owner, admin, operator, member, viewer, read-only)

ankra org list

List all organisations you belong to

ankra org list [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org members

List members of an organisation

ankra org members [org_id] [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org remove

Remove a user from the current organisation

ankra org remove <user_id> [flags]

Flags

Flag	Default	Description
-f, --force	false	Skip confirmation prompt

ankra org roles

List the assignable organisation roles

ankra org roles

ankra org switch

Switch to a different organisation by slug, name, or ID

ankra org switch <organisation>

ankra org variables

Manage organisation-scoped variables that are available to every cluster in the organisation as template substitutions in stack manifests and addon values.

ankra org variables list ankra org variables get DB_HOST ankra org variables set DB_HOST db.prod.example.com —description “Primary database” ankra org variables delete DB_HOST

Variable resolution order at deploy time is stack > cluster > organisation; a more specific scope overrides a less specific one.

ankra org variables delete

Delete an organisation variable

ankra org variables delete <name> [flags]

Flags

Flag	Default	Description
--yes	false	Skip the confirmation prompt

ankra org variables get

Get a single organisation variable

ankra org variables get <name> [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org variables list

List all organisation variables

ankra org variables list [flags]

Flags

Flag	Default	Description
-o, --output		Output format: json or yaml (default: human-readable)

ankra org variables set

Create or update an organisation variable (upsert). If the variable does not exist it is created; otherwise its value (and description, when supplied) is updated.

The value can also be read from stdin by passing ”-”:

echo “secret-token” | ankra org variables set API_TOKEN -

ankra org variables set <name> <value> [flags]

Flags

Flag	Default	Description
--description		Optional human-readable description