blob: 300c3e5828329dffdd1fa3895b2875f843cfd1b6 [file] [log] [blame]
Filip Pytloun95347292015-10-06 16:28:31 +02001=====
2Aptly
3=====
4
5Install and configure Aptly server and client.
6
7Available states
8================
9
10.. contents::
11 :local:
12
13``aptly.server``
14----------------
15
16Setup aptly server
17
18``aptly.publisher``
19-------------------
20
21Setup aptly publisher
22
23Available metadata
24==================
25
26.. contents::
27 :local:
28
29``metadata.aptly.server.single``
30--------------------------------
31
32Setup basic server
33
34
35``metadata.aptly.client.publisher``
36-----------------------------------
37
38Setup aptly publisher client
39
40Configuration parameters
41========================
42
43
44Example reclass
45===============
46
47Basic Aptly server with no repos or mirrors.
48
49.. code-block:: yaml
50
51 classes:
52 - service.aptly.server.single
53 parameters:
54 aptly:
55 server:
56 enabled: true
57 secure: true
58 gpg_keypair_id: A76882D3
59 gpg_passphrase:
60 gpg_public_key: |
61 -----BEGIN PGP PUBLIC KEY BLOCK-----
62 Version: GnuPG v1
63 ...
64 gpg_private_key: |
65 -----BEGIN PGP PRIVATE KEY BLOCK-----
66 Version: GnuPG v1
67 ...
68
69Example pillar
70==============
71
72.. code-block:: yaml
73
74 aptly:
75 server:
76 enabled: true
77 repo:
78 myrepo:
79 distribution: trusty
80 component: main
81 architectures: amd64
82 comment: "Custom components"
Petr Michalecd78b4812016-12-27 16:11:06 +010083 sources: false
Filip Pytloun95347292015-10-06 16:28:31 +020084 publisher:
85 component: mycomponent
86 distributions:
87 - nightly/trusty
88
89Read more
90=========
91
92* http://www.aptly.info/doc/configuration/
Filip Pytlounc33d90f2017-02-02 12:52:25 +010093
94Documentation and Bugs
95======================
96
97To learn how to install and update salt-formulas, consult the documentation
98available online at:
99
100 http://salt-formulas.readthedocs.io/
101
102In the unfortunate event that bugs are discovered, they should be reported to
103the appropriate issue tracker. Use Github issue tracker for specific salt
104formula:
105
106 https://github.com/salt-formulas/salt-formula-aptly/issues
107
108For feature requests, bug reports or blueprints affecting entire ecosystem,
109use Launchpad salt-formulas project:
110
111 https://launchpad.net/salt-formulas
112
113You can also join salt-formulas-users team and subscribe to mailing list:
114
115 https://launchpad.net/~salt-formulas-users
116
117Developers wishing to work on the salt-formulas projects should always base
118their work on master branch and submit pull request against specific formula.
119
120 https://github.com/salt-formulas/salt-formula-aptly
121
122Any questions or feedback is always welcome so feel free to join our IRC
123channel:
124
125 #salt-formulas @ irc.freenode.net