A Rack middleware that will add a unique identifier (sha) to the application. It will set a custom header (X-Shack-Sha) containing the sha and will automagically insert a small banner in the HTML.
Visit a live demo at https://canadiaweather.herokuapp.com or:
❯ curl -I kkez.dev
HTTP/1.1 200 OK
Server: nginx/1.6.1
Date: Sun, 30 Nov 2014 23:49:10 GMT
Content-Type: text/html;charset=utf-8
Content-Length: 491
Connection: keep-alive
X-Shack-Sha: 39aee4f
This way you can always be certain which version of your app is currently running, especially handy in staging environments.
If you don't supply a sha nothing will happen (so for example if you use an ENV variable containing the sha and don't set it in production, no one will be any wiser).
For a rack app:
require "shack"
app = Rack::Builder.new do
use Shack::Middleware, ENV["SHA"]
run -> (env) { [200, {"Content-Type" => "text/html", ["<html><body>KAAAHN</body></html>"]]
end
Rack::Server.start app: appIf your rack app happens to be a Rails app:
Add shack to your Gemfile, and specify how to get the hash in an initializer (config/initializers/shack.rb)
Shack::Middleware.configure do |shack|
shack.sha = File.open("BUILD_NUMBER").read.strip
endAnd since it's Rails, it can also be done automagically if a file called REVISION is found in the root of your project. No initializer required. Note: by default it won't show the banner in production environments, because that just feels wrong.
It's also possible to get the sha, in the running app, Shack.sha. This could be helpful in passing the sha along to a service like Airbrake.
You can either set the sha directly:
Shack::Middleware.configure do |shack|
shack.sha = File.open("REVISION").read.strip
shack.hide_stamp = true # this will hide the banner
endOr you can set the string to show in the HTML banner (with {{sha}} being a special variable which will be replaced with the sha):
Shack::Middleware.configure do |shack|
shack.sha = File.open("REVISION").read.strip
shack.content = "#{Rails.env} - <a href="https://github.com/shack/commit/{{sha}}>{{sha}}</a>"
endThere is also a {{short_sha}} substition available, which returns the first 8 chars of the set sha.
If you define your own CSS for #shack-stamp and #shack-stamp__content, you can override the default styling. (It uses classes so your specificity should be higher)
If you just want to change the position of the sha, you can do this in a configuration block:
# Sets the sha to the top left corner
Shack::Middleware.configure do |shack|
shack.horizontal = :left # or :right
shack.vertical = :top # or :bottom
endEither write it to a REVISION file on deploy (Capistrano used to this by default, now you can add a task, in mina I'm waiting on this pull request), or set an ENV variable containing the sha.
So instead of using regular mina add this to your Gemfile:
gem "mina", git: "https://github.com/pjaspers/mina.git", branch: "pj-write-sha-to-revision-file"
Now you can set the sha in the configure block.
In canadia I made an after deploy hook that added an ENV variable which set the sha. The easiest way I could do this is with something like this:
curl -n -H "Authorization: Bearer $HEROKU_API_KEY" -X PATCH https://api.heroku.com/apps/canadiaweather/config-vars -H "Accept: application/vnd.heroku+json; version=3" -H "Content-Type: application/json" -d '{"SHA":"'"$TRAVIS_COMMIT"'"}'
(I used Travis to do the deploying, look here for all the glorious details)
shack is cryptographically signed. To be sure the gem you install hasn’t been tampered with:
- Download certificate https://raw.github.com/pjaspers/shack/certs/pjaspers.pem
- Add
gem cert –add pjaspers.pem - gem install shack -P HighSecurity
For the PHP-inclined, here is a PHP version by @tinydroptest2.
- Fork it ( https://github.com/pjaspers/shack/fork )
- Create a new Pull Request
- Technology.