Browse Source

Add doc for Debian packaging

pull/1/head
Victor Laborie 6 months ago
parent
commit
7ea7b52dc0
1 changed files with 64 additions and 0 deletions
  1. 64
    0
      docs/debian.md

+ 64
- 0
docs/debian.md View File

@@ -0,0 +1,64 @@
1
+# Debian Package
2
+
3
+**kvm-tools** package can be build from the **debian** branch of this Git repository with **git-buildpackage** and **sbuild**.
4
+
5
+## Dependencies
6
+
7
+Install Debian dependencies :
8
+
9
+~~~
10
+apt install git-buildpackage sbuild
11
+~~~
12
+
13
+Add your user to sbuild :
14
+
15
+~~~
16
+sbuild-adduser <username>
17
+~~~
18
+
19
+*You must logout and re-login or use `newgrp sbuild` in your current shell*
20
+
21
+You need a schroot definition in */etc/schroot/schroot.conf*, eg :
22
+
23
+~~~
24
+[sid]
25
+description=Debian sid (unstable)
26
+directory=/srv/chroot/sid
27
+groups=root,sbuild
28
+root-groups=root,sbuild
29
+aliases=unstable,default
30
+~~~
31
+
32
+Build the sbuild chroot :
33
+
34
+~~~
35
+sbuild-createchroot --include=eatmydata,ccache,gnupg unstable /srv/chroot/sid http://deb.debian.org/debian
36
+~~~
37
+
38
+## Build
39
+
40
+Tag your changes respecting [Semantic Versioning](https://semver.org/).
41
+
42
+~~~
43
+git tag X.Y.Z
44
+~~~
45
+
46
+Go to **debian** branch and merge your current work :
47
+
48
+~~~
49
+git checkout debian
50
+git merge master
51
+~~~
52
+
53
+Update Debian changelog with **dch** and commit your change :
54
+
55
+~~~
56
+dch -v X.Y.Z-1
57
+git commit -m "New upstream release (X.Y.Z)"
58
+~~~
59
+
60
+You can now build the Debian package :
61
+
62
+~~~
63
+gbp buildpackage
64
+~~~

Loading…
Cancel
Save