Пуппет: поддержка apt sources.list

Вопрос или проблема

  apt::source { 'my_apt':
    location      => 'https://apt.example.com',
    repos         => 'main',
    release       => $facts['os']['distro']['codename'],
    notify_update => true, # значение по умолчанию
  }

  stdlib::ensure_packages(['mypackage'], {
      require => [Apt::Source['my_apt'], Exec[apt_update]]
  })

Ответ или решение

Puppet: Управление файлом sources.list для Debian

Ваша задача заключается в использовании Puppet для управления растущим числом устройств Debian, начиная с их инициализации и далее. Одним из важных шагов является настройка файла sources.list для APT и его последующее обновление. Поскольку другие модули зависят от актуальности этого списка, важно правильно организовать порядок выполнения задач.

Проблема: Порядок выполнения операций

Ваша основная проблема заключается в том, что установщики пакетов могут столкнуться с ошибками, если команда apt-get update не была выполнена до их вызова. Возможные подходы к решению этой проблемы включают использование механизмов упорядочивания выполнения ресурсов в Puppet (таких как require, before, и notify) или введение этапов (stages). Важно учитывать, что философия Puppet предполагает декларативный подход к описанию конечного состояния, а не процесса, что означает, что в первую очередь необходимо ориентироваться на конечный результат.

Рассмотрим несколько практических решений для управления файлом sources.list.

Рекомендации по управлению sources.list

1. Используйте ресурс apt::source: Лучше всего управлять источниками пакетов через ресурс apt::source модуля apt от Puppet Labs. Этот модуль автоматически обновляет список пакетов, когда вы добавляете или изменяете источник. Пример кода:

   apt::source { 'my_apt':
       location      => 'https://apt.example.com',
       repos         => 'main',
       release       => $facts['os']['distro']['codename'],
       notify_update => true, # это значение по умолчанию
   }

2. Добавление зависимостей: При установке пакетов, используйте параметр require, чтобы указать зависимости от ресурса apt::source и ресурса обновления Exec[apt_update]. Пример:

   stdlib::ensure_packages(['mypackage'], {
       require => [Apt::Source['my_apt'], Exec['apt_update']]
   })

3. Использование exec с refreshonly: В качестве альтернативного решения вы можете использовать ресурс exec с параметром refreshonly => true, который будет запускаться только при изменении файла sources.list. В этом случае классы, содержащие как ресурс управления файлом, так и ресурс exec, должны также требовать правильного порядка зависимостей.

   file { '/etc/apt/sources.list':
       ensure  => file,
       source  => 'puppet:///modules/my_module/sources.list',
       notify  => Exec['apt_update'], # Запустится только если файл изменится
   }
   
   exec { 'apt_update':
       command     => '/usr/bin/apt-get update',
       refreshonly => true,
   }

Заключение

Управляя sources.list с помощью Puppet, обязательно учитывайте порядок выполнения операций, чтобы избежать потенциальных ошибок при установке пакетов. Использование модуля apt с ресурсом apt::source является наиболее простым и эффективным способом добиться желаемого результата. Помните о необходимости указывать зависимости и уведомления, чтобы гарантировать, что команда apt-get update выполняется до начала установки пакетов. Это позволит избежать ошибок на первом запуске и обеспечит стабильную работу вашей инфраструктуры.

Таким образом, следуя рекомендациям, вы сможете эффективно управлять файлами источников APT, минимизируя риски и повышая стабильность ваших Debian серверов.