Jump to: navigation, search

Difference between revisions of "Architecture Design Guide work items"

(Chapter 7. High Availability)
(Architecture Design Guide Reorganization)
Line 2: Line 2:
 
  '''''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.'''''
 
  '''''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''
 
* Please ensure your commit messages references the blueprint: ''Implements: blueprint archguide-mitaka-reorg''
* If you need diagrams, ping darrenc.
+
* We are currently converting work items to Launchpad bugs and adding the bug number next to the work item.  
  
 
==Resources==
 
==Resources==

Revision as of 00:48, 15 February 2016

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

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.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.

Chapter 3 Functional Requirements

Chapter 4 User requirements

Chapter 5 Operator requirements

Chapter 6 Capacity planning and scaling

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,

Chapter 7. High Availability

(Xav Paice, review https://review.openstack.org/260856 Merged)

Chapter 8. Security requirements

  1. REDIRECT Target page name

Chapter 9. Legal requirements

Chapter 10. Example architectures

(reflecting concepts and terminology described in previous chapters)