Nicolas Cantu
a6bd0ea14c
**Motivations:** - Single operational reference for deploy script vs manual steps and troubleshooting. **Root causes:** - README mixed http-maps manual path with script using conf.d without full operator context. **Correctifs:** - Align documentation with deploy script paths and prerequisites. **Evolutions:** - Expanded README-ia-enso.md (tables, SSRF context, env vars, rotation, troubleshooting). - Feature doc table and deployment pointers; links from docs/README, infrastructure, services. **Pages affectées:** - deploy/nginx/README-ia-enso.md - docs/features/ia-enso-nginx-proxy-ollama-anythingllm.md - docs/README.md - docs/infrastructure.md - docs/services.md
65 lines
3.5 KiB
Markdown
65 lines
3.5 KiB
Markdown
# Infrastructure
|
||
|
||
## Scope
|
||
|
||
This repository ships shell scripts used on Ubuntu workstations and related LAN hosts. It does **not** define cloud Terraform or CI; it documents how those scripts map to the **private LAN** layout used with the 4NK bastion model.
|
||
|
||
## First deployment shape (client / server)
|
||
|
||
The **primary deployment target** is a **Linux client** that connects over **SSH** to a **remote server** where the **AI stack** (Ollama, AnythingLLM, etc.) and **Git repositories** live. Install scripts in this repo apply mainly to that **server** (or to a LAN workstation that plays the same role). The client uses SSH (and optionally port forwarding) to reach services that bind to the server’s loopback or internal interfaces. See [deployment-target.md](./deployment-target.md).
|
||
|
||
## LAN host roles (reference)
|
||
|
||
Private segment **192.168.1.0/24** (DHCP with MAC reservations). The table matches the host lists in `add-ssh-key.sh`.
|
||
|
||
| IP | Role |
|
||
|----|------|
|
||
| 192.168.1.100 | Proxy / bastion (public entry via DynDNS `4nk.myftp.biz`) |
|
||
| 192.168.1.101 | test |
|
||
| 192.168.1.102 | pre-production |
|
||
| 192.168.1.103 | production |
|
||
| 192.168.1.104 | services (Git, Mempool, Rocket.Chat, …) |
|
||
| 192.168.1.105 | bitcoin |
|
||
| 192.168.1.173 | ia |
|
||
| 192.168.1.164 | Example workstation on LAN (included in `LAN_DIRECT` list) |
|
||
|
||
Internet access to backends uses **SSH ProxyJump** via `ncantu@4nk.myftp.biz` (see `JUMP` in `add-ssh-key.sh`). On the same LAN, direct `ssh ncantu@192.168.1.x` is valid.
|
||
|
||
## Reverse proxy `ia.enso.4nkweb.com` (Ollama / AnythingLLM)
|
||
|
||
Hostname TLS sur le **proxy** `192.168.1.100` : préfixes `/ollama` et `/anythingllm` vers l’hôte LAN `192.168.1.164` (ports `11434` et `3001`). Gate Ollama par **Bearer** au nginx ; AnythingLLM reste derrière son auth applicative.
|
||
|
||
Documentation opérationnelle : [deploy/nginx/README-ia-enso.md](../deploy/nginx/README-ia-enso.md). Fiche évolution : [features/ia-enso-nginx-proxy-ollama-anythingllm.md](./features/ia-enso-nginx-proxy-ollama-anythingllm.md).
|
||
|
||
## Scripts (infrastructure / access)
|
||
|
||
### `add-ssh-key.sh`
|
||
|
||
Appends a fixed **Ed25519 public key** (comment `desk@desk`) to `~/.ssh/authorized_keys` on target hosts.
|
||
|
||
| Mode | When to use |
|
||
|------|-------------|
|
||
| Default | From a machine that can reach `JUMP` (`ncantu@4nk.myftp.biz`), then ProxyJump to each backend IP. |
|
||
| `LAN_DIRECT=1` | Same LAN: direct SSH to each IP in `LAN_IPS` (proxy, backends, `.164`). No bastion hostname. |
|
||
| `ADD_KEY_LOCAL=1` | Already logged in on the target host: update **current user** only (e.g. workstation `.164`). |
|
||
|
||
**Do not run with `sudo`:** the SSH client would use `/root/.ssh` and fail with `Permission denied (publickey)`.
|
||
|
||
**Environment (optional):** `JUMP`, `BACKEND_USER`, `SSH_IDENTITY_FILE`, `SSH_VERBOSE=1`, `EXTRA_LAN_IPS` (with `LAN_DIRECT=1`).
|
||
|
||
### `add-sudo-nopasswd-ncantu.sh`
|
||
|
||
One-time **root** execution: creates `/etc/sudoers.d/99-ncantu-nopasswd` with `ncantu ALL=(ALL) NOPASSWD: ALL`, `chmod 440`, `visudo -c`. Use only where this policy is explicitly required.
|
||
|
||
## Data paths (host)
|
||
|
||
| Path | Purpose |
|
||
|------|---------|
|
||
| `$HOME/anythingllm` | AnythingLLM Docker bind mount (storage + `.env`), default from `install-anythingllm-docker.sh` |
|
||
| `$HOME/.ssh/authorized_keys` | SSH access; updated by `add-ssh-key.sh` modes |
|
||
|
||
## Security notes
|
||
|
||
- SSH is key-based; the embedded key in `add-ssh-key.sh` is for a designated client (`desk@desk`). Rotate or replace in script if the key is compromised.
|
||
- Passwordless sudo reduces interactive friction and **increases** local privilege impact; scope to trusted machines only.
|