Dépôt de modèles d'instance

{{< details >}}

• Niveau : Premium, Ultimate
• Offre : GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Dans les systèmes hébergés, les entreprises ont souvent besoin de partager leurs propres modèles entre les équipes. Cette fonctionnalité permet à un administrateur de choisir un projet comme collection de modèles de fichiers à l'échelle de l'instance. Ces modèles sont ensuite exposés à tous les utilisateurs via l'éditeur Web, tandis que le projet reste sécurisé.

Configuration {#configuration}

Pour sélectionner un projet à utiliser comme dépôt de modèles personnalisés :

1. Dans le coin supérieur droit, sélectionnez Admin.
2. Dans la barre latérale gauche, sélectionnez Paramètres > Modèles.
3. Développez Modèles
4. Dans la liste déroulante, sélectionnez le projet à utiliser comme dépôt de modèles.
5. Sélectionnez Sauvegarder les modifications.
6. Ajoutez des modèles personnalisés au dépôt sélectionné.

Après avoir ajouté des modèles, vous pouvez les utiliser pour l'ensemble de l'instance. Ils sont disponibles dans l'éditeur Web et via les paramètres de l'API.

Ces modèles ne peuvent pas être utilisés comme valeur de la clé include:template dans .gitlab-ci.yml.

Types de fichiers et emplacements pris en charge {#supported-file-types-and-locations}

GitLab prend en charge les fichiers Markdown pour les modèles de tickets et de merge request, ainsi que d'autres modèles de types de fichiers.

Les modèles de description Markdown suivants sont pris en charge :

Pour plus d'informations, consultez les modèles de description.

Les autres modèles de types de fichiers pris en charge sont les suivants :

Chaque modèle doit se trouver dans son sous-répertoire respectif, avoir la bonne extension et ne pas être vide. La hiérarchie doit ressembler à ceci :

|-- README.md
    |-- issue_templates
        |-- feature_request.md
    |-- merge_request_templates
        |-- default.md
|-- Dockerfile
    |-- custom_dockerfile.dockerfile
    |-- another_dockerfile.dockerfile
|-- gitignore
    |-- custom_gitignore.gitignore
    |-- another_gitignore.gitignore
|-- gitlab-ci
    |-- custom_gitlab-ci.yml
    |-- another_gitlab-ci.yml
|-- LICENSE
    |-- custom_license.txt
    |-- another_license.txt

Vos modèles personnalisés sont affichés dans la liste déroulante lorsqu'un nouveau fichier est ajouté via l'interface utilisateur GitLab :

Si cette fonctionnalité est désactivée ou qu'aucun modèle n'est présent, aucune section Personnalisé ne s'affiche dans la liste déroulante de sélection.