Consolidate LDAP setup instructions
Overview
Today I wanted to see how to set up an LDAP integration with my Omnibus GitLab instance. I searched “using LDAP with Gitlab” on Google and found two different pages that have duplicative content.
Problem
Finding two separate pages that both describe how to set up an LDAP integration was confusing. I ended up reading both pages to make sure I didn't miss any important setup information, and then I found even more pages that show how to configure LDAP in GitLab.
I found gitlab.rb
samples for setting up an LDAP integration on the following pages:
- the LDAP Overview page
- Setting up LDAP sign-in page
- https://docs.gitlab.com/ee/administration/auth/how_to_configure_ldap_gitlab_ee/index.html
- https://docs.gitlab.com/ee/administration/auth/how_to_configure_ldap_gitlab_ce/index.html
The sample gitlab.rb
files in the above pages were slightly different.
There is also a separate set of instructions for configuring LDAP when using the GitLab Helm chart. The LDAP Overview page doesn't link to these instructions.
Proposal
Should we consolidate and have one sample gitlab.rb
file for LDAP configuration that the various setup pages all link to?
In addition to linking to the setup instructions for Omnibus installs, the LDAP Overview page should also link to the Charts documentation.