Preparation for installation

Before you start fetching installation artifacts:

• get an On-Premise license,
• prepare network infrastructure,
• add Helm repository.

Get an On-Premise license

To access the repository containing installation artifacts, you need an On-Premise license (see Keys and tokens).

1. Fill in the form at urbi.ae.
2. Having received the license key, specify it in DGCLI configuration file.

Prepare network infrastructure

The recommended infrastructure for running On-Premise services includes a public network and a private network. The table below describes an example of such an infrastructure with the example.com and example.local domains. All the components must be deployed in a single Kubernetes cluster managed from the example.com host.

Infrastructure component	Who must have access	Network type	Domains used in the documentation
Artifacts delivery infrastructure	The infrastructure administrator	Public	example.com
Docker Registry for storing services' images	DGCLI utility from the example.com host	Public	docker.example.com
Artifacts storage	DGCLI utility from the example.com host	Public	artifacts.example.com
Services' frontends	Applications and end users in the private network	Private	*.example.com
Services' backends	Other services and storages from all pods in the Kubernetes cluster	Private	*.example.local
Data storages	Other services and storages from all pods in the Kubernetes cluster	Private	*.storage.example.local

Note

If you use Managed Kubernetes (Kubernetes as a Service) to deploy the product, make sure that access to the Docker registry is configured using the HTTPS protocol and a certificate signed by a trusted certification authority (for example, Let’s Encrypt).

Add Helm repository

A Helm chart from the On-Premise repository is used to install each product. You need to add this repository on the host from which the installation will be run. In the example described above, it is the example.com host.

1. Install the Helm package manager into the cluster. To do so, follow the official installation instructions.

2. Add the repository containing the Helm charts.

   helm repo add 2gis-on-premise https://2gis.github.io/on-premise-helm-charts
   helm repo update

3. Check that Helm and the repository are installed correctly by running:

   helm search repo 2gis-on-premise

   If the command output contains a non-empty list of charts, everything is set up correctly.

What's next?

• Fetch installation artifacts