Mirror of https://github.com/ansible/ansible.git

ansible hacktoberfest python

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

James Cammarata 6650ba7654 Squashed commit of the following: commit `9921bb9d20` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Mon Aug 10 20:19:44 2015 +0530 Document --ssh-extra-args command-line option commit `8b25595e7b` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Thu Aug 13 13:24:57 2015 +0530 Don't disable GSSAPI/Pubkey authentication when using --ask-pass This commit is based on a bug report and PR by kolbyjack (#6846) which was subsequently closed and rebased as #11690. The original problem was: «The password on the delegated host is different from the one I provided on the command line, so it had to use the pubkey, and the main host doesn't have a pubkey on it yet, so it had to use the password.» (This commit is revised and included here because #11690 would conflict with the changes in #11908 otherwise.) Closes #11690 commit `119d032389` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Thu Aug 13 11:16:42 2015 +0530 Be more explicit about why SSH arguments are added This adds vvvvv log messages that spell out in detail where each SSH command-line argument is obtained from. Unfortunately, we can't be sure if, say, self._play_context.remote_user is obtained from ANSIBLE_REMOTE_USER in the environment, remote_user in ansible.cfg, -u on the command line, or an ansible_ssh_user setting in the inventory or on a task or play. In some cases, e.g. timeout, we can't even be sure if it was set by the user or just a default. Nevertheless, on the theory that at five v's you can use all the hints available, I've mentioned the possible sources in the log messages. Note that this caveat applies only to the arguments that ssh.py adds by itself. In the case of ssh_args and ssh_extra_args, we know where they are from, and say so, though we can't say WHERE in the inventory they may be set (e.g. in host_vars or group_vars etc.). commit `b605c285ba` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Tue Aug 11 15:19:43 2015 +0530 Add a FAQ entry about ansible_ssh_extra_args commit `49f8edd035` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Mon Aug 10 20:48:50 2015 +0530 Allow ansible_ssh_args to be set as an inventory variable Before this change, ssh_args could be set only in the [ssh_connection] section of ansible.cfg, and was applied to all hosts. Now it's possible to set ansible_ssh_args as an inventory variable (directly, or through group_vars or host_vars) to selectively override the global setting. Note that the default ControlPath settings are applied only if ssh_args is not set, and this is true of ansible_ssh_args as well. So if you want to override ssh_args but continue to set ControlPath, you'll need to repeat the appropriate options when setting ansible_ssh_args. (If you only need to add options to the default ssh_args, you may be able to use the ansible_ssh_extra_args inventory variable instead.) commit `37c1a5b679` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Mon Aug 10 19:42:30 2015 +0530 Allow overriding ansible_ssh_extra_args on the command-line This patch makes it possible to do: ansible somehost -m setup \ --ssh-extra-args '-o ProxyCommand="ssh -W %h:%p -q user@bouncer.example.com"' This overrides the inventory setting, if any, of ansible_ssh_extra_args. Based on a patch originally by @Richard2ndQuadrant. commit `b023ace8a8` Author: Abhijit Menon-Sen <ams@2ndQuadrant.com> Date: Mon Aug 10 19:06:19 2015 +0530 Add an ansible_ssh_extra_args inventory variable This can be used to configure a per-host or per-group ProxyCommand to connect to hosts through a jumphost, e.g.: inventory: [gatewayed] foo ansible_ssh_host=192.0.2.1 group_vars/gatewayed.yml: ansible_ssh_extra_args: '-o ProxyCommand="ssh -W %h:%p -q bounceuser@gateway.example.com"' Note that this variable is used in addition to any ssh_args configured in the [ssh_connection] section of ansible.cfg (so you don't need to repeat the ControlPath settings in ansible_ssh_extra_args).		9 years ago
bin	Revert "Allow exceptions to pass through the program"	9 years ago
contrib	Replace .iteritems() with six.iteritems()	9 years ago
docs/man	Squashed commit of the following:	9 years ago
docsite	Squashed commit of the following:	9 years ago
examples	Replace .iteritems() with six.iteritems()	9 years ago
hacking	Replace .iteritems() with six.iteritems()	9 years ago
lib/ansible	Squashed commit of the following:	9 years ago
packaging	much needed update to port makefile	9 years ago
samples	Multiple fixes for include statements and blocks in general	9 years ago
test	Simplify FactCache.copy()	9 years ago
ticket_stubs	for ansibot compensation	10 years ago
.coveragerc	Add tox and travis-ci support	10 years ago
.gitattributes	updated changelog with 1.8.2-4 content, added .gitattributes	10 years ago
.gitignore	Add tox and travis-ci support	10 years ago
.gitmodules	remove old dead code	9 years ago
.travis.yml	Enable py34 test in travis so we don't regress recent fixes	9 years ago
CHANGELOG.md	Add note about the trailing newlines change	9 years ago
CODING_GUIDELINES.md	CODING_GUIDELINES: Fix typo: / => \	11 years ago
CONTRIBUTING.md	Update CONTRIBUTING.md	10 years ago
COPYING	license file should be in source tree	13 years ago
ISSUE_TEMPLATE.md	Merge pull request #9853 from axos88/patch-1	9 years ago
MANIFEST.in	Fix removal of .git from modules directories	10 years ago
Makefile	added egg to cleanup	9 years ago
README.md	Merge pull request #11869 from charleswhchan/devel	9 years ago
RELEASES.txt	Backporting release info/changelog stuff to devel	10 years ago
VERSION	Version bump for v2.0.0-0.1.alpha1 and submodule updates	9 years ago
setup.py	now include galaxy/data/ stuff for use with ansible-galaxy	9 years ago
test-requirements.txt	Mock 1.1.0 lost python2.6 compatibility	10 years ago
tox.ini	Use print() as function under contrib/	9 years ago

README.md

Ansible

Ansible is a radically simple IT automation system. It handles configuration-management, application deployment, cloud provisioning, ad-hoc task-execution, and multinode orchestration - including trivializing things like zero downtime rolling updates with load balancers.

Read the documentation and more at http://ansible.com/

Many users run straight from the development branch (it's generally fine to do so), but you might also wish to consume a release.

You can find instructions here for a variety of platforms. If you decide to go with the development branch, be sure to run git submodule update --init --recursive after doing a checkout.

If you want to download a tarball of a release, go to releases.ansible.com, though most users use yum (using the EPEL instructions linked above), apt (using the PPA instructions linked above), or pip install ansible.

Design Principles

Have a dead simple setup process and a minimal learning curve
Manage machines very quickly and in parallel
Avoid custom-agents and additional open ports, be agentless by leveraging the existing SSH daemon
Describe infrastructure in a language that is both machine and human friendly
Focus on security and easy auditability/review/rewriting of content
Manage new remote machines instantly, without bootstrapping any software
Allow module development in any dynamic language, not just Python
Be usable as non-root
Be the easiest IT automation system to use, ever.

Get Involved

Read Community Information for all kinds of ways to contribute to and interact with the project, including mailing list information and how to submit bug reports and code to Ansible.
All code submissions are done through pull requests. Take care to make sure no merge commits are in the submission, and use git rebase vs git merge for this reason. If submitting a large code change (other than modules), it's probably a good idea to join ansible-devel and talk about what you would like to do or add first and to avoid duplicate efforts. This not only helps everyone know what's going on, it also helps save time and effort if we decide some changes are needed.
Users list: ansible-project
Development list: ansible-devel
Announcement list: ansible-announce - read only
irc.freenode.net: #ansible

Branch Info

Releases are named after Van Halen songs.
The devel branch corresponds to the release actively under development.
As of 1.8, modules are kept in different repos, you'll want to follow core and extras
Various release-X.Y branches exist for previous releases.
We'd love to have your contributions, read Community Information for notes on how to get started.

Authors

Ansible was created by Michael DeHaan (michael.dehaan/gmail/com) and has contributions from over 1000 users (and growing). Thanks everyone!

Ansible is sponsored by Ansible, Inc