Rôle Ansible : Installer Aptly

Installer Aptly sur Debian ou Ubuntu.

Plates-formes supportées

  platforms:
    - name: Ubuntu
      versions:
        - xenial
        - bionic
        - focal
    - name: Debian
      version:
        - oldstable
        - stable
        - testing

Exigences

[min_ansible_version: 2.8]

Variables du rôle

#--- Section principale ---#
# stable ou unstable : https://www.aptly.info/download/
aptly_repo_version: stable
# aptly_repo_version: unstable

aptly_path_to_local_repo: /var/aptly

aptly_user: aptly

aptly_group: aptly

#--- Section API ---#
aptly_run_api_service: true
# aptly_run_api_service: false

# https://www.aptly.info/doc/api/
aptly_api_port: 8080

# /lib/systemd/system/aptly-api.service
aptly_api_service_name: aptly-api

#--- Première section de dépôt ---#
aptly_my_first_repo_create: true
# aptly_create_my_first_repo: false

# https://www.aptly.info/doc/api/repos/ ou https://www.aptly.info/doc/aptly/repo/create/
aptly_my_first_repo_create_over: api
# aptly_my_first_repo_create_over: cli

# aptly repo create <name>
aptly_my_first_repo_name: mon-premier-depot

# -distribution="" depuis https://www.aptly.info/doc/aptly/repo/create/
aptly_my_first_repo_distribution: rolling

aptly_my_first_repo_comment: Dépôt généré avec https://github.com/don-rumata/ansible-role-install-aptly

# https://wiki.debian.org/ru/SourcesList
aptly_my_first_repo_component: main
# aptly_my_first_repo_component: contrib
# aptly_my_first_repo_component: non-free

#--- Logiciels dans le dépôt créé ---#

# Viber. Pourquoi ? Parce que lien de téléchargement permanent.
# aptly_add_first_software_in_created_repo: true
aptly_add_first_software_in_created_repo: false

#--- Section GPG ---#
aptly_gpg_key_generate: true
# aptly_gpg_key_generate: false

aptly_gpg_key_path: '{{ aptly_path_to_local_repo }}/gpg'

aptly_gpg_publickey_filename: repo.key

aptly_gpg_key_maintainer: Jon Doe

aptly_gpg_key_email: [email protected]

aptly_gpg_key_expire_date: 365

# À FAIRE. aptly_create_gpg_pass: true\false
aptly_gpg_key_pass: qazwsxedc

aptly_gpg_key_comment: avec une phrase secrète bête

aptly_gpg_key_type: RSA

aptly_gpg_key_length: 4096

#!!! TOUS les accès sont en LECTURE UNIQUEMENT !!!#

#--- Section www ---#
aptly_www_access: true
# aptly_www_access: false

aptly_www_webdav_access: true
# aptly_www_webdav_access: false

# http://localhost/deb <---
aptly_www_module_name: deb

aptly_www_port: 80

aptly_www_backend: nginx
# aptly_www_backend: lighttpd
# aptly_www_backend: apache

aptly_www_local_path: /var/www/{{ aptly_www_module_name }}

#--- Section rsync ---#
aptly_rsync_access: true
# aptly_rsync_access: false

# rsync://localhost/deb <---
aptly_rsync_module_name: deb

aptly_rsync_local_path: '{{ aptly_path_to_local_repo }}/public'

#--- Section ftp ---#
aptly_ftp_access: true
# aptly_ftp_access: false

# ftp://localhost/deb <---
aptly_ftp_module_name: deb

# "anon_root" dans vsftpd.conf
aptly_ftp_anon_root_dir: /srv/ftp

aptly_ftp_local_path: '{{ aptly_ftp_anon_root_dir }}/{{ aptly_ftp_module_name }}'

#--- Section nfs ---#
aptly_nfs_access: true
# aptly_nfs_access: false

Dépendances

Aucune.

Exemple de playbook

Installer la version stable d'aptly avec :

• Créer un utilisateur de service pour aptly
• Installer et configurer le démon api d'aptly
• Créer un dépôt "Hello, World !"
• Générer des clés GPG pour signer le dépôt (AVERTISSEMENT !!! SANS PASSEPHRASE !!!)
• Partager le dépôt (tous les accès en lecture seule) :
  • http (nginx)
  • webdav (nginx)
  • rsync (rsyncd)
  • ftp (vsftpd)
  • nfs (nfs-kernel-server)

install-aptly.yml :

- name: Installer Aptly
  hosts: all
  strategy: free
  serial:
    - "100%"
  roles:
    - ansible-role-install-aptly
  tasks:

Installer la version non stable d'aptly sans toutes les fonctionnalités :

- name: Installer Aptly
  hosts: all
  strategy: free
  serial:
    - "100%"
  roles:
    - ansible-role-install-aptly
  vars:
    aptly_repo_version: unstable
    aptly_run_api_service: false
    aptly_create_my_first_repo: false
    aptly_add_first_software_in_created_repo: false
    aptly_gpg_key_generate: false
    aptly_www_access: false
    aptly_www_webdav_access: false
    aptly_rsync_access: false
    aptly_ftp_access: false
    aptly_nfs_access: false
  tasks:

Installer la version stable d'aptly, en créant un dépôt via cli et en partageant le dépôt vide via apache sur le port 83 :

- name: Installer Aptly
  hosts: all
  strategy: free
  serial:
    - "100%"
  roles:
    - ansible-role-install-aptly
  vars:
    aptly_run_api_service: false
    aptly_create_my_first_repo: true
    aptly_my_first_repo_create_over: cli
    aptly_add_first_software_in_created_repo: false
    aptly_gpg_key_generate: false
    aptly_www_access: true
    aptly_www_backend: apache
    aptly_www_webdav_access: false
    aptly_www_port: 83
    aptly_rsync_access: false
    aptly_ftp_access: false
    aptly_nfs_access: false
  tasks:

Ajoutez votre dépôt dans votre Debian\Ubuntu

10.10.10.10 - exemple d'IP.

Via http

echo "deb http://10.10.10.10/deb rolling main" | sudo tee --append /etc/apt/sources.list.d/my-awesome-repo.list

wget -q -O - http://10.10.10.10/deb/repo.key | sudo apt-key add -

Via ftp

echo "deb ftp://10.10.10.10/deb rolling main" | sudo tee --append /etc/apt/sources.list.d/my-awesome-repo.list

wget -q -O - ftp://10.10.10.10/deb/repo.key | sudo apt-key add -

Via NFS

sudo mkdir /var/repo

mount.nfs 10.10.10.10:/var/aptly/public /var/repo

echo "deb file:/var/repo rolling main" | sudo tee --append /etc/apt/sources.list.d/my-awesome-repo.list

sudo apt-key add /var/repo/repo.key

Pour un montage permanent :

echo "10.10.10.10:/var/aptly/public /var/repo nfs noatime,nodiratime 0 0" | sudo tee --append /etc/fstab

Via webdav

À venir.

Après tout

sudo apt update

Licence

Licence Apache, Version 2.0

Informations sur l'auteur

don Rumata

À FAIRE

• Ajouter des tests.
• Ajouter aptly_create_gpg_pass: true\false.
• Ajouter un exemple pour webdav.