fedora-packages allows to search for packages in Fedora.
Would be nice to have a bit more documentation.
We have a docker-compose setup for hacking on the fedora-packages app. This setup matches the production deployment of fedora-packages (ie apache HTTP server with mod_wsgi).
To bring the environment up you should first install the following.
$ sudo dnf install docker-compose
And then make sure that the docker daemon is running
$ sudo systemctl start docker
$ sudo systemctl enable docker
If you do not wish to run docker-compose using sudo
you will need to add
your user to the docker group as follow.
$ sudo groupadd docker && sudo gpasswd -a $USER docker
$ MYGRP=$(id -g) ; newgrp docker ; newgrp $MYGRP
This is has for effect to give root permission to users added to the docker group.
You will also need to get a development instance of the xapian database.
$ curl -o devel/docker/xapian.tar.gz https://cverna.fedorapeople.org/xapian.tar.gz
Now from the devel directory you can run docker-compose.
$ cd devel
$ docker-compose up
The first time you execute this command, it will build a docker container and it will take few minutes. Once the build is finish and the application is started you can access the fedora-packages using this url http://127.0.0.1/packages
Since we are using apache HTTP server to serve the application we need to run the following command to reload the application to test some code changes.
$ cd devel
$ docker-compose exec web touch /usr/share/fedoracommunity/productiom/apache/fedoracommunity.wsgi
This will change the timestamp of the .wsgi file and ask apache to reload the application.
To execute the test suite simply run the following command
$ docker-compose exec web py.test /usr/share/fedoracommunity/tests
We have a simple vagrant setup for hacking on the fedora-packages app.
First, install Ansible, Vagrant, the vagrant-sshfs plugin, and the vagrant-libvirt plugin from the official Fedora repos:
$ sudo dnf install ansible vagrant vagrant-libvirt vagrant-sshfs
Now, from within main directory (the one with the Vagrantfile in it) of your git checkout of fedora-pacakges, run the vagrant up command to provision your dev environment:
$ vagrant up
When this command is completed (it may take a while) you will be able to ssh into your dev VM with vagrant ssh and then run the c ommand to start the fedora-packages server:
$ vagrant ssh
[vagrant@localhost ~]$ pushd /vagrant/; gearbox serve;
Once that is running, simply go to http://localhost:8080/ in your browser on your host to see your running fedora-packages test instance.
To create a new release, you need to update setup.py
and fedora-packages.spec
with the new version number and any dependencies added or removed.
The CHANGELOG.rst
needs also to be updated with the commits and pull-requests
included in the release.
Once these 3 files have been updated and commited to the develop branch, you create a new Git tag.
$ git tag -a 4.1.0 -s -m 'Release 4.1.0'
$ git push && git push --tag
Once the tag has been successfully pushed, a new release will be available in github.