- Creating the EKS cluster
- Persistent Volume Management
- External Access to GitLab
- Next Steps
For a fully functional GitLab instance, you will need a few resources before
To get started easier, a script is provided to automate the cluster creation. Alternatively, a cluster can be created manually as well.
A bootstrap script has been created to automate much of the setup process for users on EKS.
The script will:
- Create a new EKS cluster.
kubectl, and connect it to the cluster.
- Initialize Helm and install Tiller.
The script uses eksctl to initialize the cluster. If it cannot locate it in your PATH, it will install it to a temporary location.
The script reads various parameters from environment variables, or command line arguments and an argument
down for bootstrap and clean up respectively.
The table below describes all variables.
|The region where your cluster lives|
|The name of the cluster|
|The version of your EKS cluster|
|The number of nodes required|
|The type of nodes to deploy|
|The service account name to use for Helm/Tiller|
Run the script, by passing in your desired parameters. It can work with the default parameters.
The script can also be used to clean up the created EKS resources:
- We recommend a cluster with 8vCPU and 30GB of RAM.
For the most up to date instructions, follow Amazon’s EKS getting started guide.
Administrators may also want to consider the new AWS Service Operator for Kubernetes to simplify this process.
There are two methods to manage volume claims on Kubernetes:
- Manually create a persistent volume.
- Automatic persistent volume creation through dynamic provisioning.
We currently recommend using manual provisioning of persistent volumes. Amazon EKS clusters default to spanning multiple zones. Dynamic provisioning, if not configured to use a storage class locked to a particular zone leads to a scenario where pods may exist in a different zone from storage volumes and be unable to access data.
Administrators who need to deploy in multiple zones should familiarize themselves with how to set up cluster storage and review Amazon’s own documentation on storage classes when defining their storage solution.
By default, GitLab will deploy an Ingress which will create an associated Elastic Load Balancer (ELB). Since the DNS names of the ELB cannot be known ahead of time, it’s difficult to utilize Let’s Encrypt to automatically provision HTTPS certificates.
We recommend using your own certificates, and then mapping your desired DNS name to the created ELB using a CNAME record.
Continue with the installation of the chart once you have the cluster up and running, and the static IP and DNS entry ready.