Configure the GitLab chart with Mattermost Team Edition
This document describes how to install Mattermost Team Edition Helm chart in proximity with an existing GitLab Helm chart deployment.
As the Mattermost Helm chart is installed in a separate namespace, it is recommended that
cert-manager
and nginx-ingress
be configured to manage cluster-wide Ingress and certificate resources. For additional configuration information,
refer to the Mattermost Helm configuration guide.
Prerequisites
- A running Kubernetes cluster.
- Helm v3
Deploy the Mattermost Team Edition Helm chart
Once you have installed the Mattermost Team Edition Helm chart, you can deploy it using the following command:
helm repo add mattermost https://helm.mattermost.com
helm repo update
helm upgrade --install mattermost -f values.yaml mattermost/mattermost-team-edition
Wait for the pods to run. Then, using the Ingress host you specified in the configuration, access your Mattermost server.
For additional configuration information, refer to the Mattermost Helm configuration guide. you experience any issues with this, please view the Mattermost Helm chart issue repository or the Mattermost Forum.
Deploy GitLab Helm chart
To deploy the GitLab Helm chart, follow the instructions described here.
Here’s a light way to install it:
helm repo add gitlab https://charts.gitlab.io/
helm repo update
helm upgrade --install gitlab gitlab/gitlab \
--timeout 600s \
--set global.hosts.domain=<your-domain> \
--set global.hosts.externalIP=<external-ip> \
--set certmanager-issuer.email=<email>
-
<your-domain>
: your desired domain, such asgitlab.example.com
. -
<external-ip>
: the external IP pointing to your Kubernetes cluster. -
<email>
: email to register in Let’s Encrypt to retrieve TLS certificates.
Once you’ve deployed the GitLab instance, follow the instructions for the initial login.
Create an OAuth application with GitLab
The next part of the process is setting up the GitLab SSO integration. To do so, you need to create the OAuth application to allow Mattermost to use GitLab as the authentication provider.
Troubleshooting
If you are following a process other than the one provided and experience authentication and/or deployment issues, let us know in the Mattermost troubleshooting forum.