Commit Graph

3554 Commits (fab495f4dfc17b0814617fbc9224e8b9d128a1db)

Author SHA1 Message Date
paulreece 717f178870
Add tutorial links to the docs #78073 (#78084) 2 years ago
Sandra McCann 66c0882314
reword the regex note (#75393)
Co-authored-by: Matt Martz <matt@sivel.net>
Co-authored-by: Brian Scholer <1260690+briantist@users.noreply.github.com>
2 years ago
Don Naro 3cd2c494bd
issue #72449 winrm script rm (#77931) 2 years ago
Emanuele Barbato 681dc6eab9
Windows - incorrect python-devel package in WinRM docs (#78037)
Co-authored-by: Emanuele Barbato <manu@Giuseppes-MacBook-Air.local>
2 years ago
Matt Martz 18992b7947
Add new `loop_control.extended_allitems` option (#75760)
* Add new `loop_control.extended_allitems` option. Fixes #75216

* Add test for extended_allitems

* docs code block fix
2 years ago
Andrew Klychkov 46d86a882d
Docsite: update links to community docs (#78043) 2 years ago
Sandra McCann f4ad1c771e
Create reusable role layout snippet for documentation (#78057)
* reuse role structure
* reuse role snippet in role docs
2 years ago
Lewis Brogan 561cf1956d
Docsite: Updated style guide resources (#78048) 2 years ago
Felix Fontein 614dc10ef0
With antsibull-changelog >= 0.14.0 and the sidecar docs feature, test and filter plugins are detected if they have version_added (#77871)
Co-authored-by: Brian Scholer <1260690+briantist@users.noreply.github.com>
3 years ago
Bennykillua 556ac89664
Rephrase-community (#77985) 3 years ago
Philippe Kueck fa840d4c7c
mention different results for password_hash depending on library used (#76863) (#77963) 3 years ago
Sandra McCann 85329beb90
update backport instructions to reflect stable-2.13 (#77958)
Co-authored-by: Divine Odazie <dodazie@gmail.com>
3 years ago
Felix Fontein ca9be6e27e
Fix docs links for the steering committee (#77974) 3 years ago
Ompragash Viswanathan a30500144e
docs: Update porting guide for ansible 6.0.0rc1 (#77991) 3 years ago
Ompragash Viswanathan f9d4c26143
docs: Update porting guide for ansible 5.9.0 (#77982) 3 years ago
Martin Krizek 0fae2383da
Add macOS fork issue to FAQ (#77965)
* Add macOS fork issue to FAQ

* Remove colon from error msg
3 years ago
Mario Lenz 0ff1ba3e12
Move AWS guidelines to collection (#77959) 3 years ago
Martin Krizek 39b3581316
Deprecate non lists lookups (#77875) 3 years ago
Andrew Klychkov e589eba506
Docs: change community collection inclusion process (#77905) 3 years ago
Dan Kolepp 16e0d4a121
fix: update button text to "Load token" (#77925) 3 years ago
Don Naro 89e4fb71e6
Issue #77681 revamp getting started guide (#77897) 3 years ago
Mario Lenz b69eb28ed2
Migrate community.vmware Dev Guide to collection (#77723) 3 years ago
Sandra McCann f3c684564c
Remove platform dev guides from core docs (#77915) 3 years ago
David Moreau Simard 9f7956ba30
docs: add missing notes in porting guide for 6.0.0b1 (#77926)
There was an issue with the changelog in community.network 4.0.0, it's
been fixed in 4.0.1 and now properly included.
3 years ago
David Moreau Simard 7c89562580
docs: update porting guide for ansible 6.0.0b1 (#77913) 3 years ago
TheBigBear 45d930e9c1
Point to Kerberos as a safer winrm setup method (#77794) 3 years ago
Sergei Petrosian 74469bf54a
[docs]Mention that global variables are not mapped to hostvars (#77783) 3 years ago
Sandra McCann a99623bce1
add anchors for crossreferencing (#77800) 3 years ago
rawtaz 9010f0fbe3
doc: Clarify stride/increment in inventory intro (#77893) 3 years ago
Matt Martz a2eb472fb6
Remove statement about dependencies and includes. Fixes #75055 (#77912) 3 years ago
David Moreau Simard 66e92a3aff
docs: Update porting guide for ansible 6.0.0a3 (#77842) 3 years ago
David Moreau Simard 059204b871
docs: Update porting guide for ansible 5.8.0 (#77843) 3 years ago
Sandra McCann f5642cea28
update version switcher to include 2.13 (#77786) 3 years ago
Tabah Baridule f75bb09a8b
Update url to quickstart video. (#77779) 3 years ago
Sandra McCann 654fff05e6
clarify Ansible EOL details (#77778)
* clarify Ansible EOL details: update docs/docsite/rst/reference_appendices/release_and_maintenance.rst
Co-authored-by: Felix Fontein <felix@fontein.de>
3 years ago
Sandra McCann 6230244537
core-2.13 - update release table (#77780) 3 years ago
Brian Coca 8e91403412
revamp basic concepts docs (#77748) 3 years ago
Felix Fontein 836683a082
Stop making core docs build talk of (ansible-)'base' when meaning (ansible-)'core'. (#77728) 3 years ago
David Moreau Simard 235f2598b1
docs: Update ansible-core release date in Ansible roadmap (#77775) 3 years ago
Matt Martz 75bc630565
2.13 GA has been bumped up a week to release on May 16 (#77772) 3 years ago
Mario Lenz 9923e92d97
Fix plugin dev examples (#77759)
* Fix plugin dev examples

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

Co-authored-by: Felix Fontein <felix@fontein.de>
3 years ago
Andrew Klychkov 97e574fe6e
Docsite/communication.rst: fix formatting (#77760) 3 years ago
Sandra McCann 5e22fe21fd
stub out ovirt dev guide with pointer to new location (#77751) 3 years ago
Desmond Obisi 42086c14a3
Updated the playbook section in this docs (#77747) 3 years ago
Matt Davis d352f2ec21
core branch descriptions (#76152) 3 years ago
David Moreau Simard 0cfc291573
docs: update porting guide for ansible 6.0.0a2 (#77736) 3 years ago
Kristian Heljas 52bd59c481 Docs: `ansible-test sanity` example with a folder
##### SUMMARY
The docs mentions explicitly that you can run the tests against certain files which might not relay that it works on folders too!

Let's make this clear :)

##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr
3 years ago
Brian Coca 255745b3e6
simplify developing modules (#77647) 3 years ago
Jordan Borean dd094a4413
Mention admin requirement for runas become (#77722) 3 years ago
Douglas J Hunley 5753fd2d8d
docs: announce the PG working group (#77732) 3 years ago
Sandra McCann ef2fe6823c
add collection pr review checklist (#77661)
Co-authored-by: Emmanuel Ugwu <32464178+ugwutotheeshoes@users.noreply.github.com>
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
3 years ago
Andrew Klychkov a1ddb83fc1
Docsite: move a stepped down steering committee member to past members (#77715) 3 years ago
Alexei Znamensky c71faec595
typo in doc (#77672) 3 years ago
Sandra McCann f633b62cbc
clarify latest release (#77577)
* clarify latest release
* fix tables
3 years ago
Jan-Piet Mens f6fb402d1f
Update guide_vultr.rst (#77665) 3 years ago
deosrc cf5f0690f0
Typo fix (#77648) 3 years ago
Brian Coca b439e41a91
expand ansible-doc coverage (#74963)
* Expand ansible-doc to tests/filters and fix existing issues

  enable filter/test docs if in single file or companion yaml
  add docs for several filters/tests plugins
  allow .yml companion for docs for other plugins, must be colocated
  verify plugins are valid (not modules, cannot)
  fix 'per collection' filtering
  limit old style deprecation (_ prefix) to builtin/legacy
  start move to pathlib for saner path handling
  moved some funcitons, kept backwards compat shims with deprecation notice

  Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
  Co-authored-by: Felix Fontein <felix@fontein.de>
  Co-authored-by: Sandra McCann <samccann@redhat.com>
3 years ago
Sandra McCann a65fbfad5b
trim down to use sanity test docs requirements file (#77612)
* trim down to use sanity test docs requirements file
* add requirements back
Co-authored-by: Felix Fontein <felix@fontein.de>
* Update docs/docsite/rst/community/documentation_contributions.rst
3 years ago
David Moreau Simard 709ae7c050
docs: Update porting guide for ansible 5.7.0 (#77646) 3 years ago
Felix Fontein 841bdb74eb
Replace antsibull with antsibull-docs (#77504) 3 years ago
Sandra McCann 096393a221
add select distro installs to docs (#77567) 3 years ago
Andrew Klychkov 3cbfee7852
community_steering_committee.rst: add new member (#77589) 3 years ago
Sandra McCann 3b0d74c145
Add contributor path page (#77494)
Co-authored-by: Emmanuel Ugwu <32464178+ugwutotheeshoes@users.noreply.github.com>
3 years ago
Kajsa Gauza 0c1cb0e9d4
Fix a broken link and some grammatical errors (#77531) 3 years ago
Matt Martz 789d29e895
Update docs to recommend the TTY for prompts over stderr (#77533) 3 years ago
Brian Coca 2fc73a9dc3
update python devel docs (#77499)
* update python devel docs

Co-authored-by: Sandra McCann <samccann@redhat.com>
3 years ago
Martin Krizek cbe42bff7f
Allow for lazy evaluation of Jinja2 expressions (#56116) 3 years ago
Will Thames c3a3bc1d0d
Allow strftime to display time in UTC (#70351) 3 years ago
Andrew Klychkov 553a226da5
Steering Committee: add new member (#77529) 3 years ago
David Moreau Simard 0d9a580f24
docs: Add porting guide for Ansible 6.0.0a1 (#77526) 3 years ago
Iheanacho Amarachi Sharon fa7c5d9b10
Update reporting_bugs_and_features.rst (#77518) 3 years ago
Matt Martz 727387ad76
2.14 Roadmap (#77387)
Co-authored-by: Matt Clay <matt@mystile.com>
3 years ago
Emmanuel Ugwu 538a19b748
Update developing_collections_structure.rst (#77496) 3 years ago
Emmanuel Ugwu eef0a1cef9
Update developing_collections_shared.rst (#77497)
##### SUMMARY
Use of the meta/runtime.yml file to specify the ansible-core version for collections


##### ISSUE TYPE
- Docs Pull Request

+label: docsite_pr
3 years ago
Martin Krizek 7126bfc61c
Clarifying how handlers are handled (#77372) 3 years ago
Brian Coca d7d2afd203
avoid recursion in example (#77436) 3 years ago
Travis Michette 6da4186f6e
Update installing_collections_file.rst (#77439) 3 years ago
Sandra McCann e8dbc84afe
Trivial (#77467)
Co-authored-by: Iheanacho Amarachi Sharon  <58210919+Iheanacho-ai@users.noreply.github.com>
3 years ago
David Moreau Simard 36371500b7
docs: Update porting guide for ansible 5.6.0 (#77466) 3 years ago
Sandra McCann 26631de88c
Document how to release a collection (#77391)
Co-authored-by: Divine Odazie <dodazie@gmail.com>
3 years ago
Andrew Klychkov 82c622a26a
community_steering_committee.rst: add chairperson (#77454) 3 years ago
Dr. András Korn ac56647f4a
INI: values with spaces can be single or double quoted (#77369) 3 years ago
Alicia Cozine 21addac5da
Docs cheatsheet - skeleton and ansible-playbook (#76655) 3 years ago
bluikko 6557a60d08
Most Matrix channels are ansible.com and not .im (#77352) 3 years ago
Christian Adamini e918cfa588
Fix list formatting (#77354) 3 years ago
rwhector bf8e186c68
Example is a single play, not a playbook 3 years ago
Sandra McCann 8caa6efaab
add links.yml to collection structure docs (#77415)
* add links.yml to collection structure docs
* fix link
* Update docs/docsite/rst/dev_guide/developing_collections_structure.rst
3 years ago
Martin Krizek 6d260ad967
Remove COMMAND_WARNINGS and warn (#77411)
* Remove COMMAND_WARNINGS and warn

Fixes #77394
3 years ago
Matt Clay 50d4cf931c
Start of 2.14 development cycle. (#77378)
* Delete old changelog fragments.
* Add 2.14 changelog stub.
* Add porting guide.
* Update version and codename.
* Add temporary deprecated version ignores.
3 years ago
Felix Fontein 7075fa36a1
Bump requirements for antsibull to 0.42.0 (which depends on antsibull-changelog >= 0.14.0). (#77362) 3 years ago
Matt Clay 3e491db466
Porting guide fixes. (#77376)
* Update porting guide generation.
* Fix 2.13 porting guide link.
3 years ago
Sandra McCann f03624e295
clarify how to customize ansible cli output (#77357) 3 years ago
Sandra McCann 2e69b5867e
Creat steering committee docs (#77330)
Co-authored-by: Aine Riordan <44700011+ariordan-redhat@users.noreply.github.com>
3 years ago
bluikko 27aa2612d9
Add what to look for in PyYAML documentation (#77323)
Co-authored-by: Martin Krizek <martin.krizek@gmail.com>
3 years ago
Christian Adamini fa12af9042
Revision: "Address Docs: How to report bugs" #53520 (#77269) 3 years ago
bluikko ffda8ccbbd
Incorrect parent role paths var description (#77342) 3 years ago
David Auer 0a5b2e88f3
Fix quotes (#77346) 3 years ago
Sloane Hertel f96a661ada
ansible-galaxy - add configuration options for more flexible collection signature verification (#77026)
* Add a toggle to control the number of signatures required to verify the authenticity of a collection

* Make the default number of required valid signatures 1

* Add option to make signature verification strict and fail if there are no valid signatures (e.g. "+1")

* Use a regex to validate --required-valid-signature-count

* Add a toggle to limit the gpg status codes that are considered a failure

* Update documentation and changelog

* Add unit and integration tests for the new options

* Fixes #77146

Fix using user-provided signatures when running 'ansible-galaxy collection verify ns.coll --offline'

Add a test for a user-provided signature when running ansible-galaxy collection verify with --offline

Fix displaying overall gpg failure without extra verbosity

Add a test for displaying gpg failure without verbosity

Improve documentation to be more clear that signature verification only currently applies to collections directly sourced from Galaxy servers
3 years ago
Sandra McCann 21827522dc
Add quickstart testing docs for collections (#77290)
Co-authored-by: Divine Odazie <dodazie@gmail.com>
Co-authored-by: Emmanuel Ugwu <32464178+ugwutotheeshoes@users.noreply.github.com>
3 years ago
Matt Martz 82e5f368e1
Reduce intro install to just pip (#77178) 3 years ago
Stef B 8a86fa602d
Simplify documentation for search paths (#73818) 3 years ago
Tommaso Macchioni 14098d9b04
typo variable reference (#77327) 3 years ago
Ganesh Nalawade 68b5db328f
Update ansible extension information (#77235)
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
ee-github c555ce1bd9
Update intro_patterns.rst (#77300)
Describe difference between targeting a single host using -i vs. --limit.  In particular, pointing out the behavior difference that -i will not rad inventory variables.
3 years ago
David Moreau Simard d8687bd015
docs: Update porting guide for Ansible 5.5.0 (#77287) 3 years ago
Sandra McCann dfda04894f
stub out ipaddr page and point to new home (#77281) 3 years ago
Christian Adamini 6546c484f4
Address Docs: How to report bugs #53520 (#77214) 3 years ago
Jasmine Hegman 1a923e307e
After 2.10 Collections can use vars plugins (#77216) 3 years ago
Jasmine Hegman b60a5eefb2
Include links to the modern homes of the windows modules (#77220) 3 years ago
Ganesh B. Nalawade 3c72aa32d6 Add ansible devtools working group in community communication 3 years ago
lumean 1ba3ead0a0
Update developing_modules_general_aci.rst (#73925) 3 years ago
Matt Clay 3d5637beec Initial mypy sanity test support for core. 3 years ago
Divine Odazie 50d28de9ba
Make ansible_index.rst more readable (#77225) 3 years ago
Sandra McCann 7d234a40ee
Point to AH docs (#77200) 3 years ago
Matt Martz 7b0fb114be
Data tagging and sidecar docs are delayed, and will be retargeted for 2.14 (#77173) 3 years ago
Sandra McCann 8291dbdf81
add accessibility guidelines to docs style guide (#77145)
Co-authored-by: Jill R <4121322+jillr@users.noreply.github.com>
3 years ago
Martin Nečas 0d4219f265
Fix IPs for ipaddr filter in user_guide (#77151)
* Fix IPs for ipaddr filter in user_guide

* Apply suggestions from code review

Co-authored-by: Sandra McCann <samccann@redhat.com>
3 years ago
Sloane Hertel c3999d89f4
Clarify docs for using tests as filters (#77155) 3 years ago
Andrew Klychkov 68601601ce
Docsite: update communication.rst (#77135)
\
3 years ago
Sandra McCann 22ba18d7b0
add links to remote_user docs (#77140)
* add links to remote_user docs
* shorten link name
3 years ago
Sandra McCann 6a7009a84f
use present tense in changelog example (#77138) 3 years ago
Sandra McCann 5f258d2c64
move collection pr quickstart over (#77087)
* move collection pr quickstart over
* add link
* fix CI
* fix formatting
3 years ago
Aine Riordan 71dfe32ab6
76134 DOCS:Uninstall all packages before Ubuntu reinstall (#77137) 3 years ago
Matt Clay 3f0d5bc351 Fix LooseVersion and StrictVersion refs in docs. 3 years ago
Sandra McCann 30d1a93d93
update changelog fragment guidance with examples (#77040)
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
3 years ago
David Moreau Simard 36121aeee7
docs: Update porting guide for ansible 5.4.0 (#77107) 3 years ago
Matt Clay 0f41682473 Remove use of distutils in docs Makefile.
The current usage only works if `python` is Python 2.x since the syntax is invalid on Python 3.x.

When running on Python 3.x it would either be missing, or if Python 2.x was also present, incorrect.
3 years ago
Sandra McCann b2bafc054e
remove list of container images (#77089)
* remove list of container images
* remove some more centos8
3 years ago
Sandra McCann 901e3d43b1
describe how to generate a sample ansible.cfg (#77053)
* describe how to generate a sample ansible.cfg
* correct commands used
3 years ago
Brian Coca 84b85a5b5a
more explicit moustache docs (#77051) 3 years ago
Sandra McCann e620b96f49
Create collection maintainer's guide (#76976)
* initial merge of maintainer guide
* Apply suggestions from code review

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
Sandra McCann af7c9deb4e
add crosslinks for changelog fragments (#77022) 3 years ago
fbourqui 1480503326
Update complex_data_manipulation example uptime in days/h/m/s (#77019) 3 years ago
Preston Carman f82b1ba67c
Update indentation for example in playbooks_handlers.rst (#75348) 3 years ago
Sandra McCann 32f7490a2c
Add note to serial docs (#77006)
* add note to serial docs
* add keyword directly
Fixes #76820
(cherry picked from commit de20f1bae8)
3 years ago
zasca 8939f4d2f7
add tasks (#75489) 3 years ago
Sloane Hertel 43e55db208
ansible-galaxy - add signature verification of the MANIFEST.json (#76681)
* ansible-galaxy collection install|verify:

  - Support verifying the origin of the MANIFEST.json when the Galaxy server has provided signatures.
  - Allow supplemental signatures to use during verification on the CLI/requirements file.

* ansible-galaxy collection install:

  - Support disabling signature verification. This silences the warning provided by ansible-galaxy if the Galaxy server provided signatures it cannot use because no keyring is configured.
  - Store Galaxy server metadata alongside installed collections for provenance. This is used by 'ansible-galaxy collection verify --offline'.

* Add unit tests for method that gets signatures from a Galaxy server

* Add integration tests for user-provided signature sources

- Test CLI option combinations
- Test installing collections with valid/invalid signature sources
- Test disabling GPG verification when installing collections
- Test verifying collections with valid/invalid signature sources

* Make signature verification advisory-by-default if signatures are provided by the Galaxy server

- Make the default keyring None
- Warn if the keyring is None but the Galaxy server provided signatures
- Error if the keyring is None but the user supplied signatures
- Error if the keyring is not None but is invalid

* changelog

* add ansible-galaxy user documentation for new options

Co-authored-by: Matt Martz <matt@sivel.net>
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Martin Krizek <martin.krizek@gmail.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
Co-authored-by: Andy Mott <amott@redhat.com>
Co-authored-by: John R Barker <john@johnrbarker.com>
3 years ago
IronTooch 65987e86a9
Added package reference for Debian to resolve error (#76876) 3 years ago
Vladimir Botka 5448661aec
Update 'Ansible and BSD' section 'Setting the Python interpreter'. (#76825) 3 years ago
Abhijeet Kasurde a1af1d94cd
vmware: Migrate VMware Scenario Guides (#76640)
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
ChunPanYung 0ca19a5b73
Update windows_winrm.rst (#76835)
Co-authored-by: Jordan Borean <jborean93@gmail.com>
3 years ago
Vladimir Botka 9a9ef01997
Update 'Installing Ansible on FreeBSD'. (#76849)
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
Co-authored-by: Sandra McCann <samccann@redhat.com>
3 years ago
Matt Martz 3108c51764
Add note about installing python on macOS (#76873) 3 years ago
Daniel Goldman e1cf6af06d
add `undef()` keyword to core 2.12 porting guide (#76880) 3 years ago
David Moreau Simard 10fd7bf12c
docs: update porting guide for Ansible 5.3.0 (#76917) 3 years ago
Felix Fontein 1f4e50f178
Ansible 6 roadmap: simplify collection inclusion process (#76932)
Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
3 years ago
Matt Clay 2767a4cf4a
docs - remove broken link in ACI scenario guide (#76940) 3 years ago
Felix Fontein bc1e29d722
Bump antsibull version from 0.40.1 to 0.41.0 and ansible sphinx theme version to fix HTML generation in return value tables (#76759)
* Use Jinja2 comment instead of HTML comment to avoid W3C validator warning (-- inside comment).

(For those interested in the history of this: http://www.howtocreate.co.uk/SGMLComments.html#doubledash)
3 years ago
Stephen Lawrence 2bd074b486
doc: fix Jinja2 doc link templating playbook (#76889)
Signed-off-by: Stephen Lawrence <stephen.lawrence@renesas.com>
3 years ago
Joe Zollo bc5672d9ba
Update developing_modules_general_windows.rst (#76846) 3 years ago
Sandra McCann a5283d67ee
add quoted examples (#76858) 3 years ago
Felix Fontein ebea751805
Roadmap for Ansible 6 (#76772)
Co-authored-by: John R Barker <john@johnrbarker.com
3 years ago
Sandra McCann e9af4195be
update ansible.legacy docs (#76839)
* update ansible.legacy docs

* correct role description

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

* Update docs/docsite/rst/dev_guide/developing_locally.rst
3 years ago
Syed Ali Haider 6bca0a5dc2
docs: add fqcn to module examples (#73546)
Co-authored-by: Felix Fontein <felix@fontein.de>
3 years ago
Tong He ddc4b1716b
Mention ansible-core 2.11 RPM package in Ansible Core Installation Guide (#76801) 3 years ago
Sandra McCann 61bd779335
add core roadmaps to ansible docs (#76818)
* add core roadmaps to ansible docs
* make older roadmaps also show up
3 years ago
Sandra McCann 5a69023941
remove ansibot from collection docs (#76817)
* remove ansibot from collection docs
* Update docs/docsite/rst/community/collection_development_process.rst
Co-authored-by: Felix Fontein <felix@fontein.de>
3 years ago
Sandra McCann cfe4bdc1b9
Create separate core vs collection contributor guides (#76764)
* updated core guides
* ansible package docs guides
* add core guide to Ansible docs
* Update docs/docsite/rst/community/maintainers.rst
3 years ago
David Moreau Simard e33e7233d0
docs: Update porting guide for ansible 5.2.0 (#76746) 3 years ago
Sandra McCann 665e3dc629
remove outdated note on limitations of R() in module docs (#76736) 3 years ago
Mario Lenz 01ba6d4a45
Fix C&P error (#76673) 3 years ago
Felix Fontein c53e6d94e9
Use antsibull 0.40.1 for docsite build (#76675) 3 years ago
Or Bin a1d0e60703
Fixed documentation: "[a] ini file" -> "an ini file" (#76627) 3 years ago
darran-c fdf12542b2
Fix typo in task name (#76642) 3 years ago
Or Bin aa4f23dc97
Fixed documentation: "do not needed -> do not need" (#76617) 3 years ago
David Moreau Simard e2d1dbbdc5
Docs: update porting guide for ansible 5.1.0 (#76595) 3 years ago
Alicia Cozine 67e5649a26
Adds documentation about when/why to use roles (#76560)
Co-authored-by: Brian Scholer <1260690+briantist@users.noreply.github.com>
3 years ago
Jordan Borean 4c738b08b4
Add docs on Windows module util requirements (#76583) 3 years ago
Matt Martz 8a4090f749
Do not format the choice as a definition list for non-mapping values (#76568) 3 years ago
Jordan Borean 7dd22b8b4b
Update Windows host requirements (#76582) 3 years ago
Simon Monai 5db1d11c19
Replace "Encrypt" with "Hash" for prompt documentation (#76584)
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
3 years ago
Jon "The Nice Guy" Spriggs 47e2a26959
Update playbook_tests with type testing (#72732) 3 years ago
Abhijeet Kasurde 601d66c7e5
k8s: Migrated scenario guides to collection (#75249)
Kubernetes scenario guides are moved to
``kubernetes.core`` collection.

Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
3 years ago
Jacob McGill ee777567bc
Update intro_inventory.rst (#76340) 3 years ago
Kian Meng, Ang e5967c02f5
Fix typos in docs (#76526) 3 years ago
David Moreau Simard 6ee58056da
docs: Update porting guide for ansible 4.10.0 (#76559) 3 years ago
Sloane Hertel 146a4bcd0d
Fix docs for installing from a git repo (#76350) 3 years ago
Dan Kolepp 9dac51f25a
Update special_variables.rst (#76360) 3 years ago
Benoît Geeraerts 8a562ea14a
Resolves #76449 Misplaced added version info (#76539)
`.. versionadded::` are coming right after the section tittle, and was misplaced here
3 years ago
Edward Hilgendorf d0de3d3dc2
change keyword return to results (#76515)
value is getting associated to python keyword return
3 years ago
Sandra McCann 0cec4d1cfc
remove aws from the azure note (#76518) 3 years ago
Sandra McCann 0df60f3b61
per marketing request - add note for AAP on Azure availability (#76512) 3 years ago
Sandra McCann bccfb83e00
add intersphinx mapping for Ansible 5 (#76470)
* add intersphinx mapping for Ansible 5

* add the other files
3 years ago
Andrew Klychkov 60d094db73
Docsite/dev_guide: add note about ansible-test utility installation ways (#76128)
* Docsite/dev_guide: add note about ansible-test utility installation
* Add link to Testing Ansible page
3 years ago
Martin Krizek 3fe42e106c
Remove finalize from globals (#76439) 3 years ago
Sviatoslav Sydorenko 82ff7efa94
Fix how/what+look/like grammar in dev process doc (#76410) 3 years ago
Sloane Hertel 5b2334983c
Fix more 'playbook'/'play' conflation (#76387) 3 years ago
David Moreau Simard bf1e1d286d
docs: Update porting guide for Ansible 5.0.1 (#76444) 3 years ago
David Moreau Simard 1d1597ffd9
Docs: Update porting guide for Ansible 5.0.0 (#76404) 3 years ago
Sandra McCann 862a2a3599
set latest Ansible version to 5 (#76304) 3 years ago
Sandra McCann a1205d52ce
update release and maintenance for Ansible 5 (#76301) 3 years ago
David Moreau Simard b9b69c1135
Docs: Update porting guide for ansible 4.9.0 (#76363) 3 years ago
David Moreau Simard 0afc0b8506
Add a link to the Ansible 5.x changelog (#76352)
The 5.x changelog is available, add a link to it.
3 years ago
nemobis 0360728b7f
Fix typo in docs for "globbing" (#76324)
Constent with the rest of the documentation including fileglob.
3 years ago
Sandra McCann c379e61b8b
Update docs build requirements to most recent versions of dependencies (#76283)
* align requirements files to more recent versions

* bump up to latest antsibull

* update sphinx in rstcheck requirements

* update to dependency versions that sphinx 4.2 pulls in

* use same no-cap spelling
3 years ago
Matt Martz 04698b0c41
Add porting guide entry for fetch_url change in behavior (#76314) 3 years ago
Matt Clay bb63c97c16
ansible-test - Update import test and sanity requirements. (#76308)
* Add script to freeze sanity requirements.
* Declare sanity test requirements and freeze
* Use pinned requirements for import.plugin test.
* Expand scope of import test for ansible-core.
* Add ignores for galaxy import errors.
* Update test-constraints sanity test.
3 years ago
David Moreau Simard d0ec236d4a
Update porting guide for Ansible 5.0.0b2 (#76303) 3 years ago
azrdev fd4460c1e4
docs/best_practices: all contained vault passwords required when using inventory (#75976) 3 years ago
Felix Fontein a734da5e82
Restore documentation on M() and R() (#76284)
* Undo most of bf9944266c, add note on where R() does not work.
Co-authored-by: Brian Scholer <1260690+briantist@users.noreply.github.com>
3 years ago
Felix Fontein fe77bc9e3c
Validate some markup in documentation in validate-modules (#76262)
* Validate some markup in documentation.

* Add changelog fragment.

* Use urlparse instead of URL regex.

* Document new error code.

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
3 years ago
Aine Riordan 90de24da7b
Docs: Link to valid data types for role parameters (#76276) 3 years ago
Daniel Goldman be2bd2f1af
Documentation for other types in collection `requirements.yml` (#75872) 3 years ago
David Moreau Simard 55dc75b8c8
Update porting guide for Ansible 5.0.0b1 (#76263) 3 years ago
Sandra McCann 22eb4a9ce0
Remove edit on github from collection pages (#76259)
* remove main index page from Edit on Github
* remove all collection index pages from Edit on Github
3 years ago
Mark Chappell f6ec773e6e
Update porting guide Python 2.7+ wording. (#76258) 3 years ago
Sandra McCann b16d5ff7a7
set 2.12 to latest (#76191)
* set 2.12 to latest
* add 2.10 back
3 years ago
Sandra McCann d0c1e5a46d
Update release/maint page for 2.12 release (#76205)
* make changelogs more visible and fix a broken link

* add 2.12 changelogs

* add eol column
3 years ago
Felix Fontein a861cb5607
ansible-core 2.12 dropped support for galaxy.yaml. (#76179) 3 years ago
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