|Index|SUSE Telco Cloud Documentação|Provisionamento de rede direcionado totalmente automatizado|Preparar a imagem do cluster downstream para cenários conectados
Aplica-se a SUSE Telco Cloud 3.6

49 Preparar a imagem do cluster downstream para cenários conectados

O Edge Image Builder (Capítulo 12, Edge Image Builder) é usado para preparar uma imagem base SLEMicro modificada que é provisionada nos hosts do cluster downstream.

Grande parte da configuração via Edge Image Builder é possível, mas neste guia, cobrimos as configurações mínimas necessárias para configurar o cluster downstream.

49.1 Pré-requisitos para cenários conectados

Nota
Nota

É necessário usar um host de compilação com a mesma arquitetura das imagens que estão sendo criadas. Em outras palavras, para criar uma imagem aarch64, é necessário usar um host de compilação aarch64, e vice-versa para x86-64 (compilações cruzadas não são suportadas neste momento).

49.2 Configuração de imagem para cenários conectados

Ao executar o Edge Image Builder, um diretório é montado a partir do host, portanto, é necessário criar uma estrutura de diretórios para armazenar os arquivos de configuração usados para definir a imagem de destino.

  • downstream-cluster-config.yaml é o arquivo de definição de imagem, veja Capítulo 5, Clusters autônomos com o Edge Image Builder para mais detalhes.

  • A pasta da imagem base conterá a imagem bruta de saída gerada seguindo o guia Capítulo 64, Criando imagens atualizadas do SUSE Linux Micro com o Kiwi com o perfil Base (ou Base-RT para o kernel de tempo real) deve ser copiada/movida para a pasta base-images.

  • O diretório custom/files contém os arquivos performance-settings.sh e sriov-auto-filler.sh a serem copiados para a imagem durante o processo de criação da imagem.

  • O diretório custom/scripts contém scripts a serem executados na primeira inicialização:

    1. O script 01-fix-growfs.sh é necessário para redimensionar a partição raiz do SO na implantação

    2. O script 02-performance.sh é opcional e pode ser usado para configurar o sistema para ajuste de desempenho.

    3. O script 03-sriov.sh é opcional e pode ser usado para configurar o sistema para SR-IOV.

  • A pasta network é opcional, veja Seção 49.2.6, “Script adicional para Configuração de Rede Avançada” para mais detalhes.

  • A pasta os-files contém os arquivos de configuração necessários para carregar, a cada inicialização de nó, os módulos do kernel sctp e vfio-pci com as opções necessárias.

├── 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 Arquivo de definição de imagem de cluster downstream

O arquivo downstream-cluster-config.yaml é o arquivo de configuração principal para a imagem do cluster downstream. O exemplo a seguir é um exemplo mínimo para implantação via 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

Onde $SCC_REGISTRATION_CODE é o código de registro copiado do SUSE Customer Center, e a lista de pacotes contém jq, que é necessário.

$ROOT_PASSWORD é a senha criptografada para o usuário root, o que pode ser útil para teste/depuração. Ele pode ser gerado com o comando openssl passwd -6 PASSWORD

Para ambientes de produção, recomenda-se usar as chaves SSH que podem ser adicionadas ao bloco de usuários, substituindo $USERKEY1 pelas chaves SSH reais.

Nota
Nota

arch: x86_64 é a arquitetura da imagem. Para a arquitetura arm64, use arch: aarch64.

Observe que ignition.platform.id=openstack é obrigatório; sem este argumento, a configuração do SLEMicro via ignition falhará no fluxo automatizado do Metal3.

Para versões do SUSE Linux Micro anteriores à 6.2, net.ifnames=1 deve ser definido explicitamente como um argumento de kernel para habilitar Predictable Network Interface Naming. Isso é aplicado por padrão a partir da versão 6.2 em diante e a configuração explícita não é necessária. Isso está alinhado com a configuração predictableNicNames no gráfico Helm do Metal3 do Cluster de Gerenciamento, que é necessária para que o Provisionamento de Rede Direcionado funcione corretamente. A nomenclatura consistente de interfaces também é crítica quando o SR-IOV é utilizado.

49.2.2 Script Growfs

Atualmente, um script personalizado (custom/scripts/01-fix-growfs.sh) é necessário para expandir o sistema de arquivos para corresponder ao tamanho do disco na primeira inicialização após o provisionamento. O script 01-fix-growfs.sh contém as seguintes informações:

#!/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 desempenho

O script opcional a seguir (custom/scripts/02-performance.sh) pode ser usado para configurar o sistema para ajuste de desempenho:

#!/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/

O conteúdo de custom/files/performance-settings.sh é um script que pode ser usado para configurar o sistema para ajuste de desempenho e pode ser baixado do seguinte link.

49.2.4 Script SR-IOV

O script opcional a seguir (custom/scripts/03-sriov.sh) pode ser usado para configurar o 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

O conteúdo de custom/files/sriov-auto-filler.sh é um script que pode ser usado para configurar o sistema para SR-IOV e pode ser baixado do seguinte link.

Nota
Nota

Adicione seus próprios scripts personalizados para serem executados durante o processo de provisionamento usando a mesma abordagem. Para obter mais informações, consulte Capítulo 5, Clusters autônomos com o Edge Image Builder.

49.2.5 Configuração adicional para cargas de trabalho Telco

Para habilitar recursos de Telco como dpdk, sr-iov ou FEC, pacotes adicionais podem ser necessários, conforme mostrado no exemplo a seguir.

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

Onde $SCC_REGISTRATION_CODE é o código de registro copiado do SUSE Customer Center, e a lista de pacotes contém os pacotes mínimos a serem usados para os perfis de Telco.

Nota
Nota

arch: x86_64 é a arquitetura da imagem. Para a arquitetura arm64, use arch: aarch64.

49.2.6 Script adicional para Configuração de Rede Avançada

Se você precisar configurar IPs estáticos ou cenários de rede mais avançados conforme descrito em Capítulo 53, Configuração de rede avançada, a configuração adicional a seguir é necessária.

Na pasta network, crie o seguinte arquivo configure-network.sh - isso consome dados da unidade de configuração na primeira inicialização e configura a rede do host usando a ferramenta NM Configurator.

#!/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 necessários para Telco

Para garantir que os módulos de kernel necessários para cargas de trabalho de telecomunicações sejam carregados na inicialização de cada nó, os seguintes arquivos de configuração devem ser adicionados à os-files pasta EIB:

49.2.7.1 sctp.conf

Para ser colocado no caminho os-files/etc/modules-load.d/, instruindo o systemd-modules-load.service a carregar o módulo do kernel sctp na inicialização do nó.

$ 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 ser colocado no caminho os-files/etc/modules-load.d/, instruindo o systemd-modules-load.service a carregar o módulo do kernel vfio-pci na inicialização do nó.

$ 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 ser colocado no caminho os-files/etc/modprobe.d/, definindo os parâmetros necessários do módulo do kernel vfio-pci a serem aplicados quando o módulo do kernel for carregado.

$ 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 Criação de imagem

Assim que a estrutura de diretórios estiver preparada seguindo as seções anteriores, execute o seguinte comando para criar a imagem:

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

Isso cria o arquivo de imagem ISO de saída chamado eibimage-output-telco.raw, com base na definição descrita acima.

A imagem de saída deve então ser disponibilizada via um servidor web, seja o contêiner media-server habilitado via a Documentação do Cluster de Gerenciamento (Nota) ou algum outro servidor acessível localmente. Nos exemplos abaixo, nos referimos a este servidor como imagecache.local:8080