debian-mirror-gitlab/doc/user/project/integrations/gitlab_slack_application.md

62 lines
2.4 KiB
Markdown
Raw Normal View History

2019-09-30 21:07:59 +05:30
# GitLab Slack application **(FREE ONLY)**
2019-07-31 22:56:46 +05:30
NOTE: **Note:**
The GitLab Slack application is only configurable for GitLab.com. It will **not**
work for on-premises installations where you can configure the
2020-04-08 14:13:33 +05:30
[Slack slash commands](slack_slash_commands.md) service instead. We're planning
to make this configurable for all GitLab installations, but there's
no ETA - see [#28164](https://gitlab.com/gitlab-org/gitlab/issues/28164).
2019-07-31 22:56:46 +05:30
It was first introduced in GitLab 9.4 and distributed to Slack App Directory in
GitLab 10.2.
Slack provides a native application which you can enable via your project's
integrations on GitLab.com.
## Slack App Directory
The simplest way to enable the GitLab Slack application for your workspace is to
install the [GitLab application](https://slack-platform.slack.com/apps/A676ADMV5-gitlab) from
the [Slack App Directory](https://slack.com/apps).
Clicking install will take you to the
[GitLab Slack application landing page](https://gitlab.com/profile/slack/edit)
where you can select a project to enable the GitLab Slack application for.
![GitLab Slack application landing page](img/gitlab_slack_app_landing_page.png)
## Configuration
Alternatively, you can configure the Slack application with a project's
integration settings.
Keep in mind that you need to have the appropriate permissions for your Slack
team in order to be able to install a new application, read more in Slack's
2019-12-26 22:10:19 +05:30
docs on [Adding an app to your team](https://slack.com/help/articles/202035138).
2019-07-31 22:56:46 +05:30
To enable GitLab's service for your Slack team:
1. Go to your project's **Settings > Integration > Slack application** (only
visible on GitLab.com)
1. Click the "Add to Slack" button
That's all! You can now start using the Slack slash commands.
## Usage
After confirming the installation, you, and everyone else in your Slack team,
2020-04-22 19:07:51 +05:30
can use all the [slash commands](../../../integration/slash_commands.md).
2019-07-31 22:56:46 +05:30
When you perform your first slash command you will be asked to authorize your
Slack user on GitLab.com.
2020-04-22 19:07:51 +05:30
The only difference with the [manually configurable Slack slash commands](slack_slash_commands.md)
2019-07-31 22:56:46 +05:30
is that all the commands should be prefixed with the `/gitlab` keyword.
We are working on making this configurable in the future.
2019-12-21 20:55:43 +05:30
For example, to show the issue number `1001` under the `gitlab-org/gitlab`
2019-07-31 22:56:46 +05:30
project, you would do:
2020-04-08 14:13:33 +05:30
```plaintext
2019-12-21 20:55:43 +05:30
/gitlab gitlab-org/gitlab issue show 1001
2019-07-31 22:56:46 +05:30
```