Git
Français ▾ Topics ▾ Latest version ▾ git-init last updated in 2.47.0

NOM

git-init - Crée un dépôt Git vide ou réinitialise un dépôt existant

SYNOPSIS

git init [-q | --quiet] [--bare] [--template=<répertoire-modèle>]
	  [--separate-git-dir <répertoire-git>] [--object-format=<format>]
	  [--ref-format=<format>]
	  [-b <nom-de-branche> | --initial-branch=<nom-de-branche>]
	  [--shared[=++<permissions>]] [<répertoire>]

DESCRIPTION

Cette commande crée un dépôt Git vide - essentiellement un répertoire .git avec des sous-répertoires pour les fichiers objects, refs/heads, refs/tags et les fichiers de modèle. Une branche initiale sans aucun commit sera créée (voir loption --initial-branch ci-dessous pour son nom).

Si la variable d’environnement $GIT_DIR est définie, alors elle spécifie un chemin à utiliser au lieu de ./.git comme base du dépôt.

Si le répertoire de stockage d’objets est spécifié via la variable d’environnement $GIT_OBJECT_DIRECTORY, alors les répertoires sha1 sont créés dedans ; sinon le répertoire par défaut $GIT_DIR/objects est utilisé.

Exécuter git init dans un dépôt existant est sécurisé. Cela n’écrasera pas des choses qui sont déjà dedans. La raison principale de ré-exécuter git init est de récupérer les modèles récemment ajoutés (ou de déplacer le dépôt ailleurs si --separate-git-dir est fourni).

OPTIONS

-q
--quiet

N’afficher que les messages d’erreur et d’alerte ; toutes les autres sorties seront supprimées.

--bare

Créer un dépôt nu. Si l’environnement GIT_DIR n’est pas défini, alors il est défini au répertoire de travail courant.

--object-format=<format>

Spécifier le <format> d’objet donné (algorithme d’empreinte) pour le dépôt. Les valeurs valides sont sha1 et (si activé) sha256. sha1 est la valeur par défaut.

Note : À l’heure actuelle, il n’y a pas d’interopérabilité entre les dépôts SHA-256 et les dépôts SHA-1.

Historiquement, nous avons averti que les dépôts SHA-256 pourraient plus tard avoir besoin de changements incompatibles avec les versions précédentes lorsque nous introduirons ces caractéristiques d’interopérabilité. Aujourd’hui, nous nous attendons seulement à des changements compatibles. De plus, si de tels changements s’avèrent nécessaires, on peut s’attendre à ce que les dépôts SHA-256 créés avec le Git d’aujourd’hui soient utilisables par les versions futures de Git sans perte de données.

--ref-format=<format>

Spécifier le <format> de stockage de réf donné pour le dépôt. Les valeurs valides sont :

  • files pour des fichiers perdus avec des refs emballés. Valeur par défaut.

  • reftable pour le format reftable. Ce format est expérimental et son fonctionnement interne est sujet à changement.

--template=<répertoire-de-modèles>

Spécifier le dossier depuis lequel les modèles seront utilisés (Voyez la section « DOSSIER MODÈLE » ci-dessous.)

--separate-git-dir=<répertoire-git>

Au lieu d’initialiser le dépôt en tant que répertoire dans soit $GIT_DIR soit ./.git, y créer un fichier texte contenant le chemin du dépôt réel. Ce fichier agit comme un lien symbolique Git indépendant du système de fichier vers le dépôt.

Si c’est une réinitialisation, le dépôt sera déplacé vers le chemin spécifié.

-b <nom-de-branche>
--initial-branch=<nom-de-branche>

Utiliser <nom-de-branche> pour la branche initiale dans le dépôt nouvellement créé. S’il n’est pas spécifié, revenir au nom par défaut (actuellement master, mais ceci est susceptible de changer à l’avenir ; le nom peut être personnalisé via la variable de configuration init.defaultBranch).

--shared[=(false|true|umask|group|all|world|everybody|<perm>)]

Spécifier que le dépôt Git doit être partagé entre plusieurs utilisateurs. Ceci permet à des utilisateurs faisant partie du même groupe de pousser dans ce dépôt. Lorsque que cette option est spécifiée, la variable de configuration core.sharedRepository est définie de telle sorte que les fichiers et les dossiers sous $GIT_DIR sont créés avec les permissions demandées. Lorsqu’elle n’est pas spécifiée, Git utilisera les permissions rapportées par umask(2).

L’option peut avoir les valeurs suivantes, prenant par défaut la valeur group si aucune valeur n’est renseignée :

umask
false

Utiliser les permissions rapportées par umask(2). Valeur par défaut, quand --shared n’est pas spécifié.

group
true

Rendre le dépôt modifiable par groupe (et g+sx, puisque le groupe git peut ne pas être le groupe principal de tous les utilisateurs). Ceci est utilisé pour assouplir les permissions d’une valeur umask(2) par ailleurs sûre. Notez que umask s’applique toujours aux autres bits d’autorisation (par exemple, si umask est défini sur 0022, l’utilisation de group ne supprime pas les privilèges de lecture des autres utilisateurs (non membres du groupe)). Voir 0xxx pour savoir comment spécifier exactement les autorisations du dépôt.

all
world
everybody

Comme group, mais rendre le dépôt lisible par tous les utilisateurs.

<perm>

<perm> ; est un nombre octal à 3 chiffres préfixé par 0 et chaque fichier aura le mode <perm>. <perm> surchargera la valeur umask(2) des utilisateurs (en plus d’assouplir les permissions comme group et all le font). 0640 créera un dépôt qui est lisible par groupe, mais pas modifiable par groupe ni accessible aux autres. 0660 créera un dépôt lisible et modifiable par l’utilisateur et le groupe courants, mais inaccessible aux autres (les répertoires et les fichiers exécutables obtiennent leur bit x du bit r pour les classes d’utilisateurs correspondantes).

Par défaut, l’option de configuration receive.denyNonFastForwards est activée dans les dépôts partagés, de telle sorte que vous ne pouvez pas forcer une poussée qui ne serait pas en avance rapide.

Si vous renseignez un <dossier>, la commande est exécutée à l’intérieur de celui-ci. Si ce dossier n’existe pas, il sera créé.

DOSSIER MODÈLE

Les fichiers et les dossiers dans le dossier modèle dont le nom ne commence pas par un point seront copiés dans le $GIT_DIR après qu’il sera créé.

Le dossier modèle sera l’un des suivants (dans l’ordre) :

  • l’argument fourni avec l’option --template ;

  • le contenu de la variable d’environnement $GIT_TEMPLATE_DIR ;

  • la variable de configuration init.templateDir ; ou

  • le dossier modèle par défaut : /usr/share/git-core/templates.

Le dossier modèle par défaut inclut une certaine structure de dossier, des "modèles d’exclusions" suggérés (voir gitignore[5]), et des exemples de fichiers crochet.

Les exemples de crochets sont tous désactivés par défaut. Pour activer l’un des exemples de crochets, renommez-le en enlevant le suffixe .sample.

Voir githooks[5] pour des informations plus générales sur l’exécution d’un crochet.

EXEMPLES

Démarrer un nouveau dépôt Git pour une base de code existante 
$ cd /chemin/vers/mon/code/de/base
$ git init      (1)
$ git add .     (2)
$ git commit    (3)

  1. Créer un dossier /chemin/vers/mon/code/de/base/.git.

  2. Ajouter tous les fichiers existants à l’index.

  3. Enregistrer l’état d’origine comme le premier commit dans l’historique.

CONFIGURATION

Warning

Missing fr/includes/cmd-config-section-all.txt

See original version for this content.
Warning

Missing fr/config/init.txt

See original version for this content.

GIT

Fait partie de la suite git[1]

TRADUCTION

Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site https://github.com/jnavila/git-manpages-l10n .

scroll-to-top