cmueller/ansible
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
51707 commits 47 branches 390 tags 440 MiB
Commit graph

2488 commits

Author SHA1 Message Date
Kelly Brazil
91212b2008
Add JC filter plugin example (#74563) 
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
 2021-05-14 11:37:29 -04:00
Jill R
fa15d35cb1
Update AWS guides with new SDK and Python requirements (#74585) 
The 2.0 collection releases will introduce new Python requirements
and a new SDK support policy
 2021-05-14 11:35:45 -04:00
Mark Mercado
1906d75907
Adding DigitalOcean cloud support to ansible-test (#74222) 2021-05-12 16:07:21 -07:00
Alicia Cozine
829c9c3d46 updates jinja filters links with new pattern for Jinja 3.x documentation 2021-05-12 10:08:00 -07:00
Toshio Kuratomi
8f2c0e0574
Update the porting guide for ansible-3.4.0 (#74664) 2021-05-11 16:14:29 -05:00
Abhijeet Kasurde
79e12ba98e
docs: Add a note about crypt (#74640) 
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
 2021-05-11 11:39:08 -04:00
David Shrewsbury
8fb54885bf
Role argspec: allow new argument spec file (#74582) 
* support separate role argspec file in ansible-doc

* support separate role argspec file in ansible-core

* support both .yml and .yaml extensions on argspec file in ansible-doc

* fix filename building bug and rename some argspec files to test variations

* use yaml extensions from constants

* add superfluous meta/main.yml files to tests

* Update lib/ansible/cli/doc.py

Co-authored-by: Sam Doran <sdoran@redhat.com>

* update docs

* ci_complete

* add changelog and allow for main.yml variations

* add collection role testing

Co-authored-by: Sam Doran <sdoran@redhat.com>
 2021-05-11 09:29:47 -05:00
Andrew Klychkov
5463cbb841
Docs: communication.rst - add ansible-community to the IRC channel list (#74570) 2021-05-06 15:10:53 -04:00
Felix Fontein
a6cc508822
Update the module lifecycle document to also cover plugins and collections (#74413) 
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
 2021-05-06 10:16:43 -04:00
Joseph Jacobs
dcb807dea7
Update cli_parsing.rst (#74555) 
Bad indent in an example
 2021-05-06 09:34:07 +05:30
Matt Clay
8bd599d048 Change Shippable refs in docs to Azure Pipelines. 2021-05-05 17:21:48 -07:00
Alicia Cozine
b765d3799b
update backporting instructions to reflect new latest stable branch, some edits (#74512) 
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
 2021-04-30 11:42:03 -04:00
Matt Clay
a30c55f68a Remove deprecated common.removed module_util. 
Tests have been updated to reflect its removal as well.
 2021-04-29 16:07:56 -07:00
Toshio Kuratomi
112b175f17
Update the porting guide for a new ansible version (#74490) 2021-04-29 10:03:21 -04:00
Christian Fetzer
f194108a26
docs: Improve documentation for regex_search,replace,findall (#74368) 
Improve the documentation for regex_search by adding a few more
realistic examples such as showing how to extract only parts of a
string by using regex groups.

Extend regex_findall and regex_replace by an example that includes
the multiline and ignorecase parameters.
 2021-04-28 08:45:01 -04:00
Mark Chappell
c387b318a6
AWS: update reference to auto-retrying ResourceNotFound (#72314) 
AWS Dev Guidelines: update reference to auto-retrying ResourceNotFound

Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
 2021-04-28 09:59:12 +05:30
Bill Nottingham
34c9ed8a28
Product-related updates. (#74454) 2021-04-27 16:19:57 -05:00
Alicia Cozine
9d9b08bece
fix spacing to fix header, reorg contributing page (#74421) 
Co-authored-by: John R Barker <john@johnrbarker.com>
 2021-04-27 10:41:10 -04:00
Lidiane Taquehara
f97787ca74
Update argcomplete docs links on installation guide (#74410) 
Link on installation docs is outdated. Switch to currently docs at: https://kislyuk.github.io/argcomplete/
 2021-04-27 09:40:37 -05:00
Sandra McCann
d1e6ee7b21
update changelog links and release-maint page (#74431) 2021-04-27 09:33:21 -05:00
Abhijeet Kasurde
8d499bbc83
Update Kubernetes collection name in docs (#74440) 2021-04-27 19:00:03 +05:30
Mark Chappell
63afb33d86
Use is_boto3_error_code in 'standard' example (#72313) 
Use is_boto3_error_code in 'standard' example rather than e.response['Error']['Code'] (#72313)

Co-authored-by: Sloane Hertel <shertel@redhat.com>
 2021-04-27 17:49:00 +05:30
Mark Chappell
cf08c23b4f
Update AWS dev guides to use collections utils and fragments (#72312) 2021-04-27 17:34:49 +05:30
jakelevinez
ddfc648d37
Update VMware library installation docs (#71219) 
Depending upon OS/distro, please use pip/pip3.
 2021-04-27 15:19:03 +05:30
dhx-mike-palandra
c2985c491b
Update complex_data_manipulation.rst (#72509) 2021-04-27 14:04:48 +05:30
Ernst Oudhof
7ca5dede97
Add weos4 network platform to documentation (#74088) 
* Add weos4 network platform to documentation

* Fix small format issues
 2021-04-23 23:52:14 +02:00
Alicia Cozine
c90922ee36
Docs - Split Developing collections page, add info on optional module_utils (#74105) 
*
 2021-04-23 17:03:46 -04:00
Alexandre Garnier
8698855ffd
Case-insensitive set theory filters (#74256) 
Fixes #74255

* Fix call to 'unique(case_sensitive=False)' triggering error when falling back to Ansible's version which **is** case-sensitive
* Test multiple situations of 'unique' filter errors with fallback not handling specific parameters

Signed-off-by: Rick Elrod <rick@elrod.me>
Co-authored-by: Rick Elrod <rick@elrod.me>
 2021-04-23 12:44:43 -05:00
Hublerho
e6a5245d60
Using "~" instead of "+" for concatination (#74364) 
Changed FAQ examples to conform with the Jinja documentation:
If both values on either side of a plus/+ are numbers, they will be added whereas using "~" will convert all operands into strings and then concatenate them. Closes #73799.
 2021-04-23 12:44:09 -05:00
Alex Willmer
c295de661c
Correct splitext() description, and example (#74377) 
`splitext()` returns a 2-tuple of strings, and the last element of the return value includes the `.`
 2021-04-22 15:40:58 -05:00
Sam Doran
fdbef02923
Update docs on working on docs (#74201) 
* Fix the Makefile's htmlsingle command.
Co-authored-by: Toshio Kuratomi <a.badger@gmail.com>
 2021-04-21 15:15:27 -04:00
Toshio Kuratomi
4c79dd16be
Update the porting guide for a new ansible version (#74362) 2021-04-21 10:23:31 -04:00
Sam Doran
2cbfd1e350
Add porting guide and documentation for changes to argument spec validation (#74268) 
* Add ArgumentSpecValidator to docs
* Improve docs for ArgumentSpecValidator
* Document removal of private methods

* Update module_utils documentation
    - Add docs for argument spec classes as well as validation and parameters files.
    - preserve the order in the source for errors.py
    - document DEFAULT_TYPE_VALIDATORS so it can be referenced elsewhere
    - fix automodule directive for validation.py

* Update docs in arg_spec and paremeters
    - This improves the generated documentation.

* Document breaking changes in porting guide.
* Update formatting in porting guide and add a Deprecated section
* Fine tune module_utils documentation


* Move instance docstring to the __init__ method
  Remove optional description since it fails the sanity test and I am not 100% it is valid anyway.

* Remoe incorrect parameter from docstring
  This was changed a while ago but wasn't removed from the docstring.

* Use attr rather than attribute
  The py:attribute: domain only exists in newer Sphinx >= 3.1.

* Improve documentation on exceptions
* Final pass
    - use args/kwargs instead of param
    - fix formatting errors that didn't display examples correctly
    - format TypeErrors so they are referenced as classes
    - specify complex types
 2021-04-20 15:40:53 -04:00
Abhijeet Kasurde
6e56e72d99
vmware: Add a note about known issue (#73273) 
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
 2021-04-20 14:11:45 -04:00
sry9681
c0cc574e65
Update lookup.rst (#73716) 
Document that users must pass `allow_unsafe=True` as an option in the lookup to allow templating, with a note about security implications.

Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-04-20 12:54:54 -05:00
ml
c9c84594d8
Docs: Fix k8s_config_resource_name YAML example (#74129) 
The `name` key should be beneath `metadata`:
 2021-04-20 13:37:44 -04:00
Abhijeet Kasurde
9ed0e37e53
Add a link to Jinja 2 templates (#74348) 
Added a link to Jinja 2 templates in playbooks_templating documentation page.
Fixes: #74313

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
 2021-04-20 12:14:08 -05:00
yuri
5f391a72ee
Update playbooks_filters.rst (#74242) 
##### SUMMARY
Make the `random` filter description more clear.
 2021-04-20 11:59:16 -04:00
schurzi
5e5bfa8116
remove deprecated ansible.module_utils._text from documentation (#73211) 
According to comment in ansible.module_utils._text it is deprecated and
should not be used. This is now reflected in the documentation.
 2021-04-20 11:53:27 -04:00
Baptiste Mille-Mathias
99a2b5f300
Provide results to examples (#73984) 2021-04-20 11:52:54 -04:00
David Shrewsbury
d44eb03f49
Remove include from tests (#74330) 2021-04-20 11:19:29 -04:00
daeseokyoun
9369bd6ca1
correct how to install Docker SDK for Python (#74288) 
* docs: correct guide for the latest Docker SDK for Python
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Daeseok Youn <daeseok.youn@navercorp.com>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
 2021-04-20 11:03:30 -04:00
Brian Coca
7b39ee361d
corrected epmhasis line (#74254) 
need to be careful when adding lines as you create a different offset
 2021-04-20 09:38:06 -05:00
Matt Martz
17237c1d88
Deprecate Py2.6 support for target nodes (#74165) 2021-04-16 11:42:29 -05:00
Toshio Kuratomi
ee38202fc0
Update the porting guide for ansible package 4.0.0 alpha4 (#74280) 2021-04-14 16:42:28 -04:00
Brian Coca
270f109bb3
fix see_also formatting (#74252) 2021-04-13 11:51:39 -04:00
Rick Elrod
19aeb4706d
[conditional] Remove support for bare variables (#74208) 
Change:
- Variables used in ``when`` conditionals are no longer parsed and
  attempted to be converted to booleans. All non-empty strings are
  considered true (empty strings, false).

Test Plan:
- Updated existing tests
- Added a bunch of new tests with various kinds of truthy/falsy
  values.

Tickets:
- Fixes #74134

Signed-off-by: Rick Elrod <rick@elrod.me>
 2021-04-13 11:12:10 -04:00
Matthew Cengia
c7473828c7
Docs: Remove duplicate word (#74223) 
The word "to" was erroneously used twice consecutively.

Signed-off-by: Matthew Cengia <mattcen@mattcen.com>
 2021-04-11 05:50:36 -05:00
Rick Elrod
d7df8a4484
[cron] Remove deprecated features (#74197) 
Change:
- Require name always
- Drop 'reboot' parameter in favor of 'special_time: reboot'

Test Plan:
- CI

Tickets:
- fixes #74132

Signed-off-by: Rick Elrod <rick@elrod.me>
 2021-04-08 15:50:27 -04:00
Matt Martz
09c8faca9f
Add 2.12 roadmap (#74000) 2021-04-06 12:43:38 -05:00
Alicia Cozine
05662fd2ab
Docs: clarify role docs - vars vs params, dependencies (#74104) 2021-04-06 11:24:28 -04:00
Rick Elrod
3a74f7ea22
prep for 2.12 version bump (#74126) 
* prep for 2.12
* Add 2.12 deprecations and sort ignore.txt list.

Signed-off-by: Rick Elrod <rick@elrod.me>
 2021-04-05 16:56:53 -05:00
Toshio Kuratomi
112a7718c6
Porting guide update for ansible-4.0 alpha3 (#74075) 2021-03-30 18:20:11 -05:00
Toshio Kuratomi
47ffa27416
Update the porting guide for a new ansible version (#74073) 2021-03-30 14:13:42 -05:00
Baptiste Mille-Mathias
6b33864a2c
Clarify tags on tasks are applied with OR and not AND (#74038) 
Co-authored-by: flowerysong <junk+github@flowerysong.com>
 2021-03-30 11:05:54 -04:00
Felix Fontein
af7f3fc266
Revert "Add duplicated set filter and documentation (#72729)" (#74053) 
This reverts commit 99a6627c60.

* ci_complete
 2021-03-27 20:28:28 -05:00
Baptiste Mille-Mathias
99a6627c60
Add duplicated set filter and documentation (#72729) 
Co-authored-by: Kerry <kerry@flatline-studios.com>
 2021-03-27 00:18:55 +01:00
Alicia Cozine
c66cff444c
documents the use of ansible.legacy (#73942) 2021-03-25 16:36:46 -04:00
Leandro Scardua
5dbcaa4c01
Update version on FreeBSD (#73664) 
##### SUMMARY
<!--- Your description here -->
On the main freebsd change, and no the version: py37-ansible

##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr
 2021-03-25 16:30:52 -04:00
Sandra McCann
59c61bc88a
update docs to uninstall ansible-base on upgrade (#74024) 2021-03-25 15:21:37 -05:00
sgpinkus
2abb2d3f17
Update playbooks_variables.rst. To say you can define variables within a playbook is somewhat misleading. Variables are defined within plays and are only visible within the play they are defined in *not* the entire playbook. There is no way to define vars to have strictly playbook scope. (#73986) 
+label: docsite_pr
 2021-03-25 16:05:50 -04:00
Marketka
0bf9b7fdf8
Added prerequisites to install for CentOS (#73993) 
* Added prerequisites to install for CentOS as well so CentOS users don't have to look for alternatives for each Ubuntu package.

Signed-off-by: mm667937 <marketa.muzikova@broadcom.com>


Signed-off-by: mm667937 <marketa.muzikova@broadcom.com>
 2021-03-25 16:03:32 -04:00
saruter
73c08df2db
Docs: Add filter "urlencode" with example (#74034) 
* Add example for URLENCODE filter
 2021-03-25 15:20:41 -04:00
Alicia Cozine
eb631c1881
use present tense for porting guide entries (#74021) 
Co-authored-by: Toshio Kuratomi <a.badger@gmail.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-25 15:04:10 -04:00
Andrew Klychkov
46b02e125f
dev_guide/testing_integration: update image list (#74017) 2021-03-25 11:24:01 -07:00
David Greaves
4881ca1dcb
Introduce the concept of playbooks early on (#74018) 
* Introduce the concept of playbooks early on
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-25 11:55:01 -04:00
Mark Mercado
3bccfb1615
Updating Community docs with DO information (#74019) 2021-03-24 16:24:46 -04:00
Andrew Klychkov
77ec2b3b3a
Documentation: update committer_guidelines.rst (#73782) 
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
 2021-03-24 15:30:55 -04:00
Toshio Kuratomi
c8a7899869
Update the porting guide for a new ansible version (#74016) 2021-03-24 12:12:09 -05:00
Andrew Klychkov
0543916a86
Docsite: clarify a changelog entry format (#73902) 
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-24 11:21:34 -04:00
Jim Speir
4780e10a2b
Adding jborean93/WindowsServer2019 in docs (#73950) 2021-03-23 21:16:54 +05:30
Matt Davis
c6cf7986ab
add porting guide info for optional module_utils (#73979) 2021-03-19 20:21:22 -05:00
Brian Coca
ccd9a992cf
complex data example using value and default from list of dicts (#73937) 2021-03-18 12:31:33 -07:00
sgpinkus
efe97aeb31
Update developing_inventory.rst (#73931) 
* Update developing_inventory.rst

hashes/dictionaries in JSON (JavaScript Object Notation) are represented by what JSON calls "objects", so use that established terminology instead of "hash", "dictionary", or "hash/dictionary" etc.

* Update docs/docsite/rst/dev_guide/developing_inventory.rst

Co-authored-by: Sloane Hertel <19572925+s-hertel@users.noreply.github.com>
 2021-03-18 12:14:21 -07:00
Ompragash Viswanathan
561cdf3ace
Updated COLLECTIONS_4.rst to include ansible-inclusion repo link for new collection submission (#73582) 
Co-authored-by: Sandra McCann <samccann@redhat.com>

Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-18 11:59:01 -04:00
Sloane Hertel
95dc8f2361
Add some dev documentation for constructed features (#73497) 2021-03-18 09:45:13 -04:00
Alicia Cozine
30c465c1a9
Promote publication (#72400) 
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-17 16:14:32 -04:00
Alicia Cozine
b57444af14
Rebased pr73824 (#73934) 
Co-authored-by: Eugene <k.evgen61@gmail.com>
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
 2021-03-17 16:07:38 -04:00
Toshio Kuratomi
0279d02980 Add porting guide for ansible 4 2021-03-17 08:41:02 -07:00
Toshio Kuratomi
e10da3c368 Porting guide changes when adding a new ansible release 
* Add the ansible-4 porting guide to the index
* Need to exclude the porting guide for ansible-4 from the core docs build
 2021-03-17 08:41:02 -07:00
Ikko Ashimine
3098022146
Fix typo in porting_guide_3.rst (#73871) 
paramater -> parameter
 2021-03-15 15:58:41 +05:30
Toshio Kuratomi
197e8f5640
Mention that minor releases end once the next ansible release is made. (#73836) 2021-03-11 16:12:55 -06:00
Toshio Kuratomi
780f79ecbc
Update the porting guide for a new ansible version (#73856) 2021-03-11 14:49:03 -06:00
Sandra McCann
bd020dd14a
describe what ansible-core is (#73829) 2021-03-11 14:27:36 -06:00
Jens Heinrich
27eaab310b
Add direct link to using multiple inventory sources (#73680) 
This helps users to find the right ressources more easily and prevents them from clicking the first matching link only to be redirected to a subsection on the samepage from there

Co-authored-by: Jens Heinrich <github.com/JensHeinrich>
 2021-03-11 14:36:00 -05:00
Alicia Cozine
474f46ea56
Docs: Updates the release and maintenance page to reflect new cadences (#73781) 
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
Co-authored-by: John R Barker <john@johnrbarker.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
Co-authored-by: John R Barker <john@johnrbarker.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
 2021-03-11 14:25:18 -05:00
bylerbk
1ac2858b5a
Update developing_modules_general.rst (#73805) 
##### SUMMARY
<!--- Fixing a typo. There was a double "you" in the text. -->


##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr
 2021-03-11 14:11:04 -05:00
Alicia Cozine
31932f5fa3
Docs: Update installation page for package split (#73790) 2021-03-11 11:05:44 -08:00
Felix Fontein
b2015c98e2
validate-modules: make sure that options that potentially contain secret data have no_log set (#73508) 
* Catch more potential errors (and increase false-positive rate).
* Flag some false-positives in lib/ansible/modules/ with no_log=False.

Co-authored-by: John Barker <john@johnrbarker.com>
 2021-03-11 12:57:11 -05:00
David Shrewsbury
78d3810fdf
Auto cleanup of async cache file (#73760) 
* Auto cleanup of async cache file

* Add changelog
 2021-03-04 11:06:27 -08:00
Rick Elrod
2d85c9de93
Some changelog fixes for 2.11 (#73778) 
Signed-off-by: Rick Elrod <rick@elrod.me>
 2021-03-03 16:26:59 -05:00
Felix Fontein
c888705493
Add note on infoblox inventory script. (#73676) 2021-03-02 11:01:50 -06:00
Brian Williams
1f2f292290
Fix invalid yaml in collections_using.rst (#73727) 
Fix invalid quoting.
 2021-03-02 10:10:08 -05:00
Felix Fontein
3cc693b92c
Import test: improve docs, add more tests (#73600) 2021-03-01 16:10:46 -08:00
Brian Coca
91b42d62fa
another useful example (#73728) 2021-02-25 16:11:16 -06:00
Sviatoslav Sydorenko
c22bc46cb9
Mention ansible-core @ "Release and maintenance" (#73612) 2021-02-22 19:07:25 -06:00
Viktor Ekholm
b28abdfbdb
Fixed typo in vault documentation (#73666) 
Example variable was named `my_encrytped_var`. Renamed it to `my_encrypted_var`.
 2021-02-22 19:03:23 -06:00
David Shrewsbury
c8ee186e11
Remove warning about role validation with deps (#73653) 
* Remove warning about role validation with deps

* add changelog

* update cl
 2021-02-18 17:16:03 -06:00
Willams de Lima
fa05af8321
Fixing ad-hoc commands #73636 (#73646) 2021-02-18 16:48:22 -06:00
Toshio Kuratomi
89ed2353e0
Update the porting guide for a new ansible version (#73650) 
* Update the porting guide for a new ansible version

* Add a link to the changelog to the ansible-3 porting guide
 2021-02-18 12:38:56 -05:00