diff --git a/k8s/AGENTS.md b/k8s/AGENTS.md index a346fcc..f22c3e8 100644 --- a/k8s/AGENTS.md +++ b/k8s/AGENTS.md @@ -32,6 +32,32 @@ This directory contains the Kubernetes manifests and Helm charts for a single-no * `*.secret.values` * `*.secret.sh` +## Remote Access +It is possible to execute commands on the remote Linux node for information retrieval or troubleshooting. + +* **Host**: `haumdaucher.de` +* **User**: `moritz` (local user) +* **Privileges**: Use `sudo` to gain root privileges. + +> [!CAUTION] +> **SSH Identity Required**: The agent cannot enter an SSH passphrase. +> If SSH commands fail with authentication errors, request the user to run `ssh-add` locally to load their identity. + +### Command Execution +You can execute commands remotely via SSH. This is useful for checking node-level resources (memory, disk, etc.) that `kubectl` might not expose directly. + +**Example: Check Memory Usage** +```bash +ssh moritz@haumdaucher.de "free -h" +``` + +**Example: Check Disk Usage (with sudo)** +```bash +ssh -t moritz@haumdaucher.de "sudo df -h" +``` +*Note: The `-t` flag forces pseudo-terminal allocation, which is often required for `sudo` prompts.* + + ## Deployment Instructions **Always consult `README.md` first.** Deployments vary between Helm charts and raw manifests.