Deployment methods

Sites built using Bunto can be deployed in a large number of ways due to the static nature of the generated output. A few of the most common deployment techniques are described below.

Web hosting providers (FTP)

Just about any traditional web hosting provider will let you upload files to their servers over FTP. To upload a Bunto site to a web host using FTP, simply run the bunto build command and copy the generated _site folder to the root folder of your hosting account. This is most likely to be the httpdocs or public_html folder on most hosting providers.

Self-managed web server

If you have direct access to the deployment web server, the process is essentially the same, except you might have other methods available to you (such as scp, or even direct filesystem access) for transferring the files. Just remember to make sure the contents of the generated _site folder get placed in the appropriate web root directory for your web server.

Automated methods

There are also a number of ways to easily automate the deployment of a Bunto site. If you’ve got another method that isn’t listed below, we’d love it if you contributed so that everyone else can benefit too.

Git post-update hook

If you store your Bunto site in Git (you are using
version control, right?), it’s pretty easy to automate the
deployment process by setting up a post-update hook in your Git
repository, like
this.

Git post-receive hook

To have a remote server handle the deploy for you every time you push changes using Git, you can create a user account which has all the public keys that are authorized to deploy in its authorized_keys file. With that in place, setting up the post-receive hook is done as follows:

Deploying is now as easy as telling nginx or Apache to look at
/var/www/myrepo and running the following:

laptops$ git push deploy master

Static Publisher

Static Publisher is another automated deployment option with a server listening for webhook posts, though it’s not tied to GitHub specifically. It has a one-click deploy to Heroku, it can watch multiple projects from one server, it has an easy to user admin interface and can publish to either S3 or to a git repository (e.g. gh-pages).

Rake

Another way to deploy your Bunto site is to use Rake, HighLine, and
Net::SSH. A more complex example of deploying Bunto with Rake that deals with multiple branches can be found in Git Ready.

scp

Once you’ve generated the _site directory, you can easily scp it using a
tasks/deploy shell script similar to this deploy script. You’d obviously
need to change the values to reflect your site’s details. There is even a
matching TextMate command that will help you run this script.

rsync

Once you’ve generated the _site directory, you can easily rsync it using a tasks/deploy shell script similar to this deploy script here. You’d obviously need to change the values to reflect your site’s details.

Certificate-based authorization is another way to simplify the publishing
process. It makes sense to restrict rsync access only to the directory which it is supposed to sync. This can be done using rrsync.

Step 1: Install rrsync to your home folder (server-side)

Step 2: Set up certificate-based SSH access (server side)

This process is
described in several places online. What is different from the typical approach
is to put the restriction to certificate-based authorization in
~/.ssh/authorized_keys. Then, launch rrsync and supply
it with the folder it shall have read-write access to:

Step 4 (Optional): Exclude the transfer script from being copied to the output folder.

This step is recommended if you use these instructions to deploy your site. If
you put the deploy script in the root folder of your project, Bunto will
copy it to the output folder. This behavior can be changed in _config.yml.

Just add the following line:

# Do not copy these files to the output directoryexclude:["deploy"]

Alternatively, you can use an rsync-exclude.txt file to control which files will be transferred to your server.

Done!

Now it’s possible to publish your website simply by running the deploy
script. If your SSH certificate is passphrase-protected, you will be asked to enter it when the
script executes.

Bunto-Admin for Rails

If you want to maintain Bunto inside your existing Rails app, Bunto-Admin contains drop in code to make this possible. See Bunto-Admin’s README for more details.

Amazon S3

If you want to host your site in Amazon S3, you can do so by
using the s3_website
application. It will push your site to Amazon S3 where it can be served like
any web server,
dynamically scaling to almost unlimited traffic. This approach has the
benefit of being about the cheapest hosting option available for
low-volume blogs as you only pay for what you use.

Setting up Kickster is very easy, just install the gem and you are good to go. More documentation can here found here. If you do not want to use the gem or start a new project you can just copy paste the deployment scripts for Travis CI or Circle CI.

Aerobatic

Aerobatic is an add-on for Bitbucket that brings GitHub Pages style functionality to Bitbucket users. It includes continuous deployment, custom domains with a wildcard SSL cert, CDN, basic auth, and staging branches all in the box.

Automating the build and deployment of a Bunto site is just as simple as GitHub Pages - push your changes to your repo (excluding the _site directory) and within seconds a build will be triggered and your built site deployed to our highly- available, globally distributed hosting service. The build process will even install and execute custom Ruby plugins. See our Bunto docs for more details.