This documentation describes a product preview for packaged integrations in Nubus for Kubernetes.

Install packaged integration

3. Install packaged integration#

This section describes how an operator installs the packaged integration for Nextcloud to Nubus for Kubernetes. For more information about loading packaged integrations, see Load packaged integrations in Univention Nubus for Kubernetes - Nubus Customization and Modification Manual [1].

Before you begin, you need to location and name of the container image from the software developer, or responsible entity of the packaged integration. The example uses the following values:

Registry:

artifacts.software-univention.de

Repository:

nubus/images/nextcloud-extension

To install the packaged integration to your Nubus for Kubernetes installation, use the following steps:

  1. Add the content from nubus-values.yaml to the custom_values.yaml values file of your Nubus for Kubernetes installation. Listing 3.1 shows the Helm Chart values of that file. You must define values for the following variables here:

    nextcloudUserPassword

    You can pick any secure password and use it later to setup the LDAP plugin in Nextcloud. For the configuration reference, see Server tab.

    portalNextcloudLinkBase

    It’s the URL to your Nextcloud instance. You have it after you installed Nextcloud. See Install Nextcloud.

    Listing 3.1 Helm Chart values for adding the Nextcloud packaged integration#
    # SPDX-License-Identifier: AGPL-3.0-only
    # SPDX-FileCopyrightText: 2024 Univention GmbH
    
    global:
      extensions:
        - name: "nextcloud"
          image:
            registry: "artifacts.software-univention.de"
            repository: "nubus/images/nextcloud-packaged-integration"
            tag: "0.1.0"
            imagePullPolicy: "IfNotPresent"
    
    nubusStackDataUms:
      templateContext:
        nextcloudUserPassword: "<your-nextcloudUser-password>"
        portalNextcloudLinkBase: "https://<fqdn-to-your-nextcloud-instance>"
    
  2. To apply the changes to your Nubus for Kubernetes installation, run the commands in Listing 3.2

    Listing 3.2 Install the Nextcloud packaged integration#
    $ export NAMESPACE_FOR_NUBUS="Set to your Kubernetes namespace"
    $ export RELEASE_NAME="The Helm Chart release name"
    $ export VERSION="Your version of Nubus"
    $ helm upgrade \
       "$RELEASE_NAME" \
       --namespace="$NAMESPACE_FOR_NUBUS" \
       oci://artifacts.software-univention.de/nubus/charts/nubus \
       --values custom_values.yaml \
       --version "$VERSION"