Skip to content

Commit e6e61bb

Browse files
committed
[docs] Tenant names cannot have dashes
Part of cozystack/cozystack#971 Signed-off-by: Nick Volynkin <[email protected]>
1 parent 0a158dd commit e6e61bb

3 files changed

Lines changed: 29 additions & 10 deletions

File tree

‎.gitignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ hugo/
1414

1515
# build directories
1616
/bin
17+
/tmp
1718

1819
# OSX .DS_Store
1920
.DS_Store

‎content/en/docs/guides/tenants.md‎

Lines changed: 15 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,23 @@ A **tenant** is the main unit of security on the platform. The closest analogy w
1111

1212
Tenants can be created recursively and are subject to the following rules:
1313

14-
### Higher-level tenants can access lower-level ones.
14+
### Tenant naming
1515

16-
Higher-level tenants can view and manage the applications of all their children.
16+
Tenant names must be alphanumeric.
17+
Using dashes (`-`) in tenant names is not allowed, unlike with other services.
18+
This limitation exists to keep consistent naming in tenants, nested tenants, and services deployed in them.
1719

18-
### Each tenant has its own domain
20+
### Nested tenants
1921

20-
By default (unless otherwise specified), it inherits the domain of its parent with a prefix of its name, for example, if the parent had the domain `example.org`, then `tenant-foo` would get the domain `foo.example.org` by default.
22+
Tenants can be nested.
23+
A tenant administrator can create nested tenants using the "Tenant" application from the catalogue.
24+
Higher-level tenants can view and manage the applications of all their children tenants.
25+
26+
### Unique domains
27+
28+
Each tenant has its own domain.
29+
By default, (unless otherwise specified), it inherits the domain of its parent with a prefix of its name.
30+
For example, if the parent had the domain `example.org`, then `tenant-foo` would get the domain `foo.example.org` by default.
2131

2232
Kubernetes clusters created in this tenant namespace would get domains like: `kubernetes-cluster.foo.example.org`
2333

@@ -39,5 +49,5 @@ This in turn means:
3949

4050
![tenant services](/img/tenants2.png)
4151

42-
See the reference for the application implementing tenant management: [`tenant`]({{% ref "/docs/reference/applications/tenant" %}})
52+
See the reference for the application implementing tenant management: [`tenant`]({{% ref "/docs/reference/applications/tenant#parameters" %}})
4353

‎content/en/docs/reference/applications/tenant.md‎

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,23 @@ A tenant is the main unit of security on the platform. The closest analogy would
88

99
Tenants can be created recursively and are subject to the following rules:
1010

11-
### Higher-level tenants can access lower-level ones.
11+
### Tenant naming
1212

13-
Higher-level tenants can view and manage the applications of all their children.
13+
Tenant names must be alphanumeric.
14+
Using dashes (`-`) in tenant names is not allowed, unlike with other services.
15+
This limitation exists to keep consistent naming in tenants, nested tenants, and services deployed in them.
1416

15-
### Each tenant has its own domain
17+
### Nested tenants
1618

17-
By default (unless otherwise specified), it inherits the domain of its parent with a prefix of its name, for example, if the parent had the domain `example.org`, then `tenant-foo` would get the domain `foo.example.org` by default.
19+
Tenants can be nested.
20+
A tenant administrator can create nested tenants using the "Tenant" application from the catalogue.
21+
Higher-level tenants can view and manage the applications of all their children tenants.
1822

19-
Kubernetes clusters created in this tenant namespace would get domains like: `kubernetes-cluster.foo.example.org`
23+
### Unique domains
24+
25+
Each tenant has its own domain.
26+
By default, (unless otherwise specified), it inherits the domain of its parent with a prefix of its name.
27+
For example, if the parent had the domain `example.org`, then `tenant-foo` would get the domain `foo.example.org` by default.
2028

2129
Example:
2230
```

0 commit comments

Comments
 (0)