ContextQMD
Back to Gitlabhq

Modèles de projets pour votre instance

doc-locale/fr-fr/administration/project_templates.md

19.3.06.4 KB
Original Source

{{< details >}}

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

{{< /details >}}

Les modèles de projets remplissent les nouveaux projets avec des fichiers et une configuration. Sur votre instance, vous pouvez configurer des modèles de projets personnalisés à partir d'un groupe que vous gérez, et contrôler si les modèles de projets intégrés sont disponibles pour les utilisateurs.

Modèles de projets personnalisés {#custom-project-templates}

Pour accélérer la création de projets sur votre instance, configurez un groupe contenant des projets modèles. Les utilisateurs peuvent alors créer de nouveaux projets basés sur vos modèles qui incluent les outils et la configuration communs que vous spécifiez.

Pour en savoir plus sur les données copiées depuis les projets modèles, consultez ce qui est copié depuis les modèles.

Avant de rendre les projets modèles disponibles sur votre instance, sélectionnez un groupe pour gérer les modèles. Pour éviter toute modification inattendue des modèles, créez un nouveau groupe à cet effet plutôt que de réutiliser un groupe existant. Si vous réutilisez un groupe existant créé à des fins différentes, les utilisateurs disposant du rôle Maintainer pourraient modifier les projets modèles sans en comprendre les effets secondaires.

Sélectionner un groupe pour gérer les projets modèles {#select-a-group-to-manage-template-projects}

Prérequis :

  • Disposer d'un accès administrateur.

Pour sélectionner le groupe chargé de gérer les modèles de projets pour votre instance :

  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 de projets personnalisés.
  4. Sélectionnez un groupe à utiliser.
  5. Sélectionnez Enregistrer les modifications.

Une fois le groupe configuré comme source de modèles de projets, les nouveaux projets ajoutés à ce groupe deviennent disponibles en tant que modèles.

Configurer un projet pour l'utiliser comme modèle {#configure-a-project-for-use-as-a-template}

Une fois le groupe créé pour gérer les projets modèles, configurez la visibilité et la disponibilité des fonctionnalités de chaque projet modèle.

Prérequis :

  • Vous devez être soit l'administrateur de l'instance, soit un utilisateur disposant d'un rôle vous permettant de configurer le projet.
  1. Assurez-vous que le projet appartient directement au groupe, et non via un sous-groupe. Les projets issus des sous-groupes du groupe sélectionné ne peuvent pas être utilisés comme modèles.
  2. Pour configurer les utilisateurs pouvant sélectionner le modèle de projet, définissez la visibilité du projet :
    • Les projets Public et Interne peuvent être sélectionnés par tout utilisateur authentifié.
    • Les projets Privé ne peuvent être sélectionnés que par les membres de ce projet.
  3. Vérifiez les paramètres des fonctionnalités du projet. Toutes les fonctionnalités du projet activées doivent être définies sur Toute personne ayant accès, à l'exception de GitLab Pages et de Sécurité et conformité.

Les informations du dépôt et de la base de données copiées dans chaque nouveau projet sont identiques aux données exportées via la fonctionnalité d'import/export de projets GitLab. Cela inclut l'historique complet des commits Git du projet modèle. Pour plus d'informations, consultez migrer les données GitLab à l'aide d'exports de fichiers.

Pour créer un modèle sans historique de commits, initialisez votre projet modèle avec un seul commit contenant tous les fichiers que vous souhaitez inclure.

Modèles de projets intégrés {#built-in-project-templates}

{{< history >}}

{{< /history >}}

Les modèles de projets intégrés remplissent les nouveaux projets avec des fichiers de démarrage. Par défaut, ces modèles sont disponibles pour tous les utilisateurs. En tant qu'administrateur, vous pouvez désactiver ce paramètre pour l'instance et, si vous le souhaitez, l'imposer afin que les Owners de groupes ne puissent pas le remplacer. Les Owners de groupes peuvent également contrôler ce paramètre pour leurs groupes.

Le paramètre utilise l'héritage en cascade :

  • Par défaut, les groupes racines héritent de la valeur de l'instance.
  • Les sous-groupes héritent de la valeur de leur groupe ancêtre le plus proche.
  • Une valeur spécifique à un groupe remplace la valeur héritée.
  • Lorsque vous imposez le paramètre pour l'instance, tous les groupes en héritent.
  • Lorsque vous imposez le paramètre pour un groupe, tous les sous-groupes en héritent.
  • Lorsque vous modifiez le paramètre de l'instance, la nouvelle valeur se propage à tous les groupes.
  • Lorsque vous modifiez le paramètre d'un groupe, la nouvelle valeur se propage à tous les sous-groupes.

Configurer les modèles de projets intégrés {#configure-built-in-project-templates}

Prérequis :

  • Être administrateur.

Pour contrôler les modèles de projets intégrés pour l'instance :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Sélectionnez Paramètres > Modèles.
  3. Développez Modèles de projets intégrés.
  4. Cochez ou décochez la case Activer les modèles de projets intégrés.
  5. Facultatif. Pour empêcher les groupes de modifier ce paramètre, cochez la case Imposer à tous les groupes.
  6. Sélectionnez Enregistrer les modifications.

Sujets connexes {#related-topics}