Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tomhillable/consul-rpm
Spec file and sources needed to package consul
https://github.com/tomhillable/consul-rpm
Last synced: about 1 month ago
JSON representation
Spec file and sources needed to package consul
- Host: GitHub
- URL: https://github.com/tomhillable/consul-rpm
- Owner: tomhillable
- License: mpl-2.0
- Created: 2014-05-14T13:07:35.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-04-30T15:48:23.000Z (over 4 years ago)
- Last Synced: 2024-08-03T02:05:43.565Z (4 months ago)
- Language: Shell
- Size: 108 KB
- Stars: 96
- Watchers: 11
- Forks: 65
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-consul - tomhillable/consul-rpm
README
# RPM Spec for Consul
Tries to follow the [packaging guidelines](https://fedoraproject.org/wiki/Packaging:Guidelines) from Fedora.
* Binary: `/usr/bin/consul`
* Config: `/etc/consul.d/`
* Shared state: `/var/lib/consul/`
* Sysconfig: `/etc/sysconfig/consul`
* WebUI: `/usr/share/consul/`
# Using
Create the RPMs using one of the techniques outlined in the Build section below.
## Pre-built packages
Pre-built packages are maintained via the [Fedora Copr](https://copr.fedoraproject.org/coprs/) system. For more information, please see the [duritong/consul](https://copr.fedoraproject.org/coprs/duritong/consul/) repository on Copr.
# Build
There are a number of ways to build the `consul` and `consul-ui` RPMs:
* Manual
* Vagrant
* Docker
Each method ultimately does the same thing - pick the one that is most comfortable for you.
### Version
The version number is hardcoded into the SPEC, however should you so choose, it can be set explicitly by passing an argument to `rpmbuild` directly:
```
$ rpmbuild --define "_version 0.6.3"
```
## Manual
Build the RPM as a non-root user from your home directory:
* Check out this repo. Seriously - check it out. Nice.
```
git clone
```
* Install `rpmdevtools` and `mock`.
```
sudo yum install rpmdevtools mock
```
* Set up your `rpmbuild` directory tree.
```
rpmdev-setuptree
```
* Link the spec file and sources.
```
ln -s $HOME/consul-rpm/SPECS/consul.spec $HOME/rpmbuild/SPECS/
find $HOME/consul-rpm/SOURCES -type f -exec ln -s {} $HOME/rpmbuild/SOURCES/ \;
```
* Download remote source files.
```
spectool -g -R rpmbuild/SPECS/consul.spec
```
* Spectool may fail if your distribution has an older version of cURL (CentOS
6.x, for example) - if so, use Wget instead.
```
VER=`grep Version rpmbuild/SPECS/consul.spec | awk '{print $2}'`
URL='https://dl.bintray.com/mitchellh/consul'
wget $URL/consul_${VER}_linux_amd64.zip -O $HOME/rpmbuild/SOURCES/consul_${VER}_linux_amd64.zip
wget $URL/consul_${VER}_web_ui.zip -O $HOME/rpmbuild/SOURCES/consul_${VER}_web_ui.zip
```
* Build the RPM.
```
rpmbuild -ba rpmbuild/SPECS/consul.spec
```
## Vagrant
If you have Vagrant installed:
* Check out this repo.
```
git clone https://github.com/tomhillable/consul-rpm
```
* Edit `Vagrantfile` to point to your favourite box (Bento CentOS7 in this example).
```
config.vm.box = "http://opscode-vm-bento.s3.amazonaws.com/vagrant/virtualbox/opscode_centos-7.0_chef-provisionerless.box"
```
* Vagrant up! The RPMs will be copied to working directory after provisioning.
```
vagrant up
```
## Docker
If you prefer building it with Docker:
### Manually
* Build the Docker image. Note that you must amend the `Dockerfile` header if you want a specific OS build (`centos6` and `centos7` are currently included).
```
docker build -t consul:build ./docker/centos7/
```
* Run the build.
```
docker run -v $HOME/consul-rpms:/RPMS consul:build
```
* Retrieve the built RPMs from `$HOME/consul-rpms`.
### Docker compose
Alternatively, there is a docker compose file included with this repo that
automates the process of building the Docker image and running commands.
* Build with:
```shell
docker-compose run
```
* Retrieve build rpms from `./RPMS`.
Currently, the docker-compose services can be either `centos6` or `centos7` for
each respective OS version.
# Result
Three RPMs:
- consul server
- consul web UI
- consul-template
# Run
* Install the RPM.
* Put config files in `/etc/consul.d/`.
* Change command line arguments to consul in `/etc/sysconfig/consul`.
* Add `-bootstrap` **only** if this is the first server and instance.
* Start the service and tail the logs `systemctl start consul.service` and `journalctl -f`.
* To enable at reboot `systemctl enable consul.service`.
* Consul may complain about the `GOMAXPROCS` setting. This is safe to ignore;
however, the warning can be supressed by uncommenting the appropriate line in
`/etc/sysconfig/consul`.
## Config
Config files are loaded in lexicographical order from the `config-dir`. Some
sample configs are provided.
# More info
See the [consul.io](http://www.consul.io) website.
## Backwards compatibility
Earlier verisons of this package used `/etc/consul/` as the default
configuration directory. As of 0.7.2, the default directory was changed to
`/etc/consul.d/` in order to align with the offcial Consul docuemntation. In
order to avoid breaking existing installations during upgrade, *both* of the
directories will be created during package install.