Debian 软件包有 standard/recommended 目录结构吗？

Question

我的下一个项目将是用 Python 编写的 Debian 守护进程，我想将其打包为 Debian 本机包。该项目使用 Git 进行版本控制，代码托管在 GitHub.

如何组织存储库中的目录和分支？有standard/common/recommended方法吗？

该项目基本上由一些python 脚本和systemd 单元文件组成。环顾四周，我想出了这个目录结构，但我不知道它是否合理：

my-app/
├── debian/
│   ├── control
│   ├── copyright
│   ├── changelog
│   ├── rules
│   └── ...
├── my_module/
│   ├── __init__.py
│   ├── my_script.py
│   └── ...
├── systemd/
│   ├── my-service.service
│   └── ...
├── README.md
├── LICENSE
└── ...

Answer 1

您似乎是在询问 目录结构 （哪些文件应该在何处），而不是 存储库结构 （应该是关于分支机构）。

结构如下：

上游项目（例如源代码发布压缩包的内容）
在此目录的根目录中加上一个 debian/ 文件夹

就是这样。此结构旨在允许打包任意项目 - 唯一的限制是没有 debian/ 文件夹。

现在，这种结构与将上游开发与 Debian 打包分开的概念非常紧密地结合在一起。（这可能不适用于您的用例，因为您似乎既是上游开发人员又是创建 Debian 软件包的人）。

为了使最终适应 Debian 更容易（例如将软件包适应真正的 Debian 发行版），您应该确保 /debian 目录不包含在发行 tarball 中.

您还应该从发布压缩包中排除存储库配置文件（.gitignore 文件、CI-配置、...）

如果使用 git，您可以添加一个 .gitattributes 文件，其中包含（除其他外）：

/debian/    export-ignore
.git*       export-ignore

关于如何成为 Debian 的优秀上游，还有更详尽的在线指南：https://wiki.debian.org/UpstreamGuide

Debian 软件包有 standard/recommended 目录结构吗？

Is there a standard/recommended directory structure for Debian packages?

python

debian

packaging