{"id":3935,"date":"2013-03-14T16:53:10","date_gmt":"2013-03-14T21:53:10","guid":{"rendered":"http:\/\/www.openstack.org\/blog\/?p=3935"},"modified":"2013-03-14T16:56:10","modified_gmt":"2013-03-14T21:56:10","slug":"introducing-the-openstack-operations-guide","status":"publish","type":"post","link":"https:\/\/www.openstack.org\/blog\/introducing-the-openstack-operations-guide\/","title":{"rendered":"Introducing the OpenStack Operations Guide"},"content":{"rendered":"
Planning to run, or design an OpenStack Cloud? \u00a0There’s a new book you should take a look at – the OpenStack Operations Guide. \u00a0Get your free download now at\u00a0http:\/\/docs.openstack.org\/ops\/<\/a>!<\/div>\n
<\/div>\n
\"OpenStack<\/a><\/div>\n
<\/div>\n
You may have already seen the blog post, We Did It: Zero to Book in Five Days<\/em><\/a>, from Anne Gentle, the OpenStack documentation coordinator who came up with the idea to\u00a0write the book sprint-style and gathered the team – including myself.<\/div>\n
<\/div>\n
\"Screen<\/a><\/div>\n
<\/div>\n
Our overarching guidance (and why you should read this book) when writing was to share our experiences. The authors have all lost sleep and worked through\u00a0holidays to nurse OpenStack clouds into a production-ready state. To that end, the book covers two main sections: Architecture and Operations.The aim of the Architecture section is to, once you’ve understood enough about OpenStack to realise that you are actually going to build a cloud using it as a basis, step\u00a0you through many of the common and non-so-common concerns to deliberate while in design. Some of it might be principles you consider standard already, but others\u00a0look to specifically address the hard questions specific to this platform. Questions like “How do you scale your OpenStack cloud?”, “How many servers should you buy\u00a0for control infrastructure?”, “Should your storage be external or in the compute node?” are covered in an opinionated manner, with realistic perspective on what works.This book does not include installation instructions. This is already covered in the installations guides at\u00a0http:\/\/docs.openstack.org\/install\/, so the book segues into\u00a0Operations assuming that you now have a working cloud – though a pre-install skim is a good idea too.In the Operations section, we really tried to consider running OpenStack from the perspective of a time-poor systems administrator. It starts with a to-the-point tour of\u00a0your cloud via the commandline as a way of familiarising yourself with what will be your working environment. Following this is a compendium detailing ways in which\u00a0you’ll be working with the cloud. “User Facing Operations” attempts to give you enough of a perspective on what users are trying to do at the IaaS level that you can can\u00a0help them, while “Maintenance, Failures and Debugging” works on the dual principle of fixing broken services, or preventing them from breaking in the first place.Two important chapters end the section – “Customise” and “Upstream OpenStack”. Openstack is as much of a community as it is a software project, and the latter gives\u00a0some insights on how to interact with the community – including how to get help when you’ve tried everything else. The former, probably the most advanced chapter in\u00a0the book, assists in taking advantage of the framework to extend it without touching the core code. Hopefully you’ll use the two in conjunction and share your work with\u00a0the community!For excellent bed time reading – perhaps to help understand that others are in the same boat, and reduce those stress levels – there’s an appendix called “Tales from the\u00a0Cryp^H^H^H^H Cloud”. Here, a few of us share our OpenStack operations stories to help you understand the processes we go through when the stakes are high.<\/p>\n

It’s been a privilege working on this book for you – learning as much as contributing – and I hope you find it useful.<\/p>\n

History behind the book:<\/p>\n

The creation of this book happened in just five days, but the story\u00a0that goes with it is a little longer. More or less since people started\u00a0using OpenStack for their production clouds (let’s call that Cactus\u00a0timeframe – those before that were fairly ‘brave’) there’s been a\u00a0request for information on the best practices for designing and running\u00a0our favourite cloud software. As it were, the small number of people\u00a0working on documentation were struggling just to keep track of the\u00a0hundreds of configuration options that make this framework so flexible.\u00a0Then, in May last year, Anne Gentle created a seemingly innocent\u00a0blueprint “Create and OpenStack Operators Manual”, and started gathering\u00a0a team – people who’d spent months sacrificing their sleep to tune\u00a0their OpenStack deployments, and able to share their knowledge.<\/p>\n

Originally,\u00a0the proposal for a book sprint was submitted to Google Summer of Code’s\u00a0documentation track – it didn’t make it in. The OpenStack foundation\u00a0came to the rescue, providing the funding needed to get the writers to the\u00a0one place and keep them fed. Thanks to the Book Sprint methodology,\u00a0from February 25th to March 1st, 2013, the authors worked out of Austin, Texas\u00a0producing more than 10,000 words \u00a0a day, allowing a launch of\u00a0the book the following\u00a0week.<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Planning to run, or design an OpenStack Cloud? \u00a0There’s a new book you should take a look at – the OpenStack Operations Guide. \u00a0Get your free download now at\u00a0http:\/\/docs.openstack.org\/ops\/! You may have already seen the blog post, We Did It: Zero to Book in Five Days, from Anne Gentle, the OpenStack documentation coordinator who came… Read more »<\/a><\/p>\n","protected":false},"author":51,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[3,5,13,1],"tags":[523],"_links":{"self":[{"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/posts\/3935"}],"collection":[{"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/users\/51"}],"replies":[{"embeddable":true,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/comments?post=3935"}],"version-history":[{"count":11,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/posts\/3935\/revisions"}],"predecessor-version":[{"id":3965,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/posts\/3935\/revisions\/3965"}],"wp:attachment":[{"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/media?parent=3935"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/categories?post=3935"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.openstack.org\/blog\/wp-json\/wp\/v2\/tags?post=3935"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}