Using Habitus with Skycap

Skycap integrates build flows created using Habitus. This allows you to reuse your existing build.yml files to build your application images within Skycap.

What is Habitus?

If you’re not an existing Habitus user, you’ll need to read through its documentation to fully understand the purpose and power of the tool.

Essentially Habitus allows you the define a workflow that controls the order and manner in which your code is built into Docker images. This is especially useful if your containers have multiple components or dependencies that need to be built in a specific order.

What you’ll need

Before you start, please check you have the following:

  • A Cloud 66 Account — If you don't already have one sign up for a Cloud 66 account. Your first server is free, no credit card required.

  • A Habitus enabled project repository — If you don’t have one, we have a sample project that you can use for this tutorial.

  • A service.yml file on your desktop — You can download the file from the repo above, or use your own.

Using a Habitus build flow with Skycap

Skycap’s default behaviour is to build “simple” applications which have a single Dockerfile, so Habitus-enabled projects need to follow a different route:

  1. Open your Cloud 66 dashboard, click the green New Application button and choose “Skycap”
  2. Name your application (e.g. “Habitus example”)
  3. Click on Upload service.yml File and then select the file in question
  4. Click Next and then wait for Skycap to ingest all the components in the service.yml (this can take a little while depending on the complexity of the project).

Once the service has been successfully added to Skycap, you can run a full Habitus build by clicking Create Snapshot.

You can track the output of the Habitus build process by clicking on the View … build logs link and then clicking the grey More logs button.

What’s next?