Creating custom scripts (recipes)

Although Cloudbreak lets you provision clusters in the cloud based on custom Ambari blueprints, Cloudbreak provisioning options don't consider all possible use cases. For that reason, we introduced recipes.

A recipe is a script that runs on all nodes of a selected node group at a specific time. You can use recipes for tasks such as installing additional software or performing advanced cluster configuration. For example, you can use a recipe to put a JAR file on the Hadoop classpath.

Available recipe execution times are:

You can upload your recipes to Cloudbreak via the UI or CLI. Then, when creating a cluster, you can optionally attach one or more "recipes" and they will be executed on a specific host group at a specified time.

Writing recipes

When using recipes, consider the following:

Sample recipe for yum proxy setting

cat >> /etc/yum.conf <<ENDOF

Add recipes

In order to use your recipe for clusters, you must register it first by using the steps below.


  1. Place your script in a network location accessible from Cloudbreak and cluster instances virtual network.

  2. Select External Sources > Recipes from the navigation menu.

  3. Click on Create Recipe.

  4. Provide the following:

    Parameter Value
    Name Enter a name for your recipe.
    Description (Optional) Enter a description for your recipe.
    Execution Type Select one of the following options:
    • pre-ambari-start: The script will be executed prior to Ambari server start.
    • post-ambari-start: The script will be executed after Ambari server start but prior to cluster installation.
    • post-cluster-install: The script will be executed after cluster deployment.
    • pre-termination: The script will be executed before cluster termination.

    Select one of:

    • Script: Paste the script.
    • File: Point to a file on your machine that contains the recipe.
    • URL: Specify the URL for your recipe.
  5. When creating a cluster, you can select previously added recipes on the advanced Cluster Extensions page of the create cluster wizard.

Reusable recipes

Install mysql connector recipe

Starting from Ambari version 2.6, if you have 'MYSQL_SERVER' component in your blueprint, then you have to manually install and register the 'mysql-connector-java.jar'.

If you would like to automate this process in Cloudbreak:

The recipe content is:


download_mysql_jdbc_driver() {
  wget -P /tmp
  tar xzf /tmp/mysql-connector-java-5.1.39.tar.gz -C /tmp/
  cp /tmp/mysql-connector-java-5.1.39/mysql-connector-java-5.1.39-bin.jar /opt/jdbc-drivers/mysql-connector-java.jar

main() {