3844
Comment: update upstream URL
|
← Revision 31 as of 2021-05-23 18:08:21 ⇥
4046
update upstream URL (fixing HTTP 404); update wording with Salt packaging status; update team aims
|
Deletions are marked like this. | Additions are marked like this. |
Line 6: | Line 6: |
Our aims are to package salt and then the other salt tools (salt-api, salt-cloud etc) for debian and subsequently ubuntu. | Our aims are to support packaging of the FOSS configuration management automation software [[https://saltproject.io/| Salt]] and other Salt tools (salt-api, salt-cloud etc) for Debian and subsequently Ubuntu. |
Line 9: | Line 9: |
Most of the information below is for the team to learn, agree and standardize on processes for setting up and working with the repository we will use for packaging. Although it contains information that may be useful for building your own salt packages, that is not the intention at this stage. For the moment, the best reference is probably http://docs.saltstack.com/topics/installation/debian.html. |
Most of the information below is for the team to learn, agree and standardize on processes for setting up and working with the repository we will use for packaging. Although it contains information that may be useful for building your own salt packages, that is not the intention at this stage. Salt has been [[https://packages.debian.org/source/sid/salt| packaged]] since Debian 8 "jessie"! For alternate installation info one can reference https://docs.saltproject.io/en/latest/topics/installation/debian.html . |
Translation(s): none
Salt Packaging Team
Our aims are to support packaging of the FOSS configuration management automation software Salt and other Salt tools (salt-api, salt-cloud etc) for Debian and subsequently Ubuntu.
Most of the information below is for the team to learn, agree and standardize on processes for setting up and working with the repository we will use for packaging. Although it contains information that may be useful for building your own salt packages, that is not the intention at this stage.
Salt has been packaged since Debian 8 "jessie"! For alternate installation info one can reference https://docs.saltproject.io/en/latest/topics/installation/debian.html .
If you wish to be involved, the best approach is probably to join the mailing list.
Infrastructure
Debian Salt packaging team on Salsa: https://salsa.debian.org/salt-team
Repository: https://salsa.debian.org/salt-team/salt.git
IRC channel: #debian-salt
Interacting with the team
Email contact: <pkg-salt-team@lists.alioth.debian.org>
Mailing list: https://lists.alioth.debian.org/mailman/listinfo/pkg-salt-team
Salt Package QA Page: salt
Task description
Packaging of Salt and related projects.
Related
HowTos
Day to Day work
In your working location, either:
gbp pull
or
git pull --all git pull --tags
Do work, then commit and push:
git push --all git push --tags
Importing a new salt release
gbp import-orig ../salt_2016.11.8+dfsg1.orig.tar.gz --pristine-tar
Patching the repository
Depending on the need, this should either be done by using quilt (http://www.debian.org/doc/manuals/maint-guide/modify.en.html) or by modifing the debian/rules file.
In a recent (and educational) example, the rm was added at the end of the override_dh_installdocs chunk to delete the .DS_Store file after the files were copied into the temporary packaging location (dh_install/dh_installdocs step) but before being packaged into the .deb file.
rm -r was used rather than rm -rf (force) so that when a fixed upstream release is made, this will fail and the patch can be removed.
The extract from debian/rules can be seen below:
override_dh_installdocs: dh_installdocs # Remove embedded copies of javascript libs for f in $(JS_FILES) ; do \ cd debian/salt-doc/usr/share/doc/salt/html/_static/ \ && rm $${f}.js \ && ln -s ../../../../javascript/sphinxdoc/1.0/$${f}.js . \ && cd $(CURDIR) ; \ done ; # Remove stray .DS_Store file rm -r debian/salt-doc/usr/share/doc/salt/html/_static/fonts/.DS_Store
Building the packages
Is this the best? Some people use pbuilder - should that be our standard process?
gbp dch --id-length=7
gbp buildpackage -us -uc
Once you are happy with the packages
gbp buildpackage --git-tag -us -uc git push --all git push --tag
Cloning the repo down
As it is a git-buildpackage repo, the following will clone the branches down properly:
gbp clone git+ssh://username-guest@git.debian.org/git/pkg-salt/salt.git
Testing the packages
- Install on sufficiently clean system
- Uninstall
- Install previous version
- Upgrade to new package
- Test basic package functionality
Backporting
If we backport to squeeze, we may need to be aware of 698901
Decisions
- Use of git and git-buildpackage for VCS