GitLab System Administration - Hands-on Lab: Use GitLab Administration Commands

Estimated time to complete: 30 minutes

Task A. Run basic service status commands

1. From a terminal prompt, SSH into your training virtual machine if not already logged in.

2. Use the gitlab-ctl maintenance command to check the status of GitLab services:

   1	sudo gitlab-ctl status

3. The output of this command will appear similar to this:

   run: alertmanager: (pid 21371) 205s; run: log: (pid 21114) 254s
   run: gitaly: (pid 21327) 208s; run: log: (pid 20429) 399s
   run: gitlab-exporter: (pid 21346) 207s; run: log: (pid 21012) 270s
   run: gitlab-kas: (pid 20689) 380s; run: log: (pid 20700) 379s
   run: gitlab-workhorse: (pid 21309) 208s; run: log: (pid 20851) 290s
   run: logrotate: (pid 20319) 414s; run: log: (pid 20327) 413s
   run: nginx: (pid 21320) 208s; run: log: (pid 20917) 282s
   run: node-exporter: (pid 21338) 208s; run: log: (pid 20965) 278s
   run: postgres-exporter: (pid 21380) 204s; run: log: (pid 21149) 248s
   run: postgresql: (pid 20496) 391s; run: log: (pid 20517) 388s
   run: prometheus: (pid 21356) 206s; run: log: (pid 21077) 258s
   run: puma: (pid 20768) 303s; run: log: (pid 20781) 300s
   run: redis: (pid 20365) 408s; run: log: (pid 20378) 405s
   run: redis-exporter: (pid 21348) 207s; run: log: (pid 21039) 266s
   run: sidekiq: (pid 20798) 297s; run: log: (pid 20806) 296s
   

   To learn more about these components and how they interact, check out the documentation.

4. In the output, you will see the pid, or process ID of each GitLab service. This process ID verifies that the process is actively running on the system.

5. Often, you may need to stop or restart a service for troubleshooting purposes. To demonstrate this process, stop the nginx service.

   1	sudo gitlab-ctl stop nginx

6. To verify that the service is down, run sudo gitlab-ctl status. Note the value displayed for nginx.

   down: nginx: 13s, normally up; run: log: (pid 20917) 1782s
   

7. Attempt to navigate to GitLab in your web browser, or refresh the page if already there. You should see some variation of “can not connect”. This is because we just turned off the web server on the GitLab instance.

8. Restart the nginx web service.

   1	sudo gitlab-ctl start nginx

9. Run sudo gitlab-ctl status to verify that nginx is up and running again.

   run: nginx: (pid 22369) 7s; run: log: (pid 20917) 1852s
   

10. Navigate to GitLab in your web browser. The application should now load properly.

Task B. Change visibility settings

1. Log into your GitLab web instance with your root user and password from Lab 1.

2. In the bottom left corner of the main screen in the sidebar, click Admin Area.

3. You will first adjust default project visibility settings. Scroll to the bottom of the left hand navigation pane and click Settings > General.

4. Under Visibility and access controls, click Expand.

5. Change the Default project visibility to Internal by clicking the associated radio button.

6. Change the Default group visibility to Internal by clicking on the associated radio button.

Task C. Locate sign-in settings

1. The second setting we will update are Sign-In restrictions. Still under Settings > General, click Collapse next to Visibility and access controls.

2. Under Sign-in restrictions, click Expand.

3. Under Two-factor authentication, click the checkbox next to Enforce two-factor authentication.

4. Click Collapse next to Sign-in restrictions to close the menu.

Task D. Update the header logo

You can personalize your GitLab instance by uploading a header logo.

1. On the left hand side panel, click Settings > Appearance.

2. Under the Navigation Bar section, click Choose File.

3. Select an appropriate picture from your computer to serve as a header logo, and click Open.

4. Click the Update appearance settings to save the changes. You should see your picture in the top left corner of the screen.

Lab Guide Complete

You have completed this lab exercise. You can view the other lab guides for this course.

Suggestions?

If you’d like to suggest changes to the GitLab System Admin Hands-on Guide, please submit them via merge request.

View page source - Edit this page - please contribute.