initial Role documentation for Glance, Horizon, Keystone and Nova (Swift will come later)

documentation/glance.md

@@ -0,0 +1,36 @@
+Description
+===========
+The following roles are used in the deployment of the OpenStack Image Service **Glance** as part of the OpenStack **Essex** reference deployment using Chef.
+
+Dependency Roles
+================
+
+base
+----
+Every Glance role depends on the `base` role included in the repository to ensure essential services (ntp, openssh, etc.).
+
+mysql-master
+------------
+roles and underlying recipes providing database services through MySQL required for glance (and Keystone, Nova and Horizon).
+
+rabbitmq-server
+---------------
+roles and underlying recipes providing messaging services through RabbitMQ required for Glance (and Nova).
+
+os-database
+-----------
+expose and provide the attributes used for configuring glance's database.
+
+os-network
+----------
+expose and provide the attributes used for configuring and defining glance's network.
+
+Glance Roles
+============
+
+glance-api
+----------
+
+
+glance-registry
+---------------

documentation/horizon.md

@@ -0,0 +1,28 @@
+Description
+===========
+The following roles are used in the deployment of the OpenStack Dashboard service **Horizon** as part of the OpenStack **Essex** reference deployment using Chef.
+
+Dependency Roles
+================
+
+base
+----
+Every Horizon role depends on the `base` role included in the repository to ensure essential services (ntp, openssh, etc.).
+
+mysql-master
+------------
+roles and underlying recipes providing database services through MySQL required for Horizon (and Keystone, Glance and Nova).
+
+os-database
+-----------
+expose and provide the attributes used for configuring Horizon's database.
+
+os-network
+----------
+expose and provide the attributes used for configuring and defining Horizon's network.
+
+Horizon Roles
+=============
+
+horizon-server
+--------------

documentation/keystone.md

@@ -0,0 +1,28 @@
+Description
+===========
+The following roles are used in the deployment of the OpenStack Identity Service **Keystone** as part of the OpenStack **Essex** reference deployment using Chef.
+
+Dependency Roles
+================
+
+base
+----
+Every Keystone role depends on the `base` role included in the repository to ensure essential services (ntp, openssh, etc.).
+
+mysql-master
+------------
+roles and underlying recipes providing database services through MySQL required for Keystone (and Nova, Glance and Horizon).
+
+os-database
+-----------
+expose and provide the attributes used for configuring Keystone's database.
+
+os-network
+----------
+expose and provide the attributes used for configuring and defining Keystone's network.
+
+Keystone Roles
+==============
+
+keystone
+--------

documentation/nova.md

@@ -1,25 +1,61 @@
-base
-database
-rabbitmq
-keystone
-glance
-nova::setup
-    nova::common : packages, /etc/nova/ nova.conf .novarc
-    configure DB connection, create networks
-nova::scheduler
-nova::api
-nova::volume
-nova::vncproxy
-horizon
+Description
+===========
+The following roles are used in the deployment of the OpenStack Compute service **Nova** as part of the OpenStack **Essex** reference deployment using Chef.
+
+Dependency Roles
+================
+
+base
+----
+Every Nova role depends on the `base` role included in the repository to ensure essential services (ntp, openssh, etc.).
+
+mysql-master
+------------
+roles and underlying recipes providing database services through MySQL required for Nova (and Keystone, Glance and Horizon).
+
+rabbitmq-server
+---------------
+roles and underlying recipes providing messaging services through RabbitMQ required for Nova (and Glance).
+
+os-database
+-----------
+expose and provide the attributes used for configuring Nova's database.
+
+os-network
+----------
+expose and provide the attributes used for configuring and defining Nova's network.
+
+Nova Roles
+==========
+
+allinone
+--------
+
+
+single-compute
+--------------
+
+
+single-controller
+-----------------
+
+
+nova-scheduler
+--------------
+
+
+nova-api-ec2
+------------
+
+
+nova-os-compute
+---------------
+
+
+nova-vncproxy
+-------------
+
+
+nova-volume
+-----------
 
-     "recipe[nova::config]",
-     "recipe[nova::mysql]",
-          "recipe[rabbitmq]",
-         "recipe[nova::rabbit]",
-         "recipe[nova::api]",
-         "recipe[nova::network]",
-         "recipe[nova::scheduler]",
-         "recipe[nova::vncproxy]",
-         "recipe[nova::volume]",
-         "recipe[nova::project]",
-         "recipe[nova::monitor]"