Commit Graph

3145 Commits (20cc87f0598e14fde3218d012c7234f5049d2899)

Author SHA1 Message Date
Vicente Jimenez Aguilar a1236a582c
Stop using "checksumming" instead of "encrypting" in the docs (#76168)
* Hashing is not encrypting

All encryption systems have a formal inverse function to decrypt
A hash is a one way function without inverse by definition

* Update docs/docsite/rst/user_guide/playbooks_filters.rst

Co-authored-by: Sandra McCann <samccann@redhat.com>
3 years ago
Sebastian Wiesinger 1b43298316
Update dev guide for vars plugins in collections (#75861) 3 years ago
Sandra McCann 636b317a4f
update backport instructions for 2.12 (#76209) 3 years ago
David Moreau Simard 2fd26ea35a
docs: Update porting guide for Ansible 5.0.0a3 (#76201) 3 years ago
David Moreau Simard 2de7c59930
docs: Update porting guide for Ansible 4.8.0 (#76197) 3 years ago
Sandra McCann fdc3348859
Docs: Add skeleton roadmap for Ansible 6 (#76130)
* add skeleton roadmaps
* fix spacing
* correct link
* remove skeleton
3 years ago
Paul e84d660140
Update playbooks_tests.rst (#76047) 3 years ago
mscherer 2955ff57a7
Fix module name (#76058) 3 years ago
Matthew Donoughe d17f9a523d
Docs: fedora32 is no longer supported (for integration tests) (#76159) 3 years ago
Aine Riordan e0e6464873
Docs: Fix text for contributing to collection link (#76174) 3 years ago
Richard Megginson 360a3d2431
Clarify that "requires_ansible" means Ansible Core (#76100)
Clarify that the `requires_ansible` field in meta/runtime.yml refers to the version of Ansible Core (ansible-core), not any package called "ansible" e.g. https://pypi.org/project/ansible/
3 years ago
Jonas I. Liechti 0b0acef423
bug fix: using non-FQDN in plugin choices fails plugin name verification (#75991)
* enable both non-FQDN and FQDN plugin name
* add info about matching requirement of plugin name in config and plugin source file
3 years ago
Sean Cavanaugh 3a9e42cfde
Docs: Change API endpoint for hub to console.redhat.com in user guide (#76080)
The cloud.redhat.com has changed to console.redhat.com
3 years ago
Matt Martz 19c8790251
2.13 schedule (#75843) 3 years ago
Brian Scholer 4abc669c24
Update module documentation about ref links (#76088)
* Update module documentation about ref links
3 years ago
Martin Krizek 26707a3c6b
Heisen jinja2_native (#75587)
* Use NativeEnvironment for all templating

ci_complete

* Keep Templar.copy_with_new_env for backwards compat

* Mention that AnsibleUndefined.__repr__ changed in the porting guide

* Templar.copy_with_new_env backwards compat

* ci_complete
3 years ago
Nedko Hristov 6b8ed23926
Update `argcomplete` install via apt command (#76139)
To install `argcomplete` on Ubuntu 21.10 we need to update the install line to use Python3
3 years ago
Matt Martz 9b4f9e9fd3
Drop python2.6 support in module execution (#76106) 3 years ago
Sandra McCann 835fe71828
Docs: fix link to 2.12 changelog (#76091) 3 years ago
David Moreau Simard 43d09710c8
Update porting guide for Ansible 5.0.0a2 (#76083) 3 years ago
Sean Cavanaugh 817e1045bb
Update network_resources.rst (#76040)
* Update network_resources.rst

I am not sure a fully qualified URL should be here... but teach me great documentation gods

* Change platform index external link to internal ref

Co-authored-by: Aine Riordan <44700011+ariordan-redhat@users.noreply.github.com>
3 years ago
Deric Crago 9a0fe18915
allow override of PYTHON variable (#76023) 3 years ago
Matt Clay fae0cf4c51 Remove unofficial packaging.
Unofficial packaging should be maintained externally since
it is not tested in CI or used in the official release process.

Maintainers of unofficial packages are better equipped with the necessary
expertise and testing resources to support alternative packaging.
3 years ago
Brian Coca ff792d252e
Docs: dash - character invalid in playbook names in collections(#75891)
* collection playbooks, note no -
fixes #75890
3 years ago
fermin 9eeaf1c5b5
Docs - add code-block:: wrapping for playbooks filter doc (#75953)
* Add code-block
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Deepansh 64506c7d15
Docs: Change note for rackspace cloud guide (#75898)
* Fix rackspace cloud guide docs
* Fix syntax error
3 years ago
Chris Hepner 67c12fc4eb
Docs - Fix "kubernetes.core" typos in code snippets (#75930)
Replace "kuberernetes.core" with "kubernetes.core" in filter examples.
3 years ago
David Moreau Simard 93a6299cd3
docs: Update porting guide for Ansible 4.7.0 (#76034) 3 years ago
Abhijeet Kasurde 1ea74f4dd6
Misc typo fix (#76008)
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Miroslav Brabenec fa4a92f221
Docs: Add code-block:: to examples in ipaddr filters doc(#75951)
* Add code-block elements to playbooks_filters_ipaddr
* Add punctuation to lead-in sentences for code blocks
3 years ago
marie 2a3aa66fbd
docs - wrap examples in code-block:: in sample setup (#75964)
* docs: Use code-block to format code in sample setup
Fixes #75905
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Tim Pogue 4444692436
Docs: add code-block:: to playbook variables doc in user guide(#75985)
* update code-block formatting changes.
3 years ago
Midhun R Nair 6bf65f6246
Docs - Added code-block:: wrappers in playbook tests doc (#75952) 3 years ago
Matěj G 6319a0f415
docs - Wrap examples in code-block:: in loops guide (#75916)
* docs - Use code-block to format examples in loops guide
Resolves #75900
3 years ago
Paul Capron afbef70bad
documenting_modules_network.rst: Add missing space (#75972) 3 years ago
Matěj G d6dbc1a26f
docs - Change :: to code-block:: in error handling guide (#75978)
Fixes #75908
3 years ago
Alfred Tso 4d8a724071
docs - Replace :: with code-block:: in playbooks_conditionals doc (#75965)
Fixes #75906
3 years ago
NarayanAdithya d26ff4e376
Docs: changed :: to code-block:: in 9 files (#75994)
* Fixed 9 files in user guide
3 years ago
Joshua Ford 221c7373db
docs - Add code-block to code examples in playbooks_strategies.rst (#75960)
Fixes ansible#75911.
3 years ago
Joshua Ford fd346565d3
docs - wrap examples in code-blocks in playbooks_vars_facts.rst (#75961)
Fixes ansible#75912.
3 years ago
Holger Dörner 37eefb47c5
Docs: Add code-blocks to examples in Windows-WinRM guide (#75974)
Co-authored-by: Holger Dörner <h.doerner@bitexpert.de>
3 years ago
Holger Dörner 84ec976378
Docs: Add code-blocks to Playbooks-Delegation in user guide(#75973)
Co-authored-by: Holger Dörner <h.doerner@bitexpert.de>
3 years ago
Tamas Szabo d0edf69fe0
docs: code-block wrapping for playbooks_debugger.rst (#75968)
* code-block wrapping for playbooks_debugger.rst #75919
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Sanjula Madurapperuma cd540544fd
Docs: add code block elements in user_guide/playbooks_async.rst (#75947)
* Fix for code block
3 years ago
Angel Mendez fffa9412f4
Docs: add code blocks elements for user_guide/vault.rst (#75963)
* feat:(docs) add code blocks elements for user_guide/vault.rst
Addresses issue #75921
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Tamas Szabo 71811407c5
Docs: code-block wrapping for playbooks_checkmode.rst #75925 (#75931)
* code-block wrapping for playbooks_checkmode.rst #75925
* Fixes typo in previously introduced code-block
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Tamas Szabo 22a540e109
Docs: Code-block wrapping for playbooks_startnstep.rst #75934 (#75943)
* Code-block wrapping for playbooks_startnstep.rst #75934
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
nicpayne713 5c4bbed2de
Docs: Add code-blocks to user guide doc (#75928)
* Add code-block elements to 5 examples

* Add :
3 years ago
Tamas Szabo 81eec4a05a
Docs: code-block wrapping for playbooks_module_defaults.rst #75936 (#75942) 3 years ago
Nathan Tsai a2ff765e06
Docs: add code-blocks to User Guide modules_intro (#75932) 3 years ago
Mahesh a4a7a34893
Docs: Add code-blocks to user_guide/intro_patterns.rst (#75941) 3 years ago
nicpayne713 4381336fbb
Docs: issue 75922 add code-blocks to user_guide/playbooks_environment.rst (#75929)
Add code-blocks in the 6 outlined examples from the Issue
3 years ago
Pinky b03afeec6c
Adding code-block elements in user_guide/playbooks_prompts.rst (#75935) 3 years ago
Tim Pogue d0b88eecd8
Code block format user guide/windows setup.rst #75914 (#75956)
* set changes for code boxes.

* post changes to attempt to fix seealso links.

* attempting to fix seealso tag

* fix un-indention for sanity check.
3 years ago
Lucas Culley 89bc7ebfe6
code-block wrapping for playbooks_advanced_syntax.rst (#75981)
* code-block wrapping for playbooks_advanced_syntax.rst

* fixed spacing
3 years ago
Sandra McCann 8e77943a97
remove fest banner (#75901)
* remove fest banner

* fix nit
3 years ago
Tamas Szabo 801db758d3
code-block wrapping for playbooks_best_practices.rst #75937 (#75939) 3 years ago
Alicia Cozine 9a4346bae3
Docs: Moves the AWS Scenario Guide out of the main docs (#74704)
* removes AWS scenario  guide, moving to collection

* first attept to replace TOC entries

* not sure what I did, but saving it

* updates TOCs to reflect new location of aws guide

* reinstates original page as a stub

* adds links to new location for AWS guide, updates header

Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
3 years ago
Toshio Kuratomi 0c8b62b527
Update the porting guide for a new ansible version (#75893) 3 years ago
Ankur H. Singh 000ae00cfd
Docs: Clarify adding newlines in YAML folded block scalar (#75875)
* Removed translatable words from code blocks

##### SUMMARY
Removed translatable words from codeblocks as per #59449

##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr

* Maintaining intend as well as clearity

* Preserving "save_as" as the key

* showing equivalence and keeping same context
3 years ago
Samuel Gaist 19fce0527a
docs - Use code-block to format code examples in Developer Guide (#75849)
Fixes #75663
3 years ago
RamblingPSTech 8988f8ab5d
Corrected mytask.yml file name (#75860) 3 years ago
Toshio Kuratomi 20904c2fb6
Move ansible-5.1 to 2021-12-21 (#75865)
We moved the target date for ansible-5.0 one week back so there's now
time to do 5.1 before the holidays start.
3 years ago
Samuel Gaist 4aede377d2
docs - Use code-block to format code examples in Community Guide (#75847)
Fixes #75675
3 years ago
Samuel Gaist 4d398ca3a4
docs - Use code-block to format examples in Network Guide (#75850)
Fixes #75676
3 years ago
Matt Davis bb59d9afe9
bump devel to 2.13 (#75833) 3 years ago
Sandra McCann 927ffe26b7
Docs: add install link for windows (#75811) 3 years ago
Matt Martz a9bd8b6cff
No Ansible Engine (#75812) 3 years ago
Felix Fontein 8643db5ac3
Bump antsibull version to get support for attributes and CLI options (#75787)
* Bump antsibull version to get support for attributes and CLI options.

* Include fix for attributes.

* Include fix for rst_epilog collision and for #75799.
3 years ago
Amin Vakil 2934c4f710
ansible is now ansible-core in AUR too (#75145) 3 years ago
Abhijeet Kasurde 6981237130
ad-hoc: add documentation about pattern (#73303)
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Brian Coca 0cb7a4d260
clarify order (#75338) 3 years ago
Jonas I. Liechti e021a65403
using FQCN also for ansible.builtin collection (#75644) 3 years ago
Brian Coca e5a52c1e9d
added section about parallelism to delegation (#74158) 3 years ago
Brian Coca d3ebbef075
correct dedupe scope (#75422) 3 years ago
Brian Scholer f4cdea9645
docs - add some info on plugin option source precedence (#75754)
* docs - add some info on plugin option source precedence

##### SUMMARY
Add some clarity on precedence, especially from sources of the same type.


##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr

* update RST formatting

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

Apply review suggestions

Co-authored-by: Aine Riordan <44700011+ariordan-redhat@users.noreply.github.com>

Co-authored-by: Aine Riordan <44700011+ariordan-redhat@users.noreply.github.com>
3 years ago
Matt Martz 5183a2e585
Add note about `loop_control.extended` memory impact (#75759)
* Add note about `loop_control.extended` memory impact

* moar correct
3 years ago
Matt Martz 65b5472ad1
Update roadmap to indicate branching happens at feature freeze (#75777) 3 years ago
Toshio Kuratomi a5e7ed0cc5
Update ansible porting guide for 4.6.0 release. (#75752) 3 years ago
Thomas Sjögren 57359d0174
use passlib default if `password_hash` option isn't set (#75043)
* add changelog fragment
* password_hash|length == 120
* mention the new default bcrypt format in the porting guide
3 years ago
Matt Martz 724800cd3f
Python 3.8 Controller Minimum (#74013) 3 years ago
Matt Clay 4ea8d9a782
ansible-test - split controller/target testing (#75605) 3 years ago
Daniel Goldman 989eeb243f
Add an `undef` global Jinja function (#75435)
* add tests for fail filter

also tests that fail does not block inspectability

* add fail filter

fallback message is a bit clunky,
since you can't invoke a filter without specifying an input.
That is, "{{ fail }}" doesn't work,
so you have to do "{{ None | fail }}"

* document 'fail' filter

* add changelog fragment

* fail filter uses default message on Undefined or emptystring

makes it slightly easier to use the default message:
```diff
- "{{ None | fail }}"
+ "{{ '' | fail }}"
```

and the user sees a slightly more relevant message
if the message itself is undefined:

```diff
- The error was: {{ failmsg | fail }}: 'failmsg' is undefined
+ The error was: {{ failmsg | fail }}: Mandatory variable has not been overridden
```

* rebuild as the builtin `Undefined`

* harmonise `hint` parameter for make_undefined with jinja

* use code block for documentation item

[ref](https://github.com/ansible/ansible/pull/75435#discussion_r707661035)

* rename to `undef` to expose less Python into the Jinja

[ref](https://github.com/ansible/ansible/pull/75435#pullrequestreview-757799031)

* explicitly instantiate undefined value now that it's possible

see I knew we would break something with reflection

* preserve test coverage of undefined variable

Co-authored-by: Matt Davis <nitzmahone@users.noreply.github.com>
3 years ago
Rick Elrod 61f5c22551
Remove (only) user-facing use of ANSIBLE_ASYNC_DIR (#74249)
Change:
- Remove only user-facing use of ANSIBLE_ASYNC_DIR.
- Remove two comments saying to change things that, apparently, we
  aren't going to change...

Test Plan:
- ci_complete

Tickets:
- Fixes #74139
- Fixes #74138
- Refs #74226

Signed-off-by: Rick Elrod <rick@elrod.me>
3 years ago
Chris Hambridge 1353678f23
Enable ansible-galaxy to specify client id override with Keycloak Token (#75601)
* Enable ansible-galaxy to specify client id override with Keycloak Token

* Specify ability to provide override of client_id

* Test client_id can be configured for individual servers

* Add issue link to changelog

* Document client_id as a config option and add an example

Co-authored-by: s-hertel <19572925+s-hertel@users.noreply.github.com>
3 years ago
Matt Clay 54a795896a
Integration test and sanity index generation fixes. (#75731)
* Fix test usage of `which python`.

Also use `command -v` instead of `which` where needed.

* Fix testing_formatter.sh file checking.

The index is longer expected to exist when generating it.
The generation script is run with `set -eux`.
3 years ago
Sloane Hertel f0d43cfffc
Document validate_certs option for Galaxy server configuration (#75728)
Added in #75710
3 years ago
Aine Riordan 2346f93961
Docs: Fix section header notation in Style Guide (#75720) 3 years ago
Aine Riordan 17122edfc5
Docs: Fix section header notation in Developer Guide (#75721) 3 years ago
Aine Riordan 3d081b6ca5
Docs: Edit list of locations to search for roles (#75703)
* Docs: Add playbook base dir to roles search

* Docs: Add link to default roles path
3 years ago
Jon Pugh b1527dcf63
Small typo in vars plugin example. (#75702) 3 years ago
Matt Martz 208014422d
Fix markdown links that were errantly formatted as rst (#75697) 3 years ago
Aine Riordan 01f0c38aa5
Docs: Update cross reference tag syntax in User Guide (#75693) 3 years ago
Erik Zettel c2fa71c4e8
Fix various typos in documentation (#75662)
* docs/docsite/rst/dev_guide/developing_modules_general_aci.rst: fix typos

* docs/docsite/rst/dev_guide/testing/sanity/no-get-exception.rst: fix typos

* docs/docsite/rst/dev_guide/testing_units_modules.rst: fix typos

* docs/docsite/rst/network/dev_guide/developing_resource_modules_network.rst: fix typos

* docs/docsite/rst/porting_guides/porting_guide_2.0.rst: fix typos

* docs/docsite/rst/porting_guides/porting_guide_2.10.rst: fix typos

* docs/docsite/rst/porting_guides/porting_guide_2.4.rst: fix typos

* docs/docsite/rst/porting_guides/porting_guide_3.rst: fix typos

* docs/docsite/rst/porting_guides/porting_guide_4.rst: fix typos

* docs/docsite/rst/reference_appendices/glossary.rst: fix typos

* docs/docsite/rst/reference_appendices/release_and_maintenance.rst: fix typos

* docs/docsite/rst/scenario_guides/vmware_rest_scenarios/collect_information.rst: fix typos

* docs/docsite/rst/scenario_guides/vmware_rest_scenarios/vm_tool_information.rst: fix typos

* docs/docsite/rst/scenario_guides/vmware_scenarios/vmware_inventory_vm_attributes.rst: fix typos

* docs/docsite/rst/user_guide/playbooks_debugger.rst: fix typos

* docs/docsite/rst/user_guide/playbooks_filters.rst: fix typos

* docs/docsite/rst/user_guide/windows_performance.rst: fix typos

* docs/docsite/rst/scenario_guides/vmware_scenarios/vmware_inventory_vm_attributes.rst: fix typos
3 years ago
Matt Clay de01db08d0
pip - Use pip from the current Python interpreter. (#75634)
* pip - Use pip from the current Python interpreter.

If `executable` and `virtualenv` were not specified, and
the `pip` Python module is available for the current interpreter,
use that `pip` module instead of searching for a `pip` command.

* Add comment about needing `__main__` to run `pip`.

* Fix unit test.

* Add porting guide entry.

* Update changelog to match porting guide description.

ci_complete
3 years ago
Brian Coca 90518d8bb5
added vault/unvault docs (#75140) 3 years ago
Brian Coca 8af54a0355
Added info about playbooks for collection (#75535)
*
3 years ago
Alicia Cozine 2c67954f9b
Docs: adds warning about utf-8 in templates (#75504) 3 years ago
Toshio Kuratomi 0ef9b9ee49
Update the porting guide for a new ansible version (#75610) 3 years ago
Greg Sutcliffe 388760eef6
Docs: Add more Matrix documentation (#75588)
* Refs #75478 - On the communicating page, add Matrix links to first 4 chat spaces, improve introduction, update working groups with Matrix and IRC locations, add a link to the community FAQ, add localised community translations, and remove Lightbulb room, the GitHub project has been archived

Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
3 years ago