blob: 4c1b825b1e594d9fd109b830ca47aac820e69fa3 [file] [log] [blame]
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +03001=====
2Usage
3=====
azvyagintseve5c4e832018-01-25 20:02:46 +02004
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +03005This file provides the debmirror sample pillars configurations for different
6use cases.
azvyagintseve5c4e832018-01-25 20:02:46 +02007
azvyagintsevb67fd052018-07-24 09:08:28 +02008See debmirror/schemas/*.yaml for all possible options
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +03009A sample of one debmirror mirror configuration (Ubuntu):
azvyagintseve5c4e832018-01-25 20:02:46 +020010
11.. code-block:: yaml
azvyagintsevb80d6222018-02-19 15:53:40 +020012
azvyagintseve5c4e832018-01-25 20:02:46 +020013 parameters:
14 debmirror:
15 client:
16 enabled: true
17 mirrors:
18 target01:
azvyagintsevb67fd052018-07-24 09:08:28 +020019 enabled: true
20 fetch_retry: 3
azvyagintsev73720db2018-06-20 17:28:09 +030021 http_proxy : "url"
22 https_proxy: "url"
23 ftp_proxy: "url"
24 rsync_proxy: "url"
25 no_proxy: ['val1', 'val2']
azvyagintseve5c4e832018-01-25 20:02:46 +020026 force: False
27 lock_target: True
28 extra_flags: [ '--verbose', '--progress', '--nosource', '--no-check-gpg', '--rsync-extra=none' ]
29 method: "rsync" # string
30 arch: [ 'amd64' ]
31 mirror_host: "mirror.mirantis.com" # rsync
32 mirror_root: ':mirror/nightly/ubuntu/'
33 target_dir: "/var/www/mirror/ubuntu/"
34 log_file: "/var/www/mirror/target01_log.log"
35 dist: [ xenial ] #, xenial-security, xenial-updates ]
36 section: [ main ] #, multiverse, restricted, universe ]
37 exclude_deb_section: [ 'games', gnome, Xfce, sound, electronics, graphics, hamradio , doc, localization, kde, video ]
38 filter:
39 00: "--exclude=/"
40 01: "--exclude='/android*'"
41 02: "--exclude='/firefox*'"
42 03: "--exclude='/chromium-browser*'"
43 04: "--exclude='/ceph*'"
44 05: "--exclude='/*-wallpapers*'"
45 06: "--exclude='/language-pack-(?!en)'"
46 07: "--include='/main(.*)manpages'"
47 08: "--include='/main(.*)python-(.*)doc'"
48 09: "--include='/main(.*)python-(.*)network'"
49
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +030050**Documentation and bugs**
51
52* http://salt-formulas.readthedocs.io/
53 Learn how to install and update salt-formulas
54
55* https://github.com/salt-formulas/salt-formula-debmirror/issues
56 In the unfortunate event that bugs are discovered, report the issue to the
57 appropriate issue tracker. Use the Github issue tracker for a specific salt
58 formula
59
60* https://launchpad.net/salt-formulas
61 For feature requests, bug reports, or blueprints affecting the entire
62 ecosystem, use the Launchpad salt-formulas project
azvyagintseve5c4e832018-01-25 20:02:46 +020063
64* https://github.com/salt-formulas/salt-formula-debmirror
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +030065 Develop the salt-formulas projects in the master branch and then submit pull
66 requests against a specific formula
azvyagintseve5c4e832018-01-25 20:02:46 +020067
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +030068* https://launchpad.net/~salt-formulas-users
69 Join the salt-formulas-users team and subscribe to mailing list if required
azvyagintseve5c4e832018-01-25 20:02:46 +020070
OlgaGusarenko4b8f0ce2018-06-19 16:04:15 +030071* #salt-formulas @ irc.freenode.net
72 Use this IRC channel in case of any questions or feedback which is always
73 welcome