search string side menu

BRIX On-Premises > Prepare infrastructure > Local image registry / Download BRIX images

Download BRIX images

BRIX Enterprise can be installed in a closed environment without direct access to an external container image repository. To achieve this, download BRIX images on a computer with internet access and upload them to a local image registry. In this article, Harbor is chosen as the local image registry. For more details on configuring and installing Harbor, refer to Install Harbor.

Loading BRIX images consists of three steps:

  1. Create a new project in Harbor.
  2. Download BRIX images.
  3. Upload BRIX images to Harbor.

Step 1: Create a new project in Harbor

  1. Log in to the Harbor web interface. In the main left menu, go to the Projects section. To create a new project, click +New project.

creating-new-project-harbor-1

  1. Enter a lowercase project name, for example, images. Specify whether the project should be public. Click OK.

creating-new-project-harbor-2

Step 2: Download BRIX images

  1. On a computer with internet access, download the script to get the BRIX distribution packages for offline installation by executing the following command:

curl -fsSL -o elma365-charts-offline.sh https://dl.elma365.com/onPremise/latest/elma365-charts-offline-latest && \
chmod +x elma365-charts-offline.sh

Please see the addresses for other BRIX versions in the BRIX On-Premises distribution packages of different versions article.

  1. Execute the script for downloading the BRIX distribution packages. When executing the script without parameters, select:
  • pull (download) command
  • Packages to download. Use the following keys on the keyboard: Up and Down arrow keys to navigate through the list of packages, Space to select a package:

./elma365-charts-offline.sh

download-images-1

To download images for all the packages, execute the script with the --pull command:

./elma365-charts-offline.sh --pull

  1. After downloading the distribution packages, copy the obtained elma365-X.Y.Z directory to the server where the installation will take place.

Step 3: Upload BRIX images to Harbor

  1. On the server where the installation will take place, go to the elma365-X.Y.Z directory.
  2. Execute the script for downloading the BRIX distribution packages for offline installation and select:
  • push (upload to private registry) command
  • Packages which BRIX images should be downloaded to the private registry. Use the following keys on the keyboard: Up and Down arrow keys to navigate through the list of packages, Space to select a package:

./elma365-charts-offline.sh

download-images-2

Non-interactive download

To perform a non-interactive download (when you pre-specify the packages to be downloaded), do the following steps:

  1. In the images.yaml file, specify the values of the parameters in advance:
  • the .config block defines the parameters for the private registry
  • the .config.charts block defines the packages to be downloaded to the private registry
    download-images-3
  1. Execute the script with the --push command for non-interactive downloading of the images to the private repository:

./elma365-charts-offline.sh --push
  1. Wait for the BRIX image download script to end.
installing-harbor.html downloading-images-deckhouse.html