Script de build Kali-Cloud

Générateur d'images cloud Kali Linux via FAI (Fully Automatic Installation), forké depuis Debian Cloud Images.

Ce sont les mêmes scripts de build que l'équipe Kali utilise pour générer les images cloud officielles de Kali Linux, disponibles sur kali.org/get-kali/.

Pour plus d'informations, veuillez consulter : kali.org/docs/cloud/ ainsi que kali.org/docs/troubleshooting/common-cloud-setup/.

Construisez votre Kali, dès aujourd'hui !

Prérequis

Nous recommandons de compiler sur un hôte Linux, correspondant à l'architecture souhaitée.

Il existe différentes façons de se préparer à utiliser le script de build kali-cloud. Vous pouvez soit :

build.sh - Compiler directement depuis votre machine
build-in-container.sh - Compiler depuis un conteneur (tel que Docker ou Podman)

Pour que build.sh fonctionne, il nécessitera un accès super utilisateur (par exemple sudo ou un conteneur rootful). Cependant, KVM n'est pas requis.

Commencez par installer git, et assurez-vous que le dépôt est cloné localement :

$ sudo apt-get install --no-install-recommends \
    git ca-certificates
$ git clone https://gitlab.com/kalilinux/build-scripts/kali-cloud.git
$ cd ./kali-cloud/

Compiler depuis l'hôte (Kali)

Pour compiler directement sur votre hôte, avec build.sh, installez les dépendances de build :

$ sudo apt-get install --no-install-recommends \
    python3-minimal libpython3-stdlib python3-yaml python3-libcloud python3-marshmallow python3-httpx python3-pytest \
    fai-server fai-setup-storage \
    sudo \
    qemu-utils qemu-user-binfmt \
    fdisk \
    udev \
    dosfstools \
    apt-utils \
    debsums

NOTE : Selon l'ancienneté de la version de l'OS, vous devrez peut-être utiliser qemu-user-static (hérité) plutôt que qemu-user-binfmt (moderne/actuel/à jour).

NOTE : qemu-user-static/qemu-user-binfmt n'est requis que si vous compilez en architecture croisée (par exemple un hôte amd64, compilant une image arm64).

Vous pouvez maintenant utiliser ./build.sh, qui compilera une image cloud Kali directement sur votre machine.

Compiler depuis l'hôte (basé sur Debian, non-Kali)

Si vous n'utilisez PAS Kali comme OS de base, vous devrez installer le kali-archive-keyring de Kali afin que fai puisse récupérer les paquets de Kali.

$ sudo apt-get install --no-install-recommends \
    wget ca-certificates
$ wget https://http.kali.org/pool/main/k/kali-archive-keyring/kali-archive-keyring_20YY.X_all.deb
$ sudo apt-get install ./kali-archive-keyring_*_all.deb

NOTE : Remplacez 20YY.X par les valeurs indiquées ici, dans kali-archive-keyring.

Vous pouvez maintenant suivre Compiler depuis l'hôte (Kali) pour installer les dépendances de build.

Compiler depuis un conteneur

Nous passerons la configuration de tout logiciel de conteneur.

Si vous préférez compiler depuis un conteneur, vous devrez installer et configurer soit docker, soit podman sur votre machine.

docker nécessite que l'utilisateur soit ajouté au groupe Docker, ou l'utilisation du compte root (par exemple $ sudo ./build-in-container.sh).
podman a été testé avec rootful (par exemple $ sudo ./build-in-container.sh). S'il est exécuté en rootless, build-in-container.sh tentera de s'élever via sudo, ou de reconfigurer la podman machine en rootful, voir Limitations connues.

build-in-container.sh est un wrapper au-dessus de build.sh. Il détecte quel moteur de conteneur conforme OCI utiliser, se charge de créer l'image de conteneur si elle est manquante, puis démarre le conteneur pour effectuer le build depuis l'intérieur.

Vous avez trois façons de fournir l'image de conteneur :

$ # Option #1 - Automated build (recommended)
$ ./build-in-container.sh
$ ./build-in-container.sh --force   # If you need to rebuild the image from scratch
$
$
$
$ # Option #2 - Manual build
$ docker build -t kali-build/kali-cloud .
$ # ...OR...
$ podman build -t kali-build/kali-cloud .
$
$
$
$ # Option #3 - Use the pre-generated
$ docker pull registry.gitlab.com/kalilinux/build-scripts/kali-cloud:latest
$ docker tag registry.gitlab.com/kalilinux/build-scripts/kali-cloud:latest kali-build/kali-cloud
$ # ...OR...
$ podman pull registry.gitlab.com/kalilinux/build-scripts/kali-cloud:latest
$ podman tag registry.gitlab.com/kalilinux/build-scripts/kali-cloud:latest kali-build/kali-cloud
$
$ # ...then point the build at it:
$ ./build-in-container.sh                                                                       # Locally built (automated or manual)
$ IMAGE=registry.gitlab.com/kalilinux/build-scripts/kali-cloud:latest ./build-in-container.sh   # Pre-generated

Si vous avez à la fois docker et podman installés, build-in-container.sh utilisera podman par défaut. Pour changer cela, préfixez CONTAINER=docker avant ./build-in-container.sh :

$ CONTAINER=docker ./build-in-container.sh [...]

Vous pouvez maintenant utiliser ./build-in-container.sh (plutôt que ./build.sh), pour compiler une image.

Aide

$ ./build.sh --help
Usage: build.sh [OPTIONS]

Build a Kali Linux Cloud image.

Build options:
  -a, --arch ARCH              Build an image for this architecture (default: amd64)
                               Supported: amd64 arm64
  -b, --branch BRANCH          Kali branch used to build the image (default: kali-rolling)
                               Supported: kali-rolling kali-dev kali-last-snapshot
  -k, --keep                   Keep intermediary build artifacts
  -m, --mirror URL             Mirror used to build the image (default: http://http.kali.org/kali)
  -o, --output DIR             Output directory (default: /home/kali/kali-cloud/output)
  -v, --variant VARIANT        Cloud platform/target image to build (default: genericcloud)
                               Supported: genericcloud azure ec2 gce generic nocloud
  -x, --version VERSION        What to name the image release as (default: rolling)
  -z, --zip                    Compress image after the build
  -h, --help                   Show this help and exit

kali-cloud