Diagrams.net

{{< details >}}

• Édition : Gratuite, GitLab Premium, GitLab Ultimate
• Offre : GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

• La prise en charge des environnements hors ligne a été introduite dans GitLab 16.1.

{{< /history >}}

Utilisez l'intégration diagrams.net pour créer et intégrer des diagrammes SVG dans les wikis. L'éditeur de diagrammes est disponible à la fois dans l'éditeur de texte brut et dans l'éditeur de texte enrichi.

Cette intégration est disponible pour tous les utilisateurs de GitLab.com et ne nécessite aucune configuration supplémentaire.

Pour GitLab Self-Managed et GitLab Dedicated, intégrez-vous au site web gratuit diagrams.net ou hébergez votre propre site diagrams.net dans des environnements hors ligne.

Pour configurer l'intégration :

1. Choisissez d'intégrer le site web gratuit diagrams.net ou configurez votre serveur diagrams.net.
2. Activez l'intégration.

Une fois l'intégration effectuée, l'éditeur diagrams.net s'ouvre avec l'URL que vous avez fournie.

Configurer votre serveur diagrams.net {#configure-your-diagramsnet-server}

Vous pouvez configurer votre propre serveur diagrams.net pour générer des diagrammes. Pour les installations hors ligne de GitLab Self-Managed, cette étape est obligatoire.

Pour exécuter un conteneur diagrams.net dans Docker, exécutez la commande suivante :

docker run -it --rm --name="draw" -p 8006:8080 -p 8443:8443 jgraph/drawio

[!note] Utilisez le port 8006 pour le point de terminaison HTTP. Vous devriez éviter le port par défaut 8080 car Puma écoute sur le port 8080 pour les métriques.

Notez le nom d'hôte du serveur exécutant le conteneur. Vous utilisez ce nom d'hôte comme URL diagrams.net lorsque vous activez l'intégration.

Pour plus d'informations, voir exécuter votre propre serveur diagrams.net avec Docker.

Activer l'intégration Diagrams.net {#enable-diagramsnet-integration}

1. Connectez-vous à GitLab en tant qu'utilisateur Administrateur.
2. Dans le coin supérieur droit, sélectionnez Admin.
3. Dans la barre latérale gauche, sélectionnez Paramètres > Général.
4. Développez Diagrams.net.
5. Cochez la case Activer Diagrams.net.
6. Saisissez l'URL Diagrams.net. Pour vous connecter à :
   • L'instance publique gratuite : saisissez https://embed.diagrams.net.
   • Une instance diagrams.net hébergée localement : saisissez l'URL que vous avez configurée précédemment.
7. Sélectionnez Sauvegarder les modifications.