Get started with GitLab EE using VMware Cloud Marketplace

GitLab Enterprise (CORE) is a complete DevOps platform delivered as a single application. It provides powerful CI/CD tools that integrate with existing processes and helps teams deliver high-quality code.

The steps below assume that:

  • You have an account in the VMware Cloud Marketplace.
  • You have a Software Defined Data Center (SDDC) configured to work with VMware Cloud on AWS.

Subscribe to the Bitnami GitLab EE OVA template and define the deployment configuration

The first step consists of searching for the application you wish to deploy (in this case, Bitnami GitLab EE) in the VMware Cloud Marketplace and defining the deployment configuration to use it with a virtual machine. Follow these steps:

  • Log in to the VMware Cloud Marketplace.
  • From the left navigation menu, select the “Catalog” option and search for the application you wish to deploy in your SDDC.
  • Look through the list of search results and select the one matching your requirements.
  • On the resulting page, you will find a summary of the solution that includes a description of the application, pricing plans, type of image, and supported operating systems. Click “Subscribe” to start configuring your virtual machine.

    Subscribe to application

  • In the “Settings” section of the “Subscribe” dialog box, select the deployment platform (in this case, “VMC”), the version and the subscription type. Click “Next” to proceed.

    Configure deployment settings

  • In the “SDDC” section, select the SDDC where the deployment will run, and enter your VCenter username and password. Click “Next” to proceed.

    Select SDDC organization

  • In the “Configuration” section, select the vSphere resources that will be used by the deployment, such as the data store. Click “Next” to proceed.

    Specify the data store

  • In the “Summary” section, review the deployment configuration and click “Finish” to begin the deployment.

    Review the configuration

To check that the product subscription is active, navigate to the “Subscriptions” page (you can access it by clicking the “Check Subscriptions” link in the previous section or through the VMware Cloud Marketplace main navigation) and confirm that the subscription status shows as “Subscribed” in the subscription list.

Launch a Bitnami GitLab EE virtual machine from the template

The next step is to launch a virtual machine using the parameters defined in the previous step. Continue with the process of launching the virtual machine as explained below:

  • Log in to your datacenter vSphere client and navigate to the “Content Libraries -> VMware Cloud Marketplace” page. You should see a list of the templates that you have subscribed to in the VMware Cloud Marketplace.
  • Select the template you wish to deploy. From the template detail page, begin the deployment by selecting “Actions -> New VM from this template” menu item.

    Create new VM from the selected template

  • Enter a name and select a location for the virtual machine within your SDDC. Click “Next” to proceed.

    Choose location for the VM

  • Select the compute resource that will be used for the deployment. Click “Next” to proceed.

    Select compute resource

  • Review the template details. Click “Next” to proceed.

    Verify template details

  • Review and accept the terms and conditions for the license agreement. Click “Next” to proceed.

    Accept licenses

  • Choose the storage capacity for the virtual machine. Click “Next” to proceed.

    Choose storage capacity

  • Select a destination network for each source network. Note that the “IP Allocation Settings” display the values defined by default in your datacenter. Click “Next” to proceed.

    Select a destination network

  • Define the contents of the SSH public key that will be used to connect to the virtual machine. Click “Next” to proceed.

    Add SSH public key

  • In the “Ready to complete” screen, review the configuration summary. If correct, click “Finish” to complete the process.

Once the deployment process completes, your virtual machine will appear in the list of available virtual machines for your specified datacenter location. Select it to obtain a detailed configuration summary and gain access to management options.

Virtual Machine management panel

By default, the virtual machine will be powered off, so you must power it on before proceeding to the next step.

Obtain GitLab EE credentials

You’re almost done but, before you can log in to GitLab EE, you need the administrator credentials and the application IP address. Follow the steps below:

  • On the virtual machine detail page in vSphere, click the “Launch Web Console” menu item:

    Access the console

  • The virtual machine console will appear with a login prompt, as shown below. The console will also display the login credentials for the application and the current IP address of the virtual machine. Make a note of these details.

    Credentials for application

You can now access GitLab EE by launching your Web browser and browsing to the virtual machine’s IP address. Log in using the obtained credentials.

Start using GitLab EE

Activate your Enterprise Edition license

Your first step should be to upload your Enterprise Edition license to activate full GitLab Enterprise Edition functionality. Follow these steps:

  • Click the wrench icon in the top navigation bar.
  • On the “Admin Area” page, select the “License” menu option.
  • Click the “Upload New License” button.

    Upload license

  • Upload your .gitlab-license file or enter your license key and click the “Upload License” button.

    Upload license

Your license will be validated and activated.

Create a project

Next, create a project (which includes a Git repository) as described below:

  • Click the plus symbol in the top navigation bar and select the “New project” menu option.
  • Enter a name for the project and select the visibility level. For this example, the project name is my-project and the visibility is Internal.

    Create project

  • Click the “Create project” button to create the project. The project will be created and will be visible in the list of projects.

  • Click the “Clone” button and note or copy the SSH URL to the GitLab repository.

    Clone repository

Add your SSH key

Before you can commit any files to the project repository, you must add your SSH key to your GitLab account.

TIP: To generate a new SSH key pair, you can use PuTTYgen (Windows) or the ssh-keygen command (Linux and Mac OS X). Read instructions on how to use PuTTYgen and instructions on how to use ssh-keygen.

Follow the steps below:

  • Click your user icon in the top navigation bar and select the “Settings” icon.
  • On the “User Settings” page, select the “SSH Keys” menu option.
  • Paste the contents of your SSH public key in the “Key” field and add a friendly title for the key in the “Title” field.

    Add SSH key

  • Click the “Add Key” button to save your SSH key.

Clone the repository and push your first commit

You should now be able to clone the repository and push commits to it. Here are some example commands. Remember to replace the REPOSITORY-URL placeholder with the SSH URL for the GitLab repository.

$ git clone REPOSITORY-URL
$ cd my-project
$ echo "Hello world" >> README.md
$ git add README.md
$ git commit -m "Initial commit"
$ git push

Learn more about using GitLab in the official documentation.

Last modification August 22, 2019