Synopsis

multistrap [-a ARCH] [-d RÉPERTOIRE] -f FICHIER_CONFIG multistrap [--simulate] -f FICHIER_CONFIG multistrap -?|-h|--help|--version

Options

-?|-h|--help|--version - afficher le texte d'aide et quitter correctement.

--dry-run - examiner tous les paramètres de configuration et afficher un bref sommaire.

--simulate - identique à --dry-run

(Les options suivantes peuvent également être définies dans le fichier de configuration.)

-a|--arch - architecture des paquets à insérer dans le multistrap.

-d|--dir - répertoire dans lequel le bootstrap sera installé.

-f|--file - fichier de configuration pour multistrap [requis]

-s|--shortcut - version raccourcie de -f pour les fichiers dans des endroits connus.

--tidy-up - supprimer les données du cache d'apt, les fichiers Packages téléchargés et le cache des paquets apt. Identique à cleanup=true.

--no-auth - autoriser l'utilisation de dépôts non authentifiés. Identique à noauth=true

--source-dir RÉP - déplacer le contenu de var/cache/apt/archives/ de l'intérieur du chroot vers le répertoire extérieur spécifié, puis ajouter les sources des paquets Debian pour chaque binaire utilisé. Identique à retainsources=RÉP. Si le répertoire indiqué n'existe pas, rien ne sera fait. --tidy-up est requis pour calculer la liste complète des paquets source en incluant les dépendances.

Description

multistrap fournit une méthode semblable à debootstrap, basée sur apt et permettant la gestion de dépôts multiples, en utilisant un fichier de configuration pour indiquer les versions de distribution, l'architecture, les paquets supplémentaires et le miroir à utiliser pour chaque bootstrap.

Le but est de créer un système de fichiers racine / bootstrap complet avec tous les paquets installés et configurés, plutôt que de créer uniquement le système de base.

Dans la plupart des cas, les utilisateurs devront créer un fichier de configuration pour chaque utilisation différente de multistrap.

Exemple de configuration :

[General]
 arch=armel
 directory=/opt/multistrap/
 # identique à l'option --tidy-up si définie à vrai
 cleanup=true
 # identique à l'option --no-auth si définie à vrai
 # les paquets « keyring » indiqués dans chaque bootstrap seront
 # toujours installés.
 noauth=false
 # extraire toutes les archives téléchargées (vrai par défaut)
 unpack=true
 # ajouter ou non la /suite pour rendre explicite l'endroit où apt
 # doit chercher les paquets. (faux par défaut)
 explicitsuite=false
 # activer MultiArch pour les architectures indiquées
 # vide par défaut
 # aptsources est une liste de sections à utiliser
 # le fichier /etc/apt/sources.list.d/multistrap.sources.list
 # de la cible. L'ordre n'est pas important
 aptsources=Debian
 # l'option bootstrap détermine quel dépôt
 # est utilisé pour calculer la liste des priorités : paquets nécessaires
 # et quels paquets vont dans le système de fichiers racine (rootfs).
 # L'ordre des sections n'est pas important
 bootstrap=Debian

 [Debian]
 packages=
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=jessie

This will result in a completely normal bootstrap of Debian Jessie from the specified mirror, for armel in '/opt/multistrap/'. (This configuration is retained in the package as /usr/share/multistrap/jessie.conf)

Indiquez un paquet pour étendre le multistrap afin d'inclure ce paquet et toutes les dépendances de ce paquet.

Indiquez des dépôts supplémentaires pour le bootstrap en ajoutant de nouvelles sections. Les noms de sections doivent figurer dans les options générales de boostrap pour les paquets à inclure dans le bootstrap.

Veuillez indiquer quels dépôts seront disponibles pour le système final lors du boot, en indiquant les noms de section dans les options générales de aptsource, par exemple pour exclure des sources internes ou quand vous utilisez un mirroir local pour compiler le système de fichiers racine.

La casse des lettres n'est pas importante dans les noms de section.

Toutes les dépendances sont résolues uniquement par apt, en utilisant tous les dépôts bootstrap, pour utiliser uniquement les dépendances les plus récentes et les plus appropriées. Notez que multistrap désactive Install-Recommands. Si le multistrap a besoin d'un paquet qui est seulement recommandé, ce paquet devra donc être indiqué explicitement à la ligne des paquets. Voir "Spécifications explicites des versions de distributions" pour obtenir plus d'informations sur la façon d'obtenir des paquets spécifiques depuis des versions de distribution spécifiques.

« arch » et « directory » peuvent être outrepassés en ligne de commande. D'autres options générales peuvent aussi être indiquées en ligne de commande.

Online examples and documentation

"multistrap" supports a range of permutations, see the wiki and the emdebian website for more information and example configurations:

http://wiki.debian.org/Multistrap

http://www.emdebian.org/multistrap/

"multistrap" includes an example configuration file with a full list of all supported config file options: /usr/share/doc/multistrap/examples/full.conf

Raccourcis

De la même manière que "debootstrap", "multistrap" gère la référence à des fichiers de configuration à des endroits connus par des raccourcis. Quand l'option "--shortcut" est utilisée, "multistrap" cherchera des fichiers dans /usr/share/multistrap puis dans /etc/multistrap.d/, ajoutant un suffixe « .conf » au raccourci indiqué.

Ces deux commandes sont équivalentes :

 $ sudo multistrap -s sid
 $ sudo multistrap -f /usr/share/multistrap/sid.conf

Veuillez noter que "multistrap" échouera à chaque fois si le fichier de configuration lui même n'indique pas le répertoire ou l'architecture.

Dépôts

"aptsources" liste les sections qui devraient être utilisées pour créer les /etc/apt/sources.list.d/multistrap.list sources apt du système final. Tous les "aptsources" ne doivent pas obligatoirement apparaître dans la section "bootstrap" s'il y a des sources internes ou locales inaccessibles par le système de fichiers racine installé.

"bootstrap" liste les sections qui seront utilisées pour créer le multistrap lui-même. Seuls les paquets indiqués dans "bootstrap" seront téléchargés et dépaquetés par multistrap.

Il faut s'assurer que "bootstrap" liste toutes les sections nécessaires afin que apt puisse trouver tous les paquets devant être dépaquetés pour le multistrap.

(Les anciennes versions de multistrap utilisaient la même option sous le nom "debootstrap" - cette écriture est toujours possible mais les nouveaux fichiers de configuration devraient plutôt être "bootstrap".

Paramètres généraux :

« arch » peut être outrepassé en ligne de commande en utilisant l'option "--arch".

« directory » indique le répertoire au sommet de l'arborescence dans lequel le debootstrap sera créé - il n'est pas empaqueté en un .tgz une fois terminé.

« bootstrap » liste les sections qui seront utilisées pour indiquer les paquets qui seront téléchargés (et éventuellement dépaquetés) dans le bootstrap.

« aptsources » liste les Sections qui seront utilisées pour indiquer les sources d'apt dans le système final. Par exemple, si vous avez besoin d'un miroir local pour générer le système de fichiers racine qui ne sera pas disponible au démarrage, indiquez cette section dans "bootstrap" et pas dans "aptsources".

Si vous souhaitez qu'un paquet soit dans le système de fichiers racine, il doit être indiqué dans la liste de "bootstrap" sous Général.

L'ordre des noms de section n'est pas important quelle que soit la liste.

If "markauto" is set to true, "multistrap" will request apt to mark all packages specified in the combined "packages" list as manually installed and all dependencies not explicitly listed as automatically installed in the APT extended state database. "markauto" can be used independently of "unpack".

Comme pour debootstrap, multistrap continuera après des erreurs aussi longtemps que le fichier de configuration peut être correctement interprété.

multistrap implémente également la gestion des variantes machines utilisée initialement dans Emdebian Crush, bien que l'implémentation soit différente. Utiliser la gestion de configuration en cascade (« cascading configuration ») permet des combinaisons de variantes machines spécifiques gérées par de simples changements sur la ligne de commande.

Définir "tarballname" à vraie empaquette également le système de fichiers final dans un tarball.

Veuillez noter que multistrap ne tient pas compte des options non reconnues dans le fichier de configuration - cela permet de garder une rétrocompatibilité ainsi que de surcharger les fichiers de configuration de multistrap pour gérer d'autres outils (comme pbuilder). Utilisez l'option "--simulate" pour voir les différentes combinaisons de paramètres.

Néanmoins, si le fichier de configuration ne peut être lu, multistrap abandonnera. Vérifiez que le fichier de configuration possède une clé et une valeur pour chaque ligne, en dehors des commentaires. Les valeurs doivent toutes se trouver sur la même ligne que la clé.

Paramètres de la section

 [Debian]
 packages=
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=jessie

Le nom de section (entre [] crochets) doit être unique pour ce fichier de configuration et tous les fichiers de configuration que ce fichier comporte. Les noms de section ne sont pas sensibles à la casse (toutes les comparaisons sont faites après la conversion en minuscules).

« packages » est la liste des paquets devant être ajoutés quand la Section est indiquée dans "bootstrap" — tous les noms de paquets doivent être indiqués sur une seule ligne ou le fichier ne pourra être lu. Une alternative consiste à définir votre liste de paquets en groupes multiples avec les paquets séparés selon une base de dépendances fonctionnelles, comme Xorg, networking, etc. et indiqué chaque groupe sous « bootstrap ».

 bootstrap=base networking
 [base]
 packages=udev mtd-utils
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie
 [networking]
 packages=netbase ifupdown iproute net-tools samba
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie

Exceptionnellement, "multistrap" prend aussi en charge plusieurs clés pour les paquets, chacune sur une ligne. Les autres clés ne peuvent être définies de la même manière.

 [Emdebian]
 packages=udev mtd-utils netbase ifupdown iproute
 packages=busybox net-tools samba
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie

« source » est la source apt à utiliser pour cette Section. Pour utiliser une source locale sur la même machine, assurez-vous d'utiliser "copy://" et pas "file://", de manière à dire à apt de copier les paquets dans le système de fichiers racine plutôt que d'essayer de les télécharger plus tard - parce que ce « plus tard » n'arrivera certainement jamais.

« keyring » liste les paquets qui contiennent la clé utilisée par la source indiquée dans la Section. Si aucune clé n'est indiquée, l'option "noauth" doit être mise à actif. Voir Securiser Apt.

« suite » est la suite à utiliser depuis cette source. Veuillez noter qu'il s'agit de la suite et non du nom de code.

Suites change from time to time: (oldstable, stable, testing, sid) The codename (squeeze, wheezy, jessie, sid) does not change.

Apt sécurisé

Pour utiliser des dépôts apt signés, multistrap doit pouvoir installer un paquet trousseau adéquat à partir des sources apt existantes en dehors de l'environnement multistrap, dans le système de destination. Malheureusement, les paquets de trousseau ne peuvent pas être téléchargés depuis les dépôts indiqués dans la configuration multistrap — ceci parce que "apt" nécessite que le trousseau soit mis à jour avant de pouvoir utiliser des dépôts non connus précédemment.

Si ces paquets existent, indiquez-les dans l'option « keyring » pour chaque dépôt. multistrap vérifiera alors que apt a déjà installé ce paquet : ainsi le dépôt pourra être authentifié avant de télécharger des paquets.

Notez que tous les dépôts devant être utilisés avec multistrap doivent être authentifiés sinon apt échouera. De même, la sécurisation d'apt ne peut être désactivée que pour tous les dépôts (en utilisant l'option --no-auth en ligne de commande ou en définissant l'option générale noauth dans le fichier de configuration), même s'il n'existe qu'un seul dépôt sans trousseau de clés convenable.

Les paquets de trousseau de clés seront également installés à l'intérieur de l'environnement du multistrap pour correspondre avec les sources apt installées pour le multistrap.

État

multistrap est sans-état - si le répertoire existe, il procédera tout simplement de manière ordinaire et apt essaiera de reprendre là où il s'était arrêté.

Configuration du système de fichiers racine

multistrap décompresse les paquets téléchargés, mais d'autres étapes de la configuration du système ne sont pas tentées. Par exemple :

 /etc/inittab
 /etc/fstab
 /etc/hosts
 /etc/securetty
 /etc/modules
 /etc/hostname
 /etc/network/interfaces
 /etc/init.d
 /etc/dhcp3

Tous les noeuds de périphériques doivent également être créés avec MAKEDEV ou "device-table.pl" - un script d'aide pouvant résoudre certains problèmes de MAKEDEV. device-table.pl nécessite un fichier contenant une table de périphériques suivant les lignes de celui contenu dans les sources du paquet mtd-utils. Voir /usr/share/doc/multistrap/examples/device_table.txt

Une fois que multistrap a réussi à créer la structure de base pour les fichiers et les répertoires, d'autres scripts spécifiques aux périphériques sont nécessaires avant que le système de fichiers puisse être installé sur le périphérique cible.

Une fois installés, les paquets doivent eux-mêmes être configurés en utilisant les scripts du responsable du paquet et "dpkg --configure -a", à moins qu'il ne s'agisse d'un multistrap natif.

Pour que "dpkg" puisse fonctionner, /proc et /sysfs doivent être montés (ou être montables), /dev/pts est également recommandé.

Voir aussi : http://wiki.debian.org/Multistrap

Environnement

Pour configurer les paquets dépaquetés (que ce soit en mode croisé ou natif), certaines variables d'environnement sont nécessaires :

Il est nécessaire de signaler à Debconf que l'interaction utilisateur n'est pas souhaitée :

 DEBIAN_FRONTEND=noninteractif DEBCONF_NONINTERACTIVE_SEEN=true

Il est nécessaire de signaler à Perl qu'aucune locale n'est disponible l'intérieur du chroot et de ne pas se plaindre :

 LC_ALL=C LANGUAGE=C LANG=C

Puis, dpkg peut configurer les paquets :

méthode chroot (PATH = le répertoire de base du chroot) :

 DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true \
 LC_ALL=C LANGUAGE=C LANG=C chroot /PATH/ dpkg --configure -a

dans un interpréteur de commandes de connexion :

 # export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 # export LC_ALL=C LANGUAGE=C LANG=C 
 # dpkg --configure -a

(Comme ci-dessus, dpkg a besoin que /proc et /sysfs soient montés en premier.)

mode natif - multistrap

multistrap n'était pas prévu pour le mode natif, il fut développé pour la gestion de plusieurs architectures. Pour que de multiples dépôts puissent être utilisés, multistrap dépaquette uniquement les paquets sélectionnés par apt.

En mode natif, diverses opérations post-multistrap que debootstrap ferait pour vous sont probablement nécessaires :

 1. copiez /etc/hosts dans le chroot
 2. nettoyez l'environnement pour détruire LANGUAGE, LC_ALL and LANG
    pour passer sous silence les nuisances des avertissements cachant d'autres erreurs

(Une alternative pour détruire les variables de localisation est d'ajouter locales à votre fichier de configuration multistrap dans l'option « paquets ».

Un multistrap natif peut être directement utilisé avec chroot, ainsi "multistrap" exécute "dpkg --configure -a" à la fin du processus du multistrap à moins que l'option ignorenativearch soit réglée sur true dans la section General du fichier de configuration.

Démons dans les chroots

En fonction du système que vous utilisez pour fournir les paquets pour "multistrap", les chroots natifs n'autorisent généralement pas les démons à démarrer au sein du chroot. Utilisez le /usr/share/multistrap/chroot.sh comme votre "setupscript" ou incluez ce script dans votre propre script d'installation.

 setupscript=/usr/share/multistrap/chroot.sh

chroot.sh sait fonctionner avec les systèmes utilisant sysvinit et upstart.

Voir également

 http://people.debian.org/~hmh/invokerc.d-policyrc.d-specification.txt

Configuration en cascade

Pour assurer les multiples variantes d'une configuration de base, "multistrap" permet d'inclure des fichiers de configuration (plus généraux) dans des fichiers de configuration : le fichier de configuration le plus spécifique ou détaillé doit être indiqué à la ligne de commande et ce fichier inclut un fichier qui est partagé avec d'autres configurations.

Fichier de base :

 /usr/share/multistrap/crosschroot.conf

Variations :

 /usr/share/multistrap/armel.conf

En indiquant uniquement le fichier armel.conf, le reste des paramètres sera obtenu à partir du fichier crosschroot.conf afin que les modifications communes ne doivent être réalisées que dans un seul fichier.

Il est fortement recommandé pour toutes modifications dans les fichiers de configuration impliqués dans n'importe quelle cascade de les tester avec l'option "--simulate" de multistrap qui produira en sortie un résumé des options définies une fois la cascade effectuée. Il faut noter que multistrap n'avertit pas si un fichier de configuration contient une option non reconnue (afin d'assurer la compatibilité future avec les configurations rétroportées). Ainsi une simple faute de frappe peut être à l'origine d'une option non définie.

Gestion des variantes de Machines

Toutes les anciennes variables de packages.conf de emsandbox peuvent être converties en variables de configuration "mulistrap". L'assistance des variantes machines dans "multistrap" se concentre sur les scripts, config.sh et setup.sh

Remarque : la prise nen charge de machine:variant sera vraisemblablement remplacée par le déclencheur décrit ci-dessous

Une fois que "multistrap" a dépaqueté les paquets téléchargés, "setup.sh" peut être appelé, en passant l'emplacement et l'architecture du système de fichiers racine, pour que d'autre réglages fins puissent être effectués. À cette étape, aucune opération à l'intérieur d'un système de fichiers racine étranger (rootfs) ne doit tenter d'exécuter de binaires dans le rootfs. À la dernière étape du processus multistrap, "config.sh" est copié vers le répertoire root du système de fichiers racine.

Un des avantages d'utiliser la gestion des variantes machines est que la totalité du système de fichiers racine peut être gérée par un seul appel à multistrap - ceci est utile lors de la création de systèmes de fichiers racines dans l'espace utilisateur.

Pour activer les variantes machines, il faut indiquer le chemin vers les scripts devant être appelés dans le fichier de configuration variant (Section Générale) :

 [General]
 include=/chemin/vers/general.conf
 setupscript=/chemin/vers/setup.sh
 configscript=/chemin/vers/config.sh

Ensure that both the setupscript and the configscript are executable or "multistrap" will ignore the script.

Example configscript.sh

 #!/bin/sh
 
 set -e
 
 export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 export LC_ALL=C LANGUAGE=C LANG=C
 /var/lib/dpkg/info/dash.preinst install
 dpkg --configure -a
 mount proc -t proc /proc
 dpkg --configure -a
 umount /proc

For more information, see the Wiki: http://wiki.debian.org/Multistrap

Mounting /dev and /proc for chroot configuration

/proc can be mounted inside the chroot, as above:

 mount proc -t proc /proc

However, /dev should be mounted from outside the chroot, before running any "configscript.sh" in the chroot:

 cd /path/chroot/
 sudo tar -xzf /path/multistrap.tgz
 sudo mount /dev -o bind ./dev/
 sudo chroot . ./configscript.sh || true

Restriction de la sélection des paquets

"multistrap" inclut les paquets requis par défaut, la liste actuelle des paquets sur votre machine personnelle peut être visualisée en utilisant :

 grep-available  -FPriority 'required' -sPackage

(La véritable liste est calculée à partir des paquets téléchargés et peut différer de la sortie de "grep-available".)

Si l'option OmitRequired est définie à vrai, ces paquets ne seront pas ajoutés - bien qu'utile, cette option peut facilement conduire à un rootfs inutilisable. Seuls les paquets indiqués manuellement dans les fichiers de configuration seront utilisés dans les calculs - les dépendances de ces paquets seront également ajoutées mais aucun autre.

Ajout des paquet de priorité « important »

"multistrap" peut imiter "debootstrap" en ajoutant automatiquement tous les paquets depuis toutes les sections où le fichier des paquets téléchargés indique les paquets de priorité « important ». Le comportement par défaut est de ne pas ajouter de tels paquets tant qu'ils ne sont pas individuellement inclus dans une option "packages=", dans une section indiquée dans les options générales de "bootstrap". Pour ajouter tous ces paquets, réglez l'option addimportant sur vrai dans la section générale.

 addimportant=true

La priorité « important  ne peut être appliquée qu'aux sections indiquées dans l'option de "bootstrap". Cela pourrait entraîner de la confusion lors de mélanges de suites.

Il n'est pas possible d'activer addimportant et omitrequired dans la même configuration. "multistrap" s'arrêtera avec le code d'erreur 7 s'il est trouvé dans n'importe quelle configuration les options addimportant et omitrequired réglées sur vrai. (Ceci inclut les effets dûs à l'inclusion d'autres fichiers de configuration.)

Comportements recommandés

Après la version Lenny, le comportement par défaut de Debian était de prendre en compte les paquets recommandés comme des paquets supplémentaires quant au moins un paquet était sélectionné. Les paquets recommandés sont ceux que le mainteneur considère comme devant être présents dans la "plupart" des installations de ce paquet et autoriser les paquets recommandés signifie autoriser les recommandés des paquets eux-mêmes recommandés et ainsi de suite.

Le comportement par défaut de multistrap est de désactiver les paquets recommandés.

Placez l'option allowrecommands (autoriser les paquets suggérés) à true (oui) dans la section générale pour utiliser ce comportement usuel de Debian.

Default release

"multistrap" supports an option to explicitly set the default release to use with apt: "aptdefaultrelease". This determines which release apt will use for the base system packages and is not the same as pinning (which relates to the use of apt after installation). Multistrap sets the default-release to the wildcard * unless a release is named in the "aptdefaultrelease" field. Any release specified here must also be defined in a stanza referenced in the bootstrap list or apt will fail.

To install a specific version of a package from a newer release than the one specified as default, "explicitsuite" must also be set to true if the package exists at any version in the default release. Also, any packages upon which that package has a strict dependency (i.e. = rather than >=) must also be explicitly added to the packages line in the stanza for the desired version, even though that package does not need to be listed to get it from the default release. This is typical apt behaviour and is not a bug in multistrap.

The combination of default release, explicit suite and apt preferences can quickly become complex and bugs can be very hard to identify. "multistrap" always outputs the complete apt command line, so test this command yourself (using the files written out by "multistrap") to see what is going on. Remember that all dependency resolution and all the logic to determine which version of a specific package gets installed in your "multistrap" chroot is entirely down to apt and all "multistrap" can do is pass files and command line options to apt.

See also: apt preferences.

Spécification claire de la version de la distribution

Quelque fois, il faut dire explicitement à apt d'aller prendre un paquet en particulier depuis une version spécifique, en ignorant une version plus récente d'une autre version de la distribution dans la même liste de sources.

"multistrap" peut fonctionner avec et sans la spécification explicite de la version de la distribution, le paramètre par défaut est de laisser apt utiliser la version la plus récente du catalogue des sources bootstrap indiquées.

La spécification d'une version de distribution n'a pas d'effet sur le système final installé - si vos sources apt incluent un dépôt disposant d'une nouvelle version du paquet explicitement indiqué, le prochain "apt-get upgrade" sur la machine installera la nouvelle version.

De même, quand vous indiquez des paquets à prendre depuis une version spécifique de la distribution, apt essaie de s'assurer que les dépendances pour ce paquet viennent également de cette même version, ce qui peut occasionner des problèmes à apt pour résoudre l'ensemble de ces dépendances. Dans ce cas, indiquer explicitement un paquet peut entrainer le fait d'indiquer quelques (pas nécessairement toutes) dépendances de ce paquet également.

Lors de l'utilisation de suite explicite, assurez-vous d'utiliser stable-proposed-updates ou d'autres emplacements temporaires - si le paquet migre dans une autre suite et est supprimé de la suite temporaire (comme avec *-proposed-updates), multistrap ne pourra pas trouver le paquet.

La manipulation de suite explicite peut être difficile à faire fonctionner. En général, il vaut mieux créer un petit chroot bootstrap de l'architecture native, puis faire un chroot dedans, ajouter les bonnes sources apt pour trouver les commandes nécessaires et suffisantes pour obtenir le mélange de paquets adéquat. Évitez d'indiquer des versions explicites pour contourner les problèmes, travaillez avec les suites uniquement. L'épinglage avec l'utilisation d'un fichier de préférences apt peut être utile ici, consultez préférences apt.

Préférences apt

Si un fichier adéquat est indiqué dans l'option aptpreferences de la section General du fichier de configuration, il sera copié dans le répertoire des préférences de apt du bootstrap avant d'utiliser apt.

Quand un fichier de préférences apt est fourni, le comportement "Default-Release" de "multistrap" est désactivé.

Comme avec d'autres scripts et fichiers extérieurs, le contenu du fichier de préférences apt sort du cadre de ce manuel. "multistrap" ne tente pas de vérifier le fichier fourni mais s'assure juste qu'il peut être lu.

Omission de la lecture de deb-src

Certains environnements multistrap ne nécessitent pas l'accès aux sources des paquets Debian durant l'installation, cela est typiquement nécessaire lors de la préparation d'une compilation (ou compilation croisée) chroot utilisant multistrap.

Pour désactiver la source additionnelle (et raccourcir le temps de téléchargement et la taille du cache de apt), utilisez le champ omitdebsrc dans chaque Section.

 [Baked]
 packages=
 source=http://www.emdebian.org/baked
 keyring=emdebian-archive-keyring
 suite=testing
 omitdebsrc=true

omitdebsrc est nécessaire en cas d'utilisation de paquets en provenance de debian-ports où les paquets n'ont pas de sources, à l'exception de « non-délivrée ».

fakeroot

Les architectures bootstrap différentes peuvent fonctionner sous "fakeroot" ("multistrap" est conçu pour en faire le maximum qu'il peut au sein d'un même appel pour faciliter cette tâche) mais le niveau de configuration qui est normalement appliqué avec une architecture bootstrap native requiert "chroot" et "chroot" en lui-même ne fonctionnera pas sous "fakeroot".

Donc, si "multistrap" détecte que "fakeroot" est en cours d'utilisation, le mode de configuration natif est sauté avec un message de rappel.

Le même problème apparaît avec "apt-get install" et donc l'installation du paquet trousseau sur le système hôte est également sauté si fakeroot est détecté.

Gestion des paquets problématiques

Quelquefois, un paquet en particulier échouera même à se dépaqueter proprement si les autres paquets n'ont pas encore été dépaquetés. Cela peut arriver si les contournements de dpkg ne sont pas correctement configurés ou si les Pre-Depends du paquet dépendent d'un exécutable se trouvant dans un autre paquet.

Multistrap offre deux façons de gérer ces problèmes. Un paquet peut être indiqué comme "reinstall" ou comme "additional". Chaque section dans le fichier de configuration de "multistrap" peut être indiqué seulement en tant que "reinstall" ou "additional" ou bien les deux.

Reinstall signifie que le paquet sera téléchargé et dépaqueté normalement - aux côtés de tous les autres paquets, mais sera alors réinstallé à la fin en lançant le script du mainteneur "preinst" avec l'argument "upgrade". "dpkg" continuera alors le reste de la configuration de ce paquet.

Additional ajoute un second tour de "apt-get install" au processus multistrap - après le dépaquetage initial. Le paquet additionnel sera alors téléchargé et dépaqueté. Lancé nativement, le paquet additionnel est téléchargé, dépaqueté et configuré après que tout le reste des paquets aient été téléchargés, dépaquetés et configurés.

Ni "reinstall" ni "additional" ne devraient être considérés mieux que de simples astuces et les bogues devant figurer sur la liste des souhaits devraient être remplis dans Debian pour des paquets qui nécessiteraient de tels mécanismes (ou les paquets qui empêcheraient le paquet en particulier de se comporter normalement).

Préconfiguration Debconf

Ajouter une préconfiguration Debconf peut aider à configurer des paquets sur un comportement en particulier au lieu de celui par défaut, lors de configuration en mode non-interactif. Voir http://www.debian-administration.org/articles/394 pour des informations sur comment créer des fichiers de préconfiguration.

Il est possible d'indiquer des fichiers de préconfiguration multiples en utilisant le champ debconfseed dans la section [General], séparés par des espaces :

 debconfseed=seed1 seed2

Files which do not exist or which cannot be opened will be silently ignored. Check the results of the parsing using the "--simulate" option to "multistrap". The preseeding files will be copied to a preseed directory in /tmp inside the rootfs.

To use the preseeding, add a section to the configscript.sh, prior to any calls to dpkg --configure -a. e.g. :

 #!/bin/sh
 
 set -e
 
 export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 export LC_ALL=C LANGUAGE=C LANG=C
 if [ -d /tmp/preseeds/ ]; then
    for file in `ls -1 /tmp/preseeds/*`; do
    debconf-set-selections $file
    done
 fi
 dpkg --configure -a

Détournements

If a hook directory (hookdir=) is specified in the General section of the "multistrap" configuration file, the hook scripts which are executable will be run from outside the multistrap directory at the following stages:

Déclencheurs téléchargés

Exécutés avant le démarrage du dépaquetage, immédiatement après que les paquets aient été téléchargés. Les déclencheurs téléchargés sont des scripts exécutables dans le répertoire de déclencheurs indiqué, avec un nom de fichier commençant par download.

Déclencheurs natifs.

Les scripts de déclencheurs natifs sont exécutés uniquement dans le mode natif, juste avant de démarrer la configuration des paquets téléchargés et encore une fois après la fin de la configuration du paquet. Les déclencheurs natifs seront appelés avec le chemin absolu et l'état de progression actuel, démarré ou arrêté.

Les scripts natifs sont exécutables dans le répertoire de déclencheurs indiqué avec un nom de fichier commençant par native.

Déclencheurs de complétion

Exécutés juste avant que l'archive (« tarball ») soit créée ou que "multistrap" quitte s'il n'est pas configuré pour la créer.

Completion scripts are executable scripts in the specified hook directory with a filename beginning with completion.

Les déclencheurs sont passés avec le chemin absolu dans le répertoire qui sera le niveau parent du chroot ou du système multistrap. Les déclencheurs ne pouvant être résolus en utilisant realpath ou qui ne sont pas exécutables seront ignorés.

Tous les déclencheurs d'une même sorte sont triés par ordre alphabétique avant d'être lancés.

Veuillez noter que "multistrap" ne fait pas de retour arrière des effets des déclencheurs en cas d'erreur. Cependant, "multistrap" signalera les erreurs accumulées sous forme d'avertissement. Si un déclencheur quitte sur autre chose que zéro, la valeur de sortie est convertie vers un nombre positif et ajoutée à la somme totale des avertissements, affichée à la fin de l'opération.

Sortie

"multistrap" peut produire beaucoup de sorties - les messages d'information apparaissent sur STDOUT, les erreurs et les avertissement sur STDERR. Les appels vers "apt" et "dpkg" respectent le même modèle, pour qu'il soit simple d'ajuster la sortie combinée de "multistrap" sur les erreurs seulement, si désiré.

"multistrap" accumule les états d'erreur des processus non fatals au sein de l'opération et les rapporte comme des avertissements sur STDERR en même temps que quitter avec le décompte des erreurs accumulées. Cela comprend les déclencheurs qui signalent des valeurs de retour différentes de zéro.

Bogues

Comme "multistrap" devient plus complexe, des bogues s'insinuent dans le paquet. Veuillez signaler ces bogues sur le BTS Debian en utilisant l'outil "reportbug" en incluant s'il vous plait les fichiers de configuration. Si votre configuration nécessite d'accéder à des dépôts apt locaux ou privés, veuillez vérifier votre configuration avec les dernières versions de "multistrap" dans Debian en utilisant l'option "--simulate" et inclure ce rapport dans votre rapport de bogue.

La sortie de l'option "--simulate" est régulièrement enrichie pour aider les utilisateurs à pister les problèmes dans les fichiers de configuration.

Veuillez également vérifier (et mettre à jour) le wiki de Multistrap à http://wiki.debian.org/Multistrap et le contenu de la page Internet de Multistrap à http://www.emdebian.org/multistrap/ avant de remplir des bogues. Plusieurs personnes sur la liste de diffusion [email protected] et sur le canal IRC #emdebian sur irc.oftc.net peuvent également aider si votre fichier de configuration ne peut être parcouru correctement. Vous devrez alors poster la sortie de "--simulate" sur un site Internet de copier-coller (« pastebin ») et indiquer l'adresse dans votre message.

Prise en charge multiarchitecture

La prise en charge multiarchitecture est expérimentale — veuillez signaler les problèmes et soumettre des rapports de bogues avec tous les détails de votre installation, le fichier de configuration complet de multistrap et les erreurs signalées.

"multistrap" outrepasse la prise en charge multiarchitecture du système externe pour qu'un système prêt pour le multiarchitecture puisse toujours créer un chroot non multiarchitecture depuis des dépôts qui ne permettent pas d'utiliser toutes les architectures compatibles avec le dpkg externe.

Si multiarch est activé au sein du chroot multistrap, "multistrap" écrit la liste dans /var/lib/dpkg/arch à l'intérieur du chroot.

Pour les architectures multiples, veuillez indiquer l'option une fois et utilisez une liste séparée par des espaces pour la liste des architectures. Assurez-vous d'avoir inclus ce qui constituera l'architecture hôte du chroot.

Consultez aussi : http://wiki.debian.org/Multiarch

 [General]
 ...
 multiarch=i386 armel armhf

Chaque section installera les paquets depuis l'architecture de base tant que l'option "Architecture" n'est pas indiquée dans des sections particulières.

 [Foreign]
 packages=libgcc1 libc6
 architecture=armel
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=sid

In the "--simulate" output, the architecture(s) specified in the MultiArch option will be listed under the ``Foreign architectures'' listing. Packages for a specific architecture will be listed as the package name followed by a colon followed by the architecture.

 libgcc1:armel libc6:armel