0.01
Repository is archived
No commit activity in last 3 years
No release in over 3 years
Cloudconfig is an application that manages configurations for resources in Cloudstack.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 10.3.2, ~> 10.3

Runtime

>= 1.0.1, ~> 1.0
>= 0.19.1, ~> 0.19
>= 0.0.4, ~> 0.0
 Project Readme

Cloudconfig

Build Status Gem Version

Cloudconfig is an application that manages configurations for resources in Cloudstack.

Installation

Add this line to your application's Gemfile:

gem 'cloudconfig'

And then execute:

$ bundle

Or install it yourself as:

$ gem install cloudconfig

Usage

Cloudconfig will configure resources in Cloudstack.

To use the application:

cloudconfig --help

Create config:

cloudconfig config URL API_KEY SECRET_KEY RESOURCE_DIRECTORY

Dryrun can be performed to view potential changes:

cloudconfig update hosts --dryrun

Configuration of resources

Cloudconfig will configure resources in Cloudstack according to resources in yaml files in specified directory.

Resources that currently are handled by cloudconfig:

  • Compute offerings (create, update, delete)
  • Disk offerings (create, update, delete)
  • System offerings (create, update, delete)
  • Host tags (create, delete)
  • Storage tags (create, delete)

Resource files are expected to be structured in following manner in configured resource directory:

.
├── diskofferings.yaml
├── hosts.yaml
├── serviceofferings.yaml
├── storages.yaml 
└── systemofferings.yaml

diskofferings.yaml:

DiskOfferings:
  20gb:   { tags: "SSD",
            displaytext: "20GB SSD Drive",
            iscustomized: false,
            disksize: 200 }

  50GB:   { tags: "SSD",
            displaytext: "50GB SSD Drive",
	iscustomized: false,
            disksize: 50 }

  Custom: { tags: "",
            displaytext: "Customized disk offering size",
            iscustomized: true,
	disksize: 0 }

hosts.yaml:

Hosts:
  host1.example.com: { hosttags: "small,medium",
                       zonename: "example" }

  host2.example.com: { hosttags: "small,medium,large",
                       zonename: "example" }

serviceofferings.yaml:

ServiceOfferings:
  small: { displaytext: "1vCPU, 1GHz, 1GB RAM",
           storagetype: "shared",
           cpunumber: 1,
           cpuspeed: 1000,
           memory: 1024,
           tags: "disk",
           hosttags: "small" }

storage.yaml:

Storages:
  ssd: { tags: "ssd",
         zonename: "example" }

  ssd: { tags: "ssd",
         zonename: "example" }

systemofferings.yaml:

SystemOfferings:
  console-proxy: { displaytext: "1vCPU, 500MHz, 1GB RAM",
                   cpunumber: 1,
                   cpuspeed: 500,
                   memory: 1024,
                   storagetype: "shared",
                   issystem: true,
                   systemvmtype: "consoleproxy" }
  domain-router: { displaytext: "1vCPU, 500MHz, 256MB RAM",
                   cpunumber: 1,
                   cpuspeed: 500,
                   memory: 256,
                   storagetype: "shared",
                   issystem: true,
                   systemvmtype: "domainrouter" }

Testing

Currently only unit testing:

bundle install
rake

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request