taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

debian-repos.rst (2349B)


      1 ..
      2   This file is part of GNU TALER.
      3   Copyright (C) 2025 Taler Systems SA
      4 
      5   TALER is free software; you can redistribute it and/or modify it under the
      6   terms of the GNU Affero General Public License as published by the Free Software
      7   Foundation; either version 3.0, or (at your option) any later version.
      8 
      9   TALER is distributed in the hope that it will be useful, but WITHOUT ANY
     10   WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
     11   A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more details.
     12 
     13   You should have received a copy of the GNU Affero General Public License along with
     14   TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
     15 
     16   @author Christian Grothoff
     17   @author Florian Dold
     18 
     19 Debian Repositories
     20 ===================
     21 
     22 We use a Debian-style workflow with *testing* and *stable* in the same
     23 reprepro setup.  This chapter is **not** about the *nightly* distribution.
     24 The ``deb.taler.net`` site is pointed to a directory of the
     25 ``taler-packaging`` user where under ``www/apt`` we have a subdirectory per
     26 supported distribution, right now we have one for Debian and one for Ubuntu.
     27 
     28 Systems should use:
     29 
     30   - ``deb https://deb.taler.net/apt/debian trixie main`` for stable
     31   - ``deb https://deb.taler.net/apt/debian trixie-testing main`` for testing
     32 
     33 or equivalent for Ubuntu noble.
     34 
     35 The repositories are now hosted via aptly. In the past, they were hosted via
     36 reprepro. We switched to aptly, since it has better support for multiple
     37 versions of the same package and is generally easier to configure and use.
     38 
     39 
     40 taler-pkg
     41 ---------
     42 
     43 The ``taler-pkg`` tool from ``taler-deployment.git/packaging/ng``
     44 is used to both build packages (via podman containers) and upload them
     45 to ``deb.taler.net``.
     46 
     47 Building packages:
     48 
     49 .. code::
     50 
     51    $ ./taler-pkg build $TARGET
     52 
     53 where target is of the form ``$VENDOR-$CODENAME``. For example, ``debian-trixie`` or ``ubuntu-noble``.
     54 
     55 Publishing packages:
     56 
     57 .. code::
     58 
     59    $ ./taler-pkg publish $TARGET
     60 
     61 Publishing packages only publishes them to the ``-testing`` distro.
     62 
     63 Promoting packages:
     64 
     65 .. code::
     66 
     67    $ ./taler-pkg promote $TARGET --dry
     68    $ ./taler-pkg promote $TARGET
     69 
     70 To show which packages are currently available, use:
     71 
     72 
     73 .. code::
     74 
     75    $ ./taler-pkg show-published debian-trixie-testing
     76    $ ./taler-pkg show-published debian-trixie