Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In some situations, the Smartfacts server has no access to the internet. In this case, it is not possible to download the needed software and images. This article describes which options we have to install Smartfacts in such scenarios.

...

Expand
titleProvide container images with a proxy container registry

Provide Container Images with a Proxy Container Registry

Please contact your administrators to add the Smartfacts registry https://repo.mid.de to the proxy registry.

Add login data to the proxy registry

To connect to your proxy registry, you will need to add the proxy registry login information to your values.yaml file.

To do this, replace the placeholder in the following text and insert it into a file called “registrylogin.txt” on the Smartfacts server.

Code Block
{
  "auths":
  {
    "<proxy registry name>" :
    {
      "username":"<username>",
      "password":"<password>"
    }
  }
}
  • Replace the placehoder <proxy registry name> with the name of your proxy registry without protocol (e.g. write “repo.yourcompany.com”, not “https://repo.yourcompany.com”)

  • Replace the value of the fields “username” and “password” with the login data for your proxy registry

  • Save the file under the name “registrylogin.txt”

  • convert the login information to a base64-encoded string

    Code Block
    cat registrylogin.txt | base64 -w0 > registrylogin.base64
  • In the file “values.yaml” add a new line below the line beginning with “instance” with the content

    Code Block
      repologin: "<content of file registrylogin.base64>"
    • Replace the placehoder “<content of file registrylogin.txt>“ with the content of the file “registrylogin.base64”

    • Make sure that the indentation at the beginning of the line is exactly the same as in the line above

  • delet the files “registrylogin.txt” and “registrylogin.base64”

Expand
titleProvide container images without a container registry

Provide container images without a container registry

In this scenario you will download the container images manually and copy it to the server.

  • Call up the web page for downloading the container images. The link to the web page contains the chart version. It has the following format:
    https://cp.mid.de/releases/smartfacts-air-gapped/smartfacts_air_gapped_<HELM_CHART_VERSION>.html

    • Make sure to replace the placeholder <HELM_CHART_VERSION> with the version of the helm chart you downloaded. You should now see the download page.

  • Download all files to your client PC

  • Create a new directory ~/download/smartfacts on the Smartfacts server

  • Copy the downloaded files to ~/download/smartfacts on the Smartfacts server

  • Download the script to load the images from https://cp.mid.de/releases/smartfacts-air-gapped/loadimages.sh and copy it to ~/download/smartfacts on the Smartfacts server

Load the container images into k3s

On the Smartfacts server

  • Change into the directory ~/download/smartfacts

  • Make the script “loadimages.sh” executeable and execute it

    Code Block
    chmod u+x loadimages.sh
    ./loadimages.sh

The script checks wether all files are present and correct. If this is the case, it will load the container images from the files. To save disk space, you can delete the image files are deleted from - and sha256-files the directory after loading.

You can view the loaded images with the following command.

Code Block
sudo k3s crictl images

...