Ansible playbooks for deploying OpenStack.

Go to file

Steve Lewis b657861a45 Update Glance service to Kilo To support a future release target deploying OpenStack Kilo release this change applies the changes required to provide an updated role for new deploys of Glance configured to run with the Kilo release. Highlights: - added template for glance-manage.conf - changed api and registry paste.ini files to be templated - added osprofiler filter to piplines in api and registry paste files New user secrets: - glance_profiler_hmac_key added for osprofiler use New Tunables: - glance_profiler_enabled for osprofiler use, default 'False' - glance_http_keepalive for api and registry services, default 'True' - glance_digest_algorithm for digital signatures, default 'SHA1' - glance_task_executor for task execution, default 'taskflow' - glance_policy_dirs & glance_policy_file for alternate policy config sources, default 'policy.d' and 'policy.json' respectively - glance_policy_default_rule for policy enforcement, default 'default' Change-Id: I611a0ce3145861233c81c81084b1648b2b4b4423 Partially implements: blueprint master-kilofication		2015-04-07 09:50:24 -05:00
etc	Update Glance service to Kilo	2015-04-07 09:50:24 -05:00
playbooks	Update Glance service to Kilo	2015-04-07 09:50:24 -05:00
rpc_deployment	Convert existing roles into galaxy roles	2015-02-18 10:56:25 +00:00
scripts	Updated repository for minimum viable kilo install	2015-04-03 12:57:10 -05:00
.gitignore	Initial Commit	2014-08-26 18:08:15 -05:00
.gitreview	Adds .gitreview file to repo	2014-12-02 17:22:12 -06:00
ansible-role-requirements.yml.example	Convert existing roles into galaxy roles	2015-02-18 10:56:25 +00:00
CONTRIBUTING.rst	Updating CONTRIBUTING for commit messages	2015-04-06 10:38:40 -05:00
dev-requirements.txt	Convert existing roles into galaxy roles	2015-02-18 10:56:25 +00:00
development-stack.rst	Removed all rackspace related logging parts	2015-03-14 22:35:59 -05:00
LICENSE.txt	Convert existing roles into galaxy roles	2015-02-18 10:56:25 +00:00
README.rst	Update to readme to reference doc source more generally	2015-04-06 10:50:03 -05:00
requirements.txt	Convert existing roles into galaxy roles	2015-02-18 10:56:25 +00:00

README.rst

OpenStack Ansible Deployment

date: 2015-02-02 22:00
tags: lxc, openstack, cloud, ansible
category: *nix

Playbooks

There are several playbooks within that will setup hosts for use in OpenStack Cloud. The playbooks will enable LXC on hosts and provides the ability to deploy LXC containers for use within openstack.

Plays:

setup-hosts.yml Performs host setup for use with LXC in the OpenStack hosts.
setup-infrastructure.yml Performs all of the setup for all infrastructure components.
setup-openstack.yml Performs all of the setup for all of the OpenStack components.

If you dont want to run plays individually you can simply run setup-everything.yml which will perform all of the setup and installation for you.

Basic Setup:

If you have any roles that you'd like to have pulled in that are outside the scope and or replace modules within this repository please add them to the ansible-role-requirements.yml file. In this file you will want to fill in the details for the role you want to pull in using standard ansible galaxy format.

- name: SuperAwesomeModule
  src: https://github.com/super-user/SuperAwesomeModule
  version: master

Run the ./scripts/bootstrap-ansible.sh script, which will install, pip, ansible 1.8.x, all of the required python packages, and bring in any third part ansible roles that you may want to add to the deployment.
Copy the etc/openstack_deploy directory to /etc/openstack_deploy.
Fill in your openstack_deploy/openstack_user_config.yml, openstack_deploy/user_secrets.yml and openstack_deploy/user_variables.yml files which you've just copied to your /etc/ directory.
Generate all of your random passwords executing scripts/pw-token-gen.py --file /etc/openstack_deploy/user_secrets.yml.
Accomplish all of the host networking that you want to use within the deployment. See the etc/network directory in this repository for an example network setup.
When ready change to the playbooks/ directory and execute your desired plays. IE:

openstack-ansible setup-everything.yml

Notes

If you run the ./scripts/bootstrap-ansible.sh script a wrapper script will be added to your system that wraps the ansible-playbook command to simplify the arguments required to run openstack ansible plays. The name of the wrapper script is openstack-ansible.
The lxc network is created within the lxcbr0 interface. This supports both NAT networks as well as more traditional networking. If NAT is enabled (default) the IPtables rules will be created along with the interface as a post-up processes. If you ever need to recreate the rules and or restart the dnsmask process you can bounce the interface IE: ifdown lxcb0; ifup lxcbr0 or you can use the lxc-system-manage command.
The tool lxc-system-manage is available on all lxc hosts and can assist in recreating parts of the LXC system whenever its needed.
Our repository uses a custom LXC module which adds lxc: support to Ansible. The module within this repository is merged in upstream ansible at "https://github.com/ansible/ansible-modules-extras/pull/123", but not yet released.
Inventory is generated by executing the playbooks/inventory/dynamic_inventory.py script. This is configured in the playbooks/ansible.cfg file.

Bugs and Blueprints

Everything we do is in launchpad and gerrit. If you'd like to raise a bug, feature request, or are looking for ways to contribute please go to "https://launchpad.net/openstack-ansible".

Documentation

While no os-ansible-deployment community documentation exists (yet), other than the .rst files present in this repository, comprehensive installation guides for Rackspace Private Cloud (an opinionated version of os-ansible-deployment) are available at "http://www.rackspace.com/knowledge_center/getting-started/rackspace-private-cloud".

Note:: These docs may not be up-to-date with the current release of this repository however they are still a good source of documentation.