Een afgeschermde VS Code Dev Container waarin AI-agents (GitHub Copilot) in een paar gekozen git-repo's kunnen werken, zonder toegang tot je tokens, ssh-agent, ~/.kube, sudo of je andere repo's.
- Waarom en welke besluiten: PROJECT.md
- Hoe het werkt en het dreigingsmodel: ARCHITECTURE.md
~/agent-sandbox/code-agent.sh repo-a # repo kiezen en aparte VS Code starten
# in VS Code: F1 → Dev Containers: Rebuild and Reopen in Container
# in de container-terminal (Terminal → New Terminal of Ctrl+Shift+`):
check-isolation # moet eindigen met "geen FOUT"De sandbox gebruikt een aparte VS Code-instantie met een eigen profiel en eigen extensies. Dat kan VS Code stable (standaard) of Insiders zijn. Je gewone VS Code blijft ongemoeid.
| Editie | Programma | Profiel | Extensies |
|---|---|---|---|
| stable (standaard) | code |
~/.config/Code-agent |
~/.vscode-agent/extensions |
| Insiders | code-insiders |
~/.config/Code-Insiders-agent |
~/.vscode-insiders-agent/extensions |
Richt per editie die je wilt gebruiken het profiel in (Dev Containers-extensie + host-instellingen uit settings.host.json):
~/agent-sandbox/setup-agent-profile.sh --stable
~/agent-sandbox/setup-agent-profile.sh --insiders # alleen als je ook Insiders gebruiktDraai dit opnieuw na elke wijziging van settings.host.json. code-agent.sh weigert te starten zolang het profiel afwijkt (melding: profiel … wijkt af van settings.host.json). Wijzig instellingen van het agentprofiel dus in settings.host.json, niet in VS Code zelf.
De sandbox moet in
~/agent-sandboxstaan (clone hem daarheen).settings.host.jsongebruikt${HOME};setup-agent-profile.shvult dat in, want VS Code doet dat zelf niet voordev.containers.dockerPath. De container krijgt jouw UID/GID (code-agent.shgeeft ze door); root wordt geweigerd.
echo stable > ~/agent-sandbox/edition.conf # standaard-editie vastleggen (of: insiders)
~/agent-sandbox/code-agent.sh # start de standaard-editie
~/agent-sandbox/code-agent.sh --insiders # eenmalig de andere editie
~/agent-sandbox/code-agent.sh --stable repo-a # editie en repo's tegelijkBeide edities gebruiken dezelfde container, repo-keuze en afscherming. Copilot Chat is in beide ingebouwd.
Zonder proxy hoef je niets te doen. Achter een http-proxy (zonder authenticatie): zet http_proxy/https_proxy/no_proxy (of de hoofdletter-varianten) in de shell waaruit je setup-agent-profile.sh en code-agent.sh start. Alleen deze variabelen gaan mee door de schone omgeving; podman geeft ze door aan image-pull, build en container.
Een proxy-URL met gebruikersnaam/wachtwoord (http://user:pass@…) wordt geweigerd: die zou in de container zichtbaar worden.
De container ziet alleen de repo's die je kiest; elke repo uit de bronmap (standaard ~/git) verschijnt als /workspaces/<repo>. Nooit de hele bronmap.
~/agent-sandbox/select-repos.sh repo-a # één repo
~/agent-sandbox/select-repos.sh repo-a repo-b # meerdere repo's
~/agent-sandbox/select-repos.sh # huidige keuze tonenOf in één keer met starten: ~/agent-sandbox/code-agent.sh repo-a repo-b.
Staan je repo's niet in ~/git? Zet de bronmap, relatief aan je home directory, in repo-root.conf (bijvoorbeeld echo src/team > ~/agent-sandbox/repo-root.conf) en kies daarna opnieuw je repo's. Absolute paden, .. en je home directory zelf worden geweigerd.
select-repos.sh maakt uit het sjabloon .devcontainer/devcontainer.template.jsonc de lokale bestanden .devcontainer/devcontainer.json, .devcontainer/tst.code-workspace en repos.conf, en toont de wijziging. Die drie staan niet in git (.gitignore). code-agent.sh genereert devcontainer.json bij elke start opnieuw; wijzigingen aan de configuratie doe je dus in het sjabloon.
Na een verse git clone kies je eerst je repo's (select-repos.sh <repo> of code-agent.sh <repo>); zonder keuze start code-agent.sh niet.
Het script weigert een repo als:
- de naam ongeldig is (bijvoorbeeld
../x) of de map niet bestaat; - het een symlink is of buiten de bronmap wijst;
- het geen git-repo is (geen
.git); - de naam in
repos.denystaat; - er bestanden in staan die op secrets lijken (
*kubeconfig*,.env,*.pem, ssh-keys,.vault_pass*,*.kdbx,.git-credentials, of credentials in een remote-URL).
In het laatste geval zie je welke bestanden het zijn. Haal ze weg, of ga bewust door met --force:
~/agent-sandbox/select-repos.sh --force <repo>Na elke andere repo-keuze is Rebuild and Reopen in Container nodig: mounts liggen vast zodra de container is aangemaakt.
Normaal bouwt VS Code de image voor je bij Rebuild and Reopen in Container (zie stap 4). De image staat in .devcontainer/Containerfile:
- basis
fedora-minimal:45; - tools:
git-core,kustomize(checksum gecontroleerd),yamllint,jq,grep,find,diff; openssl3-libsenca-certificates, nodig voor Copilot in de container;- niet aanwezig:
ssh,curl,wget,sudo,oc,kubectl,helm,ansible. De build faalt als een van deze toch in de image zit (bijvoorbeeld via de basisimage); - gebruiker
agentmet jouw UID/GID (standaard 1000), plus/usr/local/bin/check-isolation.
Los bouwen om een fout in de Containerfile te zien:
podman build -t agent-sandbox-test ~/agent-sandbox/.devcontainerOpnieuw bouwen is nodig na een wijziging in .devcontainer/ (Containerfile, devcontainer.json, repo-keuze).
-
Start altijd via het script, nooit vanuit je gewone VS Code:
~/agent-sandbox/code-agent.shHet script start VS Code met een lege omgeving (
env -i): geen tokens, geen ssh-agent, geenKUBECONFIG. Open je de map toch vanuit je gewone VS Code, dan weigert de container te starten metagent-sandbox: … – start via ~/agent-sandbox/code-agent.sh. -
Kies F1 → Dev Containers: Reopen in Container. Na een wijziging (Containerfile, repo-keuze,
devcontainer.json): F1 → Dev Containers: Rebuild and Reopen in Container.Chat pas ná deze stap. In het venster vóór "Reopen in Container" draait Copilot nog op de host, met toegang tot je bestanden (zonder tokens of ssh-agent).
-
Bij meerdere repo's: File → Open Workspace from File… →
/opt/tst.code-workspace. Copilot vindt dan per repo deAGENTS.md. -
Laat de agent werken. Hij kan bestanden lezen en wijzigen en o.a.
kustomize build,yamllintengit status/diff/logdraaien. -
Review, commit en push doe je zelf in een gewone terminal op de host. De container heeft geen push-rechten.
In een terminal in VS Code binnen de container (niet via podman exec). Na het openen toont het terminalpaneel eerst het logtabblad "Dev Containers"; dat heeft geen prompt. Open een shell met + of Ctrl+Shift+`.
[agent@agent-sandbox]$ check-isolation; echo "exit=$?"
OK geen secret-achtige variabelen
OK SSH_AUTH_SOCK leeg
OK DISPLAY leeg
OK WAYLAND_DISPLAY leeg
OK GIT_ASKPASS leeg
OK KUBECONFIG=/dev/null
OK geen X11/Wayland/ssh-agent/DBus-sockets
OK geen container-socket
OK mount /workspaces/repo-a
OK geen andere mounts onder /workspaces
OK geen vscode-cachevolume
OK geen $HOME, ~/git of dotdirs van host gemount
OK bron van elke repo-mount is de repo zelf
OK geen capabilities
OK no-new-privileges
OK seccomp actief
OK SELinux container_t
OK uid 1000 (geen root)
OK uid 1000 is eigenaar van /workspaces/repo-a
OK geen verboden tools
OK geen credential-bestanden in $HOME
OK geen git credential helper (global)
OK geen git credential helper (system)
OK systeempaden niet schrijfbaar
WARN BROWSER gezet (URL's openen in host-browser)
WARN VSCODE_IPC_HOOK_CLI (code-CLI naar host-UI)
WARN REMOTE_CONTAINERS_IPC (Dev Containers-IPC naar host)
WARN MCP-socket(s) in /tmp
WARN host.containers.internal:22 bereikbaar
WARN host.containers.internal:8080 bereikbaar
WARN egress via proxy proxy.example:8080
---
RESULTAAT: geen FOUT, wel WARN (bekende restrisico's)
exit=0OK– in ordeWARN– bekend restrisico (bijvoorbeeld URL's openen in je host-browser, internet of proxy bereikbaar, poorten op de host bereikbaar); zie PROJECT.md (B-16). Zonder proxy zie jeinternet bereikbaar (egress open)in plaats vanegress via proxy; welke host-poorten verschijnen, hangt af van wat er op je host luistertFOUT– de afscherming is gebroken; stop en zoek uit waarom
Een intern doel meetesten (bereikbaar = FOUT):
CHECK_INTERNAL="api.<cluster>:6443" check-isolationOp de host:
CID=$(podman ps -q --filter label=devcontainer.local_folder=$HOME/agent-sandbox)
podman inspect $CID --format '{{.ProcessLabel}} | {{json .HostConfig.SecurityOpt}}' # container_t, geen label=disable
podman inspect $CID --format '{{json .Mounts}}' # alleen je gekozen repo's| Melding | Oorzaak | Oplossing |
|---|---|---|
agent-sandbox: … is gezet – start via ~/agent-sandbox/code-agent.sh |
VS Code niet via code-agent.sh gestart |
Alle agent-vensters sluiten, code-agent.sh starten |
select-repos: gevoelige bestanden in <repo> |
Repo bevat mogelijk secrets | Bestanden weghalen, of bewust --force |
Build faalt op COPY … |
Bestand ontbreekt in .devcontainer/ (bijv. tst.code-workspace na een verse clone) |
Eerst select-repos.sh <repo>; anders podman build los draaien (stap 3) en fout lezen |
nog geen repo's gekozen |
Verse clone of repos.conf verwijderd |
select-repos.sh <repo> of code-agent.sh <repo> |
| Oude instellingen of mounts actief | "Reopen" hergebruikte bestaande container | Rebuild and Reopen in Container |
Terminal geeft geen prompt, alleen elke minuut Extensions cache, remote removals: None |
Dat is het logtabblad "Dev Containers", geen shell | Nieuwe terminal: + in het terminalpaneel of Ctrl+Shift+` |
profiel … wijkt af van settings.host.json |
Profiel verouderd of instelling in VS Code gewijzigd | setup-agent-profile.sh --<editie> |
Dev Containers ontbreekt in … |
Profiel nog niet ingericht | setup-agent-profile.sh --<editie> |
| Copilot toont geen modellen in de container | Image zonder openssl3-libs (oude build) |
Rebuild Container |
setup-agent-profile.sh: AggregateError [ETIMEDOUT], of Rebuild blijft hangen na Resolving Remote (podman pull) |
Netwerk zonder directe egress en proxyvariabelen niet gezet in de shell waaruit je startte | Proxyvariabelen zetten (zie Netwerk met of zonder http-proxy), script opnieuw draaien; bij hangende Rebuild eerst agent-venster sluiten |
deze map moet ~/agent-sandbox zijn |
Repo elders gecloned | Verplaatsen of clonen naar ~/agent-sandbox |
AGENT_UID/AGENT_GID ontbreken of wijken af |
VS Code niet (opnieuw) via code-agent.sh gestart, bijvoorbeeld een venster van vóór een update |
Alle agent-vensters sluiten, code-agent.sh starten |
repo-root.conf: ongeldig pad |
Absoluut pad, .. of lege naam |
Pad relatief aan je home directory, bijvoorbeeld git |
… bevat credentials (@); niet ondersteund |
Proxy-URL met gebruikersnaam/wachtwoord | Proxy zonder authenticatie gebruiken (proxy met authenticatie wordt niet ondersteund) |
Build faalt met FOUT: verboden tool … |
Basisimage bevat een verboden tool | Pakket uit de melding toevoegen aan de rpm -e-lijst in de Containerfile |
Je eigen repo-keuze staat alleen lokaal (repos.conf, .devcontainer/devcontainer.json, .devcontainer/tst.code-workspace, en eventueel repo-root.conf); die bestanden staan in .gitignore, dus git status blijft schoon. In git staat alleen het sjabloon met voorbeeld-repo.
Zet eenmalig per clone de pre-commit hook aan. Die weigert een commit met een van de lokale bestanden, een sjabloon zonder voorbeeld-repo of je home-pad:
git -C ~/agent-sandbox config core.hooksPath .githooksDaarna commit je gewoon:
cd ~/agent-sandbox
git add -A && git diff --cached # controleren
git commit| Bestand | Functie |
|---|---|
code-agent.sh |
Start de aparte VS Code (stable/Insiders) met schone omgeving; optioneel --stable/--insiders en repo-namen |
setup-agent-profile.sh, edition.sh, edition.conf |
Agentprofiel per editie inrichten, editie bepalen, standaard-editie |
select-repos.sh, repos.conf, repos.deny, repo-root.conf |
Repo's kiezen, huidige keuze (lokaal), altijd geweigerde repo's, optionele bronmap (standaard ~/git, lokaal) |
.devcontainer/devcontainer.template.jsonc |
Sjabloon van de Dev Container-configuratie (in git); devcontainer.json wordt eruit gegenereerd |
settings.host.json |
Sjabloon (met ${HOME}) voor de host-instellingen van het agentprofiel |
podman-agent.sh |
podman-wrapper: houdt SELinux aan in de container |
guard-host-env.sh |
Weigert starten vanuit een VS Code met tokens, ssh-agent of X11 |
.devcontainer/ |
Containerfile, sjabloon, gegenereerde devcontainer.json en workspace-bestand, check-isolation.sh |
AGENTS.md |
Regels voor AI-agents die aan déze repo werken (op de host) |
.githooks/pre-commit, .gitignore |
Houden je lokale repo-keuze, repo-root.conf en home-pad uit git |
Deze map wordt bewust niet in de container gemount, zodat de agent zijn eigen afscherming niet kan aanpassen.