{{tag>depot debian local logiciel howto apt-ftparchive gpg pool}}
====== Créer son propre dépot Debian ======

Il peut être tres pratique de créer son propre dépôt Debian.

Il existe pas mal de facons de faire et je vais vous présenter ici la manière que j'utilise au quotidien :
Cette méthode utilise :
  * l'utilitaire apt-ftparchive
  * un pool de fichiers .deb par dépot (perte d'espace de stockage car les paquets sont dupliqués, mais gain en lisibilité sur les logiciels disponibles par dépot)
  * pour chaque dépot, le même dépot suffixé de "-test" existe : il sert comme son nom l'indique à déposer des paquets pour les tester avant leur mise en production dans l'autre dépot.
  * le dépot est signé par une clef GPG

Ce dépot permet une installation aisée d'un ensemble de machine car il héberge des meta-packages installant un ensemble de logiciels (peut être un jour un article la dessus).

===== Créer l'arborescence d'un dépot =====
Voici l'arborescence type de l'ensemble des depots :<code>
./cache
./mirror/pool-lenny
./mirror/pool-lenny/custom
./mirror/pool-lenny/custom/binary-i386
./mirror/pool-lenny/custom/binary-amd64
./mirror/pool-lenny/custom/binary-all
./mirror/pool-lenny-test
./mirror/pool-lenny-test/custom
./mirror/pool-lenny-test/custom/binary-i386
./mirror/pool-lenny-test/custom/binary-amd64
./mirror/pool-lenny-test/custom/binary-all
./mirror/pool-hardy
./mirror/pool-hardy/custom
./mirror/pool-hardy/custom/binary-i386
./mirror/pool-hardy/custom/binary-amd64
./mirror/pool-hardy/custom/binary-all
./mirror/pool-hardy-test
./mirror/pool-hardy-test/custom
./mirror/pool-hardy-test/custom/binary-i386
./mirror/pool-hardy-test/custom/binary-amd64
./mirror/pool-hardy-test/custom/binary-all
./filelists
./filelists/dists
./filelists/dists/lenny
./filelists/dists/lenny-test
./filelists/dists/hardy
./filelists/dists/hardy-test
</code>Comme on ne va pas créer cette arborescence a la main, voici un petit script permettant de créer/ajouter facilement un dépot :<code bash>
#!/bin/bash
# /usr/local/sbin/create_debian_repository.sh
# cree un nouveau depot deb local
ARCHS="i386 amd64"
REPO_ROOT="/var/www/depots_deb"
MIRROR_ROOT="$REPO_ROOT/mirror/dists"
FILELISTS_DIR="$REPO_ROOT/filelists"

if [ $# -lt 1 ] ; then
    echo "" >&2
    echo "Usage: $0  depot section" >&2
    echo "" >&2
    echo "Cree l'arborescence nécessaire pour créer un depot avec la section souhaitée" >&2
    echo "Genere le fichier de configuration associé pour apt-ftparchive" >&2
    echo "" >&2
    exit 1
fi

# le premier argument specifie le depot
if [ -n "$1" ]; then
    DIST=$1
    shift
fi

# le deuxieme argument specifie la section
if [ -n "$1" ]; then
    SECTION=$1
    shift
fi

FTP_ARCHIVE_CONF_FILE="/etc/apt/apt-perso-${DIST}.conf"

#creation de l'arborescence
DIR=""
    for archi in $ARCHS; do
     DIR="$DIR ${FILELISTS_DIR}/dists/${DIST} $REPO_ROOT/mirror/pool-${DIST}/$SECTION/binary-${archi} $MIRROR_ROOT/$DIST/$SECTION/binary-${archi}"
    done

    DIR="$DIR $REPO_ROOT/mirror/pool-${DIST}/$SECTION/binary-all $MIRROR_ROOT/$DIST/$SECTION/binary-all"

mkdir -p $DIR
chown root:admin $DIR
chmod u=rwx,g=rwxs,o=rx,g+s $DIR
chmod g+ws $DIR

# generation du fichier de configuration du depot
if [ -f $FTP_ARCHIVE_CONF_FILE ]; then
    echo "Le fichier de conf $FTP_ARCHIVE_CONF_FILE existe deja : Abandon" >&2
    echo "Veuillez le compléter a la main (si vous voulez créer une nouvelle section dans un depot existant)" >&2
    echo "ou le supprimer avant de relancer ce script" >&2
    exit 1
fi

echo "APT::FTPArchive::Release::Origin \"Internal Repository\";" > $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::Label \"Internal tools\";" >> $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::Suite \"$DIST\";" >> $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::Codename \"$DIST\";" >> $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::Architecture \"$ARCHS\";" >> $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::components \"$SECTION\";" >> $FTP_ARCHIVE_CONF_FILE
echo "APT::FTPArchive::Release::Description \"Internal Repository\";" >> $FTP_ARCHIVE_CONF_FILE
echo "" >> $FTP_ARCHIVE_CONF_FILE
echo "Tree \"dists/$DIST\" {" >> $FTP_ARCHIVE_CONF_FILE
echo "        Sections \"$SECTION\";" >> $FTP_ARCHIVE_CONF_FILE
echo "        Architectures \"$ARCHS\";" >> $FTP_ARCHIVE_CONF_FILE
echo "        Directory \"pool-$DIST/\$(SECTION)/binary-\$(ARCH)\";" >> $FTP_ARCHIVE_CONF_FILE
echo "        SrcDirectory \"pool-$DIST/\$(SECTION)/source\";" >> $FTP_ARCHIVE_CONF_FILE
echo "}" >> $FTP_ARCHIVE_CONF_FILE
</code>
Il ne vous reste plus qu'a poser les paquets .deb dans le repertoire pool-$DIST/$(SECTION)/binary-$(ARCH) qui convient.

===== Mettre a jour le depot =====

Pour générer l'index du dépot afin qu'il soit utilisable sur vos postes clients, voici le script de mise à jour utilisé :<code bash>
#!/bin/bash
#/usr/local/bin/updateMirror.sh
# met a jour le depot debian cible passé en argument

DISTS="etch gutsy hardy intrepid lenny ubuntu unstable" # adapter  ala liste des depots que vous possédez
REPO_ROOT="/var/www/depots_deb"
MIRROR_ROOT="$REPO_ROOT/mirror/dists"
GPG_HOME="/root/.gnupg_depots_deb"
FILELISTS_DIR="$REPO_ROOT/filelists"
ARCH_LIST="i386 amd64 all"

if [ $# -lt 1 ] ; then
    echo "" >&2
    echo "Usage: $0 [ all|etch|unstable|... ] [ test ]" >&2
    echo "" >&2
    echo "Mise à jour du ou des dépots (all)  spécifié en premier argument." >&2
    echo "Un seul dépot peut-être spécifié à la fois." >&2
    echo "" >&2
    echo "Si le deuxième argument est 'test', " >&2
    echo "la mise à jour se fait sur les dépots de test" >&2
    echo "" >&2
    exit 1
fi

# le premier argument specifie le depot à mettre à jour
if [ -n "$1" ]; then
    ONLY_DIST=""
    tmp_sec=$1
    shift

    for i in ${DISTS}
    do
        if [ "X$i" = "X$tmp_sec" ]; then
            ONLY_DIST=$i
            break
        fi
    done

    if [ "X$tmp_sec" = "Xall" ]; then
        ONLY_DIST=${DISTS}
    fi

    if [ -z "${ONLY_DIST}" ]; then
        echo "ERREUR: depot invalide $tmp_sec" >&2
        exit 1
    fi

    DISTS=${ONLY_DIST}
fi
# depots de prod ou de test 
DIST_SUFFIX=""
if [ "X$1" == "Xtest" ]; then
    DIST_SUFFIX="-test"
    shift
fi

for DIST in $DISTS
do
    DIST="${DIST}${DIST_SUFFIX}"
    FTP_ARCHIVE_CONF_FILE="/etc/apt/apt-perso-${DIST}.conf"

    rm -f $REPO_ROOT/cache/*db

    # generation des filelist des depots
    cd $REPO_ROOT/mirror
    for section in `ls pool-${DIST}`
    do
        for archi in $ARCH_LIST;
        do
                if [ "x${archi}" = "xall" ]; then
                    continue
                fi
                mkdir -p ${FILELISTS_DIR}/dists/${DIST}
                echo "Section : ${section}"
                echo "Arch : ${archi}"
                FILELIST="${FILELISTS_DIR}/dists/${DIST}/${section}-${archi}.filelist"
                echo "filelist : $FILELIST"
                find pool-${DIST}/$section/binary-${archi} pool-${DIST}/$section/binary-all -name "*.deb" > \
                    ${FILELISTS_DIR}/dists/${DIST}/${section}-${archi}.filelist
        done

    done
    echo "generation apt ftp archive :"
        apt-ftparchive generate ${FTP_ARCHIVE_CONF_FILE}
    echo "creation du fichier Release :"
        # creation des fichiers Release
        RELEASE_FILE="${MIRROR_ROOT}/${DIST}/Release"
        apt-ftparchive -c $FTP_ARCHIVE_CONF_FILE release \
            ${MIRROR_ROOT}/${DIST}/ > $RELEASE_FILE

        # signature gpg des fichiers Release
     rm -f $RELEASE_FILE.gpg
     ${DEBUG} gpg --verbose --homedir ${GPG_HOME} -ba \
         --output $RELEASE_FILE.gpg $RELEASE_FILE
done
</code>

===== Configuration du virtualhost apache =====
Pour utiliser ce dépot le plus simple est de le servir en http via un serveur Web (apache2 dans notre cas). Voici un exemple de fichier de VirtualHost apache2 (fichier : /etc/apache2/sites-available/debtools.domaine.interne ) :<code>
# /etc/apache2/sites-available/debtools.domaine.interne
<VirtualHost *>
        ServerAdmin admin@mondomaine.com
        ServerName debtools.domaine.interne
        ServerAlias debtools

        DocumentRoot   /var/www/depots_deb/mirror/

        ErrorLog /var/log/apache2/depots_deb_error.log
        TransferLog /var/log/apache2/depots_deb_access.log

        <Directory /var/www/depots_deb/mirror/>
                AllowOverride AuthConfig
                Options Indexes FollowSymLinks MultiViews

                order deny,allow
                allow from all
        </Directory>
</VirtualHost>
</code>

===== Utilisation coté client =====

Il suffit d'ajouter la ligne correspondante a la distribution dans votre fichier /etc/apt/sources.list (ou créer un nouveau fichier dans le repertoire /etc/apt/sources.list.d/ ), par exemple pour lenny :<code bash>
cat << EOF >> /etc/apt/sources.list
deb http://debtools.domaine.interne lenny custom
EOF
</code>