Skip to content

Latest commit

 

History

History
144 lines (93 loc) · 5.06 KB

README.md

File metadata and controls

144 lines (93 loc) · 5.06 KB
Raw

Cloud Foundry v2 Nise Installer

Devbox Installer with Nise BOSH and nise-bosh-vagrant

CF Nise Installer is a set of scripts that install Cloud Foundry v2 instance to your single machine or Vagrant VM. You can build your 'devbox' quickly by runing a single command with this installer.

CF Nise Installer is based on cf-release by Pivotal, Nise BOSH by NTT Laboratory and nise-bosh-vagrant by Brian McClain.

Build Devbox on Single Server

This section shows you how to install CF components to your server.

If you want to build a devbox on a Vagrant VM, skip this section and see the next section.

Requirements

  • Ubuntu 10.04 64bit
    • Ubuntu 12.04 is not suported
  • 8GB+ free HDD space
  • 4Gb+ memory
    • m1.large or larger instance is recommended on AWS

Install Cloud Foundry Components

Run the commands below on your server:

sudo apt-get install curl
bash < <(curl -s -k -B https://raw.github.com/yudai/cf_nise_installer/master/scripts/bootstrap.sh)

The bootstrap.sh script installs everything needed for the devbox. This command may take a couple of hours at first run.

Launch Processes

Once the installation completes, You can launch the processes for the devbox with the Monit which installed by Nise BOSH.

# Start Monit (required only after rebooting your server)
sudo /var/vcap/bosh/bin/monit
# Launch `all` processes
sudo /var/vcap/bosh/bin/monit start all
# See status
sudo /var/vcap/bosh/bin/monit status
sudo /var/vcap/bosh/bin/monit summary # shorter
# Stop `all` processes
sudo /var/vcap/bosh/bin/monit stop all

Confirm all the processes shown by monit summary indicate running. It takes a few minutes to initialize all processes.

Update Existing Devobox

You can update your existing devbox with the latest cf-release resources by executing local_install.sh script downloaded by the bootstrap.sh script.

Customize Devbox

You can choose your cf-release repositry and its branch to install by setting environmental variables.

Name Default
CF_RELEASE_URI https://github.com/cloudfoundry/cf-release.git
CF_RELEASE_BRANCH master

These values are used only when no cf-release directory exists in the working directory. You can also put your prefered cf-release before running the script.

Build Devbox with Vagrant

You can create a devbox VM quickly with Vagrant and nise-bosh-vagrant.

Requirements

  • Vagrant 1.2 or later
  • Ruby 1.9.3-p392 (Required by cf-release)
  • 8GB+ free HDD space
  • 4GB+ free memory

Preparation

Install some gems required for installation and clone this repository.

# Install required gems, add `sudo` if needed
gem install bosh_cli bundler nise-bosh-vagrant
rbenv rehash # for rbenv users

git clone https://github.com/yudai/cf_nise_installer.git

Build cf-release

You need a 'release' of cf-release repository that contains all source code for Cloud Foundry.

If you don't have a release. You can build one by executing following command. This command may take one hour at first run.

./cf_nise_installer/scripts/clone_cf_release.sh

Launch Vagrant VM

Run the following command:

nise-bosh-vagrant ./cf-release --manifest ./cf_nise_installer/manifests/micro.yml --postinstall ./cf_nise_installer/scripts/postinstall.sh --memory 4096 --start

Public Network

If you want to make your devbox accessible from other hosts, you need to add the --bridge option and specify the IP address of the VM with the --address option.

nise-bosh-vagrant ./cf-release --manifest ./cf_nise_installer/manifests/micro.yml --postinstall ./cf_nise_installer/scripts/postinstall.sh --memory 4096 --start --bridge --address 10.1.1.39

Play with installed Devbox

You can target and login to your installed devbox using following values:

Target URI api.<IP Address>.xip.io api.192.168.10.10.xip.io
Admin User micro@vcap.me <-
Admin Password micr0@micr0 <-

When you installed your devbox with Vagrant, you can access your devobx only from the host machine that runs the VM.

'xip.io' is a DNS service provided by 37signals that returns the IP address specified in the subdomain of FQDNs.

Service token registration

To create services, you need to register tokens to UAA.

# login as an admin in advance
gem install admin-cf-plugin
cf create-service-auth-token --provider core --token token --label postgresql
cf create-service-auth-token --provider core --token token --label mysql

Other resources