Blueprint-os-admin-docs
- Launchpad Entry: Design for OpenStack Administration Guide
- Created: Nicholas Chase
- Contributors:
Contents
- 1 Summary
- 2 Blueprint - OpenStack Administration Guide
- 2.1 CHAPTER 1: Overview
- 2.2 CHAPTER 2: Architecture
- 2.3 CHAPTER 3: Compute
- 2.3.1 SECTION 1: Introduction
- 2.3.2 SECTION 2: Installation
- 2.3.3 SECTION 3: Configuration
- 2.3.4 SECTION 4: Identity, Image, and Instance Management
- 2.3.5 SECTION 5: Scheduling
- 2.3.6 SECTION 6: System Administration
- 2.3.7 SECTION 7: Interfaces
- 2.3.8 SECTION 8: Security
- 2.3.9 SECTION 9: Troubleshooting
- 2.3.10 SECTION 10: Community Support
- 2.3.11 SECTION 11: Tutorials
- 2.4 CHAPTER 3. OpenStack Networking
- 2.5 CHAPTER 4 OpenStack Storage
- 2.6 CHAPTER 5. Summary
- 2.7 CHAPTER 6. Glossary
- 2.8 CHAPTER 7. Index
Summary
This blueprint describes a plan to create documentation for OpenStack administrators and operators. These are tasks that go beyond the everyday actions an OpenStack user would take, but don't get into the depths of the OpenStack Operations Manual.
This documentation organizes the existing administration documentation into conceptional categories rather than chronological activities. It is meant to be comprehensive, but to be built out of content that has been drawn from other manuals. The reason for this is that while this guide is meant to be comprehensive, users should still be able to create documentation in smaller chunks to avoid being overwhelmed. (This process is covered by a separate blueprint.)
This blueprint is related to Blueprint Restructure Documentation.
Blueprint - OpenStack Administration Guide
Audience: Administrators and operators of OpenStack clouds who maintain OpenStack clusters.
Product info: Havana, 2013.1
Include common glossary? Yes
Purpose:
- Explain OpenStack cloud concepts and describe how to use an OpenStack cloud.
- Include Cloud application architecture diagram.
- TBD
Source material:
- Suse End User Guide
- Rackspace-sponsored OpenStack training
- OpenStack API Quick Start
- Python Developer Documentation
- Language Bindings Documentation
- OpenStack Clients Guide
- OpenStack Administration Guides
- OpenStack API Specifications
- Programming OpenStack Compute API with Shell and Python
CHAPTER 1: Overview
One-to-two paragraph description of the OpenStack cloud. Descriptions of the OpenStack projects. Architecture diagram with few sentences of explanation. State the goals of the book - concepts, set-up, and tutorials.
SECTION 1: OpenStack Cloud Concepts
Describe the main concepts that a user needs to understand to use the cloud.
- Authentication/Identity service - http://www.openstack.org/software/openstack-shared-services/
- Images, Image service - What’s an image? What’s a snapshot? http://www.openstack.org/software/openstack-shared-services/
- Servers - What is a virtual machine? A hypervisor? A server personality? What does it mean to boot a server? http://www.openstack.org/software/openstack-compute/. Also, http://docs.openstack.org/cli/quick-start/content/nova_client.html
- Security groups - http://www.openstack.org/software/openstack-compute/
- Floating IP addresses
- Console log
- Object and block storage - http://www.openstack.org/software/openstack-storage/ - What storage can you attach to instances? Can I attach an ISO as if I'm mounting a CD/DVD? Backend Storage Devices, Users and Tenants (Projects), Volumes Snapshots and Backups.
- Networking - http://www.openstack.org/software/openstack-networking/
SECTION 2: How to Interact with an OpenStack Cloud
Describe ways you can interact with a cloud:
Horizon Dashboard
http://www.openstack.org/software/openstack-dashboard/
OpenStack Command-line Clients
Provide x-ref to OpenStack Command Reference. Base off of: http://docs.rackspace.com/servers/api/v2/cn-gettingstarted/content/novaclient.html
cURL Commands with Embedded API Calls
Base off of: http://docs.rackspace.com/servers/api/v2/cn-gettingstarted/content/curl.html
OpenStack APIs
Talk about ways to use the APIs – cURL? SDKs? Language bindings?
CHAPTER 2: Architecture
A more in-depth discussion of how all of the pieces and projects fit together.
CHAPTER 3: Compute
SECTION 1: Introduction
Images
Instances
SECTION 2: Installation
This section includes both basic and automated installation. It will likely pull heavily from the installation guide.
SECTION 3: Configuration
This section discusses nova.conf. but any actual configuration parameters will be sourced from the configuration guide.
SECTION 4: Identity, Image, and Instance Management
SECTION 5: Scheduling
SECTION 6: System Administration
SECTION 7: Interfaces
SECTION 8: Security
SECTION 9: Troubleshooting
SECTION 10: Community Support
SECTION 11: Tutorials
CHAPTER 3. OpenStack Networking
SECTION 1: Introduction
This section gives an overview of the architecture and touches on what things look like under the hood, including giving a "teaser" of advanced features.
SECTION 2: Installation
SECTION 3: Configuration for OpenStack Identity and Compute
This section includes both basic and advanced configuration and core configuration options.
SECTION 4 Deployment and Usage Cases
This section includes both basic and advanced use cases, such as high availability, demos and plugin pagination and sorting support.
SECTION 5 Authentication and Authorization
CHAPTER 4 OpenStack Storage
This chapter is a combination of the Object and Block storage books, and might be better broken out into two chapters, if we can find a way to include the introduction just once. Perhaps we need to create parts. The only thing stopping me is that the other parts would have just one chapter each, which is just wrong.
SECTION 1 Introduction
This section includes the storage concepts table.
SECTION 2 Object Storage
Source material
Introduction
Installation
System Administration
Monitoring
Troubleshooting
Community Support
Tutorials
SECTION 3 Block Storage
Source material
Introduction (link to OpenStack Compute in the text)
Volumes
- Managing
- Drivers
Installation
Administration
System Monitoring
Troubleshooting
Community Support
Tutorials
CHAPTER 5. Summary
CHAPTER 6. Glossary
This is the common glossary
CHAPTER 7. Index
I think this would be pretty useful, but probably difficult to maintain.