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.
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.
In the “SDDC” section, select the SDDC where the deployment will run, and enter your VCenter username and password. Click “Next” to proceed.
In the “Configuration” section, select the vSphere resources that will be used by the deployment, such as the data store. Click “Next” to proceed.
In the “Summary” section, review the deployment configuration and click “Finish” to begin the deployment.
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.
Enter a name and select a location for the virtual machine within your SDDC. Click “Next” to proceed.
Select the compute resource that will be used for the deployment. Click “Next” to proceed.
Review the template details. Click “Next” to proceed.
Review and accept the terms and conditions for the license agreement. Click “Next” to proceed.
Choose the storage capacity for the virtual machine. Click “Next” to proceed.
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.
Define the contents of the SSH public key that will be used to connect to the virtual machine. Click “Next” to proceed.
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.
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:
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.
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 your .gitlab-license file or enter your license key and click the “Upload License” button.
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.
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.
Add your SSH key
Before you can commit any files to the project repository, you must add your SSH key to your GitLab account.
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.
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