Files
akyldash/docs/operations/ACCESS.md
T
agent 02cf4e6e95
CI / tests-and-images (pull_request) Has been cancelled
Expose drift verifier through a fixed sudo helper
2026-10-11 19:39:02 +03:00

3.5 KiB

Infrastructure access

Discover existing access first

In a new Codex session, inspect the SSH alias and key file metadata without printing key contents, then check the connection:

ssh -F ~/.ssh/config -G akyldash_vps | awk '$1 == "hostname" || $1 == "user" || $1 == "port" || $1 == "identityfile" { print }'
test -r ~/.ssh/akyldash_codex && echo 'SSH key is available'
ssh -F ~/.ssh/config -o BatchMode=yes akyldash_vps 'id; hostname'
gitea-api GET /version
gitea-api GET /repos/admin/akyldash

Do not ask for the host, login, password, token, or key again before these checks. Never print a private key, token, or complete environment file.

VPS

  • SSH alias: akyldash_vps, user codex, host 206.223.249.118, port 22.
  • SSH configuration: ~/.ssh/config.
  • Identity file: ~/.ssh/akyldash_codex (path only; never copy its contents).
  • codex can run unprivileged read-only diagnostics. The audited account has no non-interactive sudo and must not be added to sudo or the docker group.
  • Host package installation, service setup, firewall changes, secret creation, backup creation, recovery apply, and deployment require owner approval and a reviewed root command. After the owner installs the root-owned repository checkout, infra/deploy/install-helper.sh can grant a fixed read-only verifier and guarded rollback command through sudoers; neither helper is installed on the audited VPS.
  • Never connect to other VPS hosts or Synology as part of this deployment.

This execution environment is WSL2. The repository is on the Windows-mounted /mnt/d filesystem, while SSH config and the identity file are in the Linux home directory. Do not assume Windows SSH credentials are available or copy keys between environments. Plain ssh akyldash_vps failed because the system SSH config include had unsafe permissions. Use ssh -F ~/.ssh/config ...; in a network-restricted session this read-only command may also require approved execution. If the key is missing in a future environment, report that limitation and do not retrieve it elsewhere.

Gitea

  • Repository: https://git.vakanaut.ru/admin/akyldash.
  • Use the installed gitea-api helper; it reads credentials from the environment. Never inspect local credential files, print environment values, or construct HTTP authorization headers.
  • The audited API token can read/write this repository and create issues, but does not have read:user or read:package. An API 403 caused by a missing scope is not evidence that the account itself lacks the permission.
  • Protected main requires one approval. Do not push directly to main, merge automatically, or start a review. Work on a feature branch and use a PR.
  • Gitea Actions and package features are enabled for the repository, but runner availability and package publishing permissions have not been confirmed.

Who can do what

Role Operations
codex over SSH Read-only host diagnostics; inspect service health and public listeners
Restricted verifier Runs the root-owned read-only drift check; not installed on the audited VPS
Restricted rollback helper Can restore prior local backend/OpenSearch images from a verified backup after an explicit data-compatibility confirmation; not installed on the audited VPS
VPS owner/root Bootstrap, package installation, SSH/firewall, secret setup, recovery, and approval of production changes
Gitea repository writer Feature branch push and PR creation; protected-main merge needs an approval