The agent itself is pretty "dumb". Its sole purpose is to monitor files paths, supplied via config file, for changes and, whenever the file has changed, send it over to the appcanary api for us to parse and make decisions on.
Oh, and it also pings us once an hour so we know it's still working.
- This project depends on a working golang and ruby environment, as well as docker.
- First, let's set up go. Go to your
go get github.com/appcanary/agent
cdinto the brand new agent folder, and install all of our go dependencies by typing:
go get -t -d -v ./...
- We'll also need go-bindata:
go get -u github.com/jteeuwen/go-bindata/...
We don't run it by default, cos it's annoying, but whenever you touch a binned file don't forget to run:
go-bindata -pkg detect -o agent/detect/bindata.go agent/resources/
and check in the result.
- Now we set bundler and install our ruby dependencies. We use ruby to script all of our build and packaging tasks. Go ahead and type:
gem install bundler # if you don't have it bundle install
This gets you all the basics up on your machine.
In order to cross compile releases, you're going to need
goxc, so visit the goxc github page and install that (last we used was version 0.16.0).
We package releases using
fpm. This is installed via bundler in step 4, HOWEVER,
rpmbuildin order to assemble rpm packages. We last used
rpmbuildversion 5.4.15. On OSX at least, that util is a apart of the
rpmhomebrew package, so:
brew install rpm
- At this stage you're able to build, test, package and deploy packages. But you know what you're missing? A way to test that the packages work on the (at time of writing) 10 different linux versions you support. We ended up using docker for this. We went and got boot2docker (cli/docker version 1.6.2 is what we used).
You may have to also fetch VirtualBox. There's instructions, docker is... complicated.
Once you've done the above, you're all set!
rake build # to compile rake test # to test rake test t=path/to/test # to test an individual file
Testing on non-Debian based systems
Note that tests will only pass completely on a system with
dpkg installed. If you do not, we include a
Dockerfile which should help. There are extra steps needed to get this working.
Now you should be able to build the docker container and run the tests:
$ cd $AGENT_REPO_ROOT $ docker build . [ ... lots of output elided ... ] Successfully built <container-id>
AGENT_REPO_ROOT is set to the correct location on your local filesystem and where
<container-sha> is actually a hexadecimal container ID. Next, run the tests:
$ docker run <container-id> rake test
You will need to rebuild the container for any code changes - don't forget! The container building process caches intermediate layers, so subsequent builds will be faster.
rake package # just to create packages rake deploy # packages, then deploys to package cloud # actually deploy to 'production' package cloud repo CANARY_ENV=production rake deploy
Testing the packaging
boot2docker start # copy and paste the export fields it gives you rake integration:test
or, alternatively, if you built a specific package:
boot2docker start # again, make sure you copy those exports rake integration:single distro=debian release=jessie package=releases/appcanary_0.0.2-2015.11.10-212042-UTC_amd64_debian_jessie.deb
Pro-tip! Don't forget to use the correct package architecture version for the machine you're on (probably, amd64).
By submitting a pull request directly to us you hereby agree to assign the copyright of your patch to the Canary Computer Corporation. Our lives are made immensely easier by this and we hope you understand.