en to fr translation catalogue (45 entries)

note: type: Content of: <sect1><title>
en: Running a Git Server
fr: Lancer un serveur Git

note: type: Content of: <sect1><sect2><para>
en: This section will describe how to set up, administer and secure a <application>git</application> server. <application>Git</application> has many options available. For more detailed documentation see <ulink url="https://git-scm.com/book/en/v2"/>.
fr: Cette section décrit comment mettre en place, administrer et sécuriser un serveur <application>git</application>. <application>Git</application> a de nombreuses options disponibles. Pour la documentation détaillée voir <ulink url="https://git-scm.com/book/en/v2"/>.

note: type: Content of: <sect1><sect2><bridgehead>
en: Server Dependencies
fr: Dépendances de Server

note: type: Content of: <sect1><sect2><bridgehead>
en: Required
fr: Requises

note: type: Content of: <sect1><sect2><para>
en: <xref linkend="git"/> and <xref linkend="openssh"/>
fr: <xref linkend="git"/> et <xref linkend="openssh"/>

note: type: Content of: <sect1><sect2><title>
en: Setting up a Git Server
fr: Paramétrer un serveur Git

note: type: Content of: <sect1><sect2><para>
en: The following instructions will install a <application>git</application> server. It will be set up to use <application>OpenSSH</application> as the secure remote access method.
fr: Les instructions suivantes installeront un serveur <application>git</application>. Il sera paramétré pour utiliser <application>OpenSSH</application> comme méthode d'accès à distance sécurisée.

note: type: Content of: <sect1><sect2><para>
en: Configuration of the server consists of the following steps:
fr: La configuration du serveur comporte les étapes suivantes&nbsp;:

note: type: Content of: <sect1><sect2><sect3><title>
en: 1. Set Up Users, Groups, and Permissions
fr: 1. Mise en place des utilisateurs, des groupes et des permissions

note: type: Content of: <sect1><sect2><sect3><para>
en: You will need to be user <systemitem class='username'>root</systemitem> for the initial portion of configuration. Create the <systemitem class="username">git</systemitem> user and group and set and unusable password hash with the following commands:
fr: Vous devrez être utilisateur <systemitem class='username'>root</systemitem> pour la première partie de la configuration. Créez l'utilisateur et le groupe <systemitem class="username">git</systemitem> et indiquez un hash de mot de passe inutilisable avec les commandes suivantes&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: Putting in an unusable password hash (replacing the <literal>!</literal> by <literal>NP</literal>) unlocks the account but it cannot be used to login via password authentication. That is required by <application>sshd</application> to work properly.  Next, create some files and directories in the home directory of the git user allowing access to the git repository using ssh keys.
fr: Enregistrer un hash de mot de passe inutilisable (en remplaçant le <literal>!</literal> par <literal>NP</literal>) déverrouille le compte mais empêche de l'utiliser avec un mot de passe. Cela est requis par <application>sshd</application> pour fonctionner correctement. Ensuite, créez certains fichiers et répertoires dans le répertoire personnel de l'utilisateur git qui permettent de donner accès aux dépôts git avec des clés ssh.

note: type: Content of: <sect1><sect2><sect3><para>
en: For any developer who should have access to the repository add his/her public ssh key to <filename>/home/git/.ssh/authorized_keys</filename>.  First, prepend some options to prevent users from using the connection to git for port forwarding to other machines the git server might reach.
fr: Pour les développeurs qui doivent accéder au dépôt, ajoutez sa clé publique ssh à <filename>/home/git/.ssh/authorized_keys</filename>. Commencez par ajouter certaines options pour éviter que les utilisateurs ne puissent utiliser la connexion à git pour rediriger des ports vers d'autres machines que le serveur git peut atteindre.

note: type: Content of: <sect1><sect2><sect3><para>
en: It is also useful to set the default name of the initial branch of new repositories by modifying the git configuration. As the <systemitem class='username'>root</systemitem> user, run:
fr: C'est aussi utile d'indiquer le nom par défaut de la branche initiale d'un nouveau dépôt en modifiant la configuration git. En tant qu'utilisateur <systemitem class='username'>root</systemitem>, lancez&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: Finally add the <filename>/usr/bin/git-shell</filename> entry to the <filename>/etc/shells</filename> configuration file. This shell has been set in the <systemitem class='username'>git</systemitem> user profile and is to make sure that only git related actions can be executed:
fr: Enfin, ajoutez l'entrée <filename>/usr/bin/git-shell</filename> au fichier de configuration <filename>/etc/shells</filename>. Ce shell a été indiqué dans le profil utilisateur de <systemitem class='username'>git</systemitem> et s'assure que seules les actions liées à git peuvent être exécutées&nbsp;:

note: type: Content of: <sect1><sect2><sect3><title>
en: 2. Create a git repository
fr: 2. Créer un dépôt git

note: type: Content of: <sect1><sect2><sect3><para>
en: The repository can be anywhere on the filesystem. It is important that the git user has read/write access to that location. We use <filename class="directory">/srv/git</filename> as base directory. Create a new <application>git</application> repository with the following commands (as the <systemitem class="username">root</systemitem> user):
fr: Le dépôt peut être n'importe où sur le système de fichiers. Il est important que l'utilisateur git puisse lire et écrire à cet emplacement. Nous utilisons <filename class="directory">/srv/git</filename> comme répertoire de base. Créez un nouveau dépôt <application>git</application> avec les commandes suivante (en tant qu'utilisateur <systemitem class="username">root</systemitem>)&nbsp;:

note: type: Content of: <sect1><sect2><sect3><note><para>
en: In all the instructions below, we use <emphasis>project1</emphasis> as an example repository name.  You should name your repository as a short descriptive name for your specific project.
fr: Dans les instructions ci-dessous, nous utilisons <emphasis>project1</emphasis> comme nom de dépôt. Vous devriez nommer votre dépôt en fonction des détails de votre projet.

note: type: Content of: <sect1><sect2><sect3><title>
en: 3. Populate the repository from a client system
fr: 3. Remplissez le dépôt à partir du système client

note: type: Content of: <sect1><sect2><sect3><note><para>
en: All the instructions in this section and the next should be done on a user system, not the server system.
fr: Toutes les instructions de cette section et de la suivante devraient être lancées sur un système utilisateur, pas sur le système serveur.

note: type: Content of: <sect1><sect2><sect3><para>
en: Now that the repository is created, it can be used by the developers to put some files into it. Once the ssh key of the user is imported to git's <filename>authorized_keys</filename> file, the user can interact with the repository.
fr: Maintenant que le dépôt est créé, il peut être utilisé par les développeurs pour y mettre des fichiers. Une fois les clés ssh des utilisateurs importées dans le fichier <filename>authorized_keys</filename> de git, on peut interagir avec le dépôt.

note: type: Content of: <sect1><sect2><sect3><para>
en: A minimal configuration should be available on the developer's system specifying its user name and the email address.  Create this minimal config file on client side:
fr: Une configuration minimale devrait être disponible sur le système du développeur pour spécifier son nom d'utilisateur et l'adresse de courriel. Créez ce fichier de configuration minimal côté client&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: On the developer's machine, set up some files to be pushed to the repository as the initial content:
fr: Sur la machine du développeur, configurez certains fichiers à pousser vers le dépôt comme contenu initial&nbsp;:

note: type: Content of: <sect1><sect2><sect3><note><para>
en: The <emphasis>gitserver</emphasis> term used below should be the host name (or ip address) of the git server.
fr: Le terme <emphasis>gitserver</emphasis> utilisé ci-dessous devrait être le nom d'hôte (ou l'adresse IP) du serveur git.

note: type: Content of: <sect1><sect2><sect3><para>
en: The initial content is now pushed to the server and is available for other users. On the current machine, the argument <literal>--set-upstream origin trunk</literal> is now no longer required as the local repository is now connected to the remote repository. Subsequent pushes can be performed as
fr: Le contenu initial est maintenant poussé sur le serveur et est disponible pour les autres utilisateurs. Sur la machine actuelle, l'argument <literal>--set-upstream origin trunk</literal> n'est maintenant plus requis car le dépôt local est maintenant connecté au dépôt distant. Les poussages suivants peuvent se faire avec

note: type: Content of: <sect1><sect2><sect3><para>
en: Other developers can now clone the repository and do modifications to the content (as long as their ssh keys has been installed):
fr: Les autres développeurs peuvent maintenant cloner le dépôt et faire des modifications sur le contenu (tant que leurs clés ssh ont été installées)&nbsp;:

note: type: Content of: <sect1><sect2><sect3><note><para>
en: This is a very basic server setup based on <application>OpenSSH</application> access. All developers are using the <systemitem class="username">git</systemitem> user to perform actions on the repository and the changes users are committing can be distinguished as the local user name (see <filename>~/.gitconfig</filename>) is recorded in the changesets.
fr: C'est une configuration du serveur très basique basée sur l'accès <application>OpenSSH</application>. Tous les développeurs utilisent l'utilisateur <systemitem class="username">git</systemitem> pour effectuer les actions sur le dépôt et les changements commités par les utilisateurs se distinguent par le nom d'utilisateur local (voir <filename>~/.gitconfig</filename>) enregistré dans les changements.

note: type: Content of: <sect1><sect2><sect3><para>
en: Access is restricted by the public keys added to git's <filename>authorized_keys</filename> file and there is no option for the public to export/clone the repository. To enable this, continue with step 4 to set up the git server for public read-only access.
fr: L'accès est restreint aux clés publique ajoutées dans le fichier <filename>authorized_keys</filename> de git et il n'y a pas de possibilité pour l'export / clonage public du dépôt. Pour cela, continuez à l'étape 4 pour configurer le serveur git pour l'accès public en lecture seule.

note: type: Content of: <sect1><sect2><sect3><para>
en: In the URL used to clone the project, the absolute path (here <filename>/srv/git/project1.git</filename>) has to be specified as the repository is not in git's home directory but in <filename class="directory">/srv/git</filename>. To get rid of the need to expose the structure of the server installation, a symlink can be added in git's home directory for each project like this:
fr: Dans l'URL utilisée pour cloner le projet, le chemin absolu (ici <filename>/srv/git/project1.git</filename>) a été spécifié car le dépôt n'est pas dans le répertoire personnel de git mais dans <filename class="directory">/srv/git</filename>. Pour ne pas avoir à exposer la structure de l'installation du serveur, vous pouvez ajouter un lien symbolique dans le répertoire personnel de git pour chaque projet, comme ceci&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: Now, the repository can be cloned using
fr: Maintenant, le dépôt peut être cloné avec

note: type: Content of: <sect1><sect2><sect3><title>
en: 4. Configure the Server
fr: 4. Configurer le serveur

note: type: Content of: <sect1><sect2><sect3><para>
en: The setup described above makes a repository available for authenticated users (via providing the ssh public key file).  There is also a simple way to publish the repository to unauthenticated users &mdash; of course without write access.
fr: La configuration décrite plus haut rend le dépôt disponible pour les utilisateurs authentifiés (en fournissant la clé ssh publique). Il y a aussi un moyen simple de publier le dépôt pour des utilisateurs non authentifiés &mdash; évidemment sans l'accès en écriture.

note: type: Content of: <sect1><sect2><sect3><para>
en: The combination of access via ssh (for authenticated users) and the export of repositories to unauthenticated users via the daemon is in most cases enough for a development site.
fr: La combinaison de l'accès via ssh (pour les utilisateurs authentifiés) et l'export des dépôt pour les utilisateurs non authentifiés via le démon est en général suffisant pour un site de développement.

note: type: Content of: <sect1><sect2><sect3><note><para>
en: The daemon will be reachable at port <literal>9418</literal> by default. Make sure that your firewall setup allows access to that port.
fr: Le démon sera atteignable sur le port <literal>9418</literal> par défaut. Assurez-vous que votre pare-feu permet l'accès à ce port.

note: type: Content of: <sect1><sect2><sect3><para>
en: To start the server at boot time, install the git-daemon bootscript included in the <xref linkend="bootscripts"/> package:
fr: Pour démarrer le serveur au démarrage, installez le script de démarrage inclus dans le paquet <xref linkend="bootscripts"/>&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: To start the server at boot time, install the <filename>git-daemon.service</filename> unit from the <xref linkend="systemd-units"/> package:
fr: Pour démarrer le serveur au démarrage, installez l'unité <filename>git-daemon.service</filename> du paquet <xref linkend="systemd-units"/>&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para>
en: In order to allow <application>git</application> to export a repository, a file named <filename>git-daemon-export-ok</filename> is required in each repository directory on the server. The file needs no content, just its existence enables, its absence disables the export of that repository.
fr: Pour permettre à <application>git</application> d'exporter un dépôt, un fichier nommé <filename>git-daemon-export-ok</filename> est requis dans chaque répertoire de dépôt sur le serveur. Le fichier n'a pas besoin de contenu, son existence suffit à activer et son absence à désactiver l'export du dépôt.

note: type: Content of: <sect1><sect2><sect3><para>
en: The script to start the git daemon uses some default values internally. Most important is the path to the repository directory which is set to <filename class="directory">/srv/git</filename>.  In case you have for whatever reason created the repository in a different location, you'll need to tell the boot script where the repository is to be found. This can be achieved by creating a configuration file named <filename>/etc/sysconfig/git-daemon</filename>.  This configuration file will be imported if it exists, meaning it is optional. The file can look like:
fr: Le script pour démarrer le démon git utiliser des valeurs par défaut en interne. Le plus important est le chemin vers le dépôt qui est mis à <filename class="directory">/srv/git</filename>. Dans le cas où vous avez créé le dépôt dans un autre répertoire, vous devrez le dire au script de démarrage. Cela se fait en créant un fichier de configuration nommé <filename>/etc/sysconfig/git-daemon</filename>. Ce fichier de configuration sera importé s'il existe, ce qui veut dire qu'il est facultatif. Le fichier peut ressembler à&nbsp;:

note: type: Content of: <sect1><sect2><sect3><screen>
en: # Begin /etc/sysconfig/git-daemon
    
    # Specify the location of the git repository
    GIT_BASE_DIR="/srv/git/"
    
    # Directories added to whitelist
    DFT_REPO_DIR="$GIT_BASE_DIR"
    
    # Add extra options which will appended to the 'git daemon'
    # command executed in the boot script
    GIT_DAEMON_OPTS=""
    
    # End /etc/sysconfig/git-daemon
fr: # Début de /etc/sysconfig/git-daemon
    
    # Spécifie l'emplacement du dépôt git
    GIT_BASE_DIR="/srv/git/"
    
    # Répertoires ajoutés à la liste blanche
    DFT_REPO_DIR="$GIT_BASE_DIR"
    
    # Ajoute des options supplémentaires qui seront ajoutées à la commande
    # 'git daemon' exécutée dans le script de démarrage
    GIT_DAEMON_OPTS=""
    
    # Fin de /etc/sysconfig/git-daemon

note: type: Content of: <sect1><sect2><sect3><para>
en: Along with the <filename>git-daemon.service</filename> unit, a configuration file named <filename>/etc/default/git-daemon</filename> has been installed. Review this configuration file to match your needs.
fr: En plus de l'unité <filename>git-daemon.service</filename>, un fichier de configuration nommé <filename>/etc/default/git-daemon</filename> a été installé. Voyez ce fichier de configuration et faite-le correspondre à vos besoins.

note: type: Content of: <sect1><sect2><sect3><para>
en: There are only three options to set in the configuration file:
fr: Il n'y a que trois options à indiquer dans le fichier de configuration&nbsp;:

note: type: Content of: <sect1><sect2><sect3><para><itemizedlist><listitem><para>
en: Specify the location of the git repositories.  Relative paths used when accessing the daemon will translated relative to this directory.
fr: Spécifiez l'emplacement des dépôts git. Les chemins relatifs utilisés pour accéder au démon seront traduits par rapport à ce répertoire.

note: type: Content of: <sect1><sect2><sect3><para><itemizedlist><listitem><para>
en: This directory is added to the white list of allowed directories. This variable can hold multiple directory names but is usually set equal to <literal>GIT_BASE_DIR</literal>.
fr: Ce répertoire est ajouté à la liste blanche des répertoires autorisés. Cette variable peut contenir plusieurs noms de répertoires mais elle est habituellement égale à <literal>GIT_BASE_DIR</literal>.

note: type: Content of: <sect1><sect2><sect3><para><itemizedlist><listitem><para>
en: In case special options to the <command>git daemon</command> command are needed, they have to be specified in this setting.  One example might be to adjust the port number where daemon is listening. In this case, add <literal>--port=&lt;port number&gt;</literal> to this variable.  For more information about which options can be set, take a look at the output of <command>git daemon --help</command>.
fr: Au cas où vous ayez besoin d'options spéciales pour la commande <command>git daemon</command>, vous pouvez les spécifier dans ce paramètre. Un exemple peut être pour ajuster le numéro de port sur lequel le démon écoute. Dans ce cas, ajoutez <literal>--port=&lt;port number&gt;</literal> à cette variable. Pour plus d'information sur les options à indiquer, voyez la sortie de <command>git daemon --help</command>.

note: type: Content of: <sect1><sect2><sect3><para>
en: After starting the daemon, unauthenticated users can clone exported repositories by using
fr: Après avoir démarré le démon, les utilisateurs non authentifiés peuvent cloner les dépôts exportés en utilisant

note: type: Content of: <sect1><sect2><sect3><para>
en: As the base directory is <filename class="directory">/srv/git</filename> by default (or set to a custom value in the configuration), <application>git</application> interprets the incoming path (/project1.git) relative to that base directory so that the repository in <filename class="directory">/srv/git/project1.git</filename> is served.
fr: Comme le répertoire de bsae est <filename class="directory">/srv/git</filename> par défaut (ou une valeur personnalisée dans la configuration), <application>git</application> interprète les chemins (/project1.git) relativement au répertoire de base, si bien que c'est le dépôt dans <filename class="directory">/srv/git/project1.git</filename> qui est servi.
