talks/2026-11-04-dev-con-ro-sbx-workshoppublic Fork
⑂ 28bfe6e
Commits
⬇ Clone ▾
git clone https://git.rickub.com/talks/2026-11-04-dev-con-ro-sbx-workshop.git
git clone ssh://git@rickub.com/talks/2026-11-04-dev-con-ro-sbx-workshop.git

Host key fingerprint (ed25519): SHA256:iycHnxEyq0Q7uyVpB7JlznP0G7JrTPXLYRcAU5CSLhc — verify it before your first connect.

Download ZIP

🛟 Updated.Unverified

k33g committed 2026-11-04T02:50:22+02:00 Browse files
28bfe6e parent: 0401529
modified .gitignore +2 -0
@@ -5,3 +5,5 @@ docker-agent
55 .tmp
66 .claude
77 slides
8+*.fr.md
9+.backup
\ No newline at end of file
@@ -5,3 +5,5 @@ docker-agent
5 .tmp5 .tmp
6 .claude6 .claude
7 slides7 slides
8+*.fr.md
9+.backup
\ No newline at end of file\ No newline at end of file
deleted 00-introduction/README.fr.md +0 -54
deleted file mode 100644
@@ -1,54 +0,0 @@
1-# Introduction
2-
3-## Ce que l'on va faire
4-
5-Un agent IA qui lit des fichiers, exécute des commandes et appelle des API est puissant, mais s'il tourne directement sur votre machine, il a accès à vos fichiers, à vos variables d'environnement et donc à vos secrets.
6-
7-Dans ce workshop, nous allons :
8-
9-1. **Créer un compte Mistral AI** et une clé d'API (`01-mistral-ai`).
10-2. **Installer Docker Agent** (`02-docker-agent`).
11-3. **Écrire notre premier agent** avec Docker Agent et le modèle Mistral, le lancer sur notre machine, et constater que ce n'est pas sans risque (`03-first-agent`).
12-4. **Découvrir `sbx`** et lancer notre premier sandbox (`04-sbx`).
13-5. **Sandboxer notre agent** : faire tourner Docker Agent dans un sandbox, connecté à Mistral AI sans que la clé d'API n'entre jamais dans le sandbox (`05-sbx-docker-agent`).
14-6. **Décrire le sandbox de façon déclarative** avec un fichier `sbxenv.yaml` et `sbx env` (`06-sbx-docker-agent-sbx-env`).
15-7. **Composer le sandbox avec des kits**, comme des Lego : un kit pour l'agent, un autre pour la toolchain Rust (`07-play-lego-with-kits`).
16-8. **Ajouter des policies** pour contrôler ce que le sandbox peut atteindre sur le réseau, par exemple interdire `gitlab.com` (`08-policies`).
17-
18-## Qu'est-ce que Docker Agent ?
19-
20-**Docker Agent** (`docker-agent`) permet de créer et d'exécuter des agents IA, et des équipes d'agents qui collaborent, sans écrire de code : un agent se décrit dans un fichier YAML (modèle, instructions, outils).
21-
22-- Les agents peuvent utiliser des outils intégrés (`filesystem`, `shell`, ...) et n'importe quel serveur [MCP](https://modelcontextprotocol.io/).
23-- Il est agnostique du fournisseur de modèles : OpenAI, Anthropic, Gemini, Mistral, [Docker Model Runner](https://docs.docker.com/ai/model-runner/) (modèles locaux), etc.
24-- Il se lance avec `docker agent run agent.yaml` (plugin de la CLI Docker) ou `docker-agent run agent.yaml` (binaire autonome).
25-
26-Références :
27-- Documentation : [https://docker.github.io/docker-agent/](https://docker.github.io/docker-agent/)
28-- Installation : [https://docker.github.io/docker-agent/getting-started/installation/](https://docker.github.io/docker-agent/getting-started/installation/)
29-- Code source : [https://github.com/docker/docker-agent](https://github.com/docker/docker-agent)
30-
31-## Qu'est-ce que `sbx` ?
32-
33-**Docker Sandboxes** (CLI `sbx`) exécute des agents de code IA dans des **microVM isolées**. Chaque sandbox a son propre système de fichiers, son propre réseau et son propre démon Docker ; seul le workspace que vous choisissez est partagé avec l'hôte.
34-
35-Ce que cela apporte :
36-
37-- **Isolation** : l'agent ne voit plus votre machine, seulement le workspace partagé.
38-- **Secrets protégés** : les clés d'API restent sur l'hôte et sont injectées par un proxy lors des requêtes sortantes. Le sandbox ne voit qu'une valeur de remplacement.
39-- **Policies réseau** : vous décidez quels hôtes le sandbox peut joindre (`sbx policy allow/deny`).
40-- **Environnements déclaratifs** : un fichier `sbxenv.yaml` décrit l'agent, les kits, les variables, les secrets et les ports, et `sbx env` crée, lance et supprime le sandbox correspondant.
41-- **Kits** : des briques réutilisables pour composer un sandbox (agent, outils, règles réseau).
42-
43-Références :
44-- Documentation : [https://docs.docker.com/ai/sandboxes/](https://docs.docker.com/ai/sandboxes/)
45-- Installation : [https://docs.docker.com/ai/sandboxes/install/](https://docs.docker.com/ai/sandboxes/install/)
46-- Fichiers d'environnement (`sbxenv.yaml`) : [https://docs.docker.com/ai/sandboxes/configuration/environment-files/](https://docs.docker.com/ai/sandboxes/configuration/environment-files/)
47-
48-## Prérequis
49-
50-- Un poste sous macOS, Linux ou Windows (ce workshop a été testé sur macOS Apple Silicon).
51-- Un compte [Mistral AI](https://console.mistral.ai/) et une clé d'API.
52-- `docker-agent` et `sbx` installés (voir les étapes 02 et 04).
53-
54-**Commençons par la clé d'API Mistral AI : rendez-vous dans `01-mistral-ai`.**
deleted file mode 100644
@@ -1,54 +0,0 @@
1-# Introduction
2-
3-## Ce que l'on va faire
4-
5-Un agent IA qui lit des fichiers, exécute des commandes et appelle des API est puissant, mais s'il tourne directement sur votre machine, il a accès à vos fichiers, à vos variables d'environnement et donc à vos secrets.
6-
7-Dans ce workshop, nous allons :
8-
9-1. **Créer un compte Mistral AI** et une clé d'API (`01-mistral-ai`).
10-2. **Installer Docker Agent** (`02-docker-agent`).
11-3. **Écrire notre premier agent** avec Docker Agent et le modèle Mistral, le lancer sur notre machine, et constater que ce n'est pas sans risque (`03-first-agent`).
12-4. **Découvrir `sbx`** et lancer notre premier sandbox (`04-sbx`).
13-5. **Sandboxer notre agent** : faire tourner Docker Agent dans un sandbox, connecté à Mistral AI sans que la clé d'API n'entre jamais dans le sandbox (`05-sbx-docker-agent`).
14-6. **Décrire le sandbox de façon déclarative** avec un fichier `sbxenv.yaml` et `sbx env` (`06-sbx-docker-agent-sbx-env`).
15-7. **Composer le sandbox avec des kits**, comme des Lego : un kit pour l'agent, un autre pour la toolchain Rust (`07-play-lego-with-kits`).
16-8. **Ajouter des policies** pour contrôler ce que le sandbox peut atteindre sur le réseau, par exemple interdire `gitlab.com` (`08-policies`).
17-
18-## Qu'est-ce que Docker Agent ?
19-
20-**Docker Agent** (`docker-agent`) permet de créer et d'exécuter des agents IA, et des équipes d'agents qui collaborent, sans écrire de code : un agent se décrit dans un fichier YAML (modèle, instructions, outils).
21-
22-- Les agents peuvent utiliser des outils intégrés (`filesystem`, `shell`, ...) et n'importe quel serveur [MCP](https://modelcontextprotocol.io/).
23-- Il est agnostique du fournisseur de modèles : OpenAI, Anthropic, Gemini, Mistral, [Docker Model Runner](https://docs.docker.com/ai/model-runner/) (modèles locaux), etc.
24-- Il se lance avec `docker agent run agent.yaml` (plugin de la CLI Docker) ou `docker-agent run agent.yaml` (binaire autonome).
25-
26-Références :
27-- Documentation : [https://docker.github.io/docker-agent/](https://docker.github.io/docker-agent/)
28-- Installation : [https://docker.github.io/docker-agent/getting-started/installation/](https://docker.github.io/docker-agent/getting-started/installation/)
29-- Code source : [https://github.com/docker/docker-agent](https://github.com/docker/docker-agent)
30-
31-## Qu'est-ce que `sbx` ?
32-
33-**Docker Sandboxes** (CLI `sbx`) exécute des agents de code IA dans des **microVM isolées**. Chaque sandbox a son propre système de fichiers, son propre réseau et son propre démon Docker ; seul le workspace que vous choisissez est partagé avec l'hôte.
34-
35-Ce que cela apporte :
36-
37-- **Isolation** : l'agent ne voit plus votre machine, seulement le workspace partagé.
38-- **Secrets protégés** : les clés d'API restent sur l'hôte et sont injectées par un proxy lors des requêtes sortantes. Le sandbox ne voit qu'une valeur de remplacement.
39-- **Policies réseau** : vous décidez quels hôtes le sandbox peut joindre (`sbx policy allow/deny`).
40-- **Environnements déclaratifs** : un fichier `sbxenv.yaml` décrit l'agent, les kits, les variables, les secrets et les ports, et `sbx env` crée, lance et supprime le sandbox correspondant.
41-- **Kits** : des briques réutilisables pour composer un sandbox (agent, outils, règles réseau).
42-
43-Références :
44-- Documentation : [https://docs.docker.com/ai/sandboxes/](https://docs.docker.com/ai/sandboxes/)
45-- Installation : [https://docs.docker.com/ai/sandboxes/install/](https://docs.docker.com/ai/sandboxes/install/)
46-- Fichiers d'environnement (`sbxenv.yaml`) : [https://docs.docker.com/ai/sandboxes/configuration/environment-files/](https://docs.docker.com/ai/sandboxes/configuration/environment-files/)
47-
48-## Prérequis
49-
50-- Un poste sous macOS, Linux ou Windows (ce workshop a été testé sur macOS Apple Silicon).
51-- Un compte [Mistral AI](https://console.mistral.ai/) et une clé d'API.
52-- `docker-agent` et `sbx` installés (voir les étapes 02 et 04).
53-
54-**Commençons par la clé d'API Mistral AI : rendez-vous dans `01-mistral-ai`.**
deleted 01-mistral-ai/README.fr.md +0 -27
deleted file mode 100644
@@ -1,27 +0,0 @@
1-# Mistral AI
2-
3-## Vous devez vous créer un compte chez Mistral
4-
5-Allez sur [https://console.mistral.ai/](https://console.mistral.ai/) et créez un compte pour ensuite créer une clé d'API:
6-
7-Utilisez votre email:
8-![email](./assets/mistral-account-01.png)
9-
10-Renseignez les informations nécessaires:
11-![information](./assets/mistral-account-02.png)
12-
13-Vous allez recevoir un code par email:
14-![email check](./assets/mistral-account-03.png)
15-
16-Que vous allez saisir côté Mistral AI pour vérification:
17-![check](./assets/mistral-account-04.png)
18-
19-Ensuite, une fois dans Mistral Studio, vous pouvez créer votre clé:
20-![create key](./assets/mistral-account-05.png)
21-
22-Et voir la liste de vos clés en cours:
23-![API keys](./assets/mistral-account-06.png)
24-
25-**Copiez votre clé quelque part, vous allez l'utiliser pour la suite du workshop**.
26-
27-Maintenant passons à l'installation de Docker Agent.
\ No newline at end of file
deleted file mode 100644
@@ -1,27 +0,0 @@
1-# Mistral AI
2-
3-## Vous devez vous créer un compte chez Mistral
4-
5-Allez sur [https://console.mistral.ai/](https://console.mistral.ai/) et créez un compte pour ensuite créer une clé d'API:
6-
7-Utilisez votre email:
8-![email](./assets/mistral-account-01.png)
9-
10-Renseignez les informations nécessaires:
11-![information](./assets/mistral-account-02.png)
12-
13-Vous allez recevoir un code par email:
14-![email check](./assets/mistral-account-03.png)
15-
16-Que vous allez saisir côté Mistral AI pour vérification:
17-![check](./assets/mistral-account-04.png)
18-
19-Ensuite, une fois dans Mistral Studio, vous pouvez créer votre clé:
20-![create key](./assets/mistral-account-05.png)
21-
22-Et voir la liste de vos clés en cours:
23-![API keys](./assets/mistral-account-06.png)
24-
25-**Copiez votre clé quelque part, vous allez l'utiliser pour la suite du workshop**.
26-
27-Maintenant passons à l'installation de Docker Agent.
\ No newline at end of file\ No newline at end of file
deleted 02-docker-agent/README.fr.md +0 -14
deleted file mode 100644
@@ -1,14 +0,0 @@
1-# Installer Docker Agent
2-
3-Nous allons installer la version locale de Docker Agent (et non pas la version plugin de Docker Agent pour Docker Desktop)
4-
5-Vous trouverez ici la page décrivant les installations possible pour vos systèmes d'exploitation: [https://docker.github.io/docker-agent/getting-started/installation/](https://docker.github.io/docker-agent/getting-started/installation/)
6-
7-
8-## On Windows
9-
10-- Go to: https://github.com/docker/docker-agent/releases and download the appropriate version of Docker Agent
11-- Rename it to docker-agent
12-- Add it to the PATH (ex: C:\Users\Philippe\docker-agent\)
13-
14-You probably need to restart VSCode (on Windows, don’t ask why)
deleted file mode 100644
@@ -1,14 +0,0 @@
1-# Installer Docker Agent
2-
3-Nous allons installer la version locale de Docker Agent (et non pas la version plugin de Docker Agent pour Docker Desktop)
4-
5-Vous trouverez ici la page décrivant les installations possible pour vos systèmes d'exploitation: [https://docker.github.io/docker-agent/getting-started/installation/](https://docker.github.io/docker-agent/getting-started/installation/)
6-
7-
8-## On Windows
9-
10-- Go to: https://github.com/docker/docker-agent/releases and download the appropriate version of Docker Agent
11-- Rename it to docker-agent
12-- Add it to the PATH (ex: C:\Users\Philippe\docker-agent\)
13-
14-You probably need to restart VSCode (on Windows, don’t ask why)
deleted 03-first-agent/README.fr.md +0 -119
deleted file mode 100644
@@ -1,119 +0,0 @@
1-# Premier contact avec Docker Agent
2-
3-On travaille dans le dossier `./03-first-agent`
4-
5-## Create a docker agent configuration file: `agent.yaml`
6-
7-```yaml
8-models:
9- mistral:
10- provider: mistral
11- model: ministral-3b-2512
12- temperature: 0.7
13- max_tokens: 8192
14-
15-agents:
16- root:
17- model: mistral
18- description: Assistant using Mistral
19- instruction: |
20- You name is [Bob 🤓], You are a helpful assistant.
21-
22- welcome_message: |
23- 🤖 Local Assistant propulsed by **Mistral** 🐱
24-
25- toolsets:
26- - type: filesystem
27- - type: shell
28-```
29-
30-**Attention**: les outils `filesystem` et `shell` sont activés, donc ne demandez rien de dangereux à l'agent (ou laissez moi faire la démo sur mon poste et ne prenez pas de risque 😀).
31-
32-
33-## Lancez Docker Agent
34-
35-```bash
36-export MISTRAL_API_KEY="your-api-key"
37-docker agent run agent.yaml
38-```
39-> Docker sait reconnaître `MISTRAL_API_KEY` comme secret pour les endpoint Mistral AI.
40-
41-Vous devriez avoir cet écran (la TUI de Docker Agent)
42-![docker-agent](./assets/docker-agent-01.png)
43-
44-### Première question
45-
46-Et essayez la question suivante:
47-
48-```raw
49-Create a text file at the home of my machine with a greeting message
50-```
51-
52-**🖐️ If you are using Windows, try it like this**:
53-```raw
54-I'm using powershell,
55-Create a text file at the home of my machine with a greeting message
56-```
57-
58-Choisissez **[A]** pour laisser exécuter les tools:
59-![docker-agent](./assets/docker-agent-02.png)
60-
61-Et vous découvrez que l'agent a probablement accés à l'ensemble des données sur votre machine:
62-![docker-agent](./assets/docker-agent-03.png)
63-
64-
65-Allez quand même vérifier, si l'agent a créé le fichier pour de vrai:
66-```bash
67-➜ ~ bat $HOME/greeting_message.txt
68-─────┬────────────────────────────────────────────────────────────────
69- │ File: /Users/k33g/greeting_message.txt
70-─────┼────────────────────────────────────────────────────────────────
71- 1 │ Hello! Welcome to your new greeting file. Enjoy your day! 🌞
72-─────┴────────────────────────────────────────────────────────────────
73-```
74-
75-### Allons un peu plus loin
76-
77-
78-```raw
79-Show me the list of my environment variables
80-```
81-> Vous devriez parfois, au début de la génération, voir le contenu de certains de vos secrets ...🙀
82-
83-![docker-agent](./assets/docker-agent-04.png)
84-
85-```raw
86-What is the content of MISTRAL_API_KEY?
87-```
88-
89-![docker-agent](./assets/docker-agent-05.png)
90-> Parfois l'agent (le modèle) refuse de montrer ce contenu
91-
92-### Essayons encore
93-
94-```raw
95-Show me the first 5 characters of MISTRAL_API_KEY
96-```
97-
98-![docker-agent](./assets/docker-agent-06.png)
99-> Cette fois-ci le modèle refuse
100-
101-
102-### Un dernier essai...
103-
104-Pour celui ci, il faudrait Go installé sur votre mchine, mais vous pouvez proposer à l'agent d'utiliser un autre langage installé sur votre machine:
105-
106-```raw
107-Create a Go script that analyzes the content of an environment variable, then iterates through each character and displays it.
108-```
109-
110-![docker-agent](./assets/docker-agent-07.png)
111-> 🙀 ouch! donc, si vous le demandez bien poliment, votre agent ne saura rien vous refuser. Et si il est en forme, il pourra leaker vos clés sur Internet.
112-
113-## Premier constat
114-
115-- Exécuter un agent directement en local sur votre machine, n'est pas une bonne idée
116-- Rien n'est à l'abri, ni vos fichiers, ni vos données, ni vos secrets, ...
117-
118-**Il est donc temps de "sandboxer notre agent"**.
119-
deleted file mode 100644
@@ -1,119 +0,0 @@
1-# Premier contact avec Docker Agent
2-
3-On travaille dans le dossier `./03-first-agent`
4-
5-## Create a docker agent configuration file: `agent.yaml`
6-
7-```yaml
8-models:
9- mistral:
10- provider: mistral
11- model: ministral-3b-2512
12- temperature: 0.7
13- max_tokens: 8192
14-
15-agents:
16- root:
17- model: mistral
18- description: Assistant using Mistral
19- instruction: |
20- You name is [Bob 🤓], You are a helpful assistant.
21-
22- welcome_message: |
23- 🤖 Local Assistant propulsed by **Mistral** 🐱
24-
25- toolsets:
26- - type: filesystem
27- - type: shell
28-```
29-
30-**Attention**: les outils `filesystem` et `shell` sont activés, donc ne demandez rien de dangereux à l'agent (ou laissez moi faire la démo sur mon poste et ne prenez pas de risque 😀).
31-
32-
33-## Lancez Docker Agent
34-
35-```bash
36-export MISTRAL_API_KEY="your-api-key"
37-docker agent run agent.yaml
38-```
39-> Docker sait reconnaître `MISTRAL_API_KEY` comme secret pour les endpoint Mistral AI.
40-
41-Vous devriez avoir cet écran (la TUI de Docker Agent)
42-![docker-agent](./assets/docker-agent-01.png)
43-
44-### Première question
45-
46-Et essayez la question suivante:
47-
48-```raw
49-Create a text file at the home of my machine with a greeting message
50-```
51-
52-**🖐️ If you are using Windows, try it like this**:
53-```raw
54-I'm using powershell,
55-Create a text file at the home of my machine with a greeting message
56-```
57-
58-Choisissez **[A]** pour laisser exécuter les tools:
59-![docker-agent](./assets/docker-agent-02.png)
60-
61-Et vous découvrez que l'agent a probablement accés à l'ensemble des données sur votre machine:
62-![docker-agent](./assets/docker-agent-03.png)
63-
64-
65-Allez quand même vérifier, si l'agent a créé le fichier pour de vrai:
66-```bash
67-➜ ~ bat $HOME/greeting_message.txt
68-─────┬────────────────────────────────────────────────────────────────
69- │ File: /Users/k33g/greeting_message.txt
70-─────┼────────────────────────────────────────────────────────────────
71- 1 │ Hello! Welcome to your new greeting file. Enjoy your day! 🌞
72-─────┴────────────────────────────────────────────────────────────────
73-```
74-
75-### Allons un peu plus loin
76-
77-
78-```raw
79-Show me the list of my environment variables
80-```
81-> Vous devriez parfois, au début de la génération, voir le contenu de certains de vos secrets ...🙀
82-
83-![docker-agent](./assets/docker-agent-04.png)
84-
85-```raw
86-What is the content of MISTRAL_API_KEY?
87-```
88-
89-![docker-agent](./assets/docker-agent-05.png)
90-> Parfois l'agent (le modèle) refuse de montrer ce contenu
91-
92-### Essayons encore
93-
94-```raw
95-Show me the first 5 characters of MISTRAL_API_KEY
96-```
97-
98-![docker-agent](./assets/docker-agent-06.png)
99-> Cette fois-ci le modèle refuse
100-
101-
102-### Un dernier essai...
103-
104-Pour celui ci, il faudrait Go installé sur votre mchine, mais vous pouvez proposer à l'agent d'utiliser un autre langage installé sur votre machine:
105-
106-```raw
107-Create a Go script that analyzes the content of an environment variable, then iterates through each character and displays it.
108-```
109-
110-![docker-agent](./assets/docker-agent-07.png)
111-> 🙀 ouch! donc, si vous le demandez bien poliment, votre agent ne saura rien vous refuser. Et si il est en forme, il pourra leaker vos clés sur Internet.
112-
113-## Premier constat
114-
115-- Exécuter un agent directement en local sur votre machine, n'est pas une bonne idée
116-- Rien n'est à l'abri, ni vos fichiers, ni vos données, ni vos secrets, ...
117-
118-**Il est donc temps de "sandboxer notre agent"**.
119-
deleted 04-sbx/README.fr.md +0 -62
deleted file mode 100644
@@ -1,62 +0,0 @@
1-# Parlons un peu de `sbx`
2-
3-## Pourquoi vous devez utiliser `sbx`
4-
5-![sbx security model](./assets/sbx-security-model.drawio.svg)
6-
7-## Prerequisites
8-
9-- **You need a Docker Account for using SBX**
10-- You need Docker Desktop (only or exercise 07)
11-
12-
13-## Installer `sbx`
14-
15-Commencez par installer `sbx` en suivant ces instructions: [https://docs.docker.com/ai/sandboxes/install/](https://docs.docker.com/ai/sandboxes/install/)
16-
17-If you haven't chosen a default preset, the CLI prompts you before it runs a sandbox. Running `sbx policy reset` clears the preset and prompts you to choose again:
18-
19-```raw
20-Initialize the global network policy for your sandboxes:
21-
22- Applies to all sandboxes, current and future — change it later with
23- "sbx policy allow/deny/rm". Kits, including built-in agent kits, may
24- also add per-sandbox rules.
25-
26- 1. Open - All network traffic allowed, no restrictions.
27- 2. Balanced - Default deny, with common dev sites allowed.
28- 3. Locked Down - All network traffic blocked unless you allow it.
29-
30- Use ↑/↓†or 1-3 to navigate, Enter to confirm, Esc to cancel.
31-```
32-
33-## Tester votr installation - Premier contact avec `sbx`
34-
35-Dans le dossier courant, lancez la commande suivante:
36-
37-```bash
38-sbx run shell .
39-```
40-
41-Then try these commands:
42-```bash
43-uname
44-go version
45-node --version
46-cargo --version
47-```
48-
49-In another terminal, type:
50-```bash
51-sbx ls
52-```
53-
54-Then:
55-```bash
56-sbx
57-```
58-
59-Stoppez et détruisez votre dandbox.
60-
61-**Il est temps de passer aux choses sérieuses**.
62-
deleted file mode 100644
@@ -1,62 +0,0 @@
1-# Parlons un peu de `sbx`
2-
3-## Pourquoi vous devez utiliser `sbx`
4-
5-![sbx security model](./assets/sbx-security-model.drawio.svg)
6-
7-## Prerequisites
8-
9-- **You need a Docker Account for using SBX**
10-- You need Docker Desktop (only or exercise 07)
11-
12-
13-## Installer `sbx`
14-
15-Commencez par installer `sbx` en suivant ces instructions: [https://docs.docker.com/ai/sandboxes/install/](https://docs.docker.com/ai/sandboxes/install/)
16-
17-If you haven't chosen a default preset, the CLI prompts you before it runs a sandbox. Running `sbx policy reset` clears the preset and prompts you to choose again:
18-
19-```raw
20-Initialize the global network policy for your sandboxes:
21-
22- Applies to all sandboxes, current and future — change it later with
23- "sbx policy allow/deny/rm". Kits, including built-in agent kits, may
24- also add per-sandbox rules.
25-
26- 1. Open - All network traffic allowed, no restrictions.
27- 2. Balanced - Default deny, with common dev sites allowed.
28- 3. Locked Down - All network traffic blocked unless you allow it.
29-
30- Use ↑/↓†or 1-3 to navigate, Enter to confirm, Esc to cancel.
31-```
32-
33-## Tester votr installation - Premier contact avec `sbx`
34-
35-Dans le dossier courant, lancez la commande suivante:
36-
37-```bash
38-sbx run shell .
39-```
40-
41-Then try these commands:
42-```bash
43-uname
44-go version
45-node --version
46-cargo --version
47-```
48-
49-In another terminal, type:
50-```bash
51-sbx ls
52-```
53-
54-Then:
55-```bash
56-sbx
57-```
58-
59-Stoppez et détruisez votre dandbox.
60-
61-**Il est temps de passer aux choses sérieuses**.
62-
deleted 05-sbx-docker-agent/README.fr.md +0 -50
deleted file mode 100644
@@ -1,50 +0,0 @@
1-# Je veux Docker Agent sandboxé et connecté à Mistral.ai
2-
3-Aujourd'hui Docker Agent ne reconnaît pas automatiquement le secret mistral (`sbx secret set mistral`) contrairement à la CLI **Vibe** de Mistral. Nous allons donc utiliser un "custom secret".
4-
5-## Custom secret and `MISTRAL_API_KEY`
6-
7-1. Créer un fichier `sbx.env` :
8- ```
9- DOCKER_AGENT_AUTO_UPDATE=0
10- MISTRAL_API_KEY=sbx-mistral-key
11- ```
12-2. Créer un custom secret avec une **valeur de remplacement fixe** que tu choisis :
13- ```bash
14- export MISTRAL_API_KEY="your-api-key"
15- sbx secret set-custom --host api.mistral.ai --env MISTRAL_API_KEY \
16- --placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
17- ```
18-
19- 🖐️ **on Windows:**
20- ```bash
21- $env:MISTRAL_API_KEY="your-api-key"
22-
23- sbx secret set-custom --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
24- ```
25-
26-3. Démarrer la sandbox :
27- ```bash
28- sbx run --env-file sbx.env docker-agent -- run agent.yaml .
29- ```
30- > dont forget the `.`
31-
32-Ou sans le fichier `sbx.env`:
33-
34-```bash
35-sbx run -e MISTRAL_API_KEY=sbx-mistral-key -e DOCKER_AGENT_AUTO_UPDATE=0 docker-agent -- run agent.yaml .
36-```
37-
38-![docker-agent](./assets/docker-agent-01.png)
39-
40-
41-## Et essayez à nouveau
42-
43-```raw
44-Create a text file at the home of my machine with a greeting message
45-```
46-
47-![docker-agent](./assets/docker-agent-02.png)
48-
49-
50-Essayez aussi d'aller écrire ou lire des fichiers en dehors de ce répertoire.
\ No newline at end of file
deleted file mode 100644
@@ -1,50 +0,0 @@
1-# Je veux Docker Agent sandboxé et connecté à Mistral.ai
2-
3-Aujourd'hui Docker Agent ne reconnaît pas automatiquement le secret mistral (`sbx secret set mistral`) contrairement à la CLI **Vibe** de Mistral. Nous allons donc utiliser un "custom secret".
4-
5-## Custom secret and `MISTRAL_API_KEY`
6-
7-1. Créer un fichier `sbx.env` :
8- ```
9- DOCKER_AGENT_AUTO_UPDATE=0
10- MISTRAL_API_KEY=sbx-mistral-key
11- ```
12-2. Créer un custom secret avec une **valeur de remplacement fixe** que tu choisis :
13- ```bash
14- export MISTRAL_API_KEY="your-api-key"
15- sbx secret set-custom --host api.mistral.ai --env MISTRAL_API_KEY \
16- --placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
17- ```
18-
19- 🖐️ **on Windows:**
20- ```bash
21- $env:MISTRAL_API_KEY="your-api-key"
22-
23- sbx secret set-custom --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
24- ```
25-
26-3. Démarrer la sandbox :
27- ```bash
28- sbx run --env-file sbx.env docker-agent -- run agent.yaml .
29- ```
30- > dont forget the `.`
31-
32-Ou sans le fichier `sbx.env`:
33-
34-```bash
35-sbx run -e MISTRAL_API_KEY=sbx-mistral-key -e DOCKER_AGENT_AUTO_UPDATE=0 docker-agent -- run agent.yaml .
36-```
37-
38-![docker-agent](./assets/docker-agent-01.png)
39-
40-
41-## Et essayez à nouveau
42-
43-```raw
44-Create a text file at the home of my machine with a greeting message
45-```
46-
47-![docker-agent](./assets/docker-agent-02.png)
48-
49-
50-Essayez aussi d'aller écrire ou lire des fichiers en dehors de ce répertoire.
\ No newline at end of file\ No newline at end of file
deleted 06-sbx-docker-agent-sbx-env/README.fr.md +0 -59
deleted file mode 100644
@@ -1,59 +0,0 @@
1-# Docker Agent sandboxé et connecté à Mistral.ai, avec `sbx env run`
2-
3-Même objectif que l'étape précédente, mais la sandbox est décrite de façon déclarative dans un fichier `sbxenv.yaml` au lieu d'une longue ligne de commande `sbx run`.
4-
5-## Le fichier `sbxenv.yaml`
6-
7-```yaml
8-schemaVersion: "1"
9-name: docker-agent-mistral
10-agent: docker-agent
11-workspace: .
12-env:
13- DOCKER_AGENT_AUTO_UPDATE: "0"
14- MISTRAL_API_KEY: sbx-mistral-key
15-```
16-
17-- `name` : nom de la sandbox (et "scope" des secrets qui lui sont associés).
18-- `agent` : l'agent de base à utiliser.
19-- `workspace` : le répertoire monté dans la sandbox (`.` = le dossier du fichier).
20-- `env` : les variables d'environnement de la sandbox (remplace `sbx.env`). `MISTRAL_API_KEY` ne contient que la **valeur de remplacement** (placeholder), jamais la vraie clé.
21-
22-## Custom secret
23-
24-`sbxenv.yaml` ne sait pas déclarer un custom secret. On le crée donc avant, **en le rattachant à la sandbox** (`name` du fichier) pour qu'il soit supprimé par `sbx env rm` :
25-
26-```bash
27-export MISTRAL_API_KEY="your-api-key"
28-sbx secret set-custom --sandbox docker-agent-mistral \
29---host api.mistral.ai --env MISTRAL_API_KEY \
30---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
31-```
32-
33-🖐️ **on Windows:**
34-```bash
35-$env:MISTRAL_API_KEY="your-api-key"
36-
37-sbx secret set-custom --sandbox docker-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
38-```
39-
40-
41-## Démarrer la sandbox
42-
43-`sbx env run` ne permet pas de passer d'arguments à l'agent (pas de `-- run agent.yaml`) : Docker Agent serait lancé avec ses arguments par défaut (`run --yolo --agent-picker`), donc pas forcément avec `agent.yaml` et Mistral. On crée la sandbox, puis on lance Docker Agent avec `agent.yaml` via `sbx env exec` :
44-
45-```bash
46-sbx env create
47-sbx env exec -it -- docker-agent run agent.yaml
48-```
49-
50-`sbx env` affiche le plan (ce qui va être créé) et demande une approbation ; `--force` l'accepte sans demander. `sbx env exec` applique aussi le `env:` de `sbxenv.yaml`.
51-
52-Autres commandes utiles :
53-
54-```bash
55-sbx env plan # prévisualiser les changements
56-sbx env run # créer (si besoin) et s'attacher avec l'agent par défaut
57-sbx env rm # supprimer la sandbox et ses secrets
58-```
59-
deleted file mode 100644
@@ -1,59 +0,0 @@
1-# Docker Agent sandboxé et connecté à Mistral.ai, avec `sbx env run`
2-
3-Même objectif que l'étape précédente, mais la sandbox est décrite de façon déclarative dans un fichier `sbxenv.yaml` au lieu d'une longue ligne de commande `sbx run`.
4-
5-## Le fichier `sbxenv.yaml`
6-
7-```yaml
8-schemaVersion: "1"
9-name: docker-agent-mistral
10-agent: docker-agent
11-workspace: .
12-env:
13- DOCKER_AGENT_AUTO_UPDATE: "0"
14- MISTRAL_API_KEY: sbx-mistral-key
15-```
16-
17-- `name` : nom de la sandbox (et "scope" des secrets qui lui sont associés).
18-- `agent` : l'agent de base à utiliser.
19-- `workspace` : le répertoire monté dans la sandbox (`.` = le dossier du fichier).
20-- `env` : les variables d'environnement de la sandbox (remplace `sbx.env`). `MISTRAL_API_KEY` ne contient que la **valeur de remplacement** (placeholder), jamais la vraie clé.
21-
22-## Custom secret
23-
24-`sbxenv.yaml` ne sait pas déclarer un custom secret. On le crée donc avant, **en le rattachant à la sandbox** (`name` du fichier) pour qu'il soit supprimé par `sbx env rm` :
25-
26-```bash
27-export MISTRAL_API_KEY="your-api-key"
28-sbx secret set-custom --sandbox docker-agent-mistral \
29---host api.mistral.ai --env MISTRAL_API_KEY \
30---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
31-```
32-
33-🖐️ **on Windows:**
34-```bash
35-$env:MISTRAL_API_KEY="your-api-key"
36-
37-sbx secret set-custom --sandbox docker-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
38-```
39-
40-
41-## Démarrer la sandbox
42-
43-`sbx env run` ne permet pas de passer d'arguments à l'agent (pas de `-- run agent.yaml`) : Docker Agent serait lancé avec ses arguments par défaut (`run --yolo --agent-picker`), donc pas forcément avec `agent.yaml` et Mistral. On crée la sandbox, puis on lance Docker Agent avec `agent.yaml` via `sbx env exec` :
44-
45-```bash
46-sbx env create
47-sbx env exec -it -- docker-agent run agent.yaml
48-```
49-
50-`sbx env` affiche le plan (ce qui va être créé) et demande une approbation ; `--force` l'accepte sans demander. `sbx env exec` applique aussi le `env:` de `sbxenv.yaml`.
51-
52-Autres commandes utiles :
53-
54-```bash
55-sbx env plan # prévisualiser les changements
56-sbx env run # créer (si besoin) et s'attacher avec l'agent par défaut
57-sbx env rm # supprimer la sandbox et ses secrets
58-```
59-
deleted 07-play-lego-with-kits/README.fr.md +0 -96
deleted file mode 100644
@@ -1,96 +0,0 @@
1-# Jouer aux Lego avec les kits : Docker Agent + Rust
2-
3-Un **kit** est une brique réutilisable pour composer une sandbox. Ici, on assemble deux kits dans `sbxenv.yaml` :
4-
5-| Kit | Rôle |
6-|-----|------|
7-| `kits/docker-agent-mistral` | le **workload** (la base) : Docker Agent, lancé directement sur `agent.yaml`, avec accès à l'API Mistral |
8-| `kits/rust-toolchain` | un **mixin** : la toolchain Rust (`cargo`, `rustc`, `rustfmt`, `clippy`, `rust-analyzer`) |
9-
10-Un ensemble de kits v3 contient **exactement un workload** et autant de mixins que l'on veut. Un mixin v3 seul, associé à l'agent intégré `docker-agent` (qui est un kit v2), est refusé : `no workload kit in the set`.
11-
12-## Le fichier `sbxenv.yaml`
13-
14-```yaml
15-schemaVersion: "1"
16-name: docker-rust-agent-mistral
17-agent: docker-agent-mistral
18-workspace: .
19-env:
20- DOCKER_AGENT_AUTO_UPDATE: "0"
21- MISTRAL_API_KEY: sbx-mistral-key
22-
23-kits:
24- - ./kits/docker-agent-mistral
25- - ./kits/rust-toolchain
26-```
27-
28-- `agent` : doit porter le nom du kit workload (le nom du fichier `docker-agent-mistral.yaml`).
29-- `kits` : le workload, puis les mixins. Les chemins relatifs se résolvent par rapport à ce fichier.
30-- `env` : `MISTRAL_API_KEY` ne contient que la **valeur de remplacement** (placeholder), jamais la vraie clé.
31-
32-## Le kit workload : `docker-agent-mistral`
33-
34-- `docker-agent-mistral.dockerfile` part de l'image `docker/sandbox-templates:docker-agent-docker` et définit la commande de lancement (`ENTRYPOINT`/`CMD`) : `docker-agent run agent.yaml`.
35-- `docker-agent-mistral.yaml` déclare `kind: workload` et autorise la sortie vers `api.mistral.ai`.
36-
37-## Le kit mixin : `rust-toolchain`
38-
39-- `rust-toolchain.dockerfile` construit un calque avec la toolchain Rust et le linker (`gcc`) ; il n'est ajouté à l'image qu'en surcouche.
40-- `rust-toolchain.yaml` déclare `kind: mixin`, l'argument `rust_version` (par défaut `1.99.0`) et autorise la sortie vers crates.io.
41-
42-Pour changer la version de Rust sans modifier les fichiers :
43-
44-```bash
45-sbx env create --kit-arg rust_version=stable
46-```
47-
48-## Custom secret
49-
50-`sbxenv.yaml` ne sait pas déclarer un custom secret : on le crée avant. Avec `--sandbox`, il est supprimé en même temps que la sandbox par `sbx env rm` :
51-
52-```bash
53-export MISTRAL_API_KEY="your-api-key"
54-sbx secret set-custom --sandbox docker-rust-agent-mistral \
55---host api.mistral.ai --env MISTRAL_API_KEY \
56---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
57-```
58-
59-🖐️ **on Windows:**
60-```bash
61-$env:MISTRAL_API_KEY="your-api-key"
62-
63-sbx secret set-custom --sandbox docker-rust-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
64-```
65-
66-Sans `--sandbox`, le secret est global et fonctionne aussi.
67-
68-## Démarrer la sandbox
69-
70-```bash
71-sbx env create
72-sbx env exec -it -- docker-agent run agent.yaml
73-```
74-> 🖐️ **you need Docker to build a kit**
75-
76-`sbx env` affiche le plan (ce qui va être créé) et demande une approbation ; `--force` l'accepte sans demander. La première création construit les deux kits, ce qui prend un peu de temps.
77-
78-Autres commandes utiles :
79-
80-```bash
81-sbx env plan # prévisualiser les changements
82-sbx env rm # supprimer la sandbox et ses secrets
83-```
84-
85-## Et essayez
86-
87-```raw
88-What is the version of cargo?
89-```
90-
91-
92-```raw
93-Create a new Rust project with cargo that prints a greeting, then build and run it
94-```
95-
96-L'agent peut maintenant utiliser `cargo build`, `cargo test` ou `cargo clippy` dans la sandbox.
deleted file mode 100644
@@ -1,96 +0,0 @@
1-# Jouer aux Lego avec les kits : Docker Agent + Rust
2-
3-Un **kit** est une brique réutilisable pour composer une sandbox. Ici, on assemble deux kits dans `sbxenv.yaml` :
4-
5-| Kit | Rôle |
6-|-----|------|
7-| `kits/docker-agent-mistral` | le **workload** (la base) : Docker Agent, lancé directement sur `agent.yaml`, avec accès à l'API Mistral |
8-| `kits/rust-toolchain` | un **mixin** : la toolchain Rust (`cargo`, `rustc`, `rustfmt`, `clippy`, `rust-analyzer`) |
9-
10-Un ensemble de kits v3 contient **exactement un workload** et autant de mixins que l'on veut. Un mixin v3 seul, associé à l'agent intégré `docker-agent` (qui est un kit v2), est refusé : `no workload kit in the set`.
11-
12-## Le fichier `sbxenv.yaml`
13-
14-```yaml
15-schemaVersion: "1"
16-name: docker-rust-agent-mistral
17-agent: docker-agent-mistral
18-workspace: .
19-env:
20- DOCKER_AGENT_AUTO_UPDATE: "0"
21- MISTRAL_API_KEY: sbx-mistral-key
22-
23-kits:
24- - ./kits/docker-agent-mistral
25- - ./kits/rust-toolchain
26-```
27-
28-- `agent` : doit porter le nom du kit workload (le nom du fichier `docker-agent-mistral.yaml`).
29-- `kits` : le workload, puis les mixins. Les chemins relatifs se résolvent par rapport à ce fichier.
30-- `env` : `MISTRAL_API_KEY` ne contient que la **valeur de remplacement** (placeholder), jamais la vraie clé.
31-
32-## Le kit workload : `docker-agent-mistral`
33-
34-- `docker-agent-mistral.dockerfile` part de l'image `docker/sandbox-templates:docker-agent-docker` et définit la commande de lancement (`ENTRYPOINT`/`CMD`) : `docker-agent run agent.yaml`.
35-- `docker-agent-mistral.yaml` déclare `kind: workload` et autorise la sortie vers `api.mistral.ai`.
36-
37-## Le kit mixin : `rust-toolchain`
38-
39-- `rust-toolchain.dockerfile` construit un calque avec la toolchain Rust et le linker (`gcc`) ; il n'est ajouté à l'image qu'en surcouche.
40-- `rust-toolchain.yaml` déclare `kind: mixin`, l'argument `rust_version` (par défaut `1.99.0`) et autorise la sortie vers crates.io.
41-
42-Pour changer la version de Rust sans modifier les fichiers :
43-
44-```bash
45-sbx env create --kit-arg rust_version=stable
46-```
47-
48-## Custom secret
49-
50-`sbxenv.yaml` ne sait pas déclarer un custom secret : on le crée avant. Avec `--sandbox`, il est supprimé en même temps que la sandbox par `sbx env rm` :
51-
52-```bash
53-export MISTRAL_API_KEY="your-api-key"
54-sbx secret set-custom --sandbox docker-rust-agent-mistral \
55---host api.mistral.ai --env MISTRAL_API_KEY \
56---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
57-```
58-
59-🖐️ **on Windows:**
60-```bash
61-$env:MISTRAL_API_KEY="your-api-key"
62-
63-sbx secret set-custom --sandbox docker-rust-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
64-```
65-
66-Sans `--sandbox`, le secret est global et fonctionne aussi.
67-
68-## Démarrer la sandbox
69-
70-```bash
71-sbx env create
72-sbx env exec -it -- docker-agent run agent.yaml
73-```
74-> 🖐️ **you need Docker to build a kit**
75-
76-`sbx env` affiche le plan (ce qui va être créé) et demande une approbation ; `--force` l'accepte sans demander. La première création construit les deux kits, ce qui prend un peu de temps.
77-
78-Autres commandes utiles :
79-
80-```bash
81-sbx env plan # prévisualiser les changements
82-sbx env rm # supprimer la sandbox et ses secrets
83-```
84-
85-## Et essayez
86-
87-```raw
88-What is the version of cargo?
89-```
90-
91-
92-```raw
93-Create a new Rust project with cargo that prints a greeting, then build and run it
94-```
95-
96-L'agent peut maintenant utiliser `cargo build`, `cargo test` ou `cargo clippy` dans la sandbox.
deleted 08-policies/README.fr.md +0 -114
deleted file mode 100644
@@ -1,114 +0,0 @@
1-# Ajouter des policies : interdire `gitlab.com` et `mini-me.org`
2-
3-On réutilise les kits de l'étape précédente (`07-play-lego-with-kits`) et on ajoute une brique : un kit qui **interdit** l'accès à certains hôtes.
4-
5-## Le fichier `sbxenv.yaml`
6-
7-```yaml
8-schemaVersion: "1"
9-name: docker-policies-agent-mistral
10-agent: docker-agent-mistral
11-workspace: .
12-env:
13- DOCKER_AGENT_AUTO_UPDATE: "0"
14- MISTRAL_API_KEY: sbx-mistral-key
15-
16-kits:
17- - ../07-play-lego-with-kits/kits/docker-agent-mistral
18- - ../07-play-lego-with-kits/kits/rust-toolchain
19- - ./kits/deny-hosts
20-```
21-
22-- `agent` : le nom du kit workload (`docker-agent-mistral`), comme à l'étape 07.
23-- `kits` : le workload et le mixin Rust de l'étape 07 (chemins relatifs à ce fichier), plus le mixin de policy local.
24-- `name` : une sandbox distincte de celle de l'étape 07, avec ses propres secrets.
25-
26-## Le kit de policy : `deny-hosts`
27-
28-`sbxenv.yaml` n'a pas de section pour les règles réseau : elles passent par un kit. `kits/deny-hosts/deny-hosts.yaml` est un mixin v3 sans Dockerfile, qui ne contient que la règle :
29-
30-```yaml
31-# syntax=docker/sandbox-kit:3
32-schemaVersion: "3"
33-kind: mixin
34-displayName: Deny hosts
35-description: Network policy that blocks the hosts the sandbox must never reach
36-
37-capabilities:
38- - type: com.docker.sandbox/network-policy@1
39- config:
40- runtime:
41- deny:
42- - gitlab.com
43- - "**.gitlab.com"
44- - mini-me.org
45- - "**.mini-me.org"
46-```
47-
48-- `gitlab.com` et `mini-me.org` : les domaines eux-mêmes.
49-- `**.gitlab.com` et `**.mini-me.org` : tous leurs sous-domaines.
50-- Un `deny` l'emporte toujours sur un `allow`, quel que soit le kit qui l'a déclaré.
51-
52-Pour bloquer d'autres hôtes, ajoutez-les à la liste `deny`.
53-
54-## Custom secret
55-
56-Comme aux étapes précédentes, on crée le custom secret avant. Avec `--sandbox`, il est supprimé en même temps que la sandbox par `sbx env rm` :
57-
58-```bash
59-export MISTRAL_API_KEY="your-api-key"
60-sbx secret set-custom --sandbox docker-policies-agent-mistral \
61---host api.mistral.ai --env MISTRAL_API_KEY \
62---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
63-```
64-
65-🖐️ **on Windows:**
66-```bash
67-$env:MISTRAL_API_KEY="your-api-key"
68-
69-sbx secret set-custom --sandbox docker-policies-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
70-```
71-
72-Un custom secret global (sans `--sandbox`) fonctionne aussi.
73-
74-## Démarrer la sandbox
75-
76-```bash
77-sbx env create --force
78-sbx env exec -it -- docker-agent run agent.yaml
79-```
80-
81-Le plan affiché par `sbx env` liste les trois kits ; il faut l'approuver (`--force` l'accepte sans demander).
82-
83-## Et essayez
84-
85-```raw
86-Show me the content of https://gitlab.com
87-```
88-
89-```raw
90-Show me the content of https://mini-me.org
91-```
92-
93-Les deux requêtes doivent être bloquées. Comparez avec un hôte non interdit, par exemple `https://crates.io`.
94-
95-## Autre méthode : la policy côté hôte
96-
97-On peut poser la même règle sans kit, avec la CLI. Elle vit alors sur la machine hôte et non dans `sbxenv.yaml` :
98-
99-```bash
100-# pour cette sandbox seulement
101-sbx policy deny network --sandbox docker-policies-agent-mistral gitlab.com mini-me.org
102-
103-# pour toutes les sandboxes
104-sbx policy deny network gitlab.com mini-me.org
105-```
106-
107-Pour vérifier ce qui est autorisé ou bloqué :
108-
109-```bash
110-sbx policy ls
111-sbx policy log
112-```
113-
114-L'avantage du kit : la règle voyage avec le projet (`sbxenv.yaml` est versionné) et s'applique à quiconque lance l'environnement. L'avantage de la CLI : elle peut s'appliquer à toutes les sandboxes d'un coup.
deleted file mode 100644
@@ -1,114 +0,0 @@
1-# Ajouter des policies : interdire `gitlab.com` et `mini-me.org`
2-
3-On réutilise les kits de l'étape précédente (`07-play-lego-with-kits`) et on ajoute une brique : un kit qui **interdit** l'accès à certains hôtes.
4-
5-## Le fichier `sbxenv.yaml`
6-
7-```yaml
8-schemaVersion: "1"
9-name: docker-policies-agent-mistral
10-agent: docker-agent-mistral
11-workspace: .
12-env:
13- DOCKER_AGENT_AUTO_UPDATE: "0"
14- MISTRAL_API_KEY: sbx-mistral-key
15-
16-kits:
17- - ../07-play-lego-with-kits/kits/docker-agent-mistral
18- - ../07-play-lego-with-kits/kits/rust-toolchain
19- - ./kits/deny-hosts
20-```
21-
22-- `agent` : le nom du kit workload (`docker-agent-mistral`), comme à l'étape 07.
23-- `kits` : le workload et le mixin Rust de l'étape 07 (chemins relatifs à ce fichier), plus le mixin de policy local.
24-- `name` : une sandbox distincte de celle de l'étape 07, avec ses propres secrets.
25-
26-## Le kit de policy : `deny-hosts`
27-
28-`sbxenv.yaml` n'a pas de section pour les règles réseau : elles passent par un kit. `kits/deny-hosts/deny-hosts.yaml` est un mixin v3 sans Dockerfile, qui ne contient que la règle :
29-
30-```yaml
31-# syntax=docker/sandbox-kit:3
32-schemaVersion: "3"
33-kind: mixin
34-displayName: Deny hosts
35-description: Network policy that blocks the hosts the sandbox must never reach
36-
37-capabilities:
38- - type: com.docker.sandbox/network-policy@1
39- config:
40- runtime:
41- deny:
42- - gitlab.com
43- - "**.gitlab.com"
44- - mini-me.org
45- - "**.mini-me.org"
46-```
47-
48-- `gitlab.com` et `mini-me.org` : les domaines eux-mêmes.
49-- `**.gitlab.com` et `**.mini-me.org` : tous leurs sous-domaines.
50-- Un `deny` l'emporte toujours sur un `allow`, quel que soit le kit qui l'a déclaré.
51-
52-Pour bloquer d'autres hôtes, ajoutez-les à la liste `deny`.
53-
54-## Custom secret
55-
56-Comme aux étapes précédentes, on crée le custom secret avant. Avec `--sandbox`, il est supprimé en même temps que la sandbox par `sbx env rm` :
57-
58-```bash
59-export MISTRAL_API_KEY="your-api-key"
60-sbx secret set-custom --sandbox docker-policies-agent-mistral \
61---host api.mistral.ai --env MISTRAL_API_KEY \
62---placeholder sbx-mistral-key --value "$MISTRAL_API_KEY"
63-```
64-
65-🖐️ **on Windows:**
66-```bash
67-$env:MISTRAL_API_KEY="your-api-key"
68-
69-sbx secret set-custom --sandbox docker-policies-agent-mistral --host api.mistral.ai --env MISTRAL_API_KEY --placeholder sbx-mistral-key --value "$env:MISTRAL_API_KEY"
70-```
71-
72-Un custom secret global (sans `--sandbox`) fonctionne aussi.
73-
74-## Démarrer la sandbox
75-
76-```bash
77-sbx env create --force
78-sbx env exec -it -- docker-agent run agent.yaml
79-```
80-
81-Le plan affiché par `sbx env` liste les trois kits ; il faut l'approuver (`--force` l'accepte sans demander).
82-
83-## Et essayez
84-
85-```raw
86-Show me the content of https://gitlab.com
87-```
88-
89-```raw
90-Show me the content of https://mini-me.org
91-```
92-
93-Les deux requêtes doivent être bloquées. Comparez avec un hôte non interdit, par exemple `https://crates.io`.
94-
95-## Autre méthode : la policy côté hôte
96-
97-On peut poser la même règle sans kit, avec la CLI. Elle vit alors sur la machine hôte et non dans `sbxenv.yaml` :
98-
99-```bash
100-# pour cette sandbox seulement
101-sbx policy deny network --sandbox docker-policies-agent-mistral gitlab.com mini-me.org
102-
103-# pour toutes les sandboxes
104-sbx policy deny network gitlab.com mini-me.org
105-```
106-
107-Pour vérifier ce qui est autorisé ou bloqué :
108-
109-```bash
110-sbx policy ls
111-sbx policy log
112-```
113-
114-L'avantage du kit : la règle voyage avec le projet (`sbxenv.yaml` est versionné) et s'applique à quiconque lance l'environnement. L'avantage de la CLI : elle peut s'appliquer à toutes les sandboxes d'un coup.
deleted README.fr.md +0 -3
deleted file mode 100644
@@ -1,3 +0,0 @@
1-# Workshop: Docker `sbx` + Docker Agent + Mistral AI
2-
3-> Testé sur macOS arm
\ No newline at end of file
deleted file mode 100644
@@ -1,3 +0,0 @@
1-# Workshop: Docker `sbx` + Docker Agent + Mistral AI
2-
3-> Testé sur macOS arm
\ No newline at end of file\ No newline at end of file
modified README.md +0 -2
@@ -1,3 +1 @@
11 # Workshop: Docker `sbx` + Docker Agent + Mistral AI
2-
3-> Tested on macOS arm
@@ -1,3 +1 @@
1 # Workshop: Docker `sbx` + Docker Agent + Mistral AI1 # Workshop: Docker `sbx` + Docker Agent + Mistral AI
2-
3-> Tested on macOS arm