Nise BOSH is a lightweight BOSH emulator. You can easily install multiple BOSH packages on your servers with Nise BOSH commands. 'Nise' means 'Pseudo' in Japanese.

• Cloud Foundry v2 installer with Nise BOSH
  • One liner CF installer for both local machines and Vagrant
• Nise BOSH Vagrant
  • Vagrant integration by BrianMMcClain. See also: "Introducing Nise-bosh-vagrant"
• Step by Step Guide on Cloud Foundry Blog (v1)
• Architecture Guide (v1)

• Ubuntu 10.04, 12.04
• Ubuntu 10.04 64bit is recommended when you install cf-release jobs.
• Ruby 1.9.3-p448 or higher
• Bundler

("Cloud Foundry v2 installer with Nise BOSH" is available for Cloud Foundry users)

You can install the required gems to execute Nise BOSH commands with bundler.

Run the command below:

bundle install

Nise BOSH requires a clone of the 'release' repository you want to install (e.g. cf-release for Cloud Foundry). Clone the repository with the git command.

git clone [email protected]:cloudfoundry/cf-release.git

You can skip this section when you have no modification to the release repository. The latest final release will be used automatically.

When you modify the cloned repository, you need to create a dev (or final) release to install it with Nise BOSH.

If you have not installed BOSH CLI. You can install it with the gem command.

gem install bosh_cli

Then build a release, this might take several minutes at the first run.

bosh create release

You will be asked the name of the build, input the preferred name such as 'appcloud'.

Note that when your release directory is dirty (uncommitted files exist), you need to execute 'bosh create release ' with "--force" option.

Nise-BOSH requires a deployment manifest, which contains the configuration of your release. The Nise-BOSH's manifest file is compatible with, or a subset of, BOSH's manifest format.

You can find an example at Cloud foundry docs.

---
jobs:
  - name: devbox
    template: dea_next

properties:
  domain: vcap.me

  networks:
    apps: default
    management: default

  nats:
    user: nats
    password: nats
    address: 127.0.0.1
    port: 4222

  dea_next:
    streaming_timeout: 60
    memory_mb: 4096
    memory_overcommit_factor: 1
    disk_mb: 32000
    disk_overcommit_factor: 1
    num_instances: 30

Run nise-bosh command. You may want to run with 'sudo' and/or 'bundle exec'

./bin/nise-bosh <path_to_release_repository> <path_to_deploy_manifest> <job_name>

Example:

sudo env PATH=$PATH bundle exec ./bin/nise-bosh ~/cf-release ~/deploy.conf devbox

You need to install and create the required apt packages and users on your environment to execute certain job processes from cf-release. The original BOSH sets up the environment using a stemcell, but Nise-BOSH does not support it. You can simulate a stemcell-like environment on your server by executing the bin/init script.

sudo ./bin/init

This script runs the minimal (sometimes insufficient) commands extracted from the stemcell-builder stages.

Once installation is complete, you can launch job processes by the monit command installed by the bin/init script.

sudo /var/vcap/bosh/bin/monit start all

Nise-BOSH does not ask any prompts.

By default, Nise-BOSH does not re-install packages that are already installed. This option forces Nise BOSH to re-install all packages.

Nise-BOSH installs packages into this directory. The default value is /var/vcap. Be sure to change this value because some packages given by cf-release have hard-coded directory names in their packaging scripts and template files.

Nise-BOSH uses the given directory to run packaging scripts. The default value is /tmp/nise_bosh.

Nise-BOSH does not install the required packages for the given job. Nise-BOSH only fills template files for the given job and writes them out to the install directory.

Nise-BOSH uses the given release file for deploying. By default, Nise BOSH automatically detects the newest release file.

Nise-BOSH assumes the IP address of your host using 'ip' command by default. You can overwrite the value by this option.

Nise-BOSH assumes the index number of your host is assigned as 0 by default. When you install the same job on multiple hosts, you can set the index number with this option. The value "spec.index" in the job template files is replaced with this value.

Nise-BOSH installs the given packages, not a job. When this option is chosen, the file path for the deploy manifest file must be omitted.

Example:

sudo env PATH=$PATH bundle exec ./bin/nise-bosh -p ~/cf-release_interim dea_jvm dea_ruby

Nise-BOSH does not install dependency packages. This option must be used with '-c' option.

Nise-BOSH aggregates the packages and the index file required to install the given job and creates an archive file that includes them. This behavior is similar to 'bosh create release --with-tarball', but the generated archive file contains the minimum packages to install the given job.

You can generate stemcell_base.tar.gz for the rootfs of Warden containers by the 'gen-stemcell' command. Default config files are found in the config directory. Before executing, change the password for containers in config/stemcell-settings.sh.

sudo ./bin/gen-stemcell [<output_filename_or_directory>]

The generated archive file is placed on /var/vcap/stemcell_base.tar.gz by default. You can change the path and other behavior by the giving command line options shown by the '--help' option.

You can install basic apt packages and create users for the BOSH stemcell with this command.

You can download objects from the blobstore for cf-release by using the 'bget' command.

./bin/bget -o <output_file_name> <object_id>

Nise BOSH has some kwon incompatibility with BOSH.

• File permissions
  • Nise BOSH does not harden the file permisison of the files such as /dev/shm/, /var/lock, /data/vcap/data, /data/vcap/store, and /tmp.
    • Performed by bosh_agent
• Packaging-time dependencies
  • Nise BOSH keeps packaging-time depended packages (listed in the spec of packages) after installation

Apache License Version 2.0

The original BOSH is developed by VMware, inc. and distributed under Apache License Version 2.0.

• BOSH
• The original tool chain
• Recommended when IaaS support is available
• cf-vagrant-installer
• Vagrant installer for Cloud Foundry v2