Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dougsland/fedora-packaging
Setup a quick env for fedora packaging stuff
https://github.com/dougsland/fedora-packaging
Last synced: 10 days ago
JSON representation
Setup a quick env for fedora packaging stuff
- Host: GitHub
- URL: https://github.com/dougsland/fedora-packaging
- Owner: dougsland
- Created: 2022-04-22T04:07:16.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-04-22T05:02:14.000Z (over 2 years ago)
- Last Synced: 2024-12-19T13:28:56.923Z (22 days ago)
- Size: 8.79 KB
- Stars: 1
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
- [fedora-packaging](#fedora-packaging)
* [1. Setting Vagrant and libvirt in Fedora](#1-setting-vagrant-and-libvirt-in-fedora)
* [2. Creating the Virtual Machine](#2-creating-the-virtual-machine)
* [3. Start packaging](#3-start-packaging)
* [4. Resources](#4-resources)
# fedora-packaging
A quick documentation how to setup a `Fedora Packager` env with `Vagrant + libvirt` to manage **official fedora packages**.
## 1. Setting Vagrant and libvirt in Fedora
Before creating a Vagrant Virtual Machine with all tools required for Fedora packaging lets install the software needed in the HOST machine
- 1.1 Required Packages
```
sudo dnf install @vagrant
sudo dnf install nfs-utils && sudo systemctl enable nfs-server
```
- 1.2 Set Permissions for the **non root user running vagrant**
```
echo "allow all" | sudo tee /etc/qemu/${USER}.conf
echo "include /etc/qemu/${USER}.conf" | sudo tee --append /etc/qemu/bridge.conf
sudo chown root:${USER} /etc/qemu/${USER}.conf
sudo chmod 640 /etc/qemu/${USER}.conf
```
- 1.3 Installing vagrant plugins
```
vagrant plugin install vagrant-ssh
```
- 2 Enable nfs, rpc-bind and mountd services for firewalld
```
sudo firewall-cmd --permanent --zone=libvirt --add-service=nfs3 \
&& sudo firewall-cmd --permanent --zone=libvirt --add-service=nfs \
&& sudo firewall-cmd --permanent --zone=libvirt --add-service=rpc-bind \
&& sudo firewall-cmd --permanent --zone=libvirt --add-service=mountd \
&& sudo firewall-cmd --reload
```
- 3 Using NFS shares from Vagrant without password prompts
```
sudo visudo
# Allow Vagrant to manage /etc/exports
Cmnd_Alias VAGRANT_EXPORTS_ADD = /usr/bin/tee -a /etc/exports
Cmnd_Alias VAGRANT_NFSD_CHECK = /usr/bin/systemctl status --no-pager nfs-server.service
Cmnd_Alias VAGRANT_NFSD_START = /usr/bin/systemctl start nfs-server.service
Cmnd_Alias VAGRANT_NFSD_APPLY = /usr/sbin/exportfs -ar
Cmnd_Alias VAGRANT_EXPORTS_REMOVE = /bin/sed -r -e * d -ibak /*/exports
Cmnd_Alias VAGRANT_EXPORTS_REMOVE_2 = /bin/cp /*/exports /etc/exports
%vagrant ALL=(root) NOPASSWD: VAGRANT_EXPORTS_ADD, VAGRANT_NFSD_CHECK, VAGRANT_NFSD_START, VAGRANT_NFSD_APPLY, VAGRANT_EXPORTS_REMOVE, VAGRANT_EXPORTS_REMOVE_2
```
- 4 Add yourself to the vagrant group:
```
$ sudo getent group vagrant >/dev/null || sudo groupadd -r vagrant
$ sudo gpasswd -a ${USER} vagrant
$ sudo -u ${USER} ${SHELL}
```
## 2. Creating the Virtual Machine
**Before creating** the `Fedora Packager VM` check the `Global Settings` [here](https://github.com/dougsland/fedora-packaging/blob/37f1119c0af123f6d9ad2ab99d1cd0802acc9e29/Vagrantfile#L1) for setting [Fedora Account (FAS)](https://github.com/dougsland/fedora-packaging/blob/680cab8b6cb7c406c6897f792befe752d5270fd1/Vagrantfile#L4), [private key for FAS account](https://github.com/dougsland/fedora-packaging/blob/680cab8b6cb7c406c6897f792befe752d5270fd1/Vagrantfile#L12), [Git username/email](https://github.com/dougsland/fedora-packaging/blob/680cab8b6cb7c406c6897f792befe752d5270fd1/Vagrantfile#L5), [non root user for the development](https://github.com/dougsland/fedora-packaging/blob/680cab8b6cb7c406c6897f792befe752d5270fd1/Vagrantfile#L8), [password](https://github.com/dougsland/fedora-packaging/blob/680cab8b6cb7c406c6897f792befe752d5270fd1/Vagrantfile#L8), etc.
If all settings are good, run the below command to create the VM:
```
vagrant up
```
## 3. Start packaging
After the VM is up, user can access it via `vagrant ssh fedora-packager` ([PASSWORD SET IN VAGRANT FILE](https://github.com/dougsland/fedora-packaging/blob/2e96292e1d1f4df326bc0a050359db4ceadae9ce/Vagrantfile#L9))
Useful commands for packaging:
- `fkinit -u FAS_ACCOUNT` to **login and start** using fedpkg command
- `fedpkg clone PACKAGE` to clone a pakcage. Example: `fedpkg clone ovn && cd ovn`
- List all branches: `git branch -a`
- Switch branches: `fedpkg switch-branch f35`
## 4. Resources
https://developer.fedoraproject.org/tools/vagrant/vagrant-libvirt.html
https://developer.fedoraproject.org/tools/vagrant/vagrant-nfs.html