Gérer les extensions PostgreSQL

{{< details >}}

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

{{< /details >}}

GitLab nécessite des extensions PostgreSQL spécifiques dans chaque base de données. Pour la liste des extensions requises et les versions minimales de GitLab, consultez Exigences PostgreSQL.

Pour installer des extensions, PostgreSQL nécessite des privilèges de superutilisateur. L'utilisateur de la base de données GitLab n'est généralement pas un superutilisateur, vous devez donc installer les extensions manuellement avant de mettre à niveau GitLab.

Installer les extensions requises {#install-required-extensions}

1. Connectez-vous à la base de données PostgreSQL de GitLab en tant que superutilisateur, par exemple :

   shellCopy

   sudo gitlab-psql -d gitlabhq_production
   

2. Installez l'extension (btree_gist dans cet exemple) en utilisant CREATE EXTENSION :

   sqlCopy

   CREATE EXTENSION IF NOT EXISTS btree_gist
   

3. Vérifiez les extensions installées :

   shellCopy

   gitlabhq_production=# \dx
   

Sur certains systèmes, vous devrez peut-être installer un package supplémentaire (par exemple, postgresql-contrib) pour que certaines extensions soient disponibles.

Activer pg_stat_statements {#enable-pg_stat_statements}

pg_stat_statements est recommandé pour résoudre les problèmes de requêtes de base de données lentes. Son activation nécessite des privilèges de superutilisateur et un redémarrage de PostgreSQL.

1. Ajoutez pg_stat_statements à shared_preload_libraries dans postgresql.conf. Pour les installations avec le package Linux, ajoutez ce qui suit à /etc/gitlab/gitlab.rb :

   rubyCopy

   postgresql['shared_preload_libraries'] = 'pg_stat_statements'
   

2. Redémarrez PostgreSQL.

3. Créez l'extension en tant que superutilisateur :

   sqlCopy

   CREATE EXTENSION IF NOT EXISTS pg_stat_statements
   

Pour plus d'informations, consultez Activer les données statistiques de requêtes optionnelles.

Dépannage {#troubleshooting}

Lorsque vous travaillez avec des extensions PostgreSQL, vous pourriez rencontrer le problème suivant.

La migration échoue car une extension est manquante {#migration-fails-because-an-extension-is-missing}

Si une migration de base de données échoue parce qu'une extension est manquante, installez-la manuellement en tant que superutilisateur, puis relancez les migrations :

sudo gitlab-rake db:migrate