fix: Update documentation after codelab at Devoxx France 2025 (#52)

emeric-martineau · jhaumont · web-flow · commit 9c3e422ec64e · 2025-06-24T22:47:59.000+02:00
* fix: manual installation

* feat: add documentation to use local vscode with codespace

* fix: use folder .dagger instead of dagger suggered by dagger contibutor

* Update 03-utiliser-module-daggerverse.md

* fix: Update after review

* update devcontainer with latest versions

* small fix

* fix version

* fix: version and typo

* fix

* english update

* update

---------

Co-authored-by: Julien Haumont &lt;3694732+jhaumont@users.noreply.github.com&gt;
Co-authored-by: Julien Haumont &lt;julien.haumont@zenika.com&gt;
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
@@ -4,7 +4,7 @@
 {
 	"name": "Go Devcontainer",
   
-	"image": "adrienaury/go-devcontainer:v5.1.0",
+	"image": "adrienaury/go-devcontainer:v6.0.1",
 
 	// Add the IDs of extensions you want installed when the container is created.
 	"customizations": {
diff --git a/.devcontainer/install-dagger.sh b/.devcontainer/install-dagger.sh
@@ -1,7 +1,7 @@
 #!/bin/sh
 
 mkdir -p "$HOME/.local/bin"
-curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.3 BIN_DIR=$HOME/.local/bin sh
+curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.10 BIN_DIR=$HOME/.local/bin sh
 sudo su <<EOF
 echo "alias ll='ls -al'" >> $HOME/.zshrc
 echo "PATH=$PATH:$HOME/.local/bin" >> $HOME/.zshrc
diff --git a/.github/workflows/CI.yaml b/.github/workflows/CI.yaml
@@ -2,10 +2,10 @@ name: CI hello
 on:
   pull_request:
     branches:
-      - 'main'
+      - "main"
   push:
     branches:
-      - 'main'
+      - "main"
 
 jobs:
   CI:
diff --git a/runbooks/codespace-2.png b/runbooks/codespace-2.png
diff --git a/runbooks/english/01-setup.md b/runbooks/english/01-setup.md
@@ -2,14 +2,16 @@
 
 To run this codelab, you have 2 choices:
 
-- Use GitHub Codespace by clicking on the button bellow (**recommended**)
+- Use GitHub [Codespace](#codespace) by clicking on the button bellow (**recommended**)
 - Install all prerequisites and Dagger on your computer (see section [Local installation](#local-installation) of this document)
 
-## Fork this repository
+## Codespace
+
+### Repository fork
 
 Please, fork this repository. With your fork, you can commit & push to save your work.
 
-## Codespace
+### Codespace creation
 
 Click on the button bellow:
 
@@ -19,23 +21,41 @@ In the codespace's creation's page, keep in mind to **change the repository name
 
 ![](../codespace.png)
 
+Codespace environnement can take few minutes.
+
+Now, you are ready to go to next page [Getting started with Dagger](02-getting-started-with-Dagger.md)
+
+> [!TIP]
+> If the code space loading page is still displayed, scroll to bottom of [Codespace page](https://github.com/codespaces/) 
+> ![](../codespace-2.png)
+>
+> If status is `Active`, that means the codespace is ready, but web page is blocked maybe due to too many call from same IP addresses (in case of codelab with too many people). Voir [Se connecter à VSCode (optionnel)](#se-connecter-à-vscode-optionnel).
+
+### Connect to VSCode (optional)
+
+You can connect your local VSCode (from your computer) directly to codespace environnement. To do that, please read [official documentation](https://docs.github.com/en/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code).
+
 ## Local installation
 
+### Repository fork
+
+Please, fork this repository. With your fork, you can commit & push to save your work.
+
+### Configuration
+
 To run this codelab, your need install all of components bellow:
 
 - Under Windows, WSL2 is highly recommended (but you can use an other virtualization manager like [Virtualbox](https://www.virtualbox.org))
 - Install **Docker for Windows/Mac** or **Rancher Desktop**
 - Install [Git](https://git-scm.com/)
 - Install [Go](https://go.dev/doc/install) language `1.23.x`
-- Install [Dagger](https://docs.dagger.io/quickstart/cli/) version `0.18.3`
+- Install [Dagger](https://docs.dagger.io/install/) version `0.18.10`
   - Example for linux:
     ```bash
-    curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.3 $HOME/.local/bin sh
+    curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.10 BIN_DIR=$HOME/.local/bin sh
     ```
 
 > [!TIP]
 > If you have any issue with Docker credential by using WSL2, you can try this fix it by following instruction given on this website https://forums.docker.com/t/docker-credential-desktop-exe-executable-file-not-found-in-path-using-wsl2/100225/5
 
-## Getting Started with Dagger
-
 Now, you are ready to go to next page [Getting started with Dagger](02-getting-started-with-Dagger.md)
diff --git a/runbooks/english/02-getting-started-with-Dagger.md b/runbooks/english/02-getting-started-with-Dagger.md
@@ -20,16 +20,16 @@ cd hello
 
 Init your Dagger module:
 ```bash
-dagger init --sdk=go --source=./dagger
+dagger init --sdk=go --source=.dagger
 ```
 
 This command will download and run the container image of Dagger engine (based on your CLI version) and generate skeleton of your Dagger module:
 - a `dagger.json` file that contains metadata,
-- a `dagger` folder:
+- a `.dagger` folder:
   - a `main.go` file that will contains your module's code,
   - a `dagger.gen.go` file and a `internal` folder that contains utily code generated by Dagger,
 
-In the `dagger/main.go` file, replace the existing code with the one below:
+In the `.dagger/main.go` file, replace the existing code with the one below:
 
 ```go
 package main
@@ -84,7 +84,7 @@ return dag.Container().
 > [!WARNING]
 > The `dagger.gen.go` has compilation issue in VSCode (file is red).
 >
-> When we change content of `dagger/main.go` file, public interface changes and the code generation needs to happen again.
+> When we change content of `.dagger/main.go` file, public interface changes and the code generation needs to happen again.
 >
 > We must regenerate the Dagger module's code with command:
 > ```bash
@@ -149,6 +149,13 @@ export DAGGER_CLOUD_TOKEN=<token>
 
 You can add this to your `.profile` (or anything else) to avoid entering it every time you close and open your shell.
 
+Or more simple, you can directly logging on Dagger :
+
+```bash
+dagger login
+```
+
+
 ## Interact with the result of your function
 
 When your function returns a container type, you can interact with it to inspect its content.
diff --git a/runbooks/english/03-use-module-from-daggerverse.md b/runbooks/english/03-use-module-from-daggerverse.md
@@ -54,7 +54,7 @@ Another solution is to read directly the souce code: https://github.com/vito/dag
 
 ### Change BuildEnv function
 
-Add a `builder` field of type `*dagger.Go` to the `Hello` struct in file `dagger/main.go`:
+Add a `builder` field of type `*dagger.Go` to the `Hello` struct in file `.dagger/main.go`:
 ```go
 type Hello struct {
 	builder *dagger.Go
@@ -84,7 +84,7 @@ Now, this function no longer returns a container, but modifies `builder` instanc
 
 ### Update Build function
 
-Replace the `Build` function by bellow code in the file `dagger/main.go`:
+Replace the `Build` function by bellow code in the file `.dagger/main.go`:
 ```go
 // Build the application container
 func (m *Hello) Build(source *dagger.Directory) *dagger.Container {
diff --git a/runbooks/english/04-use-module-in-github-actions.md b/runbooks/english/04-use-module-in-github-actions.md
@@ -28,4 +28,7 @@ You now have a CI pipeline for the `hello` application!
 
 The pipeline is executed on GitHub Action using our Dagger module! This allows you to use the same pipeline locally and in GitHub Actions.
 
+> [!TIP]
+> You can install the GitHub app Dagger inside your repository to link directly inside the PR the build traces on Dagger Cloud. CF https://github.com/apps/dagger-cloud
+
 Now, we will expore the Dagger shell, to do same but without any code: [Introducing Dagger Shell](./05-use-interactive-dagger-shell.md).
diff --git a/runbooks/french/01-setup.md b/runbooks/french/01-setup.md
@@ -2,14 +2,16 @@
 
 Pour réaliser ce codelab, vous avez 2 possibilités :
 
-- Utiliser le GitHub Codespace mis à disposition (**méthode recommandée**)
+- Utiliser le GitHub [Codespace](#codespace) mis à disposition (**méthode recommandée**)
 - Installer les prérequis et Dagger sur votre machine (voir section [Installation locale](#installation-locale) de ce document)
 
-## Fork du repository
+## Codespace
+
+### Fork du repository
 
 Faire un fork de ce repository. Avec ce fork, vous pouvez commit et pousser votre travail pour le sauvegarder.
 
-## Codespace
+### Création du codespace
 
 Cliquez sur le bouton ci-dessous et laissez vous porter par la magie :
 
@@ -19,23 +21,41 @@ Dans la fenêtre de création du codespace, pensez à **changer le repository po
 
 ![](../codespace.png)
 
+La création de l'environnement codespace prend quelques minutes.
+
+Une fois le codespace déployé, allez à la page [Getting started with Dagger](02-getting-started-with-Dagger.md)
+
+> [!TIP]
+> Si la page de chargement reste bloquée, allez tout en bas de la page [Codespace](https://github.com/codespaces/) :
+> ![](../codespace-2.png)
+>
+> Si le statut est `Active`, le codespace est bien créé mais l'ihm est bloqué, peut-être à cause d'un trop grand nombre de connexions depuis la même adresse IP (dans le cas d'un codelab lors d'une conférence). Voir [Se connecter à VSCode (optionnel)](#se-connecter-à-vscode-optionnel).
+
+### Se connecter à VSCode (optionnel)
+
+Vous pouvez connecter l'instance VSCode de votre ordinateur à l'environnement codespace. Pour cela, suivez la [documentation officielle](https://docs.github.com/en/codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code).
+
 ## Installation locale
 
+### Fork du repository
+
+Faire un fork de ce repository. Avec ce fork, vous pouvez commit et pousser votre travail pour le sauvegarder.
+
+### Configuration
+
 Voici les éléments à mettre en place pour réaliser le codelab sur votre machine :
 
 - Avec Windows l'utilisation de WSL2 est recommandée (vous pouvez toutefois utiliser un système de virtualisation comme [Virtualbox](https://www.virtualbox.org))
 - Avoir Docker installé sur votre machine (via **Docker for Windows/Mac** ou **Rancher Desktop** pour Windows et Mac OS)
 - Installer un client [Git](https://git-scm.com/)
 - Installer la version `1.23.x` du langage [Go](https://go.dev/doc/install)
-- Installer le client [Dagger](https://docs.dagger.io/quickstart/cli/) version `0.18.3`
+- Installer le client [Dagger](https://docs.dagger.io/install/) version `0.18.10`
   - Exemple pour linux:
     ```bash
-    curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.3 $HOME/.local/bin sh
+    curl -fsSL https://dl.dagger.io/dagger/install.sh | DAGGER_VERSION=0.18.10 BIN_DIR=$HOME/.local/bin sh
     ```
 
 > [!TIP]
 > En cas de soucis avec les identifiants docker sur WSL2, essayer la solution suivante https://forums.docker.com/t/docker-credential-desktop-exe-executable-file-not-found-in-path-using-wsl2/100225/5
 
-## Getting Started with Dagger
-
-Une fois prêts, démarrer le allez à la page [Getting started with Dagger](02-getting-started-with-Dagger.md)
+Une fois la configuration terminée, allez à la page [Getting started with Dagger](02-getting-started-with-Dagger.md)
diff --git a/runbooks/french/02-getting-started-with-Dagger.md b/runbooks/french/02-getting-started-with-Dagger.md
@@ -20,16 +20,16 @@ cd hello
 
 Initialisez votre module de Dagger :
 ```bash
-dagger init --sdk=go --source=./dagger
+dagger init --sdk=go --source=.dagger
 ```
 
 Cette commande va télécharger l'image du conteneur Dagger engine (liée à votre version du CLI), le démarrer et générer votre structre de module Dagger :
 - Un fichier `dagger.json` de metadata,
-- Un répertoire `dagger` :
+- Un répertoire `.dagger` :
   - Un fichier `main.go` qui va contenir le code de votre module,
   - Un ficher `dagger.gen.go` et un répertoire `internal` contenant le code utilitaire généré par Dagger,
 
-Dans le fichier `dagger/main.go`, remplacez le code existant par celui ci-dessous :
+Dans le fichier `.dagger/main.go`, remplacez le code existant par celui ci-dessous :
 
 ```go
 package main
@@ -84,7 +84,7 @@ return dag.Container().
 > [!WARNING]
 > Le fichier `dagger.gen.go` apparait comme ayant un problème de compilation dans VSCode (le fichier est rouge).
 > 
-> En changeant le contenu du fichier `dagger/main.go`, l'interface a évolué.
+> En changeant le contenu du fichier `.dagger/main.go`, l'interface a évolué.
 > 
 > Il faut regénérer le code Dagger du module, avec la commande ci-dessous :
 > ```bash
@@ -151,6 +151,12 @@ export DAGGER_CLOUD_TOKEN=<token>
 
 Pour ne plus avoir à le faire à chaque ouverture de session/terminal, il faut ajouter ce token à votre contexte (`.profile` ou autre).
 
+Ou plus simple, vous pouvez directement vous logger sur Dagger avec :
+
+```bash
+dagger login
+```
+
 ## Intéragir avec le résultat de votre fonction
 
 Lorsque votre fonction retourne un type "container", vous avez la possibilité d'interagir avec cette dernière pour inspecter son contenu.
diff --git a/runbooks/french/03-utiliser-module-daggerverse.md b/runbooks/french/03-utiliser-module-daggerverse.md
@@ -54,7 +54,7 @@ Une autre solution est de regarder directement le code source : https://github.c
 
 ### Modifier la fonction BuildEnv
 
-Ajoutez un champ `builder` de type `*dagger.Go` dans la structure `Hello` dans le ficher `dagger/main.go` :
+Ajoutez un champ `builder` de type `*dagger.Go` dans la structure `Hello` dans le ficher `.dagger/main.go` :
 ```go
 type Hello struct {
 	builder *dagger.Go
@@ -85,7 +85,7 @@ Dorénavant, cette fonction ne retourne plus un container mais modifie l'instanc
 
 ### Modifier la fonction Build
 
-Remplacez la fonction `Build` par le code suivant dans le ficher `dagger/main.go` :
+Remplacez la fonction `Build` par le code suivant dans le ficher `.dagger/main.go` :
 ```go
 // Build the application container
 func (m *Hello) Build(source *dagger.Directory) *dagger.Container {
diff --git a/runbooks/french/04-utiliser-module-github-actions.md b/runbooks/french/04-utiliser-module-github-actions.md
@@ -28,4 +28,7 @@ Vous avez maintenant un pipeline de CI pour l'application `hello`.
 
 Le pipeline s'exécute sur GitHub Actions en utilisant les fonctions Dagger que vous avez créées. Cela vous permet d'utiliser le même pipeline localement et dans les GitHub actions.
 
+> [!TIP]
+> Vous pouvez installer la GitHub app Dagger pour avoir le lien direct dans la PR vers les traces du build dans le Dagger Cloud. CF https://github.com/apps/dagger-cloud
+
 A présent, nous allons expérimenter le Dagger shell, pour faire la même chose mais sans code : [Introduction à Dagger Shell](./05-utilisation-de-dagger-shell.md).
diff --git a/solutions/04-use-module-in-github-actions/.github/workflows/CI.yaml b/solutions/04-use-module-in-github-actions/.github/workflows/CI.yaml
@@ -18,7 +18,7 @@ jobs:
       - name: Publish
         uses: dagger/dagger-for-github@8.0.0
         with:
-          version: "0.18.3"
+          version: "0.18.10"
           verb: call
           workdir: hello
           args: publish --source=.
diff --git a/solutions/05-create-publish-module/.github/workflows/renovate.yaml b/solutions/05-create-publish-module/.github/workflows/renovate.yaml
@@ -19,7 +19,7 @@ jobs:
       - name: Scan
         uses: dagger/dagger-for-github@8.0.0
         with:
-          version: "0.18.3"
+          version: "0.18.10"
           verb: call
           workdir: renovate
           args: renovate-scan --repository="jhaumont/enter-the-daggerverse" --renovate-token=env:RENOVATE_TOKEN

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@`
`4`	`4`	`{`
`5`	`5`	`"name": "Go Devcontainer",`
`6`	`6`
`7`		`- "image": "adrienaury/go-devcontainer:v5.1.0",`
	`7`	`+ "image": "adrienaury/go-devcontainer:v6.0.1",`
`8`	`8`
`9`	`9`	`// Add the IDs of extensions you want installed when the container is created.`
`10`	`10`	`"customizations": {`