Skip to content

Commit 499f1ad

Browse files
committed
docs: point the CLI realm endpoint at Core's LB, not the node's user-api
The exordos CLI authenticates via the "default" client alias, which only Core's load balancer (port 80) knows how to rewrite to the real IAM client + inject X-Client-Id/X-Client-Secret — the same mechanism already documented above for the raw curl example. Pointing set-realm at the node's own user-api port (:11010) instead bypasses the LB, so the alias can't resolve and every CLI command fails with "Can't parse value: uuid=default." Verified against a fresh bootstrap.
1 parent 9e6cb07 commit 499f1ad

2 files changed

Lines changed: 12 additions & 2 deletions

File tree

docs/usage/local_deployment.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,10 +126,15 @@ field. Use this token as a `Bearer` token in all subsequent API requests.
126126
Configure the `exordos` CLI by registering a realm and a context with the admin credentials:
127127

128128
```bash
129-
exordos settings set-realm local --endpoint http://10.20.0.2:11010 --current
129+
exordos settings set-realm local --endpoint http://10.20.0.2:80/api/core --current
130130
exordos settings set-context local --name admin -u <ADMIN_USERNAME> -p <ADMIN_PASSWORD> --current
131131
```
132132

133+
The CLI authenticates against the `default` client alias (see above), which only Core's load
134+
balancer on port 80 knows how to rewrite. Pointing the realm at the node's own user-api port
135+
(`:11010`) instead skips the load balancer, so the alias can't be resolved and every command fails
136+
with `Can't parse value: uuid=default.`
137+
133138
- `set-realm` registers the platform endpoint under the name `local` and marks it as the active realm.
134139
- `set-context` creates a named context with the admin credentials and marks it as the active context.
135140

docs/usage/local_deployment.ru.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,10 +126,15 @@ curl --location 'http://10.20.0.2:80/api/core/v1/iam/clients/default/actions/get
126126
Настройте CLI `exordos`, зарегистрировав realm и контекст с учётными данными администратора:
127127

128128
```bash
129-
exordos settings set-realm local --endpoint http://10.20.0.2:11010 --current
129+
exordos settings set-realm local --endpoint http://10.20.0.2:80/api/core --current
130130
exordos settings set-context local --name admin -u <ADMIN_USERNAME> -p <ADMIN_PASSWORD> --current
131131
```
132132

133+
CLI аутентифицируется через алиас клиента `default` (см. выше), который умеет переписывать только
134+
балансировщик Core на порту 80. Если указать в качестве realm порт user-api самой ноды (`:11010`),
135+
балансировщик будет пропущен, алиас не резолвится, и любая команда падает с
136+
`Can't parse value: uuid=default.`
137+
133138
- `set-realm` — регистрирует endpoint платформы под именем `local` и устанавливает его как активный realm.
134139
- `set-context` — создаёт именованный контекст с учётными данными администратора и устанавливает его как активный.
135140

0 commit comments

Comments
 (0)