One-Click GitLab repository manager deployment on Scaleway Instances using InstantApp

• apps
• GitLab
• InstantApp

This guide explains the usage of the GitLab repository manager InstantApp, on a Scaleway Instance. GitLab is a web-based platform designed for managing Git repositories and provides a wide range of features, including code reviews, wikis, and issue tracking.

Scaleway provides a GitLab image that is built on Ubuntu 22.04 LTS (Jammy Jellyfish) and includes GitLab version 16.3.3. By default, this image includes support for routed IPs.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• An SSH key

Creating a GitLab Instance

1. Click Instances in the Compute section of the side menu. The Instances page displays.
2. Click Create Instance. The Instance creation wizard displays.
3. Choose the Availability Zone for your Instance.
4. Select the Instance type you want to create.
5. Select the GitLab image in the InstantApps tab.
6. Add storage volumes to your Instance.
7. Enter a name and optional tags for your Instance.
8. Click Create Instance to launch your GitLab Instance.

Configuring GitLab

1. Log in to your Instance using SSH.
2. You find your GitLab password in the MOTD when you log in to your Instance.

   #################### GITLAB ####################
   Gitlab version 16.9.1 is installed.
   Getting started with: https://www.scaleway.com/docs/how-to-use-the-gitlab-instant-apps.
   WARNING: Gitlab is not ready yet.
   You can check the status of Gitlab services by running "gitlab-ctl status".
   You can also check if the application server is running by using the monitoring endpoints:
   * curl -s http://localhost/-/health
   * curl -s http://localhost/-/readiness
   * curl -s http://localhost/-/liveness
   To access the GitLab web interface, open http://4bdbae5e-f6ea-43ad-8d4b-26c088417e5c.pub.instances.scw.cloud in your browser.
   Once connected, we strongly advise you to change your password by going in user settings page: http://4bdbae5e-f6ea-43ad-8d4b-26c088417e5c.pub.instances.scw.cloud/-/profile/password/edit
   You can hide this message for the next connections by deleting the /etc/update-motd.d/70-gitlab file.
   ################################################
   

3. Access GitLab’s web interface by copy/pasting the URL from the MOTD or the Instance’s IP address into your browser’s navigation bar. GitLab’s login screen displays.
4. Log in using the user root and the password shown in the MOTD of your Instance.
5. Change your password by accessing the URL shown in the MOTD above for security reasons.
6. Remove the MOTD file from your Instance

   rm /etc/update-motd.d/70-gitlab
   

Configuring Let’s Encrypt

GitLab can automatically fetch and renew let’s encrypt certificates. Follow this tutorial from the official GitLab documentation.

Opening the mail ports to send emails

1. Click the Security groups tab on the Instances overview page.

2. Click Create a new security group and input the security group name and description.

3. Check the Enable SMTP box to unblock the mail ports.

4. Return to the overview tab and select the security group you created in step 2.

   The new security group configuration will be applied automatically on Instances.