[elbe-devel] [PATCH] quickstart: add section about custom repos with reprepro

[Yegor Yefremov]

On Tue, Jul 11, 2017 at 8:43 AM, Yegor Yefremov
<yegorslists at googlemail.com> wrote:
> On Tue, Jul 11, 2017 at 8:25 AM, Andrey Skvortsov
> <andrej.skvortzov at gmail.com> wrote:
>> On 17-07-11 08:15, Manuel Traut wrote:
>>> Hi,
>>>
>>> > > > +ELBE replaces the string `LOCALMACHINE` with the ip address of your machine. If
>>> > > > +you use an external machine as webserver you need to replace `LOCALMACHINE` with
>>> > > > +the name or the ip of it.
>>> > > > +
>>> > > > +You need to sign your repository (see `SignWith` in the
>>> > > > +link:https://mirrorer.alioth.debian.org/reprepro.1.html[reprepro manpage]), or
>>> > > > +you may set <noauth/> in your xml file. If you don't sign your repository you
>>> > > > +don't need the `<key>` tag.
>>> > > > +
>>> > > > +Now you can install packages from your custom repository the same way you can
>>> > > > +install from any other repository.
>>> > >
>>> > > reprepro is not that flexible. AFAIK you cannot manage both jessie and
>>> > > stretch in one reprepro instance. Have you already tried freight?
>>> >
>>> > Phillipp, thanks. Nice to have reprepro how-to in quickstart.
>>> >
>>> > Yegor, I see it's possible to create repo for several suites using reprepro.
>>> > See section 'First steps' at [1]. I've setup basic repo structure for
>>> > jessie and stretch. Seems to work.
>>> >
>>> > One downside of freight is that it's not available in Debian archive
>>> > now.
>>>
>>> Limitations of reprepro are: only one version per package/suite is allowed and
>>>   there is no integrated webserver.
>>
>> By the way, freight doesn't have integrated webserver either. It handles
>> only repo structure, like reprepro. So external webserver is still needed.
>> Manual from visionsystems just uses python module SimpleHTTPServer for that.
>> IMHO, this is the simplest way to run web-server on a local directory
>> without root privileges with simple python 'oneliner'.
>
> I'm for adding SimpleHTTPServer example to the quickstart.
>
>>> If you need those features you could use 'aptly' it is also packaged in debian
>>> but IMHO more complex to use.
>
> I just find freight more intuitive for beginners, but it is important,
> that we have a quick manual for any solution for own repository at
> all.

Have found some typos:

diff --git a/docs/quickstart.txt b/docs/quickstart.txt
index b14f4b1..ea608e5 100644
--- a/docs/quickstart.txt
+++ b/docs/quickstart.txt
@@ -344,7 +344,7 @@ repo/
 │   └── distributions
 -------------------------------------------------------------------------------

-To include packages in your repository you might use the following comand from
+To include packages in your repository you might use the following command from
 inside the `repo` directory:

 -------------------------------------------------------------------------------
@@ -354,7 +354,7 @@ $ reprepro include jessie ../path/to/your/*.changes
 To use this repository from ELBE you need a webserver. Simply place the
 repository inside the document root of your webserver.

-If the webser is running on the same machine as the initvm you can use the
+If the webserver is running on the same machine as the initvm you can use the
 following to access the repository:

 [source,xml]

Btw if we mention SignWith option, what about describing "gpg
--gen-key" and also key exporting?

Yegor