5.2. Flux de travail pour les déploiements non basés sur un réseau
Pour créer une image ISO de démarrage qui installe un système basé sur OSTree à l'aide des images "RHEL for Edge Container" et "RHEL for Edge Installer" et qui peut être déployée ultérieurement sur un périphérique dans des environnements déconnectés, procédez comme suit.
5.2.1. Création d'un modèle de conteneur RHEL for Edge à l'aide de l'interface CLI de construction d'images
Pour créer un modèle d'image RHEL for Edge Container, procédez comme suit :
Procédure
Créez un fichier texte au format TOML, avec le contenu suivant :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow name = "blueprint-name" description = "blueprint-text-description" version = "0.0.1" modules = [ ] groups = [ ]
name = "blueprint-name" description = "blueprint-text-description" version = "0.0.1" modules = [ ] groups = [ ]
Où ?
- blueprint-name est le nom et blueprint-text-description est la description de votre plan.
- 0.0.1 est le numéro de version selon le schéma de versionnement sémantique.
Modules décrivent le nom du paquet et la version correspondante à installer dans l'image. Par exemple, le nom du paquet = "tmux" et la version correspondante est version = "2.9a".
Notez qu'il n'y a actuellement aucune différence entre les paquets et les modules.
Groups sont des groupes de paquets à installer dans l'image, par exemple le groupe de paquets anaconda-tools.
A ce stade, si vous ne connaissez pas les modules et les groupes, laissez-les vides.
Incluez les paquets requis et adaptez les autres détails du plan à vos besoins.
Pour chaque paquet que vous souhaitez inclure dans le plan, ajoutez les lignes suivantes au fichier :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow [[packages]] name = "package-name" version = "package-version"
[[packages]] name = "package-name" version = "package-version"
Où ?
- package-name est le nom du paquet, tel que httpd, gdb-doc, ou coreutils.
package-version est le numéro de version du paquet que vous souhaitez utiliser.
La version du paquet prend en charge les spécifications de version dnf suivantes :
- Pour une version spécifique, utilisez le numéro de version exact, par exemple 9.0.
- Pour la dernière version disponible, utilisez l'astérisque *.
- Pour la dernière version mineure, utilisez des formats tels que 9.*.
Pousser (importer) le plan vers le serveur de construction d'images :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints push blueprint-name.toml
# composer-cli blueprints push blueprint-name.toml
Liste les plans existants pour vérifier si le plan créé a été poussé avec succès et s'il existe.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints show BLUEPRINT-NAME
# composer-cli blueprints show BLUEPRINT-NAME
Vérifiez si les composants et les versions répertoriés dans le plan et leurs dépendances sont valides :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints depsolve blueprint-name
# composer-cli blueprints depsolve blueprint-name
Ressources supplémentaires
5.2.2. Création d'un plan d'installation de RHEL for Edge à l'aide de l'interface CLI de construction d'images
Vous pouvez créer un modèle pour construire une image RHEL for Edge Installer (.iso)
et spécifier des comptes utilisateur pour créer automatiquement un ou plusieurs utilisateurs sur le système au moment de l'installation. Voir Création d'un compte d'utilisateur administratif pour un modèle d'image RHEL for Edge. Il crée un utilisateur sur le système au moment de l'installation.
Lorsque vous créez un utilisateur dans le plan avec la personnalisation customizations.user
, le plan crée l'utilisateur dans le répertoire /usr/lib/passwd
et le mot de passe dans le répertoire /usr/etc/shadow
. Notez que vous ne pouvez pas modifier le mot de passe dans les versions ultérieures de l'image dans un système en cours d'exécution utilisant les mises à jour OSTree
. Les utilisateurs que vous créez avec les blueprints ne doivent être utilisés que pour accéder au système créé. Après avoir accédé au système, vous devez créer des utilisateurs, par exemple à l'aide de la commande useradd
.
Pour créer un modèle d'image pour RHEL for Edge Installer, procédez comme suit :
Procédure
Créez un fichier texte au format TOML, avec le contenu suivant :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow name = "blueprint-installer" description = "blueprint-for-installer-image" version = "0.0.1" [[customizations.user]] name = "user" description = "account" password = "user-password" key = "user-ssh-key " home = "path" groups = ["user-groups"]
name = "blueprint-installer" description = "blueprint-for-installer-image" version = "0.0.1" [[customizations.user]] name = "user" description = "account" password = "user-password" key = "user-ssh-key " home = "path" groups = ["user-groups"]
Où ?
- blueprint-name est le nom et blueprint-text-description est la description de votre plan.
- 0.0.1 est le numéro de version selon le schéma de versionnement sémantique.
Pousser (importer) le plan vers le serveur de construction d'images :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints push blueprint-name.toml
# composer-cli blueprints push blueprint-name.toml
Liste les plans existants pour vérifier si le plan créé a été poussé avec succès et s'il existe.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints show blueprint-name
# composer-cli blueprints show blueprint-name
Vérifiez si les composants et les versions répertoriés dans le plan et leurs dépendances sont valides :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli blueprints depsolve blueprint-name
# composer-cli blueprints depsolve blueprint-name
Ressources supplémentaires
5.2.3. Création d'une image de conteneur RHEL for Edge à l'aide de l'interface CLI de construction d'images
Pour créer une image RHEL for Edge Container à l'aide de l'interface de ligne de commande image builder, assurez-vous d'avoir rempli les conditions préalables suivantes et suivez la procédure.
Conditions préalables
- Vous avez créé un schéma directeur pour l'image RHEL for Edge Container.
Procédure
Créez l'image RHEL for Edge Container.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose start-ostree --ref rhel/9/x86_64/edge --url URL-OSTree-repository blueprint-name image-type
# composer-cli compose start-ostree --ref rhel/9/x86_64/edge --url URL-OSTree-repository blueprint-name image-type
Où ?
-
--ref
est la même valeur que celle utilisée par le client pour construire le dépôt d'ostree --url
est l'URL du dépôt OSTree de l'engagement à intégrer dans l'image. Par exemple, http://10.0.2.2:8080/repo/. Par défaut, le dossier de dépôt d'une image RHEL for Edge Container est "/repo". Voir Configuration d'un serveur Web pour l'installation de l'image RHEL for Edge.Pour trouver l'URL correcte à utiliser, accédez au conteneur en cours d'exécution et vérifiez le fichier
nginx.conf
. Pour savoir quelle URL utiliser, accédez au conteneur en cours d'exécution et consultez le fichiernginx.conf
. Dans le fichiernginx.conf
, trouvez l'entrée du répertoireroot
pour rechercher les informations du dossier/repo/
. Notez que si vous ne spécifiez pas d'URL de référentiel lors de la création d'une image RHEL for Edge Container(.tar)
à l'aide de Image Builder, l'entrée/repo/
par défaut est créée dans le fichiernginx.conf
.- blueprint-name est le nom du plan RHEL for Edge.
image-type est
edge-container
pour non-network-based deployment.Une confirmation de l'ajout du processus de composition à la file d'attente s'affiche. Elle indique également un numéro d'identifiant universel unique (UUID) pour l'image créée. Utilisez le numéro UUID pour suivre votre construction. Conservez également le numéro UUID à portée de main pour d'autres tâches.
-
Vérifier l'état de la composition de l'image.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose status
# composer-cli compose status
La sortie affiche l'état dans le format suivant :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <UUID> RUNNING date blueprint-name blueprint-version image-type
<UUID> RUNNING date blueprint-name blueprint-version image-type
NoteLe processus de création d'une image dure jusqu'à 20 minutes.
Pour interrompre le processus de création d'image, exécutez :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli composer cancel <UUID>
# composer-cli composer cancel <UUID>
Pour supprimer une image existante, exécutez :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli composer delete <UUID>
# composer-cli composer delete <UUID>
Une fois l'image prête, elle peut être utilisée pour non-network deployments. Voir Création d'une image RHEL for Edge Container pour les déploiements non basés sur le réseau.
Ressources supplémentaires
5.2.4. Création d'une image RHEL for Edge Installer à l'aide de l'interface de ligne de commande pour les déploiements non basés sur le réseau
Pour créer une image RHEL for Edge Installer qui intègre le commit OSTree
, à l'aide de l'interface de ligne de commande image builder, assurez-vous d'avoir rempli les conditions préalables suivantes, puis suivez la procédure.
Conditions préalables
- Vous avez créé un schéma directeur pour RHEL pour l'image Edge Installer.
- Vous avez créé une image RHEL for Edge Edge Container et l'avez déployée à l'aide d'un serveur web.
Procédure
Commencez à créer l'image RHEL for Edge Installer.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose start-ostree --ref rhel/9/x86_64/edge --url URL-OSTree-repository blueprint-name image-type
# composer-cli compose start-ostree --ref rhel/9/x86_64/edge --url URL-OSTree-repository blueprint-name image-type
Où ?
- ref est la même valeur que celle utilisée par le client pour construire le dépôt d'ostree
- URL-OSTree-repository est l'URL du dépôt OSTree de l'engagement à intégrer dans l'image. Par exemple, http://10.0.2.2:8080/repo. Voir Création d'une image RHEL for Edge Container pour les déploiements non basés sur le réseau.
- blueprint-name est le nom du modèle RHEL for Edge Installer.
image-type est
edge-installer
.Une confirmation de l'ajout du processus de composition à la file d'attente s'affiche. Elle indique également un numéro d'identifiant universel unique (UUID) pour l'image créée. Utilisez le numéro UUID pour suivre votre construction. Conservez également le numéro UUID à portée de main pour d'autres tâches.
Vérifier l'état de la composition de l'image.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose status
# composer-cli compose status
La sortie de la commande affiche l'état dans le format suivant :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <UUID> RUNNING date blueprint-name blueprint-version image-type
<UUID> RUNNING date blueprint-name blueprint-version image-type
NoteLe processus de création de l'image prend quelques minutes.
Pour interrompre le processus de création d'image, exécutez :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli composer cancel <UUID>
# composer-cli composer cancel <UUID>
Pour supprimer une image existante, exécutez :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli composer delete <UUID>
# composer-cli composer delete <UUID>
Une fois l'image prête, vous pouvez l'utiliser pour non-network deployments. Voir Installation de l'image RHEL for Edge pour les déploiements non basés sur le réseau.
5.2.5. Téléchargement d'une image RHEL for Edge Installer à l'aide de l'interface CLI de construction d'images
Pour télécharger une image RHEL for Edge Installer à l'aide de l'interface de ligne de commande image builder, assurez-vous d'avoir rempli les conditions préalables suivantes, puis suivez la procédure.
Conditions préalables
- Vous avez créé une image RHEL for Edge Installer.
Procédure
Examinez l'état de l'image RHEL for Edge.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose status
# composer-cli compose status
La sortie doit afficher ce qui suit :
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <UUID> FINIS date blueprint-name blueprint-version image-type
$ <UUID> FINIS date blueprint-name blueprint-version image-type
Télécharger l'image.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow composer-cli compose image <UUID>
# composer-cli compose image <UUID>
Image builder télécharge l'image sous forme de fichier
.iso
dans le répertoire actuel.Le numéro UUID et la taille de l'image s'affichent à côté.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow <UUID>-boot.iso : size MB
$ <UUID>-boot.iso : size MB
L'image obtenue est une image ISO amorçable.
Ressources supplémentaires