Commit Graph

90 Commits

Author SHA1 Message Date
Aaron Lauterer
e5fe7f7cea docs: offline-media: improve read- and understandability
by rephrasing parts to be easier to read or adding more context.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Aaron Lauterer
07fae362b6 docs: offline-keys: improve read- and understandabilty
By rephasing certain parts and splitting long sentences into smaller
ones.

Also changing "licensing server" to "subscription server".

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Aaron Lauterer
a1bae05459 docs: installation: improve read- and understandabilty
This patch contains the larger changes, such as splitting longer
sentences and rewording some parts.

The headline for "Reuse a Proxmox Repository for Offline Mirror Tool"
has been changed to "Set up the Repository on non Proxmox bases
systems". Sounds a bit nicer and we are in the Proxmox Offline Mirror
docs anyway.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Aaron Lauterer
32f3eca628 docs: installation: fix typos, and other small changes
switch from `Proxmox projects` to `Proxmox solutions`.
Add missing words, such as `the` and drop `also`s.

And other small changes that don't affect the actual content or meaning.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Aaron Lauterer
49c845cde5 docs: introduction: rewrite for better readability
splitting long sentences, rephrasing and extending some parts

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Aaron Lauterer
41cb625b6e docs: introduction: fix typos and missing words
adding `the` in a few places, dropping `also`s as they are almost always
just filler words.

Signed-off-by: Aaron Lauterer <a.lauterer@proxmox.com>
2022-09-09 12:38:10 +02:00
Thomas Lamprecht
ac8d260964 add .gitignore
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-09 12:38:08 +02:00
Fabian Grünbichler
0dcf473c40 pool: remove double quoting
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-09 12:00:35 +02:00
Fabian Grünbichler
c598cb154e rework pool handling
instead of having a .pool directory inside each mirror directory (both
on the mirror and medium side), instead

- specify a base directory for each mirror which can be shared
- create a .pool in this base directory
- create the mirror dir named after the mirror ID in this base directory
- adapt GC, wizard, .. accordingly

to re-use a shared pool on the medium side, hash the source mirror base
dir path to derive the destination pool .pool-XX directory name and
persist the resulting relative path in the medium state file.
2022-09-09 12:00:35 +02:00
Fabian Grünbichler
ff3d11a5d8 pool: allow pool re-use
and improve the naming of the two dirs.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-09 11:28:52 +02:00
Fabian Grünbichler
54c8397731 clippy fix
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-09 10:06:46 +02:00
Stoiko Ivanov
5d9224ed34 fix typos in command invocation
noted while blindly pasting the output after setting up my first
mirror.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2022-09-08 15:50:52 +02:00
Thomas Lamprecht
5a813b796a buildsys: dinstall target: install doc instead of lib package
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 15:50:40 +02:00
Thomas Lamprecht
fc3d0ae688 d/rules: avoid compressing pdf files
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 14:17:39 +02:00
Thomas Lamprecht
79adf07846 bump version to 0.2.0-1
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 14:12:33 +02:00
Thomas Lamprecht
42bd24dba9 d/rules: ensure DEB_VERSION and DEB_VERSION_UPSTREAM are available for docs
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 14:12:33 +02:00
Thomas Lamprecht
624b33a59f docs: drop non-existing APT ref
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 14:12:33 +02:00
Thomas Lamprecht
41fe4d749b buildsys: also upload to pbs-client repo
it has the smallest impact if added to a plain, vanilla Debian
installation (e.g., no newer ifupdown or smartmontools package
getting pulled in automatically)

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 14:12:33 +02:00
Thomas Lamprecht
859c6ebcfa docs: mirror: mention auto-debian-base selection as tip
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:56:09 +02:00
Thomas Lamprecht
ef6ebe79fd docs: intro: reference config file switch/env variable directly
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:39:48 +02:00
Thomas Lamprecht
3d44b696bd docs: ship config manpage as proxmox-offline-mirror.cfg.5
as `mirror.cfg.5` is rather overly generic

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:36:51 +02:00
Thomas Lamprecht
f03a1f2b84 setup: clarify that a *new* medium ID is queried
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:25:05 +02:00
Thomas Lamprecht
5471a4184c setup: avoid duplicated medium ID query loop
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:25:05 +02:00
Fabian Grünbichler
a085d18759 wizard: query base path
and derive the rest using the ID, and ignore already existing
directories.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 13:23:45 +02:00
Fabian Grünbichler
290810c2d9 allow overriding config file path via env
by setting PROXMOX_OFFLINE_MIRROR_CONFIG

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 13:16:32 +02:00
Thomas Lamprecht
c0c2562e42 docs: intro: add terminology heading
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:04:33 +02:00
Thomas Lamprecht
114497cc4c docs: add installation chapter
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:04:33 +02:00
Thomas Lamprecht
ffbf5b8904 docs: add intro to offline mirrors and media chapters
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:04:33 +02:00
Thomas Lamprecht
dba885fbba docs: restructur/expand offline key chapter
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 13:04:33 +02:00
Fabian Grünbichler
fc9b351a4d wizard: add option to (de)select all mirrors
else it gets a bit repetitive for the common case.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 13:04:03 +02:00
Fabian Grünbichler
6ba920ff71 wizard: add --config parameter
instead of prompting for the file path.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:54:42 +02:00
Fabian Grünbichler
b2c8df5c6f cargo fmt
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:49:54 +02:00
Fabian Grünbichler
1f7ac6f603 wizard: optionally auto-add Debian mirrors
when adding a Proxmox product mirror.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:49:54 +02:00
Fabian Grünbichler
54b47e302e wizard: extract debian release/variant/.. handling
for re-use when adding a Proxmox product.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:49:54 +02:00
Fabian Grünbichler
34ccf5f690 wizard: re-order distros
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:49:54 +02:00
Fabian Grünbichler
06474893df medium: implement remove .. --remove-data
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 12:49:54 +02:00
Thomas Lamprecht
47fd70f0cb docs: mirror: fix --dir in command example
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 11:46:00 +02:00
Thomas Lamprecht
f0cb50f34b subscription: use "-" for POM product URL
it isn't displayed anywhere currently anyway, so more future proofing

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 11:44:10 +02:00
Thomas Lamprecht
a7805ca338 apt repo: offline key: support PMG
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 11:43:46 +02:00
Thomas Lamprecht
67581096c8 docs: split out chapters into different files
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 11:03:57 +02:00
Fabian Grünbichler
fe3bf78aa8 keys: improve refresh behaviour
refresh mirror key(s) before looking for a valid one to use for offline key
refreshing, and disentagle these two parts of "refreshing keys".

also, refreshing is no longer async since dropping hyper, so drop the
async/await-s accordingly.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 10:25:57 +02:00
Fabian Grünbichler
c8b43f3e7a add some more comments
Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 09:44:46 +02:00
Fabian Grünbichler
c14cad80da keys: add 'show' command
to display full info that is available about a given key.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 09:35:25 +02:00
Fabian Grünbichler
627d92c7e0 keys: extend list return value
by decoding the contained subscription info and doing some rough checks.

Signed-off-by: Fabian Grünbichler <f.gruenbichler@proxmox.com>
2022-09-08 09:34:41 +02:00
Thomas Lamprecht
26023cc671 docs: extend, reformat and various small fixes
Fix some left overs from copying this over from PBS, note how to
acquire such a key by contacting sales@proxmox.com, add a paragraph
with some description about what this tool(ing) actually does to the
introduction section, ...

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 08:30:15 +02:00
Thomas Lamprecht
118ab592d3 docs: fix title case and heading markers
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 08:29:39 +02:00
Thomas Lamprecht
e9227093ba docs pdf: avoid extra blank page on section/chapter boundary
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-08 08:27:52 +02:00
Thomas Lamprecht
d707060cc7 d/control: add break/depends for doc split
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-07 16:21:34 +02:00
Thomas Lamprecht
e00cc7d877 buildsys: fix d/control in build dir, ensuring docs package build
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-07 16:07:22 +02:00
Thomas Lamprecht
09a01e8105 d/control: update
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2022-09-07 15:44:28 +02:00