⚠️ Traduction non officielle - Cette documentation est une traduction communautaire non officielle de Docker.

Tester et déboguer

Table des matières

Afin d'améliorer l'expérience développeur, Docker Desktop fournit un ensemble d'outils pour vous aider à tester et déboguer votre extension.

Ouvrir Chrome DevTools

Afin d'ouvrir les Chrome DevTools pour votre extension quand vous sélectionnez l'onglet Extensions, exécutez :

$ docker extension dev debug <name-of-your-extensions>

Chaque clic subséquent sur l'onglet d'extension ouvre également Chrome DevTools. Pour arrêter ce comportement, exécutez :

$ docker extension dev reset <name-of-your-extensions>

Après qu'une extension soit déployée, il est également possible d'ouvrir Chrome DevTools depuis la partie UI d'extension en utilisant une variation du Code Konami. Sélectionnez l'onglet Extensions, et ensuite appuyez sur la séquence de touches haut, haut, bas, bas, gauche, droite, gauche, droite, p, d, t.

Rechargement à chaud lors du développement de l'UI

Pendant le développement de l'UI, il est utile d'utiliser le rechargement à chaud pour tester vos changements sans reconstruire toute votre extension. Pour faire cela, vous pouvez configurer Docker Desktop pour charger votre UI depuis un serveur de développement, comme celui que Vite démarre quand invoqué avec npm start.

En supposant que votre app s'exécute sur le port par défaut, démarrez votre app UI et ensuite exécutez :

$ cd ui
$ npm run dev

Cela démarre un serveur de développement qui écoute sur le port 3000.

Vous pouvez maintenant dire à Docker Desktop d'utiliser ceci comme source frontend. Dans un autre terminal, exécutez :

$ docker extension dev ui-source <name-of-your-extensions> http://localhost:3000

Fermez et rouvrez le tableau de bord Docker Desktop et allez à votre extension. Tous les changements au code frontend sont immédiatement visibles.

Une fois terminé, vous pouvez réinitialiser la configuration d'extension aux paramètres originaux. Cela réinitialisera également l'ouverture de Chrome DevTools si vous avez utilisé docker extension dev debug <name-of-your-extensions> :

$ docker extension dev reset <name-of-your-extensions>

Afficher les conteneurs d'extension

Si votre extension est composée d'un ou plusieurs services s'exécutant comme conteneurs dans la VM Docker Desktop, vous pouvez y accéder facilement depuis le tableau de bord dans Docker Desktop.

  1. Dans Docker Desktop, naviguez vers Paramètres.
  2. Sous l'onglet Extensions, sélectionnez l'option Afficher les conteneurs système des extensions Docker Desktop. Vous pouvez maintenant voir vos conteneurs d'extension et leurs journaux.

Nettoyage

Pour supprimer l'extension, exécutez :

$ docker extension rm <name-of-your-extension>

Et ensuite