🛟 Updated.Unverified
28bfe6e parent: 0401529 modified
.gitignore +2 -0 | @@ -5,3 +5,5 @@ docker-agent | ||
| 5 | 5 | .tmp |
| 6 | 6 | .claude |
| 7 | 7 | slides |
| 8 | +*.fr.md | |
| 9 | +.backup | |
| \ No newline at end of file | ||
| @@ -5,3 +5,5 @@ docker-agent | |||
| 5 | .tmp | 5 | .tmp |
| 6 | .claude | 6 | .claude |
| 7 | slides | 7 | 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 | - | |
| 9 | - | |
| 10 | -Renseignez les informations nécessaires: | |
| 11 | - | |
| 12 | - | |
| 13 | -Vous allez recevoir un code par email: | |
| 14 | - | |
| 15 | - | |
| 16 | -Que vous allez saisir côté Mistral AI pour vérification: | |
| 17 | - | |
| 18 | - | |
| 19 | -Ensuite, une fois dans Mistral Studio, vous pouvez créer votre clé: | |
| 20 | - | |
| 21 | - | |
| 22 | -Et voir la liste de vos clés en cours: | |
| 23 | - | |
| 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 | - | ||
| 9 | - | ||
| 10 | -Renseignez les informations nécessaires: | ||
| 11 | - | ||
| 12 | - | ||
| 13 | -Vous allez recevoir un code par email: | ||
| 14 | - | ||
| 15 | - | ||
| 16 | -Que vous allez saisir côté Mistral AI pour vérification: | ||
| 17 | - | ||
| 18 | - | ||
| 19 | -Ensuite, une fois dans Mistral Studio, vous pouvez créer votre clé: | ||
| 20 | - | ||
| 21 | - | ||
| 22 | -Et voir la liste de vos clés en cours: | ||
| 23 | - | ||
| 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 | - | |
| 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 | - | |
| 60 | - | |
| 61 | -Et vous découvrez que l'agent a probablement accés à l'ensemble des données sur votre machine: | |
| 62 | - | |
| 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 | - | |
| 84 | - | |
| 85 | -```raw | |
| 86 | -What is the content of MISTRAL_API_KEY? | |
| 87 | -``` | |
| 88 | - | |
| 89 | - | |
| 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 | - | |
| 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 | - | |
| 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 | - | ||
| 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 | - | ||
| 60 | - | ||
| 61 | -Et vous découvrez que l'agent a probablement accés à l'ensemble des données sur votre machine: | ||
| 62 | - | ||
| 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 | - | ||
| 84 | - | ||
| 85 | -```raw | ||
| 86 | -What is the content of MISTRAL_API_KEY? | ||
| 87 | -``` | ||
| 88 | - | ||
| 89 | - | ||
| 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 | - | ||
| 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 | - | ||
| 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 | - | |
| 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 | - | ||
| 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 | - | |
| 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 | - | |
| 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 | - | ||
| 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 | - | ||
| 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 @@ | ||
| 1 | 1 | # Workshop: Docker `sbx` + Docker Agent + Mistral AI |
| 2 | - | |
| 3 | -> Tested on macOS arm | |
| @@ -1,3 +1 @@ | |||
| 1 | # Workshop: Docker `sbx` + Docker Agent + Mistral AI | 1 | # Workshop: Docker `sbx` + Docker Agent + Mistral AI |
| 2 | - | ||
| 3 | -> Tested on macOS arm | ||