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 #
Um tempo de execução do contêiner como Podman ou Rancher Desktop é necessário para executar o Edge Image Builder.
A imagem base será criada usando o seguinte guia Capítulo 64, Criando imagens atualizadas do SUSE Linux Micro com o Kiwi com o perfil
Base(ouBase-RTpara o kernel de tempo real). O processo é o mesmo para ambas as arquiteturas (x86-64 e aarch64).
É 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(ouBase-RTpara o kernel de tempo real) deve ser copiada/movida para a pastabase-images.O diretório
custom/filescontém os arquivosperformance-settings.shesriov-auto-filler.sha serem copiados para a imagem durante o processo de criação da imagem.O diretório
custom/scriptscontém scripts a serem executados na primeira inicialização:O script
01-fix-growfs.shé necessário para redimensionar a partição raiz do SO na implantaçãoO script
02-performance.shé opcional e pode ser usado para configurar o sistema para ajuste de desempenho.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-filescontém os arquivos de configuração necessários para carregar, a cada inicialização de nó, os módulos do kernelsctpevfio-pcicom 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.conf49.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_CODEOnde $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.
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.shO 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.
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_CODEOnde $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.
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/generated49.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
sctp49.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_pci49.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=149.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.yamlIsso 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