This guide will help you setup and deploy a Cloud Foundry Core instance to be controlled by the Static Cloud Manager at a remote providers datacenter.
##Setup
-
A Ruby setup is required to run the installer. If not already installed on the system instructions can be found in the [Installing Ruby](#Installing Ruby) section below for your given environment.
-
Setup your desired provider, links are provided below in the Provider Setup Information.
-
From the command line install the following required plugins by typing the followind commands:
vagrant plugin install vendor/cache/vagrant-omnibus-*.gem vagrant plugin install vendor/cache/vagrant-berkshelf-*.gem vagrant plugin install vendor/cache/vagrant-aws-*.gem vagrant plugin install vendor/cache/vagrant-rackspace-*.gem vagrant plugin install vendor/cache/vagrant-digitalocean-*.gem
or you can run
for i in omnibus berkshelf aws rackspace digitalocean; do vagrant plugin install vendor/cache/vagrant-$i-*.gem; done
-
You will need ssh keys in order to connect to the deployed machine instance. Insecure ssh keys are preconfigured and provided for you to use or if you like you can create custom ssh keys for use. Instructions for both options are provided as follows:
-
To use the provided insecure ssh keys copy
mv config/ssh/static_id_rsa.default config/ssh/static_id_rsa mv config/ssh/static_id_rsa.default.pub config/ssh/static_id_rsa.pub
-
To create custom ssh keys and store them in the
config/ssh
folder with the following command:ssh-keygen -t rsa -C static_id_rsa -f config/ssh/static_id_rsa
-
-
To configure the deployment for the desired provider and its options you first must copy
config/config.yml.default
toconfig/config.yml
and edit this configuration file based on the the following options:- Change the
active_provider
variable to your desired provider you wish to deploy to, choices are:- aws
- rackspace
- digital_ocean
- Set the
hosting_domain
variable to your custom domain where applications will be deployed and hosted from. The installer, when finished, will prompt you with results for you to use to set a DNS wildcard for*.{YOUR CUSTOM DOMAIN HERE}
. - If you modified the ssh key in the previous step set
ssh_key_name
to the location of your new key - Configure the given section for the specific provider. Links are provided below in the Provider Setup Information section for the information needed.
- NOTE: the
ssh_key_name
orkeypair_name
will be the name that you have set the ssh key name for within the providers control panel. The generatedconfig/ssh/static_id_rsa.pub
file will contain the string to paste on the providers control panel ssh keys settings page.
- NOTE: the
- Change the
-
Deploy Cloud Foundry to the configured provider with the following command:
vagrant up
this may take awhile depending on the given provider. When finished the installer will print out the necessary information and create a
cloud.settings
file. These settings are used within the Static Cloud Manager remote provider setting page located athttp://{YOUR-CONFIGURED-STATIC-CLOUD-MANAGER-DOMAIN}/admin/datacenter/sites/plugins
in order to control and deploy PaaS applications.
The following links will provide you with the locations for finding the necessary information to fill in the config/config.yml
configuration file.
-
Login to Amazon AWS control panel and setup your Amazon account. Region of us-east-1 is assumed for all links.
-
-
name: static_id_rsa
-
provided key:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCvYx/Sa0ucg73SJxkFMsutg1+iiNpUc2hXXiu/dMZijhiNQ/acMQjka1fx01cMSJ2+ZDU//6QPlxN8nLecrD7eWMfYARM7yOWaj/Zc6qipORMH0re38wCP2AlwOW70rNjf0j9QAf5M6h6allFRR8FHi3XjrKpvKevzBQIcy0sSM3tLzsrq2rkdsMFP/FJ0dcIof+Ktj/wMgN3Uaxj8I9F9yqScSiyTe0OG1YrAhbYEUzvgSJdBUyYwp6XIAVvo1lkt1zFz+mSUaKEFIFXVlScFLPx6fnViE+1LARAqKqd7Vi6ZyVurmoLbcoThIzlClc4N+B7yfaECRZCUSSN/f9yJ static_id_rsa
-
-
- Enable ports 22, 80, 443, 8080 for the default security group
-
Login to the Rackspace control panel and setup your Rackspace account
-
Login to the Digital Ocean control panel and setup your Digital Ocean account
- Digital Ocean Access Key and Secret
- Digital Ocean SSH Keys
-
name: static_id_rsa
-
provided key:
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCvYx/Sa0ucg73SJxkFMsutg1+iiNpUc2hXXiu/dMZijhiNQ/acMQjka1fx01cMSJ2+ZDU//6QPlxN8nLecrD7eWMfYARM7yOWaj/Zc6qipORMH0re38wCP2AlwOW70rNjf0j9QAf5M6h6allFRR8FHi3XjrKpvKevzBQIcy0sSM3tLzsrq2rkdsMFP/FJ0dcIof+Ktj/wMgN3Uaxj8I9F9yqScSiyTe0OG1YrAhbYEUzvgSJdBUyYwp6XIAVvo1lkt1zFz+mSUaKEFIFXVlScFLPx6fnViE+1LARAqKqd7Vi6ZyVurmoLbcoThIzlClc4N+B7yfaECRZCUSSN/f9yJ static_id_rsa
-
- Cloudstack
- OpenStack
- VSphere
- Eucalyptus
- Windows Azure
The following guide will walk you through how to install and setup Ruby for your current system
- Ruby setup
-
Using the system Ruby install
-
If you choose to run with the system version of ruby all
install
commands will have to be prepended with sudo to avoid ** You don't have write permissions into ... ** errors. -
To install the gems locally rather than at the system level you can use the following configuration in your terminal. Edit your default environment settings, typically located in your ~/.bash_profile, and add the following
# Ruby Configuration export GEM_HOME=$HOME/.gem export PATH=$PATH:$GEM_HOME/bin
-
-
Or you can use an RVM Install
-
RVM will automatically set the
GEM_HOME
environment variable for you when selecting the desired ruby version -
RVM can be installed manually via the command line by running
$ curl -#L https://get.rvm.io | bash -s stable --ruby
-
On OS X RVM also offers a GUI to simplify management of Ruby version and gems called JewelryBox
-
-
-
Dependency Install
apt-get install curl build-essential openssl libreadline6 libreadline6-dev curl git-core zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libgdbm-dev ncurses-dev automake libtool bison subversion pkg-config libffi-dev
-
Ruby setup
-
Using apt-get you can install ruby
apt-get install ruby rubygems
-
Using an RVM Install
-
- Ruby setup
- Download and install Ruby Installer for Windows. When using the command line be sure to use the Ruby-enabled command prompt window. You access this command prompt from the Windows Start menu (All Programs > Ruby > Start Command Prompt with Ruby).
Except as otherwise noted this software is licensed under the Apache License, Version 2.0
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.