Distribution EOLE » Modules » EOLE AD DC

h1. Compilation de Samba

{{toc}}

h2. État des lieux

Lors de la rédaction de cet article, la version de samba sur EOLE 2.7.0 et 2.7.1 (bionic) était la 4.9.2 et le but était de passer en 4.9.5 (compilée par "Debian":https://packages.debian.org/sid/samba) avec les patches (CVE) de la "4.9.6":https://www.samba.org/samba/history/samba-4.9.6.html.

Ceci tout en conservant nos deux patches actuels :

* 0035-workaround-bug-when-demoting-RODC.patch

* 0036-dlz-bind-zone-transfer-restriction.patch

h2. Dépôts Samba

https://dev-eole.ac-dijon.fr/projects/samba/repository

Sur la forge EOLE, on retrouve le dépôt samba ainsi que des dépôts pour chacune les librairies associées :

*    cmocka 

*    ldb 

*    talloc 

*    tdb 

*    tevent

h3. Dépôts distants

Pour Samba, plusieurs dépôts sont disponibles.

Il est recommandé de commencer par cloner le dépôt Debian (salsa) afin que la branche master pointe vers celui-ci puis de déclarer les autres dépôts distants :

<pre>

git clone https://salsa.debian.org/samba-team/samba.git

cd samba

git remote add dev-eole https://dev-eole.ac-dijon.fr/git/samba.git

git remote add samba https://git.samba.org/samba.git

</pre>

Une fois ces opérations réalisées, on doit obtenir la configuration suivante :

<pre>

# git remote -v 

dev-eole	ssh://git@dev-eole.ac-dijon.fr/samba.git (fetch)

dev-eole	ssh://git@dev-eole.ac-dijon.fr/samba.git (push)

origin	https://salsa.debian.org/samba-team/samba.git (fetch)

origin	https://salsa.debian.org/samba-team/samba.git (push)

samba	https://git.samba.org/samba.git (fetch)

samba	https://git.samba.org/samba.git (push)

</pre>

NB : Le dépôt officiel de Samba n'a pas été utilisé dans les manipulation réalisées ce jour ;)

h3. Branches distantes

Les branches que nous utilisons sont les suivantes :

* @master@ : branche de packaging Debian

* @upstream_4.9@ : sources samba-4.9 importées par Debian (NB : dans cette branche les patches sont déjà appliqués)

* @pristine-tar@ : upstream tarball au format "pristine"

* @dist/eole/2.7.0/master@ : branche de packaging EOLE (NB : dans cette branche les patches sont déjà appliqués)

NB1 : Pour forcer l'utilisation du dépôt "origin" pour la branche @pristine-tar@, la commande suivante pourra être utilisée :

<pre>

git checkout -b pristine-tar origin/pristine-tar

</pre>

NB2 : Pour d'obtenir (checkout) la branche @dist/eole/2.7.0/master@, il faut au préalable avoir exécuté :

<pre>

git fetch dev-eole

</pre>

h2. Préparer le paquet

h3. Fusionner les modifications

Pour commencer, mettre toutes les branches à jour :

<pre>

git pull

</pre>

À titre informatif, il est possible de lister tous les commits ajoutés depuis le dernier paquet EOLE à l'aide des tags (exemple) :

<pre>

git log debian/2%4.9.2+dfsg-2-8-ga9af810f873..debian/2%4.9.5+dfsg-3

</pre>

Se positionner sur la branche de packaging EOLE et fusionner le tag souhaité (le dernier en général) :

<pre>

git checkout dist/eole/2.7.0/master

git merge debian/2%4.9.5+dfsg-3

</pre>

Cela entraîne généralement quelques conflits mais pas trop complexes :

* @debian/changelog@: move EOLE entries at the proper place in history

* @debian/patches/series@: keep EOLE/MTES patches

%{color:darkblue}NB : dans notre exemple la lecture du changelog Debian a montré que les patches de sécurité (CVE) samba-4.9.6 étaient déjà appliqués sur la version 4.9.5 packagée par Debian.%

h3. Vérifier/Corriger les dépendances

Pour vérifier les dépendances de compilation, il est possible d'utiliser la commande indiquée dans le fichier README.sources :

<pre>

grep ^VERSION lib/{talloc,tdb,tevent,ldb}/wscript

</pre>

%{color:darkblue}NB : Les versions actuellement disponibles dans le dépôt EOLE sont visibles dans le fichier "Packages":http://test-eole.ac-dijon.fr/samba/dists/samba-4.9/main/binary-amd64/Packages%

Mais il faut également analyser en détail les versions (et les noms) des paquets mentionnés dans la section @Build-Depends@ du fichier @debian/control@.

Les pièges sont nombreux comme des noms de paquets différents entre Debian et Ubuntu (ex : libglusterfs-dev), des paquest re-numérotés avec le mot clé "really" (ex : ldb), ...

%{color:purple}Si à cette étape, on s'aperçoit qu'une des librairies est à recompiler, aller voir [[Samba#Compilation-dune-librairie-exemple-ldb|Compiler et diffuser une librairie]] et revenez plus tard !%

Ceci dit, si on en rate, on s'en apercevra très vite dans les étapes qui suivent ;)

%{color:darkblue}NB : La bionic est en retard sur la @Standards-Version@ requise mais ce n'est pas bloquant.%

%{color:darkblue}NB : La bionic est en retard également sur les debhelper.%

%{color:darkblue}NB : La bionic est en retard également sur la version de python (impact sur les noms fichiers dans les .install notamment).%

h3. Valider les modifications

Une fois qu'on a réglé les conflits et que le fichier @debian/control@ nous semble correct, il est possible de réaliser un commit pour finaliser le merge.

Il est conseillé de vérifier toutes les modifications à l'aide de la commande suivante :

<pre>

git diff HEAD~..HEAD

</pre>

Si l'on est satisfait, on ajoute une nouvelle entrée dans le changelog avec le numéro de version souhaité et on commite.

Puis exporter le "upstream tarball" (nécessite le paquet @git-buildpackage@) :

<pre>

gbp export-orig

</pre>

Cela crée une archive au format @tar.xz@ (exemple : @samba_4.9.5+dfsg.orig.tar.xz@)

%{color:red}NB : comme par hasard, ça plante sous bionic (@XD3_INVALID_INPUT@) mais fonctionne sous Debian !%

h2. Compiler et diffuser le paquet samba

h3. Compiler le paquet

Pour compiler, le plus simple est d'installer un Eolebase, lui ajouter les dépôts samba-4.9 et les dépôts sources Ubuntu ainsi que le paquet build-essential :

<pre>

echo -e "deb [ arch=amd64 ] http://test-eole.ac-dijon.fr/samba samba-4.9 main\ndeb-src [ arch=amd64 ] http://test-eole.ac-dijon.fr/samba samba-4.9 main" > /etc/apt/sources.list.d/samba.list

sed -e 's/^deb/deb-src/' /etc/apt/sources.list >> /etc/apt/sources.list.d/samba.list

apt update

apt install build-essential

</pre>

Copier l'archive et sources (branche dist/eole/2.7.0/master du dépôt) :

<pre>

scp samba_4.9.5+dfsg.orig.tar.xz root@eolebase.ac-test.fr:

rsync -avz samba -e ssh root@eolebase.ac-test.fr:

</pre>

%{color:purple}NB : La copie des sources (dépôt) samba via ssh entraîne une erreur de liens symboliques par la suite !%

Vérifier/installer les dépendances de compilation :

<pre>

apt build-dep ./samba

</pre>

%{color:purple}Si à cette étape, on s'aperçoit qu'une des librairies est à recompiler, aller voir [[Samba#Compilation-dune-librairie-exemple-ldb|Compiler et diffuser une librairie]] et revenez plus tard !%

Compiler le paquet (%{color:purple}prévoir 40 minutes% une fois lancé)

<pre>

cd samba

dpkg-buildpackage -sa --no-sign

</pre>

* l'option @-sa@ permet d'inclure les sources. Il ne faut pas la mettre si les sources ont déjà été inclues.

* l'option @--no-sign@ évite d'avoir une erreur lors de la tentative de signature des paquets ;)

Une fois le paquet compilé on obtient les fichiers deb, changes et dsc dans le répertoire supérieur.

Il est possible de vérifier la liste de ce qui a été compilé en consultant le fichier *.changes.

h3. Signer le paquet

Sur la machine @bionic-builder@, créer un répertoire dédié (exemple @~/samba@) puis copier les fichiers générés dedans :

<pre>

scp *.*deb *.tar.xz *.dsc *.changes *.buildinfo buildd@bionic-builder.eole.lan:samba

</pre>

Sur la machine @bionic-builder@, signer les paquets à l'aide de la commande :

<pre>

cd samba

debsign -k eole *.changes

</pre>

h3. Publier le paquet

Sur la machine @castor@, créer un répertoire dédié (exemple @/srv/repository/samba/tmp/samba@) puis copier les paquets signés dedans :

<pre>

scp * repository@castor:/srv/repository/samba/tmp/samba

</pre>

Puis importer les paquets dans le dépôt :

<pre>

cd /srv/repository/samba

reprepro -v include samba-4.9 tmp/samba/*.changes

</pre>

Il est possible de vérifier les paquets disponible à l'aide de la commande :

<pre>

reprepro listfilter samba-4.9 '$Source (= samba)'

</pre>

h3. Finaliser le travail

Mettre à jour et pousser toutes les branches ...

FIXME

h2. Compiler et diffuser une librairie (exemple :ldb)

Les étapes pour compiler une des librairies sont similaires à celles nécessaires à la compilation de samba.

Pour le cas de @ldb@, il faut commencer par avoir clôné les dépôts :

<pre>

git clone https://salsa.debian.org/samba-team/ldb.git

cd ldb

git remote add dev-eole https://dev-eole.ac-dijon.fr/git/ldb.git

git remote add samba https://git.samba.org/ldb.git

</pre>

On retrouve les branches distantes suivantes :

* @master@ : branche de packaging Debian

* @upstream@ : sources importées par Debian (NB : dans cette branche les patches sont déjà appliqués)

* @pristine-tar@ : upstream tarball au format "pristine"

* @dist/eole/2.7.0/master@ : branche de packaging EOLE (NB : dans cette branche les patches sont déjà appliqués)

Il faut ensuite préparer le paquet comme expliqué dans [[Samba#Pr%C3%A9parer-le-paquet]] et terminer par la commande :

<pre>

gbp export-orig

</pre>

Cela crée une archive au format @tar.gz@ (exemple : @ldb_1.5.1+really1.4.6.orig.tar.gz@)

Il faut ensuite préparer la machine de compilation (cf. [[Samba#Compiler-et-diffuser-le-paquet-samba]] et envoyer l'archive et le dépôt (branche @dist/eole/2.7.0/master@) dessus.

Puis, vérifier/installer les dépendances de compilation et compiler :

<pre>

apt build-dep ./ldb

cd ldb

dpkg-buildpackage -sa --no-sign

</pre>

%{color:purple}NB : ça peut également être assez long surtout si le paquet contient beaucoup de tests unitaires !%

h3. Liste des dépôts pour les bibliothèques

* https://salsa.debian.org/debian/cmocka.git

* https://salsa.debian.org/samba-team/ldb.git

* https://salsa.debian.org/samba-team/talloc.git

* https://salsa.debian.org/samba-team/tdb.git

* https://salsa.debian.org/samba-team/tevent.git

h3. Ordre de compilation

Le jeu de dépendance impose un certain ordre de compilation :

<pre>

talloc <---- tevent <---- ldb <----- samba

tdb <-------------------’

cmocka <---------------’

</pre>