Gitlab Cookbook

Book Image

Gitlab Cookbook

By : Jeroen van Baarsen

Book Image

Gitlab Cookbook

By: Jeroen van Baarsen

Overview of this book

GitLab Cookbook

GitLab Cookbook

Credits

About the Author

About the Author

About the Reviewers

About the Reviewers

www.PacktPub.com

www.PacktPub.com

Preface

Free Chapter

Introduction and Installation

Introduction and Installation

Using the Omnibus package

Setting up the server dependencies for source installation

Set up the database for source installation

Installing GitLab from source

Using Chef and GitLab Cookbook

Logging in for the first time

Creating your first project

Explaining Git

Generating your SSH key on Unix-like systems

Generating your SSH key on Windows

Adding your SSH key to GitLab

Creating your first Git project

Cloning your repository and pushing code to it

Working with branches

Performing a rebase operation

Squashing your commits

Managing Users, Groups, and Permissions

Managing Users, Groups, and Permissions

Creating a group

Working with user permissions

Protecting your main branches

Configuring the project's visibility

Removing a user

Issue Tracker and Wiki

Issue Tracker and Wiki

Creating your first issue

Creating your first merge request

Accepting a merge request

Referencing issues

Working with milestones

Creating your first wiki page

Managing your wiki with Gollum

Maintaining Your GitLab Instance

Maintaining Your GitLab Instance

Updating an Omnibus installation

Updating GitLab from a source installation

Troubleshooting your GitLab installation

Creating a backup

Restoring a backup

Importing an existing repository

Webhooks, External Services, and the API

Webhooks, External Services, and the API

Working with external services

Using system hooks

Getting your private token for the API

Understanding the API status codes

Managing your projects via the API

Managing issues via the API

Working with other API resources

Working with the API sudo command

Using LDAP and OmniAuth Providers

Using LDAP and OmniAuth Providers

Setting up your LDAP server

Installing a web interface for LDAP

Adding a user to your LDAP server

Configuring GitLab to use LDAP on an Omnibus installation

Configuring GitLab to use LDAP on a source installation

Setting up GitHub as an OmniAuth provider

GitLab CI

Introduction to GitLab CI

Installing the dependencies

Installing the coordinator

Installing the web server

Installing a runner

Linking your first project to GitLab CI

Creating a build script

Using GitLab CI webhooks

Tips and Tricks

Tips and Tricks

The power of snippets

Getting involved

The GitLab RSS feed

Archiving projects

How to format a good Git commit message

How to change your Git editor

Understanding the anatomy of GitLab

Understanding the differences between GitLab's Community Edition (CE) and Enterprise Edition (EE)

How to fork a project and what is forking?

Understanding the branching workflow

Index

Customer Reviews

5 star

0

4 star

0

3 star

0

2 star

0

1 star

0

Configuring GitLab to use LDAP on a source installation

In this recipe, we will configure your GitLab source installation to use the LDAP server.

How to do it…

We perform the following steps to use LDAP on a source installation:

Log in via SSH to your GitLab server.
Go to the directory with the gitlab.yml configuration file:
```
$ cd /home/git/gitlab/config/
```
Open the gitlab.yml file and find the ldap section.
Change enabled: false to enabled: true.
Change the following information:
```
host: '_your_ldap_server'
port: 636 
uid: 'uid'
method: 'plain' # "tls" or "ssl" or "plain"
bind_dn: 'CN=admin,DC=your,DC=ldap,DC=server'
password: '_the_password_of_the_bind_user'
base: 'DC=your,DC=ldap,DC=server'
```
It is important that you keep an eye on the base and the bind_dn values. They need to be in a format that LDAP understands. For example, if your domain is ldap.jvanbaarsen.com, the value needs to be 'DC=ldap,DC=jvanbaarsen,DC=com'. If you don't use a subdomain and your domain is jvanbaarsen.com, the value would...