eucalyptus Cookbook

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

Requirements

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": {
          "one": {
            "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"
          },
          "two": {
            "cc-1": "10.111.5.155",
            "sc-1": "10.111.5.155",
            "storage-backend": "das",
            "das-device": "vg01",
            "nodes": "10.111.5.177 10.111.5.156 10.111.5.159"
          }
        }
      },
      "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": "one",
            "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 6 at the time being.

Bershelf

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
• selinux - disables selinux on Eucalyptus servers

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

<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>["eucalyptus"]["install-type"]</tt></td>
<td>String</td>
<td>Choose to install from package or source</td>
<td><tt>package</tt></td>
</tr>
<tr>
<td><tt>["eucalyptus"]["source-repo"]</tt></td>
<td>String</td>
<td>Git repository to clone when building from source</td>
<td><tt>https://github.com/eucalyptus/eucalyptus.git</tt></td>
</tr>
<tr>
<td><tt>["eucalyptus"]["source-branch"]</tt></td>
<td>String</td>
<td>Branch to use when building from source</td>
<td><tt>testing</tt></td>
</tr>
</table>

eucalyptus network config

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

Usage

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

For distributed topologies:
Deployment with motherbrain

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