doc-locale/fr-fr/install/relative_url.md
{{< details >}}
{{< /details >}}
[!warning] La configuration d'une URL relative pour GitLab présente des problèmes connus avec Geo et des limitations de test. Si vous utilisez déjà une URL relative et souhaitez migrer vers un sous-domaine, consultez le guide de migration.
Bien qu'il soit recommandé d'installer GitLab sur son propre (sous-)domaine, cela n'est parfois pas possible pour diverses raisons. Dans ce cas, GitLab peut également être installé sous une URL relative, par exemple https://example.com/gitlab.
Ce document décrit comment exécuter GitLab sous une URL relative pour les installations depuis les sources. Consultez la documentation sur les URL relatives pour le package Linux ou pour le chart GitLab afin d'activer les URL relatives si vous n'effectuez pas d'installation depuis les sources.
Utilisez ce guide conjointement avec le guide d'installation si vous installez GitLab pour la première fois.
Il n'y a pas de limite à la profondeur d'imbrication de l'URL relative. Par exemple, vous pouvez servir GitLab sous /foo/bar/gitlab/git sans aucun problème.
La modification de l'URL d'une installation GitLab existante modifie toutes les URLs distantes. Vous devez donc les modifier manuellement dans tout dépôt local pointant vers votre instance GitLab.
La liste des fichiers de configuration que vous devez modifier pour servir GitLab depuis une URL relative est la suivante :
/home/git/gitlab/config/initializers/relative_url.rb/home/git/gitlab/config/gitlab.yml/home/git/gitlab/config/puma.rb/home/git/gitlab-shell/config.yml/etc/default/gitlabAprès toutes les modifications, vous devez recompiler les ressources et redémarrer GitLab.
Si vous configurez GitLab avec une URL relative, les ressources (notamment JavaScript, CSS, les polices et les images) doivent être recompilées, ce qui peut consommer beaucoup de ressources CPU et mémoire. Pour éviter les erreurs de mémoire insuffisante, vous devez disposer d'au moins 2 Go de RAM sur votre ordinateur. Idéalement, vous devriez disposer de 4 Go de RAM et de quatre ou huit cœurs CPU.
Consultez le document sur les prérequis pour plus d'informations.
[!note] N'apportez aucune modification à votre fichier de configuration de serveur web concernant l'URL relative. La prise en charge des URL relatives est implémentée par GitLab Workhorse.
Ce processus suppose que :
/gitlab/home/git/Pour activer les URL relatives dans GitLab :
Facultatif. Si vous manquez de ressources, vous pouvez libérer temporairement de la mémoire en arrêtant le service GitLab avec la commande suivante :
sudo service gitlab stop
Créez /home/git/gitlab/config/initializers/relative_url.rb
cp /home/git/gitlab/config/initializers/relative_url.rb.sample \
/home/git/gitlab/config/initializers/relative_url.rb
et modifiez la ligne suivante :
config.relative_url_root = "/gitlab"
Modifiez /home/git/gitlab/config/gitlab.yml et décommentez/modifiez la ligne suivante :
relative_url_root: /gitlab
Modifiez /home/git/gitlab/config/puma.rb et décommentez/modifiez la ligne suivante :
ENV['RAILS_RELATIVE_URL_ROOT'] = "/gitlab"
Modifiez /home/git/gitlab-shell/config.yml et ajoutez le chemin relatif à la ligne suivante :
gitlab_url: http://127.0.0.1/gitlab
Assurez-vous d'avoir copié les services systemd fournis, ou bien le script d'initialisation et le fichier de valeurs par défaut, comme indiqué dans le guide d'installation. Ensuite, modifiez /etc/default/gitlab et définissez dans gitlab_workhorse_options le paramètre -authBackend comme suit :
-authBackend http://127.0.0.1:8080/gitlab
[!note] Si vous utilisez un script d'initialisation personnalisé, assurez-vous de modifier le paramètre GitLab Workhorse précédent selon vos besoins.
Redémarrez GitLab pour que les modifications prennent effet.
Pour désactiver l'URL relative :
/home/git/gitlab/config/initializers/relative_url.rb