Nextcloud en Ku­be­r­ne­tes: descubre cómo in­s­ta­lar­lo

Si quieres co­n­fi­gu­rar Nextcloud en Ku­be­r­ne­tes, es re­co­me­n­da­ble que utilices S3 como backend de al­ma­ce­na­mie­n­to y MariaDB como base de datos. Puedes mejorar el re­n­di­mie­n­to con algunos cambios en la co­n­fi­gu­ra­ción.

Combinar Nextcloud y Ku­be­r­ne­tes vale la pena

Combinar Nextcloud y Ku­be­r­ne­tes con S3 como backend de al­ma­ce­na­mie­n­to es en muchos casos una solución pro­me­te­do­ra para el sector privado y em­pre­sa­rial. El software de nube no comercial es adecuado tanto para trabajar con se­r­vi­do­res locales como con hosts externos y destaca en co­m­pa­ra­ción con numerosas al­te­r­na­ti­vas a Nextcloud por una excelente ar­qui­te­c­tu­ra de seguridad. Ku­be­r­ne­tes es un sistema de gestión de apli­ca­cio­nes en co­n­te­ne­do­res de código abierto y puede uti­li­zar­se tanto lo­ca­l­me­n­te como para co­mpu­tación en la nube. Este sistema es co­n­si­de­ra­do ex­tre­ma­da­me­n­te flexible, altamente escalable y muy fiable. Te mostramos cómo co­n­fi­gu­rar Nextcloud en Ku­be­r­ne­tes.

¿Qué re­qui­si­tos deben cumplirse?

Antes de que puedas comenzar a co­n­fi­gu­rar Nextcloud en Ku­be­r­ne­tes, es necesario cumplir con algunos re­qui­si­tos. Ne­ce­si­ta­rás su­fi­cie­n­te al­ma­ce­na­mie­n­to y ya deberías haber creado un clúster de Ku­be­r­ne­tes. Puedes crearlo en tu ordenador o utilizar un al­ma­ce­na­mie­n­to en la nube, de­pe­n­die­n­do de los recursos que necesites o tengas di­s­po­ni­bles. También debes haber co­n­fi­gu­ra­do el gestor de paquetes Helm para Ku­be­r­ne­tes. Si ya has cumplido estos re­qui­si­tos, puedes comenzar con los pasos in­di­vi­dua­les.

Instalar Nextcloud en Ku­be­r­ne­tes: los pasos más im­po­r­ta­n­tes

Ahora que están sentadas las bases ne­ce­sa­rias, puedes comenzar a co­n­fi­gu­rar la co­m­bi­na­ción de Nextcloud y Ku­be­r­ne­tes. Hemos resumido los pasos más im­po­r­ta­n­tes a co­n­ti­nua­ción para que puedas hacerlo sin problemas.

Co­n­fi­gu­rar DNS

El primer paso es crear un registro A para un su­b­do­mi­nio que pueda dirigirse a la dirección IP deseada. Si estás uti­li­za­n­do una solución local, tu dirección IP pública será el destino correcto; de lo contrario, pro­po­r­cio­na la IP de tu servicio en la nube. Los pasos ne­ce­sa­rios para ello pueden variar un poco de­pe­n­die­n­do del proveedor de DNS que se esté usando.

Añadir y ac­tua­li­zar Helm

Para preparar los recursos para Ku­be­r­ne­tes, se utiliza el gestor de paquetes me­n­cio­na­do antes: Helm. Asegúrate de tenerlo instalado en tu di­s­po­si­ti­vo y de estar conectado a tu clúster de Ku­be­r­ne­tes. Si todo está co­n­fi­gu­ra­do, añade el re­po­si­to­rio de Helm y ac­tua­lí­za­lo con los si­guie­n­tes dos comandos:

helm repo add nextcloud https://nextcloud.github.io/helm/
helm repo update

Crear values.yaml

Crea ahora un nuevo Helm chart uti­li­za­n­do el siguiente comando:

nano values.yaml

Después, añade las si­guie­n­tes es­pe­ci­fi­ca­cio­nes en este archivo.

Co­n­fi­gu­rar los Cronjobs

En primer lugar, define un límite de tiempo para los Cronjobs. En sistemas ope­ra­ti­vos similares a Unix Estas, estos son tareas que se ejecutan au­to­má­ti­ca­me­n­te en segundo plano y se repiten. En el caso de Nextcloud en Ku­be­r­ne­tes, se trata pri­n­ci­pa­l­me­n­te de labores de ma­n­te­ni­mie­n­to. En el ejemplo, se indica que se ejecuten cada cinco minutos. Sin embargo, es­pe­cia­l­me­n­te con conjuntos de datos más grandes, puede ser re­co­me­n­da­ble realizar el ma­n­te­ni­mie­n­to con mayor fre­cue­n­cia. Este es el código co­rre­s­po­n­die­n­te:

cronjob:
    annotations: {}
    curlInsecure: false
    enabled: true
    failedJobsHistoryLimit: 5
    image: {}
    schedule: '*/5*     *** '
    successfulJobsHistoryLimit: 2

Des­ac­ti­var el HPA

Ahora desactiva el HPA (Ho­ri­zo­n­tal Pod Au­to­s­ca­ler). Este escalador ajusta de manera au­to­má­ti­ca el número de pods. Si estás uti­li­za­n­do Read­W­ri­teO­n­ce para Nextcloud y deseas controlar la es­ca­la­bi­li­dad, deberías des­ac­ti­var el HPA y centrarte en un solo pod. Esta es una solución mucho más co­n­ve­nie­n­te si solo algunos usuarios quieren acceder a los datos. El código se escribe así:

hpa:
    cputhreshold: 60
    enabled: false
    maxPods: 10
    minPods: 1

So­bre­s­cri­bir la etiqueta de la imagen

Para ase­gu­rar­te de que se tenga en cuenta la versión actual de Helm, so­bre­s­cri­be la etiqueta de la imagen usando este código:

image:
    repositor: nextcloud
    tag: 28.0.2-apache
    pullPolicy: IfNotPresent

Ahora se se­le­c­cio­na la versión 28.0.2 o una más reciente.

Elegir una base de datos

Al elegir tu base de datos, tienes tres opciones: MariaDB, Po­s­t­gre­S­QL o SQLite. Para el ejemplo, se ha optado por MariaDB. Configura esta base de datos de la manera descrita a co­n­ti­nua­ción y desactiva los otros dos sistemas.

internalDatabase:
    enabled: false
mariadb:
    db:
        name: nextcloud
        password: db-password
        user: nextcloud
    enabled: true
    master:
        persistence:
            accessMode: ReadWriteOnce
            enabled: true
            size: 8Gi
    replication:
        enabled: false
    rootUser:
        password: root-db-password
        forcePassword: true
postgresql:
    enabled: false

Monitoreo para métricas

Si quieres hacer un se­gui­mie­n­to con Pro­me­theus o Grafana, puedes añadir el siguiente código de manera opcional:

metrics:
    enabled: true
    https: false
    image:
        pullPolicy: IfNotPresent
        repository: xperimental/nextcloud-exporter
        tag: v0.3.0
    replicaCount: 1
    service:
        annotations:
            prometheus.io/port: '9205'
            prometheus.io/scrape: 'true'
        labels: {}
        type: ClusterIP
    timeout: 5s

Permitir archivos de co­n­fi­gu­ra­ción pe­r­so­na­li­za­dos

Por defecto, Nextcloud en Ku­be­r­ne­tes utiliza un archivo llamado config.php para la co­n­fi­gu­ra­ción. Si deseas si­m­pli­fi­car o hacer más flexible esta co­n­fi­gu­ra­ción, puedes utilizar tus propios archivos de co­n­fi­gu­ra­ción. Aquí tienes el código necesario para hacerlo:

nextcloud:
    configs:
        custom.config.php: |-
            <?php
            $CONFIG = array (
                'overwriteprotocol' => 'https',
                'overwrite.cli.url' => 'https://drive.example.com',
                'filelocking.enabled' => 'true',
                'loglevel' => '2',
                'enable_previews' => true,
                'trusted_domains' =>
                     [
                        'nextcloud',
                        'drive.example.com'
                     ]
            );

Para hacerlo, si­m­ple­me­n­te tienes que re­em­pla­zar el marcador de posición “example.com” con tu propio dominio.

Co­n­fi­gu­rar Redis

El siguiente archivo de co­n­fi­gu­ra­ción pe­r­so­na­li­za­do se im­ple­me­n­ta­rá para mejorar el al­ma­ce­na­mie­n­to en caché uti­li­za­n­do Redis. Helm instala Redis por defecto sin pro­te­c­ción de co­n­tra­se­ña, por lo que es re­co­me­n­da­ble añadir una capa adicional de seguridad para evitar problemas futuros al iniciar sesión. Para ello, se puede utilizar el siguiente código para ello:

redis.config.php: |-
    <?php
    $CONFIG = array (
      'memcache.local' => '\\OC\\Memcache\\Redis',
      'memcache.distributed' => '\OC\Memcache\Redis',
      'memcache.locking' => '\OC\Memcache\Redis',
      'redis' => array(
        'host' => getenv('REDIS_HOST'),
        'port' => getenv('REDIS_HOST_PORT') ?: 6379,
        'password' => getenv('your-password-for-redis')
      )
    );

Co­n­fi­gu­rar el backend de al­ma­ce­na­mie­n­to

El último archivo de co­n­fi­gu­ra­ción se añade para el backend de al­ma­ce­na­mie­n­to S3. A co­n­ti­nua­ción, se muestra cómo se integra en el código:

s3.config.php: |-
    <?php
    $CONFIG = array (
      'objectstore' => array(
        'class' => '\\OC\\Files\\ObjectStore\\S3',
        'arguments' => array(
        'bucket'     => 'bucket-name',
        'autocreate' => true,
        'key'      => 's3-access-key',
        'secret'     => 's3-secret-key',
        'region'     => 's3-region',
        'hostname'   => 's3-endpoint',
        'use_ssl'    => true,
        'use_path_style' => true
        )
      )
    );

Des­ac­ti­var la co­n­fi­gu­ra­ción de Redis

Como an­te­rio­r­me­n­te so­bre­s­cri­bi­s­te la co­n­fi­gu­ra­ción pre­de­te­r­mi­na­da de Redis, ahora debes des­ac­ti­var­la para evitar errores. El código adecuado para ello es el siguiente:

defaultConfigs:
    .htaccess: true
    apache-pretty-urls.config.php: true
    apcu.config.php: true
    apps.config.php: true
    autoconfig.php: false
    redis.config.php: false
    smtp.config.php: true

Definir host, ad­mi­ni­s­tra­dor y co­n­tra­se­ña

Ahora, define el host, el ad­mi­ni­s­tra­dor y la co­n­tra­se­ña co­rre­s­po­n­die­n­tes para utilizar Nextcloud en Ku­be­r­ne­tes. Escribe para ello este código:

host: drive.example.com
password: your-password
username: admin-name

Si­m­ple­me­n­te, sustituye los ma­r­ca­do­res de posición por tus datos.

Co­n­fi­gu­rar no­ti­fi­ca­cio­nes por correo ele­c­tró­ni­co

Tienes la opción de co­n­fi­gu­rar un servicio SMTP (protocolo simple de tra­n­s­fe­re­n­cia de correo) para recibir no­ti­fi­ca­cio­nes de Nextcloud. Si quieres activarla, utiliza el siguiente código:

mail:
    domain: example.com
    enabled: false
    fromAddress: user
    smtp:
      authtype: LOGIN
      host: example.com
      name: username
      password: your-password
      port: 465
      secure: ssl

Co­n­fi­gu­ra­ción del disco pe­r­si­s­te­n­te

La siguiente co­n­fi­gu­ra­ción de pe­r­si­s­te­n­cia está destinada a los datos que Nextcloud almacena en el disco co­rre­s­po­n­die­n­te. Esto no incluye tus datos de usuario, que se guardarán en S3 como estaba previsto.

persistence:
    accessMode: ReadWriteOnce
    annotations: {}
    enabled: true
    size: 8Gi

Pro­te­c­ción con co­n­tra­se­ña para Redis

Es re­co­me­n­da­ble proteger Redis con una co­n­tra­se­ña, lo cual también ayuda a prevenir errores de au­te­n­ti­ca­ción. Para ello, sigue el siguiente código y asegúrate de re­em­pla­zar ‘your-password-for-redis’ por tu co­n­tra­se­ña personal:

redis:
    enabled: true
    password: 'your-password-for-redis'
    usePassword: true

Limitar las réplicas

Como ya has des­ac­ti­va­do el HPA, deberías limitar el número de réplicas a 1. Esta es la in­s­tru­c­ción que debes aplicar:

replicaCount: 1

Instalar Nextcloud en Ku­be­r­ne­tes

Por último, instala Nextcloud en Ku­be­r­ne­tes y añade MariaDB y Redis. Usa este comando:

kubectl create ns nextcloud
helm upgrade --install --namespace nextcloud -f your-values.yaml nextcloud nextcloud/nextcloud