Chef cookbook for deploying Eucalyptus
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
attributes
environments
eucadev
faststart
libraries
recipes
roles
templates/default
test/integration/ciab/serverspec
.gitignore
.kitchen.yml
Berksfile
CHANGELOG.md
LICENSE
README.md
Vagrantfile
bootstrap.json
bootstrap_ceph.json
bootstrap_riakcs.json
chefignore
eucadev.md
metadata.json
metadata.rb
motherbrain.rb

README.md

Stories in Ready eucalyptus Cookbook

This cookbook installs and configures Eucalyptus on RHEL/CentOS 7 physical and virtual machines. Source and package installations are supported.

Requirements

Branches

The following table descirbes the branch to use for each Eucalyptus release:

Branch Cookbook version Euca version Notes
master 0.3.x 4.1.0 maps to latest released eucalyptus version
euca-4.0 0.3.x 4.0.2 Stable branch for 4.0.x installs
euca-4.1 0.4.x 4.1.1 Maint branch for 4.1.x installs
euca-4.2 1.0.x 4.2.0 breaks the attribute API
euca-4.3 1.0.x 4.3.0 Stable branch for 4.3.x installs
euca-4.4 1.0.x 4.4.0 Stable branch for 4.4.x installs

Environment

To deploy a distributed topology it is necessary to define an environment with at least these attributes defined:

  • node['eucalyptus']['topology']
  • node['eucalyptus']['network']['config-json']
"default_attributes": {
    "eucalyptus": {
      "topology": {
        "clc-1": "10.111.5.163",
        "walrus": "10.111.5.163",
        "user-facing": ["10.111.5.163"],
        "clusters": {
          "default": {
            "cc-1": "10.111.5.164",
            "sc-1": "10.111.5.164",
            "storage-backend": "das",
            "das-device": "vg01",
            "nodes": "10.111.5.162 10.111.5.166 10.111.5.165 10.111.5.157"
          }
        }
      },
      "network": {
        "mode": "EDGE",
        "config-json": {
                  "InstanceDnsDomain" : "eucalyptus.internal",
                  "InstanceDnsServers": ["10.111.5.163"],
                  "PublicIps": ["10.111.55.1-10.111.55.220"],
                  "Subnets": [],
        "Clusters": [
           {
            "Name": "default",
            "MacPrefix": "d0:0d",
            "Subnet": {
                "Name": "172.16.55.0",
                "Subnet": "172.16.55.0",
                "Netmask": "255.255.255.0",
                "Gateway": "172.16.55.1"
            },
            "PrivateIps": [ "172.16.55.20-172.16.55.140"]
            }]
          }
        }
      }
    }  

Platforms

This cookbook only supports RHEL/CentOS 7 at the time being.

Berkshelf

A Berksfile is included to allow users to easily download the required cookbook dependencies.

  • Install Berkshelf: gem install berkshelf
  • Install Deps from inside this cookbook: berks install

Cookbooks

  • ntp - sets up NTP for all Eucalyptus servers
  • yum - used for managing repositories

Chef server config

Ensure that the following config is set in /etc/chef-server/chef-server.rb: erchef['s3_url_ttl'] = 3600

Attributes

Attribute list can be found in attributes/default.rb

Some common attributes are:

eucalyptus installation config

Key Type Description Default
["eucalyptus"]["install-type"] String Choose to install from `package` or `source` package
["eucalyptus"]["source-repo"] String Git repository to clone when building from source https://github.com/eucalyptus/eucalyptus.git
["eucalyptus"]["source-branch"] String Branch to use when building from source maint-4.1

eucalyptus network config

Key Type Description Default
["eucalyptus"]["network"]["mode"] String Networking mode to use MANAGED-NOVLAN
["eucalyptus"]["network"]["private-interface"] String Private interface of component eth0
["eucalyptus"]["network"]["public-interface"] String Public interface of component eth0
["eucalyptus"]["network"]["bridge-interface"] String Bridge interface of component. Will be created and set by playbook br0

Usage

For cloud-in-a-box installs look at... Eucadev

For distributed topologies... Deployment with motherbrain

Faststart

Methodology

Faststart is a Bash script, faststart/cloud-in-a-box.sh, that invokes the Eucalyptus cookbook in order to install a single host cloud-in-a-box install. It will package up the Chef cookbooks as a berks package, then install Eucalyptus. To run the Faststart script, from the top level eucalyptus-cookbook directory, execute:

faststart/cloud-in-a-box.sh

Once invoked the script does the following:

  1. Checks for necessary resources on the machine that it is installing on (ie disk, memory, virtualization extensions)
  2. Asks the user for the minimum necessary configuration parameters.
  3. Installs the Chef client
  4. Runs the Chef client in order to install Eucalyptus using the cookbook tarball and the inputs from the user.

Inputs from the user are searched and replaced into the templates in faststart/ciab-template.json and fastart/node-template.json and then used as follows to run the cookbook:

chef-client -z -r cookbooks.tgz -j ciab.json

Contributing

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github

License and Authors

Authors:

Vic Iglesias vic.iglesias@eucalyptus.com