Architecture Design Guide work items

= 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 archguide-mitaka-reorg
 * We are currently converting work items to Launchpad bugs and adding the bug number next to the work item.

Resources
etherpad

spec

reviews and for those of us with dyslexia archguide-reviews Cloud architect article

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/, Merged)
 * 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. (Alexandra Settle)

See Launchpad bug 1548148

Chapter 3 Functional Requirements

 * Information from SMEs - Alexandra Settle (contacted potential SME's) https://review.openstack.org/#/c/304973/
 * 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?

See Launchpad bug 1548154

Chapter 4 User requirements

 * Information from SMEs (Brian Moss - https://review.openstack.org/#/c/290261/)
 * 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.

See Launchpad bug 1548149

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), http://docs.openstack.org/arch-design/specialized-hardware.html
 * 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
See Launchpag bug 1548179
 * 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

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.2 Networking
 * Neutron considerations with router design - DVR or centralized
 * Consolidate http://docs.openstack.org/arch-design/hybrid-architecture.html#network-services

See Launchpad bug 1548182


 * 6.3 Compute
 * See http://docs.openstack.org/arch-design/generalpurpose-technical-considerations.html#compute-resource-design
 * 6.4 Control plane API services & Horizon

See Launchpad bug 1548184

Chapter 7. High Availability
(Xav Paice, review https://review.openstack.org/260856 Merged)


 * 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/, merged)
 * REDIRECT Target page name

Chapter 9. Legal requirements

 * Include original content (Darren Chan, https://review.openstack.org/#/c/260286/, merged)
 * Include things to consider and how this impacts the cloud architecture design

See Launchpad bug 1548175

Chapter 10 Cloud architecture examples
(reflecting concepts and terminology described in previous chapters)
 * Are any of these 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 (Njira Perci, In Progress)

See Launchpad bug 1548176