diff --git a/rst/gettingstarted.rst b/rst/gettingstarted.rst index 62001b0007..cc7f886174 100644 --- a/rst/gettingstarted.rst +++ b/rst/gettingstarted.rst @@ -34,16 +34,21 @@ These distributions don't have Python 2.6 by default, but it is easily installab Getting Ansible ``````````````` -As the project is still pretty new, you will probably want to clone -the git checkout, so you can keep up with all of the latest features, -and also easily contribute back to the project (if you want). +If you are interested in using all the latest features, you may wish to keep up to date +with the development branch of the git checkout. This also makes it easiest to contribute +back to the project. Instructions for installing from source are below. +Ansible's release cycles are about one month long. Due to this +short release cycle, any bugs will generally be fixed in the next release versus maintaining +backports on the stable branch. + You may also wish to follow the `Github project `_ if you have a github account. This is also where we keep the issue tracker for sharing bugs and feature ideas. + Running From Checkout +++++++++++++++++++++ @@ -51,6 +56,7 @@ Ansible is trivially easy to run from a checkout, root permissions are not requi to use it:: $ git clone git://github.com/ansible/ansible.git + $ git checkout -t origin/devel $ cd ./ansible $ source ./hacking/env-setup @@ -71,6 +77,7 @@ If you are not working from a distribution where Ansible is packaged yet, you ca using "make install". This is done through `python-distutils`:: $ git clone git://github.com/ansible/ansible.git + $ git checkout -t origin/devel $ cd ./ansible $ sudo make install @@ -78,8 +85,13 @@ using "make install". This is done through `python-distutils`:: Via RPM +++++++ -In the near future, pre-built packages will be available through your -distribution. Until that time, you can use the ``make rpm`` command to +RPMs for the last Ansible release are available for `EPEL `_ 6 and currently supported +Fedora distributions. + + # install the epel-release RPM if needed on CentOS, RHEL, or Scientific Linux + $ sudo yum install ansible + +You can also use the ``make rpm`` command to build an RPM you can distribute and install:: $ git clone git://github.com/ansible/ansible.git @@ -97,8 +109,9 @@ Debian, Gentoo, Arch, Others Gentoo eBuilds are available `here `_ -Debian package recipes are in progress -- see the source checkout, in the packaging/debian -directory. +Debian package recipes can be built from the source checkout, run:: + + make debian An Arch PKGBUILD is available on `AUR `_ If you have python3 installed on Arch, you probably want to symlink python to python2.:: @@ -106,7 +119,7 @@ If you have python3 installed on Arch, you probably want to symlink python to py sudo ln -sf /usr/bin/python2 /usr/bin/python If you would like to package Ansible for Homebrew, BSD, or others, -please stop by the mailing list and say hi. +please stop by the mailing list and say hi! Tagged Releases @@ -117,9 +130,6 @@ project page: * `Ansible/downloads `_ -At this point in Ansible's development, running or building from checkout is preferred -if you want access to all of the latest modules and improvements. - Your first commands ``````````````````` diff --git a/rst/playbooks.rst b/rst/playbooks.rst index adf42a5a61..eaf4ff34f5 100644 --- a/rst/playbooks.rst +++ b/rst/playbooks.rst @@ -236,7 +236,7 @@ to run a playbook inside a OS installer, such as an Anaconda kickstart. To run an entire playbook locally, just set the "hosts:" line to "hosts:127.0.0.1" and then run the playbook like so:: - playbook playbook.yml --connection=local + ansible-playbook playbook.yml --connection=local Alternatively, a local connection can be used in a single playbook play, even if other plays in the playbook use the default remote connection type::