Ansible Роль: Установка Aptly

Установка Aptly на Debian или Ubuntu.

Поддерживаемые платформы

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

Требования

[min_ansible_version: 2.8]

Переменные роли

#--- Основной раздел ---#
# stable или 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

#--- Раздел 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

#--- Раздел первого репозитория ---#
aptly_my_first_repo_create: true
# aptly_create_my_first_repo: false

# https://www.aptly.info/doc/api/repos/ или 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: my-first-repo

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

aptly_my_first_repo_comment: Репозиторий создан с 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

#--- Программное обеспечение в созданном репозитории ---#

# Viber. Почему? Потому что постоянная прямая ссылка для скачивания.
# aptly_add_first_software_in_created_repo: true
aptly_add_first_software_in_created_repo: false

#--- Раздел 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

# TODO. aptly_create_gpg_pass: true\false
aptly_gpg_key_pass: qazwsxedc

aptly_gpg_key_comment: с глупым паролем

aptly_gpg_key_type: RSA

aptly_gpg_key_length: 4096

#!!! Все доступы только для чтения для всех !!!#

#--- Раздел 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 }}

#--- Раздел 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'

#--- Раздел ftp ---#
aptly_ftp_access: true
# aptly_ftp_access: false

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

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

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

#--- Раздел nfs ---#
aptly_nfs_access: true
# aptly_nfs_access: false

Зависимости

Нет.

Пример плейбука

Установка стабильной версии aptly с:

• Созданий пользователя службы для aptly
• Установкой и настройкой демона API aptly
• Созданием репозитория "Hello, World!"
• Генерацией GPG-ключей для подписи репозитория (ПРЕДУПРЕЖДЕНИЕ!!! БЕЗ ПАРОЛЯ!!!)
• Доступом к репозиторию (все доступы только для чтения):
  • http (nginx)
  • webdav (nginx)
  • rsync (rsyncd)
  • ftp (vsftpd)
  • nfs (nfs-kernel-server)

install-aptly.yml:

- name: Установка Aptly
  hosts: all
  strategy: free
  serial:
    - "100%"
  roles:
    - ansible-role-install-aptly
  tasks:

Установите не стабильную версию aptly, без всех функций:

- name: Установка 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:

Установка стабильной версии aptly, с созданием репозитория через CLI и предоставлением пустого репозитория через Apache на порту 83:

- name: Установка 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:

Добавление вашего репозитория в Debian\Ubuntu

10.10.10.10 - пример IP.

Через 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 -

Через 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 -

Через 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

Для постоянного монтирования:

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

Через WebDAV

Скоро будет.

После всего

sudo apt update

Лицензия

Лицензия Apache, версия 2.0

Информация об авторе

don Rumata

TODO

• Добавить тесты.
• Добавить aptly_create_gpg_pass: true\false.
• Добавить пример для webdav.