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
a75bae8a62
update versions ( #74432 )
2021-04-27 09:36:53 -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
Sandra McCann
6119fb0a9a
lighten navigation background to make section labels easier to read for core docs ( #74356 )
...
* make section labels for /ansible-core/ docs easier to read, with black text and lighter gray background
2021-04-22 13:54:27 -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
Scott Sinclair
325ccf22fe
Fix issue with version 3 in docs version list ( #74089 )
...
Previously would subsitute the "3" in "s3" instead of the version location in the URL
2021-04-19 18:33:35 +02: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
Alicia Cozine
126e9244c2
updates list of available versions for Ansible 3 ( #74265 )
...
* updates list of available versions for Ansible 3
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
2021-04-13 16:59:36 -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
Sandra McCann
481c036632
update intersphinx links for Ansible 3
2021-04-12 14:53:11 -07:00
Alicia Cozine
d7f826c987
Change look and feel of the ansible-core
docs ( #74200 )
2021-04-12 16:39:13 -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
Sandra McCann
7443e9d659
pin docutils to 0.16 until theme problem is fixed ( #74193 )
2021-04-08 13:37:00 -05: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
Yanis Guenane
212837defc
Documentation: Lay the ground for i18n work. ( #73746 )
...
* Documentation: Lay the ground for i18n work.
* Translating both ansible-core and ansible docs requires msgcat
(a program from the gettext package). If msgcat is not present,
only the ansible-core index file's strings will be extracted for translation.
If this is a problem, a short hacking script could be written to take the
place of msgcat (merging the various index pot files into a single pot file).
Co-authored-by: Toshio Kuratomi <a.badger@gmail.com>
2021-03-05 09:31:56 -08: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
Sandra McCann
6514027957
add base 2.10 to docs version switcher ( #73770 )
2021-03-03 13:06:11 -06: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
Alicia Cozine
29d3951464
Docs: Adds banner for core/package split ( #73552 )
...
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
2021-02-23 15:54:17 -05:00
Sandra McCann
f4eab92aa0
fix core version switcher ( #73704 )
2021-02-23 14:12:54 -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