Please find attached a DRAFT INITIAL FIRST VERYBASIC /dev/null-VERSION
(!!) for an Ansible reference card. As usual, this kind of an idea turns
out to be more work than anticipated...
The idea is to create a desktop reference for Ansible, and *not* to
replace the project's documentation! I'd like a few pages on which I can
be reminded of how templates work, SSH connections are done, module
parameters, tips & tricks, etc.
A lot (most) of this is currently copied/pasted from Ansible's
documentation.
I'd *very greatly* appreciate your feedback. I'd particularly appreciate
snippets of plain text I can add to some of the sections. (Plain text is
fine -- I'll do the rest.) If you have some bright ideas on how to best
fill the missing sections or how to improve on existing sections, please
speak up: the project will have an AUTHORS file which is just waiting
for your name...
Give me tips and tricks. Write a short paragraph on how to best set up
Paramiko and native SSH. P.l.e.a.s.e.
1. Don't mind the green bits: they're temporary to ensure I'm using
correct markup
2. Red bits are clickable
3. I'm writing this in LaTeX so we'll be able to share this on Github,
etc.
4. I've forseen a "short" version of the reference card which omits some
of the verbosity in the Modules section, thereby reducing the page
count.
Please find attached a DRAFT INITIAL FIRST VERYBASIC /dev/null-VERSION
(!!) for an Ansible reference card. As usual, this kind of an idea turns
out to be more work than anticipated...
The idea is to create a desktop reference for Ansible, and *not* to
replace the project's documentation! I'd like a few pages on which I can
be reminded of how templates work, SSH connections are done, module
parameters, tips & tricks, etc.
A lot (most) of this is currently copied/pasted from Ansible's
documentation.
I'd *very greatly* appreciate your feedback. I'd particularly appreciate
snippets of plain text I can add to some of the sections. (Plain text is
fine -- I'll do the rest.) If you have some bright ideas on how to best
fill the missing sections or how to improve on existing sections, please
speak up: the project will have an AUTHORS file which is just waiting
for your name...
Give me tips and tricks. Write a short paragraph on how to best set up
Paramiko and native SSH. P.l.e.a.s.e.
Paramiko is a native python implementation of the SSH protocol. It's
the default transport method used by Ansible, this method should work
for 99% of people by default. The native ssh transport method is
necessary in more complicated infrastructures where support for
bastion ('proxy') hosts is necessary, or if GSSAPI (kerberos) is used
for authentication. The native ssh transport will recognize your
~/.ssh/config file because it uses the 'ssh' command installed on the
local system.
1. Don't mind the green bits: they're temporary to ensure I'm using
correct markup
2. Red bits are clickable
3. I'm writing this in LaTeX so we'll be able to share this on Github,
etc.
4. I've forseen a "short" version of the reference card which omits some
of the verbosity in the Modules section, thereby reducing the page
count.
Regards,
-JP
PS: kindly burn PDF after reading.
PR submitted to fix the online nagios docs, wtr 'services' = required.
This is pretty nicely formatted. Also, I see now where you mention
full/empty circles.
The part about environment variables is kind of legacy behavior. My
understanding is that even though some ENV vars work, they're not
fully supported as a configuration method. You might want to stick to
just mentioning $ANSIBLE_CONFIG and giving reference to http://ansible.github.com/examples.html#configuration-defaults
