ContextQMD
Back to Gitlabhq

Administration de l'application GitLab pour Slack

doc-locale/fr-fr/administration/settings/slack_app.md

19.3.09.0 KB
Original Source

{{< details >}}

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

{{< /details >}}

{{< history >}}

  • Introduite pour GitLab Self-Managed dans GitLab 16.2.

{{< /history >}}

[!note] Cette page contient la documentation administrateur pour l'application GitLab pour Slack. Pour la documentation utilisateur, voir Application GitLab pour Slack.

L'application GitLab pour Slack distribuée via le répertoire d'applications Slack fonctionne uniquement avec GitLab.com. Sur GitLab Self-Managed, vous pouvez créer votre propre copie de l'application GitLab pour Slack à partir d'un fichier manifeste et configurer votre instance.

L'application est une copie privée à usage unique installée uniquement dans votre workspace Slack et non distribuée via le répertoire d'applications Slack. Pour disposer de l'application GitLab pour Slack sur votre instance GitLab Self-Managed, vous devez activer l'intégration.

Créer une application GitLab pour Slack {#create-a-gitlab-for-slack-app}

Prérequis :

Pour créer une application GitLab pour Slack :

  • Dans GitLab :

    1. Dans le coin supérieur droit, sélectionnez Admin.
    2. Dans la barre latérale gauche, sélectionnez Paramètres > Général.
    3. Développez Application GitLab pour Slack.
    4. Sélectionnez Créer une application Slack.

Vous êtes ensuite redirigé vers Slack pour les étapes suivantes.

  • In Slack :

    1. Sélectionnez le workspace Slack dans lequel créer l'application, puis sélectionnez Suivant.
    2. Slack affiche un résumé de l'application pour révision. Pour afficher le manifeste complet, sélectionnez Edit Configurations. Pour revenir au résumé de révision, sélectionnez Suivant.
    3. Sélectionnez Créer.
    4. Sélectionnez Compris pour fermer la boîte de dialogue.
    5. Sélectionnez Install to Workspace.

Configurer les paramètres {#configure-the-settings}

Après avoir créé une application GitLab pour Slack, vous pouvez configurer les paramètres dans GitLab :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Général.
  3. Développez Application GitLab pour Slack.
  4. Cochez la case Activer GitLab pour l'application Slack.
  5. Saisissez les détails de votre application GitLab pour Slack :
    1. Accédez à Slack API.
    2. Recherchez et sélectionnez GitLab (<your host name>).
    3. Faites défiler jusqu'à App Credentials.
  6. Sélectionnez Sauvegarder les modifications.

Installer l'application GitLab pour Slack {#install-the-gitlab-for-slack-app}

{{< history >}}

{{< /history >}}

Prérequis :

Pour installer l'application GitLab pour Slack à partir des paramètres de l'instance :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Intégrations.
  3. Sélectionnez Application GitLab pour Slack.
  4. Sélectionnez Installer l'application GitLab pour Slack..
  5. Sur la page de confirmation Slack, sélectionnez Autoriser.

Tester votre configuration {#test-your-configuration}

Pour tester la configuration de votre application GitLab pour Slack :

  1. Saisissez la commande slash /gitlab help dans un canal de votre workspace Slack.
  2. Appuyez sur <kbd>Entrée</kbd>.

Vous devriez voir une liste des commandes slash disponibles.

Pour utiliser des commandes slash pour un projet, configurez l'application GitLab pour Slack pour le projet.

Mettre à jour l'application GitLab pour Slack {#update-the-gitlab-for-slack-app}

Prérequis :

Lorsque GitLab publie de nouvelles fonctionnalités pour l'application GitLab pour Slack, vous devrez peut-être mettre à jour manuellement votre copie pour utiliser les nouvelles fonctionnalités.

Pour mettre à jour votre copie de l'application GitLab pour Slack :

  • Dans GitLab :
    1. Dans le coin supérieur droit, sélectionnez Admin.
    2. Dans la barre latérale gauche, sélectionnez Paramètres > Général.
    3. Développez Application GitLab pour Slack.
    4. Sélectionnez Télécharger le dernier fichier manifeste pour télécharger slack_manifest.json.
  • In Slack :
    1. Accédez à Slack API.
    2. Recherchez et sélectionnez GitLab (<your host name>).
    3. Dans la barre latérale gauche, sélectionnez App Manifest.
    4. Sélectionnez l'onglet JSON pour passer à une vue JSON du manifeste.
    5. Copiez le contenu du fichier slack_manifest.json que vous avez téléchargé depuis GitLab.
    6. Collez le contenu dans le visualiseur JSON pour remplacer tout contenu existant.
    7. Sélectionnez Enregistrer les modifications.

Exigences de connectivité {#connectivity-requirements}

Pour activer les fonctionnalités de l'application GitLab pour Slack, votre réseau doit autoriser les connexions entrantes et sortantes entre GitLab et Slack.

  • Pour les notifications Slack, l'instance GitLab doit être en mesure d'envoyer des requêtes à https://slack.com.
  • Pour les commandes slash et autres fonctionnalités, l'instance GitLab doit être en mesure de recevoir des requêtes depuis https://slack.com.

Activer la prise en charge de plusieurs workspaces {#enable-support-for-multiple-workspaces}

Par défaut, vous pouvez installer l'application GitLab pour Slack dans un seul workspace Slack. Un administrateur sélectionne ce workspace lors de la création d'une application GitLab pour Slack.

Pour activer la prise en charge de plusieurs workspaces Slack, vous devez configurer l'application GitLab pour Slack en tant qu'application distribuée non répertoriée. Une application distribuée non répertoriée :

  • N'est pas publiée dans le répertoire d'applications Slack.
  • Ne peut être utilisée qu'avec votre instance GitLab et non par d'autres sites.

Pour configurer l'application GitLab pour Slack en tant qu'application distribuée non répertoriée :

  1. Accédez à la page Your Apps sur Slack et sélectionnez votre application GitLab pour Slack.
  2. Sélectionnez Manage Distribution.
  3. Dans la section Share Your App with Other Workspaces, développez Remove Hard Coded Information.
  4. Cochez la case I've reviewed and removed any hard-coded information.
  5. Sélectionnez Activate Public Distribution.

Dépannage {#troubleshooting}

Lors de l'administration de l'application GitLab pour Slack, vous pourriez rencontrer les problèmes suivants.

Pour la documentation utilisateur, voir Application GitLab pour Slack.

Les commandes slash retournent dispatch_failed dans Slack {#slash-commands-return-dispatch_failed-in-slack}

Les commandes slash peuvent retourner /gitlab failed with the error "dispatch_failed" dans Slack.

Pour résoudre ce problème, assurez-vous que :