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.
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.
- 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
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.
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 allConfirm all the processes shown by monit summary indicate running. It takes a few minutes to initialize all processes.
You can update your existing devbox with the latest cf-release resources by executing local_install.sh script downloaded by the bootstrap.sh script.
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.
You can create a devbox VM quickly with Vagrant and nise-bosh-vagrant.
- Vagrant 1.2 or later
- Ruby 1.9.3-p392 (Required by cf-release)
- 8GB+ free HDD space
- 4GB+ free memory
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.gitYou 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.shRun the following command:
nise-bosh-vagrant ./cf-release --manifest ./cf_nise_installer/manifests/micro.yml --postinstall ./cf_nise_installer/scripts/postinstall.sh --memory 4096 --startIf 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.39You 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 | [email protected] | <- |
| 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.
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- cf-vagrant-installer
- Another Chef-based vagrant project