GitLab: 4. Create the service

This documentation is part of the Automate with the CLI guide. You can view the complete guide here: Start GitLab, retrieve its credentials, and modify its configuration programmatically using the Stackhero CLI.

👋 Welcome to the Stackhero documentation!

Stackhero offers a ready-to-use GitLab cloud solution designed for teams seeking a fast, secure, and scalable environment:

• Unlimited users, repositories, data transfers, and CI/CD processing time for total flexibility.
• Effortless updates with just one click, so your environment stays up to date with no downtime.
• Custom domain name secured with HTTPS (for example, https://git.your-company.com) for a professional image and enhanced security.
• Consistent performance and strong security on your own private, dedicated infrastructure. No noisy neighbours, full isolation guaranteed.
• Choice of hosting location: 🇪🇺 Europe or 🇺🇸 USA to meet your compliance or latency requirements.

Get started quickly and focus on your code. Stackhero's GitLab cloud hosting solution is up and running in about 5 minutes.

Below is a sample script that creates a stack, adds your GitLab service to it, waits for it to start, retrieves its configuration (including generated credentials), and then applies a new configuration.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="gitlab"   # The GitLab service store name (see step 2)
instance="..."                # An instance size from step 3
region="europe"               # A region name from step 3

# Create a stack for your service (uses your default organization; add --organization if needed)
stackId=$(stackhero --format=script stack-create \
  --name="My GitLab stack")
echo "Stack created: ${stackId}"

# Add GitLab to the stack (names are resolved automatically)
serviceId=$(stackhero --format=script service-add \
  --stack="My GitLab stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service added: gitlab"

# Wait for the service to be fully operational (this may take a few minutes)
stackhero service-wait-for --service="gitlab"

# Retrieve the service configuration, including generated credentials
stackhero service-configuration-get --service="gitlab" --format=json