|Index|SUSE Telco Cloud Documentación|Aprovisionamiento de red dirigido totalmente automatizado|Preparar la imagen del clúster descendente para escenarios conectados
Se aplica a SUSE Telco Cloud 3.6

49 Preparar la imagen del clúster descendente para escenarios conectados

Edge Image Builder (Capítulo 12, Edge Image Builder) se utiliza para preparar una imagen base SLEMicro modificada que se aprovisiona en los hosts del clúster descendente.

Gran parte de la configuración a través de Edge Image Builder es posible, pero en esta guía cubrimos las configuraciones mínimas necesarias para configurar el clúster descendente.

49.1 Requisitos previos para escenarios conectados

Nota
Nota

Es necesario utilizar un host de compilación con la misma arquitectura que las imágenes que se están compilando. En otras palabras, para compilar una imagen aarch64, es necesario utilizar un host de compilación aarch64, y viceversa para x86-64 (las compilaciones cruzadas no son compatibles en este momento).

49.2 Configuración de imagen para escenarios conectados

Al ejecutar Edge Image Builder, se monta un directorio desde el host, por lo que es necesario crear una estructura de directorios para almacenar los archivos de configuración utilizados para definir la imagen de destino.

  • downstream-cluster-config.yaml es el archivo de definición de imagen, véase Capítulo 5, Clústeres independientes con Edge Image Builder para más detalles.

  • La carpeta de la imagen base contendrá la imagen raw de salida generada siguiendo la guía Capítulo 64, Creación de imágenes actualizadas de SUSE Linux Micro con Kiwi con el perfil Base (o Base-RT para el kernel de tiempo real), y ésta debe copiarse o moverse a la carpeta base-images.

  • El directorio custom/files contiene los archivos performance-settings.sh y sriov-auto-filler.sh que se copiarán a la imagen durante el proceso de creación de la misma.

  • El directorio custom/scripts contiene scripts que se ejecutarán en el primer arranque:

    1. El script 01-fix-growfs.sh es necesario para redimensionar la partición raíz del SO durante el despliegue

    2. El script 02-performance.sh es opcional y puede utilizarse para configurar el sistema para el ajuste del rendimiento.

    3. El script 03-sriov.sh es opcional y puede utilizarse para configurar el sistema para SR-IOV.

  • La carpeta network es opcional; consulte Sección 49.2.6, “Script adicional para la configuración de red avanzada” para obtener más detalles.

  • La carpeta os-files contiene los archivos de configuración necesarios para cargar, en cada arranque del nodo, los módulos del kernel sctp y vfio-pci con las opciones requeridas.

├── downstream-cluster-config.yaml
├── base-images
│   └── SL-Micro.x86_64-6.2-Base-GM.raw
├── custom
│   ├── files
│   │   ├── performance-settings.sh
│   │   └── sriov-auto-filler.sh
│   └── scripts
│       ├── 01-fix-growfs.sh
│       ├── 02-performance.sh
│       └── 03-sriov.sh
├── network
│   └── configure-network.sh
└── os-files
    └── etc
        ├── modprobe.d
        │   └── vfio-pci-options.conf
        └── modules-load.d
            ├── sctp.conf
            └── vfio-pci.conf

49.2.1 Archivo de definición de imagen del clúster descendente

El archivo downstream-cluster-config.yaml es el archivo de configuración principal para la imagen del clúster descendente. A continuación se muestra un ejemplo mínimo para el despliegue mediante Metal3:

apiVersion: 1.3
image:
  imageType: raw
  arch: x86_64
  baseImage: SL-Micro.x86_64-6.2-Base-GM.raw
  outputImageName: eibimage-output-telco.raw
operatingSystem:
  kernelArgs:
    - ignition.platform.id=openstack
  systemd:
    disable:
      - rebootmgr
      - transactional-update.timer
      - transactional-update-cleanup.timer
      - fstrim
      - time-sync.target
  users:
    - username: root
      encryptedPassword: $ROOT_PASSWORD
      sshKeys:
      - $USERKEY1
      createHomeDir: true
  packages:
    packageList:
      - jq
    sccRegistrationCode: $SCC_REGISTRATION_CODE

Donde $SCC_REGISTRATION_CODE es el código de registro copiado de SUSE Customer Center, y la lista de paquetes contiene jq, que es requerido.

$ROOT_PASSWORD es la contraseña cifrada para el usuario raíz, que puede ser útil para pruebas o depuración. Puede generarse con el comando openssl passwd -6 PASSWORD

Para los entornos de producción, se recomienda utilizar las claves SSH que pueden añadirse al bloque de usuarios sustituyendo $USERKEY1 por las claves SSH reales.

Nota
Nota

arch: x86_64 es la arquitectura de la imagen. Para la arquitectura arm64, utilice arch: aarch64.

Tenga en cuenta que ignition.platform.id=openstack es obligatorio; sin este argumento, la configuración de SLEMicro mediante ignition fallará en el flujo automatizado de Metal3.

Para versiones de SUSE Linux Micro anteriores a la 6.2, net.ifnames=1 debe establecerse explícitamente como argumento del kernel para habilitar Predictable Network Interface Naming. Esto se aplica de forma predeterminada a partir de la versión 6.2 y no se requiere una configuración explícita. Esto se alinea con la configuración predictableNicNames en el gráfico de Helm de Metal3 del clúster de gestión, que es necesaria para que el aprovisionamiento de red dirigido funcione correctamente. La nomenclatura coherente de las interfaces también es fundamental cuando se utiliza SR-IOV.

49.2.2 Script Growfs

Actualmente, se requiere un script personalizado (custom/scripts/01-fix-growfs.sh) para ampliar el sistema de archivos de modo que coincida con el tamaño del disco en el primer arranque tras el aprovisionamiento. El script 01-fix-growfs.sh contiene la siguiente información:

#!/bin/bash
growfs() {
  mnt="$1"
  dev="$(findmnt --fstab --target ${mnt} --evaluate --real --output SOURCE --noheadings)"
  # /dev/sda3 -> /dev/sda, /dev/nvme0n1p3 -> /dev/nvme0n1
  parent_dev="/dev/$(lsblk --nodeps -rno PKNAME "${dev}")"
  # Last number in the device name: /dev/nvme0n1p42 -> 42
  partnum="$(echo "${dev}" | sed 's/^.*[^0-9]\([0-9]\+\)$/\1/')"
  ret=0
  growpart "$parent_dev" "$partnum" || ret=$?
  [ $ret -eq 0 ] || [ $ret -eq 1 ] || exit 1
  /usr/lib/systemd/systemd-growfs "$mnt"
}
growfs /

49.2.3 Script de rendimiento

El siguiente script opcional (custom/scripts/02-performance.sh) puede utilizarse para configurar el sistema para el ajuste del rendimiento:

#!/bin/bash

# create the folder to extract the artifacts there
mkdir -p /opt/performance-settings

# copy the artifacts
cp performance-settings.sh /opt/performance-settings/

El contenido de custom/files/performance-settings.sh es un script que puede utilizarse para configurar el sistema para el ajuste del rendimiento y puede descargarse desde el siguiente enlace.

49.2.4 Script de SR-IOV

El siguiente script opcional (custom/scripts/03-sriov.sh) puede utilizarse para configurar el sistema para SR-IOV:

#!/bin/bash

# create the folder to extract the artifacts there
mkdir -p /opt/sriov
# copy the artifacts
cp sriov-auto-filler.sh /opt/sriov/sriov-auto-filler.sh

El contenido de custom/files/sriov-auto-filler.sh es un script que puede utilizarse para configurar el sistema para SR-IOV y puede descargarse desde el siguiente enlace.

Nota
Nota

Añada sus propios scripts personalizados para que se ejecuten durante el proceso de aprovisionamiento utilizando el mismo enfoque. Para obtener más información, consulte el Capítulo 5, Clústeres independientes con Edge Image Builder.

49.2.5 Configuración adicional para cargas de trabajo de Telco

Para habilitar funciones de Telco como dpdk, sr-iov o FEC, pueden ser necesarios paquetes adicionales como se muestra en el siguiente ejemplo.

apiVersion: 1.3
image:
  imageType: raw
  arch: x86_64
  baseImage: SL-Micro.x86_64-6.2-Base-GM.raw
  outputImageName: eibimage-output-telco.raw
operatingSystem:
  kernelArgs:
    - ignition.platform.id=openstack
  systemd:
    disable:
      - rebootmgr
      - transactional-update.timer
      - transactional-update-cleanup.timer
      - fstrim
      - time-sync.target
  users:
    - username: root
      encryptedPassword: $ROOT_PASSWORD
      sshKeys:
      - $user1Key1
      createHomeDir: true
  packages:
    packageList:
      - jq            # Non Telco specific - category: testing/utils
      - dpdk          # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
      - dpdk-tools    # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: testing/utils
      - libdpdk-25    # TelCo Core-Network UserPlane (5G UPF) and RAN UserPlane (gNB: DU and CU-UP) - category: runtime
      - pf-bb-config  # TelCo RAN (gNB: DU) - category: config.
      - open-iscsi    # Non Telco specific (required by SUSE Storage/Longhorn) - category: runtime
      - tuned         # Non Telco specific (linux tuning) - category: config.
      - cpupower      # Non Telco specific (linux tuning - CPU power related settings) - category: config.
      - rt-tests      # Non Telco specific (RT scheduler-latency testing) - category: testing/utils
      - linuxptp      # TelCo RAN; time sync (gNB: DU) - category: runtime
      - synce4l       # TelCo RAN; time sync (gNN: DU) - category: runtime
      - pciutils      # Non Telco specific (provides "lspci" command) - category: testing/utils
      - numactl       # Non Telco specific (provides "numactl" command) - category: testing/utils
    sccRegistrationCode: $SCC_REGISTRATION_CODE

Donde $SCC_REGISTRATION_CODE es el código de registro copiado de SUSE Customer Center, y la lista de paquetes contiene los paquetes mínimos que se utilizarán para los perfiles de Telco.

Nota
Nota

arch: x86_64 es la arquitectura de la imagen. Para la arquitectura arm64, utilice arch: aarch64.

49.2.6 Script adicional para la configuración de red avanzada

Si necesita configurar IP estáticas o escenarios de red más avanzados como se describe en Capítulo 53, Configuración de red avanzada, es necesaria la siguiente configuración adicional.

En la carpeta network, cree el siguiente archivo configure-network.sh: esto consume los datos de la unidad de configuración en el primer arranque y configura la red del host utilizando la herramienta de configuración de NM.

#!/bin/bash

set -eux

# Attempt to statically configure a NIC in the case where we find a network_data.json
# In a configuration drive

CONFIG_DRIVE=$(blkid --label config-2 || true)
if [ -z "${CONFIG_DRIVE}" ]; then
  echo "No config-2 device found, skipping network configuration"
  exit 0
fi

mount -o ro $CONFIG_DRIVE /mnt

META_DATA_FILE="/mnt/openstack/latest/meta_data.json"
if [ ! -f "${META_DATA_FILE}" ]; then
  umount /mnt
  echo "No meta_data.json found, skipping hostname configuration"
  exit 0
fi

DESIRED_HOSTNAME=$(cat /mnt/openstack/latest/meta_data.json | tr ',{}' '\n' | grep '"metal3-name"' | sed 's/.*\"metal3-name\": \"\(.*\)\"/\1/')
echo "${DESIRED_HOSTNAME}" > /etc/hostname

NETWORK_DATA_FILE="/mnt/openstack/latest/network_data.json"

if [ ! -f "${NETWORK_DATA_FILE}" ]; then
  umount /mnt
  echo "No network_data.json found, skipping network configuration"
  exit 0
fi

mkdir -p /tmp/nmc/{desired,generated}
cp ${NETWORK_DATA_FILE} /tmp/nmc/desired/_all.yaml
umount /mnt

./nmc generate --config-dir /tmp/nmc/desired --output-dir /tmp/nmc/generated
./nmc apply --config-dir /tmp/nmc/generated

49.2.7 Módulos de kernel necesarios para Telco

Para asegurar que los módulos de kernel necesarios para las cargas de trabajo de telecomunicaciones se carguen en cada arranque del nodo, debe añadir los siguientes archivos de configuración a la carpeta EIB os-files:

49.2.7.1 sctp.conf

Para colocar en la ruta os-files/etc/modules-load.d/, indicando al systemd-modules-load.service que cargue el módulo del kernel sctp en el arranque del nodo.

$ cat os-files/etc/modules-load.d/sctp.conf
# Request "systemd-modules-load.service" to load sctp module at boot time
sctp

49.2.7.2 vfio-pci.conf

Para colocar en la ruta os-files/etc/modules-load.d/, indicando al systemd-modules-load.service que cargue el módulo del kernel vfio-pci en el arranque del nodo.

$ cat os-files/etc/modules-load.d/vfio-pci.conf
# Request "systemd-modules-load.service" to load vfio-pci module at boot time
# NOTE: The (SRIOV & DPDK related) required load-module options settings are defined in related "/etc/modprobe.d/vfio-pci-options.conf" file
vfio_pci

49.2.7.3 vfio-pci-options.conf

Para colocar en la ruta os-files/etc/modprobe.d/, estableciendo los parámetros necesarios del módulo del kernel vfio-pci que se aplicarán cuando se cargue el módulo del kernel.

$ cat os-files/etc/modprobe.d/vfio-pci-options.conf
# Enable SR-IOV and disable idle D3 state for vfio-pci driver
options vfio_pci enable_sriov=1 disable_idle_d3=1

49.3 Creación de imágenes

Una vez preparada la estructura de directorios siguiendo las secciones anteriores, ejecute el siguiente comando para compilar la imagen:

podman run --rm --privileged -it -v $PWD:/eib \
 registry.suse.com/edge/3.6/edge-image-builder:1.3.3.1 \
 build --definition-file downstream-cluster-config.yaml

Esto crea el archivo de imagen ISO de salida llamado eibimage-output-telco.raw, basado en la definición descrita anteriormente.

La imagen de salida debe estar disponible a través de un servidor web, ya sea el contenedor del servidor multimedia habilitado mediante la Documentación del Clúster de Gestión (Nota) o algún otro servidor accesible localmente. En los ejemplos siguientes, nos referimos a este servidor como imagecache.local:8080