https://github.com/yudai/cf_nise_installer

Cloud Foundry v2 installer with Nise BOSH and Vagrant
https://github.com/yudai/cf_nise_installer

Last synced: 6 months ago
JSON representation

Cloud Foundry v2 installer with Nise BOSH and Vagrant

Host: GitHub
URL: https://github.com/yudai/cf_nise_installer
Owner: yudai
License: apache-2.0
Created: 2013-05-29T14:08:59.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2023-04-15T12:36:44.000Z (over 2 years ago)
Last Synced: 2025-03-26T10:48:03.492Z (7 months ago)
Language: Shell
Size: 179 KB
Stars: 85
Watchers: 14
Forks: 57
Open Issues: 12
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Cloud Foundry v2 Nise Installer

## Devbox Installer with Nise BOSH

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

CF Nise Installer is based on [cf-release](https://github.com/cloudfoundry/cf-release) by Pivotal, [Nise BOSH](http://github.com/nttlabs/nise_bosh/) by NTT Laboratory.

### *NOTICE*

This installer is maintained mainly for testing cf-release on a baremetal environemnt. If you just want to try Cloud Foundry, [bosh-lite](https://github.com/cloudfoundry/bosh-lite) may be a better solution for you.

When ask a question about Cloud Foundry build by this installer at vcap-dev, please describe that you are uing cf-nise-installer in your post. That makes it easier to isolate your problem and to answer your question. If the problem you got is certainly caused by this installer, please do not post to vcap-dev and submit an issue to this repository.

## Building 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 14.04 64bit (Trusty)
* Do NOT install RVM to avoid conflicting with RBenv
* 8GB+ free HDD space
* 2GB+ memory
* m1.medium or larger instance is recommended on AWS

### Installing Cloud Foundry Components

Run the commands below on your server:

```sh
sudo apt-get install curl
bash < <(curl -s -k -B https://raw.githubusercontent.com/yudai/cf_nise_installer/${INSTALLER_BRANCH:-master}/scripts/bootstrap.sh)
```

The `bootstrap.sh` script installs everything necessary to your devbox. This command may take a couple of hours at first run.

You need to restart your server once after the installation is completed.

### Launching Processes

You can start Cloud Foundry by running the following command in the `cf_nise_installer` directory cloned by the `bootstrap.sh` script:

```sh
./scripts/start.sh
```

This command launches a Monit process and then start up all monit jobs installed by Nise BOSH.

You can also manually manage the processes with the Monit command:

```sh
# Start Monit
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` is indicating `running`. It takes a few minutes to initialize all processes.

### Update Existing Devbox

To update your existing Devbox, you can use scripts in the `scripts` directory. You don't need to execute the `bootstrap.sh` script for this purpose.

* install.sh
* Runs the following scripts in order
* install_ruby.sh
* Installs Ruby binaries with Rbenv and the `cf` command gem
* If `.rbenv` directory exists in your homedirectory, this script do nothing
* clone_nise_bosh.sh
* Clones the `nise_bosh` repository
* When the `nise_bosh` directory is not empty, this script do nothing
* clone_cf_release.sh
* Clones the `cf-release` repository
* When the `cf-release` directory is not empty, this script do nothing
* install_environemnt.sh
* Run the `init` command of Nise BOSH
* install_cf_release.sh
* Installs cf-release jobs and packages with Nise BOSH

* start.sh
* Invokes a Monit process and CF processes
* stop.sh
* Stop all CF processes

When run these scrips, be sure your are in the `cf_nise_installer` directory and not in `scripts` directory.

#### Notes for Updating Devbox

These scripts do *not* automatically update existing files in the working directory such as the `cf-release` and `nise_bosh` directories. This means once you have executed the installer, you need to manually update files in your working directory to update your devbox. If you just want to update your debox to the latest version of cf-release, it is the easiest way to delete your `cf_nise_installer` directory and run the `bootstarp.sh` script.

### Environment Variables

You can customize your installation using environment variables. Note that variables taks effect only when script is not skipped. For example, the variable `CF_RELEASE_URL` is used only when the `cf-release` directory is empty.

[note]: Do *not* use any relative revision specifier from HEAD (e.g. `HEAD~`, `HEAD~10`, `HEAD^^`). Please use an absolute revision specifier (e.g. `123abc`, `develop`). You may use a relative revision specifier from an absolute revision specifier (e.g. `master~~`).

## Build Devbox with Vagrant

You can create a devbox VM quickly with a VM using Vagrant.

#### Requirements

* Vagrant 1.4 or later
* Ruby 1.9.3-p484
* 8GB+ free HDD space
* 2GB+ free memory

### Launch Vagrant VM

Clone this repository and run the command below.

```sh
vagrant up
```

Your working directory will be mount at `/vagrant`.

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/yudai/cf_nise_installer

Awesome Lists containing this project

README