Operator Contrib Guide Expansion

There are a lot of operator guides that aren't mentioned in the
current state of the operator guide. This patch adds those guides
and does some reorganization to give things a better flow.

Change-Id: I7c2713cbe59ba3f25adec60b0229d3c974950713
Story: 2003117
Task: 26368
This commit is contained in:
Kendall Nelson 2019-04-16 18:15:56 -07:00
parent 1ddee6b2a0
commit 718d3679a8
4 changed files with 89 additions and 16 deletions

View File

@ -14,6 +14,8 @@ This section allows you to:
* Understand the differences between the different in-person OpenStack events
* Know which events are valuable to you
.. _summit:
Open Infrastructure Summit
--------------------------
@ -43,6 +45,8 @@ propose sessions for the upcoming event. After the CFP deadline the proposals
go through a community vote after which a group of track chairs decide about
the final content for each track.
.. _events-forum:
Forum
+++++
@ -117,3 +121,12 @@ few hours long with a few presentations, discussion topics and some snacks.
Look for `meetups in your area <http://meetup.com/pro/osf>`_ and if you
cannot find one you are welcome to organize one yourself!
Operators Meetup
-------------------
Aside from the Forum, the other operator focused event is the operator
meetup. You can read general information about it here :ref:`ops-meetup`.
It's organized by the operator community biannually in locations all over
the world.

View File

@ -7,12 +7,13 @@ Operators' Contributor Guide
:maxdepth: 2
/operators/introduction
/operators/participate
/common/communication
/common/irc
/common/accounts
/common/communication
/common/events
/common/git
/common/setup-gerrit
/operators/participate
/common/governance
/common/releases
/operators/resources

View File

@ -4,13 +4,19 @@ Participating
Mailing List
=============
Operators have used a dedicated mailing list until November 2018. You
Operators had previously used a dedicated mailing list until November 2018. You
can read the `openstack.operators archive
<http://lists.openstack.org/pipermail/openstack-operators/>`_
which contain plenty of valuable information.
Currently there is a `joint mailing list
which contains plenty of valuable information.
To unify our community, we have replaced the operator and developer
specific mailing lists with a `joint mailing list
<http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-discuss>`_
for developer and operator to subscribe.
for developers and operators to subscribe to and converse on together.
.. note::
To get more operator attention, prepend '[ops]' to your email subject lines.
More generic information about mailing lists can be found in the Communication
page's :ref:`communication-mailing-lists` section.
@ -19,9 +25,15 @@ IRC Channels
There is the #openstack-operators channel on Freenode IRC for live
conversations and `Operators' team meeting
<http://eavesdrop.openstack.org/#OpenStack_OSOps_Team>`_.
On top of the #openstack-operators channel there are several others. More
generic information about IRC channels can be found in the :ref:`irc-channels`
section of the IRC page.
On top of the #openstack-operators channel there are many others that you
might find useful. More generic information about IRC channels can be found
in the :ref:`irc-channels` section of the IRC page.
In the :ref:`setup-irc` section of this guide, there are instructions on how
to setup a desktop client and register your irc nickname so that you can
join these channels.
.. _ops-meetup:
Meet Ups
========
@ -36,10 +48,5 @@ with only a small number of presentations, with the following aims:
interested parties
3. Increase constructive, proactive involvement from those running clouds
Share and Learn From Real Configurations
========================================
Example configurations for various OpenStack services are provided in the `openstack/osops-example-configs
repository
<https://opendev.org/x/osops-example-configs/src/README.md>`_.
Operators can share their configuration files to help others, and review how
others setup and tune their configurations.
There are other events relevant to operators besides just the meetup,
:ref:`events-forum` and the rest of the :ref:`summit`

View File

@ -0,0 +1,52 @@
##########
Resources
##########
There are many resources available to operators. Some are maintained by the
operator community while others are maintained by the upstream developers.
Below are brief descriptions of guides to hopefully help you get to the
information you need quicker!
.. note::
If you find any issues with the guides, please file a bug! Better yet, fix the bug!
On each page of the documentation there is a link in the top right corner to
the place bugs are filed (could be Launchpad or StoryBoard depending on the
repository).
The order the guides are presented in is the typical order they are needed in,
but of course you should feel free to explore them in any order you like.
Architecture Guides
=====================
`The Architecture Guide <https://docs.openstack.org/arch-design/>`_ provides
basic information about designing an OpenStack cloud. This guide discusses the
basiscs, common use cases, and architecture design requirements.
Virtual Machine Image Guides
=================================
`The VM Image Guide <https://docs.openstack.org/image-guide/>`_ explains how
to 'obtain, create and modify vm images that are compatible with OpenStack.'
Operations Guide
================
`The Operations Guide <https://docs.openstack.org/arch-design/>`_ is
generally focused on what happens after day 1 of spinning up an
OpenStack Cloud. It offers some basic setup infromation, but the
majority of the content is about maintenence, troubleshooting, user
facing capabilities, and scaling.
Security Guide
===============
`The Security Guide <https://docs.openstack.org/security-guide/>`_ provides information about ways
to keep your cloud secure. It covers everything from identity and secrets
management to per service security options (compute, networking, storage,
messaging, etc)
Share and Learn From Real Configurations
========================================
Example configurations for various OpenStack services are provided in the
`openstack/osops-example-configs repository
<https://git.openstack.org/cgit/openstack/osops-example-configs/tree/README.md>`_.
Operators can share their configuration files to help others, and review
how others setup and tune their configurations.