Die voorsieningsprobleem

Nadat jy jou beeld gebou het, moet elke nuwe bord gepersonaliseer word — met instellings soos gasheernaam, SSH-sleutels, konfigurasie, of agterkantregistrasie.
Om dit handmatig te doen vir dosyne of selfs honderde Raspberry Pi Compute Module 5 (CM5) eenhede is eenvoudig nie prakties nie.

Dit is waar rpi-sb-provisioner inkom — 'n buigsame eerste-boot outomatiseringsraamwerk vir Raspberry Pi toestelle.

Hoe rpi-sb-provisioner werk

By die eerste opstart begin die stelsel outomaties rpi-sb-provisioner, wat:

  • Lees 'n voorsieningskonfigurasielêer
  • Voer skripte uit om stelselinstellings toe te pas
  • Skryf toestelidentiteitsdata (serienommers, geloofsbrenge, sertifikate, ens.)
  • Merk die voorsieningsproses as voltooi aan

Dit verseker dat elke toestel uniek gekonfigureer is en gereed is vir implementering — sonder handmatige ingryping.

Installasie

Volg die amptelike installasiegids by: https://github.com/raspberrypi/rpi-sb-provisioner

Konfigurasie

rpi-sb-provisioner sluit 'n eenvoudige blaaiergebaseerde konfigurasie-GUI in.
Om dit oop te maak, voer die volgende opdrag in 'n terminaal uit:

xdg-open http://localhost:3142

Van hier af:

  1. Maak die Beelde-kieslys oop en laai jou .img-lêer op (geskep met rpi-image-gen).
  2. Maak die Opsies-kieslys oop om voorsieningsparameters te konfigureer, soos die teikentoestelfamilie of die basisbeeld om te gebruik.
  3. Die resulterende konfigurasie word in /etc/rpi-sb-provisioner/config gestoor en kan soos volg lyk:
CUSTOMER_KEY_FILE_PEM=
CUSTOMER_KEY_PKCS11_NAME=
GOLD_MASTER_OS_FILE=/srv/rpi-sb-provisioner/images/deb12-arm64-ix-base.img
PROVISIONING_STYLE=naked
RPI_DEVICE_BOOTLOADER_CONFIG_FILE=/srv/rpi-sb-provisioner/bootloader_config_files/bootloader-gpio17.naked
RPI_DEVICE_EEPROM_WP_SET=
RPI_DEVICE_FAMILY=5
RPI_DEVICE_FIRMWARE_FILE=/lib/firmware/raspberrypi/bootloader-2712/latest/pieeprom-2025-10-17.bin
RPI_DEVICE_LOCK_JTAG=
RPI_DEVICE_RETRIEVE_KEYPAIR=
RPI_DEVICE_STORAGE_CIPHER=aes-xts-plain64
RPI_DEVICE_STORAGE_TYPE=emmc
RPI_SB_PROVISIONER_MANUFACTURING_DB=/srv/rpi-sb-provisioner/manufacturing.db
RPI_SB_WORKDIR=

Gebruik

  1. Byvoorbeeld, wanneer 'n amptelike Raspberry Pi Compute Module 5gebruik word, stel die J2-springer in om eMMC-opstart te deaktiveer.
  2. Koppel die CM5 aan die voorsieningsgasheer via USB. Die voorsieningsproses begin outomaties.
  3. Sodra voorsiening voltooi is, verwyder die jumper en koppel 'n kragtoevoer — die toestel sal nou van eMMC begin.

Jumper-instelling vir rpi-sb-provisioner

Voordele

  • Volledig outomatiese toestel-aanboord
  • Konsekwente konfigurasie oor alle eenhede
  • Maklike integrasie met vervaardigingstelsels of agterkant-API's
  • Herhaalbaar — geen handmatige aanpassings of inkonsekwenthede tussen toestelle nie

Uitbreiding van die Proses

Die voorsieningswerkvloei kan uitgebrei word om in te sluit:

  • API-oproepe om toestelle met agterkantdienste te registreer
  • Sertifikaatgenerering vir veilige opstart of enkripsie
  • Hardeware-validering of funksionele toetse voor aktivering

Met rpi-sb-provisionerword voorsiening 'n geïntegreerde stap in jou bou- en ontplooiingspyplyn — nie 'n nagedagte nie.

Artikels in hierdie reeks

Bronne