autonomic-bot
f283a371bb
Sanitized single-commit public mirror of recipe-maintainer. - Removed test-ssh/.testenv (live creds); added test-ssh/.testenv.example placeholders. - Removed plans/ and planned-updates/ (deployment-planning docs) so no client/ deployment domains appear in the public repo. - All other secret stores were already gitignored. - docs.coopcloud.tech retained as a submodule (public upstream).
43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
# La Suite Docs — First-Time Setup
|
|
|
|
## Prerequisites
|
|
|
|
- DNS: `lasuite-docs.<domain_suffix>` must resolve to the server
|
|
- **Keycloak** must be deployed and running (dependency)
|
|
|
|
## Steps
|
|
|
|
1. **Create the app:**
|
|
```bash
|
|
abra app new lasuite-docs --server <SERVER> --domain lasuite-docs.<DOMAIN_SUFFIX> --no-input
|
|
```
|
|
|
|
2. **Generate secrets:**
|
|
```bash
|
|
abra app secret generate lasuite-docs.<DOMAIN_SUFFIX> --all -m --no-input
|
|
```
|
|
Save output to `recipe-info/testsecrets/lasuite-docs.<DOMAIN_SUFFIX>`.
|
|
|
|
3. **Deploy:**
|
|
```bash
|
|
abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input
|
|
```
|
|
|
|
4. **Keycloak SSO integration:**
|
|
```bash
|
|
python3 recipe-info/lasuite-docs/setup_keycloak_integration.py
|
|
```
|
|
This creates a `lasuite-docs` realm, OIDC client, and test user in Keycloak. It also inserts the client secret and updates the env file.
|
|
|
|
5. **Redeploy with SSO config:**
|
|
```bash
|
|
abra app deploy lasuite-docs.<DOMAIN_SUFFIX> --chaos --force --no-input
|
|
```
|
|
|
|
6. **Verify:** curl `https://lasuite-docs.<DOMAIN_SUFFIX>` returns HTTP 200.
|
|
|
|
## Notes
|
|
|
|
- Credentials are saved to `recipe-info/lasuite-docs/keycloak-test-credentials.<DOMAIN_SUFFIX>.toml`.
|
|
- OIDC test user: `testuser` / `testpass123`.
|