Difference between revisions of "OpenStack-Ansible"
m |
|||
Line 3: | Line 3: | ||
=== Documentation === | === Documentation === | ||
− | All releases | + | ====All releases==== |
* http://docs.openstack.org/developer/openstack-ansible/ | * http://docs.openstack.org/developer/openstack-ansible/ | ||
− | Specific guides | + | ====Specific guides==== |
* http://docs.openstack.org/developer/openstack-ansible/draft-operations-guide/index.html | * http://docs.openstack.org/developer/openstack-ansible/draft-operations-guide/index.html | ||
* http://docs.openstack.org/developer/openstack-ansible/upgrade-guide/index.html | * http://docs.openstack.org/developer/openstack-ansible/upgrade-guide/index.html | ||
Line 12: | Line 12: | ||
* http://docs.openstack.org/developer/openstack-ansible/inventory/index.html | * http://docs.openstack.org/developer/openstack-ansible/inventory/index.html | ||
− | Deployment Guide | + | ====Deployment Guide==== |
+ | |||
* http://docs.openstack.org/project-deploy-guide/openstack-ansible/newton/ | * http://docs.openstack.org/project-deploy-guide/openstack-ansible/newton/ | ||
Line 25: | Line 26: | ||
* http://docs.openstack.org/developer/openstack-ansible-rsyslog_client | * http://docs.openstack.org/developer/openstack-ansible-rsyslog_client | ||
* http://docs.openstack.org/developer/openstack-ansible-security | * http://docs.openstack.org/developer/openstack-ansible-security | ||
+ | |||
+ | === Documentation planning === | ||
+ | |||
+ | The following table will be used as a way to track the collaborative work for the Operations Guide. | ||
+ | |||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! Chapter !! Section !! Sub-section !! Assignee !! Progress | ||
+ | |- | ||
+ | | OpenStack operations || Chapter introduction || || Alexandra Settle || | ||
+ | |- | ||
+ | | OpenStack operations || Accessing your environment || OpenStack client utilities (complete section) || Alexandra Settle and Darren Chan || Example | ||
+ | |- | ||
+ | | OpenStack operations || Managing instances || Managing volumes for persistent storage || || | ||
+ | |- | ||
+ | | OpenStack operations || Managing instances || Live migration || || | ||
+ | |- | ||
+ | | Maintenance tasks || Introduction || || Alexandra Settle and Darren Chan || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Add network interfaces to LXC containers || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Remove network interfaces from LXC containers || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Add provider bridges using new NICs || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Remove provider bridges || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Move from Open vSwitch to LinuxBridge and vice versa (helper tool?) || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Restart a neutron agent container || || | ||
+ | |- | ||
+ | | Maintenance tasks || Network maintenance || Reference to networking guide /ops guide content || Alexandra Settle and Darren Chan || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || Create a RabbitMQ cluster || || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || Check the RabbitMQ cluster status || || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || Stop and restart a RabbitMQ cluster || || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || RabbitMQ and mnesia || || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || Repair a partitioned RabbitMQ cluster for a single-node || || | ||
+ | |- | ||
+ | | Maintenance tasks || RabbitMQ cluster maintenance || Repair a partitioned RabbitMQ cluster for a multi-node cluster || || | ||
+ | |- | ||
+ | | Maintenance tasks || Backups || Backup of /etc/openstack_deploy || || | ||
+ | |- | ||
+ | | Maintenance tasks || Backups || Backup of Galera data || || | ||
+ | |- | ||
+ | | Maintenance tasks || Backups || Backup your environment || || | ||
+ | |- | ||
+ | | Maintenance tasks || Running ad-hoc Ansible plays || Darren Carpenter || COMPLETE: https://review.openstack.org/#/c/416392/ | ||
+ | |- | ||
+ | | Maintenance tasks || Firewalls || Finding ports used by an external IP address || || | ||
+ | |- | ||
+ | | Maintenance tasks || Scale the environment (sub-topics) || Darren Carpenter || COMPLETE: https://review.openstack.org/#/c/414392/ | ||
+ | |- | ||
+ | | Monitoring your environment || Introduction || || Alexandra Settle and Darren Chan || | ||
+ | |- | ||
+ | | Monitoring the environment || Integrate OpenStack-Ansible into your monitoring system || || || | ||
+ | |- | ||
+ | | Troubleshooting || Introduction || || Alexandra Settle and Darren Chan || | ||
+ | |- | ||
+ | | Troubleshooting || Networking || || || | ||
+ | |- | ||
+ | | Troubleshooting || Checking services || || || | ||
+ | |- | ||
+ | | Troubleshooting || Restarting services || || || | ||
+ | |- | ||
+ | | Troubleshooting || Troubleshooting Instance connectivity issues || || || | ||
+ | |- | ||
+ | | Troubleshooting || RabbitMQ issues || Analyze RabbitMQ queues || || | ||
+ | |- | ||
+ | | Troubleshooting || RabbitMQ issues || Analyze OpenStack service logs and RabbitMQ logs || || | ||
+ | |- | ||
+ | | Troubleshooting || Failed Ansible playbooks during an upgrade || || || | ||
+ | |} | ||
=== Manifesto === | === Manifesto === |
Revision as of 11:48, 4 January 2017
Contents
OpenStack-Ansible Wiki
Documentation
All releases
Specific guides
- http://docs.openstack.org/developer/openstack-ansible/draft-operations-guide/index.html
- http://docs.openstack.org/developer/openstack-ansible/upgrade-guide/index.html
- http://docs.openstack.org/developer/openstack-ansible/developer-docs/index.html
- http://docs.openstack.org/developer/openstack-ansible/inventory/index.html
Deployment Guide
Role Documentation
- http://docs.openstack.org/developer/openstack-ansible-apt_package_pinning
- http://docs.openstack.org/developer/openstack-ansible-lxc_container_create
- http://docs.openstack.org/developer/openstack-ansible-lxc_hosts
- http://docs.openstack.org/developer/openstack-ansible-openstack_hosts
- http://docs.openstack.org/developer/openstack-ansible-pip_install
- http://docs.openstack.org/developer/openstack-ansible-py_from_git
- http://docs.openstack.org/developer/openstack-ansible-rsyslog_client
- http://docs.openstack.org/developer/openstack-ansible-security
Documentation planning
The following table will be used as a way to track the collaborative work for the Operations Guide.
Chapter | Section | Sub-section | Assignee | Progress |
---|---|---|---|---|
OpenStack operations | Chapter introduction | Alexandra Settle | ||
OpenStack operations | Accessing your environment | OpenStack client utilities (complete section) | Alexandra Settle and Darren Chan | Example |
OpenStack operations | Managing instances | Managing volumes for persistent storage | ||
OpenStack operations | Managing instances | Live migration | ||
Maintenance tasks | Introduction | Alexandra Settle and Darren Chan | ||
Maintenance tasks | Network maintenance | Add network interfaces to LXC containers | ||
Maintenance tasks | Network maintenance | Remove network interfaces from LXC containers | ||
Maintenance tasks | Network maintenance | Add provider bridges using new NICs | ||
Maintenance tasks | Network maintenance | Remove provider bridges | ||
Maintenance tasks | Network maintenance | Move from Open vSwitch to LinuxBridge and vice versa (helper tool?) | ||
Maintenance tasks | Network maintenance | Restart a neutron agent container | ||
Maintenance tasks | Network maintenance | Reference to networking guide /ops guide content | Alexandra Settle and Darren Chan | |
Maintenance tasks | RabbitMQ cluster maintenance | Create a RabbitMQ cluster | ||
Maintenance tasks | RabbitMQ cluster maintenance | Check the RabbitMQ cluster status | ||
Maintenance tasks | RabbitMQ cluster maintenance | Stop and restart a RabbitMQ cluster | ||
Maintenance tasks | RabbitMQ cluster maintenance | RabbitMQ and mnesia | ||
Maintenance tasks | RabbitMQ cluster maintenance | Repair a partitioned RabbitMQ cluster for a single-node | ||
Maintenance tasks | RabbitMQ cluster maintenance | Repair a partitioned RabbitMQ cluster for a multi-node cluster | ||
Maintenance tasks | Backups | Backup of /etc/openstack_deploy | ||
Maintenance tasks | Backups | Backup of Galera data | ||
Maintenance tasks | Backups | Backup your environment | ||
Maintenance tasks | Running ad-hoc Ansible plays | Darren Carpenter | COMPLETE: https://review.openstack.org/#/c/416392/ | |
Maintenance tasks | Firewalls | Finding ports used by an external IP address | ||
Maintenance tasks | Scale the environment (sub-topics) | Darren Carpenter | COMPLETE: https://review.openstack.org/#/c/414392/ | |
Monitoring your environment | Introduction | Alexandra Settle and Darren Chan | ||
Monitoring the environment | Integrate OpenStack-Ansible into your monitoring system | |||
Troubleshooting | Introduction | Alexandra Settle and Darren Chan | ||
Troubleshooting | Networking | |||
Troubleshooting | Checking services | |||
Troubleshooting | Restarting services | |||
Troubleshooting | Troubleshooting Instance connectivity issues | |||
Troubleshooting | RabbitMQ issues | Analyze RabbitMQ queues | ||
Troubleshooting | RabbitMQ issues | Analyze OpenStack service logs and RabbitMQ logs | ||
Troubleshooting | Failed Ansible playbooks during an upgrade |
Manifesto
Core Team
The OpenStack Ansible core team is responsible for reviewing all changes proposed to the following repositories:
- openstack/openstack-ansible
- openstack/openstack-ansible-apt_package_pinning
- openstack/openstack-ansible-galera_client
- openstack/openstack-ansible-galera_server
- openstack/openstack-ansible-lxc_container_create
- openstack/openstack-ansible-lxc_hosts
- openstack/openstack-ansible-memcached_server
- openstack/openstack-ansible-openstack_hosts
- openstack/openstack-ansible-pip_install
- openstack/openstack-ansible-pip_lock_down
- openstack/openstack-ansible-plugins
- openstack/openstack-ansible-py_from_git
- openstack/openstack-ansible-rsyslog_client
- openstack/openstack-ansible-rabbitmq_server
- openstack/openstack-ansible-repo_server
- openstack/openstack-ansible-rsyslog_server
- openstack/openstack-ansible-security
- openstack/openstack-ansible-specs
Note that everyone is encouraged to help review changes, even if you are not a member of this team. All reviews are very useful and are taken into account by the core team members. Active participation in the review process is a critical task on the road to joining the core reviewer team.
Community Meetings
Bugs & Blueprints
- Launchpad Bug & Blueprint Tracker: https://launchpad.net/openstack-ansible
- Design Specifications - http://specs.openstack.org/openstack/openstack-ansible-specs
Code
References
- Big tent discussion - https://etherpad.openstack.org/p/osad-openstack-naming
- Liberty Summit Collaboration Day - https://etherpad.openstack.org/p/osad-discussion
- General topics from the liberty collaboration day - https://etherpad.openstack.org/p/ansible-collaboration-day