50 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.
50.1 Requisitos previos para escenarios conectados #
Se requiere un entorno de ejecución de contenedor como Podman o Rancher Desktop para ejecutar Edge Image Builder.
La imagen base se compilará utilizando la siguiente guía Capítulo 65, Creación de imágenes actualizadas de SUSE Linux Micro con Kiwi con el perfil
Base(oBase-RTpara el kernel de tiempo real). El proceso es el mismo para ambas arquitecturas (x86-64 y aarch64).
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).
50.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.yamles 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 65, Creación de imágenes actualizadas de SUSE Linux Micro con Kiwi con el perfil
Base(oBase-RTpara el kernel de tiempo real), y ésta debe copiarse o moverse a la carpetabase-images.El directorio
custom/filescontiene los archivosperformance-settings.shysriov-auto-filler.shque se copiarán a la imagen durante el proceso de creación de la misma.El directorio
custom/scriptscontiene scripts que se ejecutarán en el primer arranque:El script
01-fix-growfs.shes necesario para redimensionar la partición raíz del SO durante el despliegueEl script
02-performance.shes opcional y puede utilizarse para configurar el sistema para el ajuste del rendimiento.El script
03-sriov.shes opcional y puede utilizarse para configurar el sistema para SR-IOV.
La carpeta
networkes opcional; consulte Sección 50.2.6, “Script adicional para la configuración de red avanzada” para obtener más detalles.La carpeta
os-filescontiene los archivos de configuración necesarios para cargar, en cada arranque del nodo, los módulos del kernelsctpyvfio-pcicon 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.conf50.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_CODEDonde $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.
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.
50.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 /50.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.
50.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.shEl 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.
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.
50.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_CODEDonde $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.
arch: x86_64 es la arquitectura de la imagen. Para la arquitectura arm64, utilice arch: aarch64.
50.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 54, 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/generated50.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:
50.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
sctp50.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_pci50.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=150.3 Creación de imágenes #
Una vez preparado el directorio 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,7/edge-image-builder:1.3.4 \
build --definition-file downstream-cluster-config.yamlEsto crea el archivo de imagen RAW 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 media-server 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