Difference between revisions of "Architecture Design Guide work items"
Darren Chan (talk | contribs) (→Chapter 5 Operator requirements) |
(→Chapter 5 Operator requirements) |
||
Line 46: | Line 46: | ||
=== Chapter 5 Operator requirements=== | === Chapter 5 Operator requirements=== | ||
− | * Consolidate http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/storage-focus-operational-considerations.html, http://docs.openstack.org/arch-design/network-focus-operational-considerations.html, http://docs.openstack.org/arch-design/multi-site-operational-considerations.html, http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/massively-scalable-user-requirements.html#operator-requirements (Xav, review | + | * Consolidate http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/storage-focus-operational-considerations.html, http://docs.openstack.org/arch-design/network-focus-operational-considerations.html, http://docs.openstack.org/arch-design/multi-site-operational-considerations.html, http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/massively-scalable-user-requirements.html#operator-requirements (Xav, review https://review.openstack.org/#/c/260238) |
* 5.1 SLA considerations (Xav Paice, https://review.openstack.org/259823, Merged) | * 5.1 SLA considerations (Xav Paice, https://review.openstack.org/259823, Merged) | ||
− | * 5.2 Monitoring - - consolidate http://docs.openstack.org/arch-design/compute-focus-operational-considerations.html#monitoring, | + | * 5.2 Monitoring - - consolidate http://docs.openstack.org/arch-design/compute-focus-operational-considerations.html#monitoring, (also in https://review.openstack.org/#/c/260238) |
* 5.3 Selecting hardware | * 5.3 Selecting hardware | ||
**Selecting the right hardware - servers, switches, and how they integrate | **Selecting the right hardware - servers, switches, and how they integrate | ||
** Consolidate http://docs.openstack.org/arch-design/generalpurpose-architecture.html, http://docs.openstack.org/arch-design/compute-focus-architecture.html, http://docs.openstack.org/arch-design/storage-focus-architecture.html (Darren Chan, reivew TBA) | ** Consolidate http://docs.openstack.org/arch-design/generalpurpose-architecture.html, http://docs.openstack.org/arch-design/compute-focus-architecture.html, http://docs.openstack.org/arch-design/storage-focus-architecture.html (Darren Chan, reivew TBA) | ||
* 5.4 integration with external IDP | * 5.4 integration with external IDP | ||
− | * 5.5 Upgrades?http://docs.openstack.org/arch-design/multi-site-operational-considerations.html#upgrades | + | * 5.5 Upgrades?http://docs.openstack.org/arch-design/multi-site-operational-considerations.html#upgrades (see https://review.openstack.org/#/c/260238) |
=== Chapter 6 Capacity planning and scaling === | === Chapter 6 Capacity planning and scaling === |
Revision as of 01:35, 22 December 2015
Contents
- 1 Architecture Design Guide Reorganization
- 1.1 Resources
- 1.2 Global tasks
- 1.3 Chapter/Section tasks
- 1.3.1 Chapter 1. Introduction
- 1.3.2 Chapter 2 Identifying stakeholders
- 1.3.3 Chapter 3 Functional Requirements
- 1.3.4 Chapter 4 User requirements
- 1.3.5 Chapter 5 Operator requirements
- 1.3.6 Chapter 6 Capacity planning and scaling
- 1.3.7 Chapter 7. High Availability
- 1.3.8 Chapter 8. Security requirements
- 1.3.9 Chapter 9. Legal requirements
- 1.3.10 Chapter 10. Example architectures
Architecture Design Guide Reorganization
Do not modify the current guide in openstack-manuals/docs/arch-design. Commit your work to the draft directory openstack-manuals/docs/arch-design-draft.
- Please ensure your commit messages references the blueprint: Implements: blueprint arch-guide-mitaka-reorg
- If you need diagrams, ping darrenc.
Resources
Global tasks
To assign yourself a task, put your name next to the task and reference the review URL. Change the status to complete when the task is completed.
- Rewrite abstract - Shilla Saebi
- Markup glossary terms
- How about we condense the use case information as a chapter at the start of the book, and mention hybrid as the main focus in the guide?
- Mention http://docs.openstack.org/openstack-ops/content/cloud_controller_design.html
- Would including a generic architecture design planning template in an appendix be useful or relevant?
- Considerations when designing an OpenStack cloud in a development, staged or production environment
Chapter/Section tasks
To assign yourself a task, put your name next to the section or task and reference the review URL. Change the status to complete when the task is completed.
Chapter 1. Introduction
- 1.1 Intended audience (Njira Perci, https://review.openstack.org/259998/, Merged)
- include content from the original guide
- 1.2 How this book is organized (Njira Perci, https://review.openstack.org/260045/, In Progress)
- Rewrite this section mentioning the book follows a structure that system architects would use in developing cloud architecture design documents
- 1.3 Why and How we wrote this book - Shilla Saebi
- Include section?
Chapter 2 Identifying stakeholders
- Describe who the internal and external stakeholders are, and the impact they may have on business requirements and architecture design.
Chapter 3 Functional Requirements
- Information from SMEs
- Mention deployment methods will affect cost, and reference to http://docs.openstack.org/openstack-ops/content/section_arch_provision.html the ops-guide
- Do we need to expand http://docs.openstack.org/openstack-ops/content/section_arch_provision.html to include other deployment methods? If so, what are they?
Chapter 4 User requirements
- Information from SMEs
- Business and technical requirements, consolidate http://docs.openstack.org/arch-design/generalpurpose-user-requirements.html, http://docs.openstack.org/arch-design/storage-focus-technical-considerations.html, http://docs.openstack.org/arch-design/network-focus-user-requirements.html#, http://docs.openstack.org/arch-design/multi-site-user-requirements.html, http://docs.openstack.org/arch-design/hybrid-user-requirements.html, http://docs.openstack.org/arch-design/hybrid-technical-considerations.html, http://docs.openstack.org/arch-design/massively-scalable-user-requirements.html
Chapter 5 Operator requirements
- Consolidate http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/storage-focus-operational-considerations.html, http://docs.openstack.org/arch-design/network-focus-operational-considerations.html, http://docs.openstack.org/arch-design/multi-site-operational-considerations.html, http://docs.openstack.org/arch-design/hybrid-operational-considerations.html, http://docs.openstack.org/arch-design/massively-scalable-user-requirements.html#operator-requirements (Xav, review https://review.openstack.org/#/c/260238)
- 5.1 SLA considerations (Xav Paice, https://review.openstack.org/259823, Merged)
- 5.2 Monitoring - - consolidate http://docs.openstack.org/arch-design/compute-focus-operational-considerations.html#monitoring, (also in https://review.openstack.org/#/c/260238)
- 5.3 Selecting hardware
- Selecting the right hardware - servers, switches, and how they integrate
- Consolidate http://docs.openstack.org/arch-design/generalpurpose-architecture.html, http://docs.openstack.org/arch-design/compute-focus-architecture.html, http://docs.openstack.org/arch-design/storage-focus-architecture.html (Darren Chan, reivew TBA)
- 5.4 integration with external IDP
- 5.5 Upgrades?http://docs.openstack.org/arch-design/multi-site-operational-considerations.html#upgrades (see https://review.openstack.org/#/c/260238)
Chapter 6 Capacity planning and scaling
- Consolidate http://docs.openstack.org/arch-design/hybrid-technical-considerations.html#capacity-planning, http://docs.openstack.org/arch-design/compute-focus-operational-considerations.html#capacity-planning, http://docs.openstack.org/arch-design/massively-scalable-operational-considerations.html#growth-and-capacity-planning, http://docs.openstack.org/arch-design/multi-site-technical-considerations.html, http://docs.openstack.org/arch-design/hybrid-technical-considerations.html#capacity-planning
- 6.1 Storage [mjrichardson, review TBA]
- Consolidate http://docs.openstack.org/arch-design/hybrid-architecture.html#data, http://docs.openstack.org/arch-design/multi-site-architecture.html#storage, http://docs.openstack.org/arch-design/hybrid-architecture.html#data
- Shared storage, implications for live migration
- Protecting data-at-rest
- 6.2 Networking
- Neutron considerations with router design - DVR or centralized
- Consolidate http://docs.openstack.org/arch-design/hybrid-architecture.html#network-services
http://docs.openstack.org/arch-design/generalpurpose-technical-considerations.html#designing-network-resources, http://docs.openstack.org/arch-design/network-focus-technical-considerations.html, http://docs.openstack.org/arch-design/network-focus-architecture.html#tunable-networking-components, http://docs.openstack.org/arch-design/multi-site-architecture.html#networking, http://docs.openstack.org/arch-design/hybrid-user-requirements.html#network-considerations, http://docs.openstack.org/arch-design/hybrid-architecture.html,
- 6.3 Compute
- 6.4 Control plane API services & Horizon
Chapter 7. High Availability
- Consolidate http://docs.openstack.org/arch-design/hybrid-architecture.html#network-services, http://docs.openstack.org/arch-design/generalpurpose-technical-considerations.html, http://docs.openstack.org/arch-design/network-focus-user-requirements.html#high-availability-issues, http://docs.openstack.org/arch-design/multi-site-user-requirements.html#high-availability
- Separation of data plane and control plane
- Eliminating single points of failure
- The services that must remain up 100%, and those that can be restarted without affecting users
Chapter 8. Security requirements
- Include original content. Perhaps reference to the relevant sections in the Security Guide?
- See also http://docs.openstack.org/arch-design/generalpurpose-technical-considerations.html#security (Darren Chan, https://review.openstack.org/#/c/259844/, In progress)
Chapter 9. Legal requirements
- Include original content (Darren Chan, https://review.openstack.org/#/c/260286/)
- Include things to consider and how this impacts the cloud architecture design
Chapter 10. Example architectures
(reflecting concepts and terminology described in previous chapters)
- Are any of there examples applicable: http://docs.openstack.org/arch-design/hybrid-prescriptive-examples.html, http://docs.openstack.org/arch-design/storage-focus-prescriptive-examples.html, http://docs.openstack.org/arch-design/network-focus-prescriptive-examples.html,http://docs.openstack.org/arch-design/hybrid-prescriptive-examples.html, http://docs.openstack.org/arch-design/specialized.html
- 10.1 Small scale, single site with Neutron networking
- 10.2 Adding another region
- 10.3 Scaling with multiple cells
- Real world examples: http://docs.openstack.org/arch-design/compute-focus-prescriptive-examples.html