Skip to content

A
ansible
Commit e086d6fd by michael@ansibleworks.com Committed by Michael DeHaan
Options

Doc updates

parent b68f81a7
Showing with 76 additions and 42 deletions
docsite/_themes/bootstrap/layout.html
......@@ -134,6 +134,8 @@ $(window).ready(set_max_menu_height);
{%- block footer %}
<footer class="footer">
<center>
<a href="http://ansibleworks.com"><img src="http://ansible.cc/img/AnsibleWorks.png" alt="AnsibleWorks"></a>
<p>
{%- if show_copyright %}
{%- if hasdoc('copyright') %}
......@@ -147,6 +149,7 @@ $(window).ready(set_max_menu_height);
{%- endif %}
</p>
</div>
</center>
</footer>
{%- endblock %}
docsite/conf.py
......@@ -25,7 +25,7 @@ sys.path.insert(0, os.path.join('ansible', 'lib'))
sys.path.append(os.path.abspath('_themes'))
VERSION='0.01'
AUTHOR='Michael DeHaan'
AUTHOR='AnsibleWorks'
# General configuration
......@@ -51,7 +51,7 @@ master_doc = 'index'
# General substitutions.
project = 'Ansible Documentation'
copyright = "2012 Michael DeHaan"
copyright = "2013 AnsibleWorks"
# The default replacements for |version| and |release|, also used in various
# other places throughout the built documents.
......
docsite/rst/YAMLSyntax.rst
YAML Syntax
===========
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
This page provides a basic overview of correct YAML syntax, which is how Ansible
playbooks (our configuration management language) are expressed.
......
docsite/rst/api.rst
API & Integrations
==================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
There are several interesting ways to use Ansible from an API perspective. You can use
the Ansible python API to control nodes, you can extend Ansible to respond to various python events,
and you can plug in inventory data from external data sources. Ansible is written in its own
......
docsite/rst/bestpractices.rst
Best Practices
==============
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
Here are some tips for making the most of Ansible.
You can find some example playbooks illustrating these best practices in our `ansible-examples repository <https://github.com/ansible/ansible-examples>`_.
......
docsite/rst/contrib.rst
Ansible Resources
=================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
User contributed playbooks, modules, and articles. This is a small
curated list, but growing. Everyone is encouraged to add to this
document, just send in a github pull request to docsite/rst/contrib.rst!
......
docsite/rst/examples.rst
Command Line Examples And Next Steps
====================================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
.. highlight:: bash
The following examples show how to use `/usr/bin/ansible` for running
......
docsite/rst/gettingstarted.rst
Getting Started
===============
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
.. contents::
:depth: 2
:backlinks: top
......
docsite/rst/glossary.rst
Glossary
========
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
The following is a list (and re-explanation) of term definitions used elsewhere in the Ansible documentation.
Consult the documentation home page for the full documentation and to see this in context, but this should be a good resource
......
docsite/rst/index.rst
......@@ -3,12 +3,22 @@
Ansible Documentation
`````````````````````
This page contains documentation about how to use `Ansible <http://ansible.cc>`_.
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
Before we dive into playbooks, configuration management, deployment, and orchestration, learn how to get Ansible installed and some
This page contains documentation about how to use `Ansible <http://ansible.cc>`_. You may also be interested in taking a class:
.. image:: http://www.ansibleworks.com.s3-website-us-east-1.amazonaws.com/img/banners/training.png
:alt: ansibleworks training
:target: http://www.ansibleworks.com/training/
Before we dive into playbooks, configuration management, deployment, and orchestration, we'll learn how to get Ansible installed and some
basic information. We'll go over how to execute ad-hoc commands in parallel across your nodes using /usr/bin/ansible. We'll also see
what sort of modules are available in Ansible's core (though you can also write your own, which we'll also show later).
.. toctree::
:maxdepth: 1
......@@ -17,7 +27,6 @@ what sort of modules are available in Ansible's core (though you can also write
examples
modules
Overview
````````
......@@ -26,6 +35,7 @@ Overview
:width: 566px
:height: 439px
Playbooks
`````````
......
docsite/rst/moduledev.rst
Module Development
==================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
Ansible modules are reusable units of magic that can be used by the Ansible API,
or by the `ansible` or `ansible-playbook` programs.
......
docsite/rst/modules.rst
Ansible Modules
===============
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
.. contents::
:depth: 2
:backlinks: top
......
docsite/rst/patterns.rst
......@@ -3,6 +3,11 @@
Inventory & Patterns
====================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
Ansible works against multiple systems in your infrastructure at the
same time. It does this by selecting portions of systems listed in
Ansible's inventory file, which defaults to /etc/ansible/hosts.
......
docsite/rst/playbooks.rst
Playbooks
=========
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
.. contents::
:depth: 2
:backlinks: top
......
docsite/rst/playbooks2.rst
Advanced Playbooks
==================
.. image:: http://ansible.cc/docs/_static/ansible_fest_2013.png
:alt: ansiblefest 2013
:target: http://www.eventbrite.com/event/5593981750
Here are some advanced features of the playbooks language. Using all of these features
are not neccessary, but many of them will prove useful. If a feature doesn't seem immediately
relevant, feel free to skip it. For many people, the features documented in `playbooks` will
......
docsite/rst/who_uses_ansible.rst deleted 100644 → 0
.. _who_uses_ansible:
Who Uses Ansible
================
The following is an opt-in list of just some of the folks using Ansible -- to get your company details here, `Email Michael <mailto:michael.dehaan@gmail.com>`_.
* `Action.IO <http://www.action.io/>`_ - Action.IO Cloud Development Platform
* `Alta Language Services <http://www.altalang.com>`_ - language testing, solutions, and translation services
* `Aspiro TV <http://www.aspiro.com/en/TV/>`_ - Media Streaming
* `Basho <http://basho.com>`_ - makers of NoSQL engine Riak
* `CatN Hosting <http://catn.com>`_ - scalable Cloud hosting
* `Cygate AB <http://cygate.se>`_ - IT solutions from Malmo, Sweeden
* `D square NV <http://dsquare.be>`_ - Process industry data mining, Belgium
* `Dag IT Solutions <http://dagit.net>`_ - Enterprise Linux & Beyond
* `Digital Repository of Ireland <http://www.dri.ie/>` - Digital Preservation and Archiving
* `Duke University Economics <http://duke.edu>`_ - Research & Education
* `Eucalyptus Systems Inc. <http://www.eucalyptus.com>`_ - Makers of the AWS-compatible private cloud platform
* `Ginsys <http://ginsys.eu/>`_ - Linux infrastructure consulting from Belgium
* `The Fedora Project <http://fedoraproject.org>`_ - Produces the Popular Linux Distribution
* `Four Kitchens <http://fourkitchens.com>`_ - The Drupal Experts
* `Muck Rack <http://muckrack.com>`_ - "The destination for journalists on twitter & social media"
* `HP (Germany) <http://hp.com>`_ - HP
* `Nimbis Services <http://nimbisservices.com>`_ - Technical Computing for the Cloud
* `Lizenfrei.at <http://lizenzfrei.at/>`_ - Open Source consulting and development, Austria
* `Schmooze Com <http://www.schmoozecom.com/>`_ - Creators of Industry Leading PBX Platforms
* `Scientific Computing Center, Aristotle Univ. of Thessaloniki <http://www.grid.auth.gr/en/>`_ - Grid/Cloud-Based Scientific Computing
* `Shorty Awards <http://shortyawards.com>`_ - Honoring the best in social media
* `Speedy Rails <http://speedyrails.com>`_ - Cloud Based Rails Hosting
* `Skylines.io <http://skylines.io>`_ - Real time photo search engine
* `Steelhouse <http://steelhouse.com>`_ - Behavioral commerce
* `Tent.is <http://tent.is>`_ - "The easiest way to start using Tent"
* `Tranquil Hosting <http://tranquilhosting.com>`_ - Managed Linux Hosting Services
* `Trinity Centre for High Performance Computing - <http://www.tchpc.tcd.ie>`_ - Research and Education
* `Tomorrow Focus Technologies GmbH <http://www.t-f-t.net/>`_ - Running some of the biggest web sites in Europe
* `123i.com.br <http://123i.com.br>`_ - Find real estate in Brazil
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment