Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Créez une variante personnalisée de l'AMI Bottlerocket pour Amazon EKS

Lorsque vous exécutez des charges de travail GPU sur Amazon Elastic Kubernetes Service (Amazon EKS), vous choisissez une variante de Bottlerocket. La variante doit correspondre à votre version de Kubernetes et à votre type d'accélérateur. Bottlerocket propose des variantes validées pour les configurations courantes. Toutefois, il se peut que votre organisation ait besoin d'une autre variante pour l'une des raisons suivantes :

Comme Bottlerocket sur le GitHub site Web est entièrement open source, vous pouvez créer une variante personnalisée qui répond à ces besoins. Cette rubrique explique comment cloner une variante existante et remplacer le pilote NVIDIA de la branche R580 par le pilote R595 (version 595.71.05). Vous créez ensuite l'image et vous l'enregistrez en tant qu'AMI privée.

Comment fonctionne le système de compilation

Lorsque vous courezcargo make -e BUILDSYS_VARIANT=aws-k8s-1.36-nvidia, trois choses se produisent :

Disposition du référentiel

Les répertoires suivants sont pertinents pour le travail sur les variantes :

bottlerocket/
├── Cargo.toml                       # workspace: lists every variant
├── Twoliter.toml                    # pins SDK + kit versions
├── Twoliter.lock                    # locked digests for the above
├── Licenses.toml                    # you create this (NVIDIA license acknowledgement)
├── Infra.toml                       # you create this (AMI publish regions)
│
├── variants/
│   ├── aws-k8s-1.36-nvidia/         # example variant you'll copy
│   │   ├── Cargo.toml               #   package list + kernel params
│   │   └── amispec.toml             #   symlink → ../shared/amispec-split.toml
│   └── shared/                      # shared AMI spec templates
│
├── sources/
│   ├── Cargo.toml                   # workspace: lists every settings-defaults crate
│   ├── shared-defaults/             # the actual defaults (symlink targets)
│   └── settings-defaults/
│       └── aws-k8s-1.36-nvidia/
│           ├── Cargo.toml
│           └── defaults.d/          # 30+ symlinks into shared-defaults/
│
└── packages/
    ├── settings-defaults/
    │   └── settings-defaults.spec   # RPM: declares which variants exist
    └── settings-plugins/
        └── settings-plugins.spec    # RPM: maps variants to settings plugins

Consultez les remarques suivantes concernant la structure du référentiel :

Conditions préalables

Pour terminer la procédure pas à pas, vous devez :

Étape 1 : préparer l'hôte de compilation

Lancez une instance EC2, par exemple une c7i.8xlarge (32 vCPU, 64 GiB de mémoire). Utilisez un volume racine gp3 de 150 Go et attachez la politique AmazonSSMManagedInstanceCore gérée pour l'accès SSM.

Connectez-vous à l'instance à l'aide du gestionnaire de session AWS Systems Manager (SSM) :

aws ssm start-session --target <instance-id>
cd ~

Installez les packages de système d'exploitation requis :

apt-get update
apt-get install -y build-essential openssl libssl-dev pkg-config lz4 \
                   git ca-certificates curl gnupg

Installez Docker à l'aide des commandes suivantes :

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \
  https://download.docker.com/linux/ubuntu noble stable" \
  > /etc/apt/sources.list.d/docker.list
apt-get update
apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin
systemctl enable --now docker

Installez Rust et cargo-make à l'aide des commandes suivantes :

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
. "$HOME/.cargo/env"
cargo install cargo-make

Étape 2 : Cloner le dépôt

Clonez le référentiel Bottlerocket sur le GitHub site Web et naviguez dans le répertoire :

cd ~/bottlerocket

Pour créer une version reproductible, consultez une version étiquetée (par exemple,git checkout v1.62.1). Pour utiliser les derniers packages, restez sur la develop succursale.

Étape 3 : vérifier les versions du kit

Ouvrez Twoliter.toml et confirmez les versions du kit. Pour le support du R595, vous avez besoin de bottlerocket-kernel-kit la version 6.2.2 ou ultérieure :

[[kit]]
name = "bottlerocket-kernel-kit"
version = "6.2.2"
vendor = "bottlerocket"

Si la version est plus ancienne, mettez-la à jour et régénérez le verrou :

./tools/twoliter/twoliter update

Étape 4 : contourner le problème du chemin de fabrication de la cargaison

Deux litres se fixent CARGO_HOME à~/bottlerocket/.cargo, ce qui empêche le processus interne de chargement de trouver votre marque de cargaison installée dans le monde entier. Créer un lien symbolique

mkdir -p ~/bottlerocket/.cargo/bin
ln -sf /root/.cargo/bin/cargo-make ~/bottlerocket/.cargo/bin/cargo-make

Sans cette étape, la compilation échoue avecerror: no such command: make.

Étape 5 : Trouvez les succursales de chauffeurs disponibles

Les packages NVIDIA kmod sont livrés à l'intérieurbottlerocket-kernel-kit. Pour plus d'informations sur les packages de pilotes disponibles, consultez le répertoire des packages kernel-kit sur le GitHub site Web ou les notes de version sur le GitHub site Web.

Pour le noyau 6.18 (utilisé par les aws-k8s-1.36 variantes) :

kmod-6.18-nvidia-r580   ← driver 580.159.03 (current default)
kmod-6.18-nvidia-r595   ← driver 595.71.05

Pour le noyau 6.12 (utilisé paraws-k8s-1.33,1.34,1.35) :

kmod-6.12-nvidia-r580
kmod-6.12-nvidia-r595

Étape 6 : Création de la nouvelle variante

Copiez la variante existante. cp -RÀ utiliser pour préserver les liens symboliques :

cp -R variants/aws-k8s-1.36-nvidia variants/aws-k8s-1.36-nvidia-595
cp -R sources/settings-defaults/aws-k8s-1.36-nvidia \
      sources/settings-defaults/aws-k8s-1.36-nvidia-595

Modifier variants/aws-k8s-1.36-nvidia-595/Cargo.toml :

- name = "aws-k8s-1_36-nvidia"
+ name = "aws-k8s-1_36-nvidia-595"

- "kmod-6.18-nvidia-r580-tesla",
+ "kmod-6.18-nvidia-r595-tesla",

Modifier sources/settings-defaults/aws-k8s-1.36-nvidia-595/Cargo.toml :

- name = "settings-defaults-aws-k8s-1_36-nvidia"
+ name = "settings-defaults-aws-k8s-1_36-nvidia-595"

Étape 7 : Enregistrer la variante

Enregistrez la nouvelle variante dans cinq fichiers :

1. Cargo.toml— ajoutez le membre de l'espace de travail :

 "variants/aws-k8s-1.36-nvidia",
+    "variants/aws-k8s-1.36-nvidia-595",
 "variants/aws-k8s-1.36-nvidia-fips",

2. sources/Cargo.toml— ajoute le membre settings-defaults :

 "settings-defaults/aws-k8s-1.36-nvidia",
+    "settings-defaults/aws-k8s-1.36-nvidia-595",

3. packages/settings-defaults/settings-defaults.spec— ajoute un %package bloc, des entrées dans les deux boucles de construction et une %files section :

%package aws-k8s-1.36-nvidia-595
Summary: Settings defaults for the aws-k8s 1.36 nvidia-595 variant
Requires: %{_cross_os}variant(aws-k8s-1.36-nvidia-595)
Provides: %{_cross_os}settings-defaults(any)
Provides: %{_cross_os}settings-defaults(aws-k8s-1.36-nvidia-595)
Conflicts: %{_cross_os}settings-defaults(any)

%description aws-k8s-1.36-nvidia-595
%{summary}.

Ajoutez aux deux for defaults in boucles :

    aws-k8s-1.36-nvidia \
+   aws-k8s-1.36-nvidia-595 \
    metal-dev \

Ajoutez la %files section :

%files aws-k8s-1.36-nvidia-595
%{_cross_defaultsdir}/aws-k8s-1.36-nvidia-595.toml
%{_cross_tmpfilesdir}/storewolf-defaults-aws-k8s-1.36-nvidia-595.conf

4. packages/settings-plugins/settings-plugins.spec— ajoute une Provides: ligne sous %package aws-k8s-nvidia :

 Provides: %{_cross_os}settings-plugin(aws-k8s-1.36-nvidia)
+Provides: %{_cross_os}settings-plugin(aws-k8s-1.36-nvidia-595)
 Conflicts: %{_cross_os}settings-plugin(any)

Étape 8 : Actualiser le fichier de verrouillage

L'ajout d'un membre de l'espace de travail est invalidesources/Cargo.lock. Rafraîchissez-le :

cd ~/bottlerocket/sources
cargo update --workspace

Étape 9 : Création du fichier de licence NVIDIA

NVIDIA restreint la redistribution des sources de pilotes. Vous devez ajouter un accusé de réception de licence explicite avant de créer :

cat > ~/bottlerocket/Licenses.toml <<'EOF'
[nvidia]
spdx-id = "LicensesRef-NVIDIA-Customer-Use"
licenses = [
  { path = "LICENSE", license-url = "https://www.nvidia.com/en-us/drivers/nvidia-license/" }
]
EOF

Étape 10 : créer et publier l'AMI

Créez une Infra.toml annonce avec vos régions cibles :

cat > ~/bottlerocket/Infra.toml <<'EOF'
[aws]
regions = ["us-west-2", "us-east-1", "us-east-2"]
EOF

Créez l'image :

cd ~/bottlerocket
cargo make \
  -e BUILDSYS_VARIANT=aws-k8s-1.36-nvidia-595 \
  -e BUILDSYS_UPSTREAM_SOURCE_FALLBACK=true \
  -e BUILDSYS_UPSTREAM_LICENSE_FETCH=true \
  -e BUILDSYS_JOBS=32

La première version extrait le SDK et les images du kit (environ 2 Go au total). Les builds suivants prennent de 3 à 5 minutes sur un hôte à 32 cœurs.

Publiez l'AMI :

cargo make \
  -e BUILDSYS_VARIANT=aws-k8s-1.36-nvidia-595 \
  -e PUBLISH_REGIONS=us-west-2,us-east-1,us-east-2 \
  ami

Le build écrit des identifiants d'AMI dansbuild/images/x86_64-aws-k8s-1.36-nvidia-595/latest/*-amis.json. Utilisez-les dans vos groupes de nœuds gérés par EKS, dans Karpenter EC2NodeClass ou dans vos modèles de lancement.

Autres combinaisons que vous pouvez créer

Cette procédure pas à pas remplace la branche du pilote NVIDIA, mais vous pouvez utiliser la même approche pour tous les packages disponibles dans les kits en amont. Les exemples suivants montrent ce que vous pouvez assembler sans avoir à bifurquer un kit :

Pour plus d'informations sur les packages disponibles, consultez le kit de noyau sur le GitHub site Web et le kit de base sur le site Web. GitHub

Nettoyage

Si vous n'avez plus besoin de l'hôte de build, mettez fin à l'instance EC2 pour éviter des frais récurrents. Les AMI sont conservées indépendamment dans votre compte ; désenregistrez-les avec la console EC2 ou la CLI si vous n'en avez plus besoin.

Résumé

Cette rubrique explique comment créer une variante personnalisée de Bottlerocket avec une branche de pilote NVIDIA différente. Le processus consiste à copier une variante existante, à modifier une référence de package, à enregistrer la nouvelle variante dans l'espace de travail et dans les spécifications RPM, puis à exécuter le build. La même approche s'applique à toute personnalisation : échange de versions du noyau, ajout de packages ou création de variantes pour les nouvelles versions de Kubernetes.