Brian Coca
13ea312cc8
added pb fqcn docs ( #72602 )
...
* added pb fqcn docs
4 years ago
Martijn Suijlen
aa21804165
Added TLS security protocol for Powershell downloads ( #73226 )
...
##### SUMMARY
Added `[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12` to the Powershell scripts that use a file download. If not specified the script won't be allowed to download data from the mentioned URL's.
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
4 years ago
Adam Miller
e9a1ff296e
Fix block example line emphasis ( #73238 )
...
Signed-off-by: Adam Miller <admiller@redhat.com>
4 years ago
Gregor Riepl
403a3b90b5
Fix list to dict example ( #73213 )
...
##### SUMMARY
<!--- Your description here -->
single_list must be transformed to a list of pairs before feeding it into dict()
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
4 years ago
Sascha Marcel Schmidt
61f0d6b919
add note regarding datetime docs ( #72976 )
...
Adds a note pointing to the datetime documentation as to_datetime does not use the time library but instead uses datetime.
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
4 years ago
Tim Herty
995e76c6e3
Update windows_winrm.rst ( #73101 )
...
The standard Port for ansible winrm is set to 5986/HTTPS.
To be able to use Kerberos, you need to set ansible_port: 5985/HTTP otherwiese you get error message or timeout.
HTTPS is not needed for environments with Kerberos, since kerberos has server identification built in to the protocoll.
FYI: HTTP traffic will by default also be encrypted when using kerberos
4 years ago
Jean-Pierre Matsumoto
3074ede8a3
ExecutionPolicy default value is RemoteSigned ( #72993 )
...
* ExecutionPolicy default value is RemoteSigned
##### SUMMARY
In Windows setup steps, settings `ExecutionPolicy` is restored to value `Restricted`. But actually default value for Windows server is not `Restricted` but `RemoteSigned` ([source](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.1#default )).
I have got issue with `win_dsc` because `ExecutionPolicy` was `Restricted`.
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
* Add changelog fragment
* Apply suggestions from code review
Co-authored-by: Sandra McCann <samccann@redhat.com>
4 years ago
Dmitry
79ab1247b8
Fixed vault id in variable encryption example ( #72626 )
4 years ago
Sam Doooran
103decccac
Add complex example of fileglob with loop ( #72396 )
...
* Add complex example of fileglob with loop
* Explain Python unpacking notation
* Add missing paren
4 years ago
Matt Martz
97765f4ebd
Role duplicates docs updates ( #72666 )
...
* Change example to use role params to represent the documented outcome. Fixes #68922
* Add notes about how vars vs role params affect variable scoping, and how lazy evaluation and role-deduplicating is affected. Fixes #72650
* link to term
4 years ago
Sam Doooran
8fdb5ace01
Update WSL docs to mention sleep workaround ( #72839 )
...
Co-authored-by: Joseph Chambers <joe.chambers@lexisnexis.com>
4 years ago
flowerysong
8450858651
Remove inaccurate Vault documentation ( #72938 )
...
This is not functionality that exists.
4 years ago
Alicia Cozine
e5ccd18be4
Wording changes to docs ( #70082 )
4 years ago
devon-mar
e97f333532
Add missing endfor to vlan_parser example ( #72872 )
4 years ago
Abhijeet Kasurde
38f21557ba
json_query: Add examples for starts_with and contains ( #72821 )
...
* Add a note about - data structure returned from register variables
needs to be parsed using ``to_json | from_json`` in order to
get correct result.
* Add examples for starts_with and contains
Fixes: https://github.com/ansible-collections/community.general/issues/320
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
Andrew Klychkov
2aa3531b1b
Docsite: update complex_data_manipulation and playbooks_advanced_syntax rst files to use FQCNs ( #72539 )
4 years ago
Simon Heimberg
79fb065d16
document that handler can not run include_role and import_role ( #72744 )
...
Warn the users until issue #20493 is fixed.
4 years ago
gfyoung
fa481e3316
Fix missing dashes in playbooks intro doc ( #72746 )
4 years ago
Pablo Martinez
454ac6420e
Update playbooks_filters_ipaddr.rst ( #72705 )
...
Fix the order of the arguments for ansible.netcommon.reduce_on_network. Pass the network as the argument and the list of IP addresses as the filter input.
4 years ago
gdiamond
74196577a3
added sample output for echo example ( #72718 )
4 years ago
gdiamond
35022e13a8
Update intro_getting_started.rst ( #72689 )
...
Move the command output to immediately follow the example.
4 years ago
Brian Coca
452bc3af04
example of exponential backup ( #72617 )
4 years ago
Andrew Klychkov
dbe43e071e
Docsite: update user_guide/playbooks_module_defaults ( #72051 )
...
* Docsite: update user_guide/playbooks_module_defaults, add name: lines and use FQCN consistently
4 years ago
Josh
1a5d2938c6
Update playbooks_filters_ipaddr.rst ( #72464 )
...
Fix small code formatting issue - remove extra `:` before code-block.
4 years ago
Kohei Takahashi
2e4038f4d2
Fixed a typo in user_guide/playbooks_conditinals ( #72427 )
...
+label: docsite_pr
4 years ago
Daniel Tavernier
dd19c9f737
Update playbooks_tags.rst ( #72351 )
...
##### SUMMARY
Corrected the "Adding tags to blocks" example syntax.
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
4 years ago
Jaime Hablutzel
afba5c2852
Miscellaneous fixes in user_guide/intro_inventory.rst docs ( #72202 )
...
* Fixing missing hosts entry under the group dict.
* Added missing 'vars:' key
* Reordering arguments for consistency with the format displayed by "ansible-playbook --help"
* Fixing contradictory text
4 years ago
Ronald Eddy Jr
d18901dd4a
Update HTTP -> HTTPS ( #72244 )
...
Co-authored-by: Ronald Eddy Jr <ron@Ronalds-MacBook-Pro.local>
4 years ago
Justin Otherguy
8465f285cc
Update playbooks_strategies.rst ( #72176 )
...
beside the fact that naming the variable to specify the number of machines executed in *parallel* is named *serial* - the number of hosts chosen in this example is not optimal, either: 2x2 = 4; so - 3 hosts in 2 batches should clear things up a little
4 years ago
Ken Celenza
b18e462bbb
Consistent Taxonomy ( #72215 )
...
Historically "these" have been called directives, attributes, and keywords. We've now settled on `keyword` (https://docs.ansible.com/ansible/latest/reference_appendices/playbooks_keywords.html ). Update all documentation to reflect this term.
4 years ago
Sandra McCann
7c1dd1c7fb
add link to jinja docs from templating section ( #72205 )
4 years ago
Andrew Klychkov
30a651bca3
Docsite: update user_guide/playbooks_async ( #72115 )
4 years ago
Jens Heinrich
835752cc53
Update playbooks_vars_facts.rst ( #72150 )
...
Remove misleading typo, add a note on the mode of local facts
Co-authored-by: JensHeinrich <github.com/JensHeinrich>
4 years ago
Evan Van Dam
3db08adbb1
Add optional attribute arg for min and max filters ( #50909 )
...
* Pass **kwargs to min and max filters
* Use the jinja2 filters if available
* Add unit tests
* Add examples to docs passing attribute
4 years ago
Erik Zettel
2b79cd2c0f
Fix typos ( #72072 )
4 years ago
Andrew Klychkov
3efc8b6de8
Docsite: update user_guide/playbooks_prompts ( #72049 )
4 years ago
Andrew Klychkov
c12fce3aa9
Docsite: update user_guide/playbooks_checkmode ( #72052 )
4 years ago
Andrew Klychkov
77840f886e
Docsite: update user_guide/playbooks_debugger ( #72053 )
4 years ago
Abhijit Menon-Sen
64d9ccb965
Reword strangely patronising introduction to loops ( #72019 )
4 years ago
Jorge Vallecillo
94522b7c10
Fix typos ( #71970 )
4 years ago
Andrew Klychkov
74be7de361
Docsite: improve user_guide/playbooks_vars_facts ( #71973 )
...
* Docsite: improve user_guide/playbooks_vars_facts
4 years ago
Andrew Klychkov
8ae3998ecf
Docsite: update user_guide/vault ( #71975 )
4 years ago
Andrew Klychkov
0645436acd
Docsite: update user_guide/playbooks_filters ( #71980 )
4 years ago
Alicia Cozine
eed606e0e9
adds name lines to handler re-use examples ( #71946 )
...
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
4 years ago
Andrew Klychkov
c19af92be6
Docsite: improve user_guide/playbooks_variables ( #71938 )
...
* Docsite: improve user_guide/playbooks_variables
4 years ago
Andrew Klychkov
2fed63a930
Docsite: improve inventory-related pages ( #71907 )
...
* Update docs/docsite/rst/plugins/inventory.rst
4 years ago
Badhreesh
a47eafa581
Update playbooks_reuse_roles.rst ( #71880 )
...
Change "vars_files" to "vars, files" under the Roles heading
4 years ago
Andrew Klychkov
25bfda8417
Docsite: improve user_guide/intro_inventory ( #71859 )
4 years ago
Andrew Klychkov
c3841b8440
Docsite: improve user_guide/playbooks_tags ( #71858 )
4 years ago
Andrew Klychkov
7a0a2f188b
Docsite: improve user_guide/playbooks_reuse_roles ( #71857 )
...
* Docsite: improve user_guide/playbooks_reuse_roles
* fix
4 years ago
Baptiste Mille-Mathias
401be27053
Add example values and results for theory filters ( #71908 )
...
Add example values and results for theory filters
4 years ago
Andrew Klychkov
ed6fb2e3f6
Docsite: improve user_guide/intro_adhoc ( #71909 )
4 years ago
Sandra McCann
d6063b7457
clarify FQCN use for playbooks ( #71816 )
...
* clarify FQCN use
* Apply suggestions from code review
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
4 years ago
brnl
5b27b307b9
Update intro_getting_started.rst ( #71851 )
...
Fixed the formatting on the remote user name override list.
4 years ago
Sandra McCann
bcfead8e0f
change duplicated label
4 years ago
Andrew Klychkov
3db4be2c3b
Docsite: improve user_guide/playbooks_reuse ( #71834 )
4 years ago
Andrew Klychkov
05a45f63ff
Docsite: misc fixes of playbooks_delegation ( #71753 )
4 years ago
Andrew Klychkov
aa1f0bd062
Docsite: fix playbooks_conditionals ( #71754 )
4 years ago
Andrew Klychkov
79dc6fa948
Docsite: fix user_guide/playbooks_blocks ( #71769 )
4 years ago
Andrew Klychkov
1cf42897d2
Docsite: fix user_guide/playbooks_handlers ( #71770 )
4 years ago
Andrew Klychkov
2c6661d4c1
Docsite: fix user_guide/playbooks_error_handling ( #71771 )
4 years ago
Andrew Klychkov
a204f5f955
Docsite: fix user_guide/playbooks_environment ( #71772 )
4 years ago
Evaristo Rojas
00ed5b1f2e
Fix broken bullet list ( #71728 )
4 years ago
Andrew Klychkov
13ab9f5932
Docsite: improve playbooks_loops.rst ( #71718 )
4 years ago
Andrew Klychkov
5511c898cc
Docsite: fix a typo in user_guide/index.rst ( #71717 )
4 years ago
Alicia Cozine
b430f9b9aa
Adds FAQ and other pointers for collections ( #71606 )
4 years ago
esmersmith
a34043c6be
Changed all_modules references to list_of_collections in the documentation ( #71656 )
4 years ago
Matt Martz
61f6aa55b6
Add semver support to the jinja2 version test ( #71600 )
4 years ago
Sandra McCann
2f240f5dd7
Add note on where inventory scripts moved to' ( #71638 )
4 years ago
Andrew Klychkov
7bfeed3e24
Docsite: replace Latin phrases to English ( #71588 )
...
Replace Latin phrases like "e.g." and "i.e." and "etc." with English phrases.
* Update docs/docsite/rst/community/committer_guidelines.rst
* Update docs/docsite/rst/dev_guide/developing_modules_documenting.rst
* Update docs/docsite/rst/dev_guide/developing_program_flow_modules.rst
* Update docs/docsite/rst/dev_guide/module_lifecycle.rst
* Update docs/docsite/rst/user_guide/intro_inventory.rst
* Update docs/docsite/rst/user_guide/playbooks_loops.rst
* Update docs/docsite/rst/user_guide/playbooks_reuse.rst
* Update docs/docsite/rst/dev_guide/platforms/aws_guidelines.rst
* Update docs/docsite/rst/dev_guide/testing.rst
* Update docs/docsite/rst/dev_guide/testing_integration.rst
* Update docs/docsite/rst/porting_guides/porting_guide_2.5.rst
* Update docs/docsite/rst/reference_appendices/faq.rst
4 years ago
Alicia Cozine
96aee766f4
More docs updates to reflect collections ecosystem ( #71597 )
4 years ago
Alicia Cozine
b694dbadfe
User guide overhaul, Table of Contents ( #71553 )
4 years ago
Matt Deacalion
ec3920cef1
Update intro_patterns.rst ( #71542 )
...
Call out the trailing comma when specifying a single host. Small snag that took me a while to notice.
4 years ago
Abhijeet Kasurde
0b16c0a8c7
user_guide: Fix reuse role examples ( #71440 )
...
Fixes : #53919
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
Abhijeet Kasurde
5c1594916a
user_guide: Add an example for loop ( #71441 )
...
Explain how to use complex data in loop while converting
from with_together
Fixes : #47906
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
John Westcott IV
a6537b59ab
Modify wording to specify two ctl-d to end stdin input in ansible-vault ( #69436 )
...
* 51860 - Modify wording to specify two ctl-d to end stdin input in ansible-vault
* removes space to make line 160 chars
4 years ago
Patrick Reader
2b7461eb52
fix broken links due to master -> main branch rename ( #71426 )
4 years ago
flowerysong
66e38bf499
docs: Remove examples using the `ec2.py` script ( #69107 )
...
This script is mostly unmaintained and relies on the deprecated and
unmaintained `boto` library. Featuring it prominently in the docs
leads to many new users using it instead of the supported `aws_ec2`
inventory plugin.
4 years ago
Sandra McCann
6c48c62f93
document securing editor for vault ( #71404 )
4 years ago
Eric G
13ab73cd89
Docs: ansible_host can contain FQDN ( #71186 )
4 years ago
David M. Lee
3e4377300b
Explain duplicate checks includes tags and when ( #68183 )
...
##### SUMMARY
Per #67913 , when comparing dependencies, Ansible takes into account parameters, tags and the when clause in determining whether a role is a duplicate or not.
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
4 years ago
Alicia Cozine
5073cfc8bc
incorporate minimalism feedback on debugging page ( #71272 )
...
Co-authored-by: bobjohnsrh <50667510+bobjohnsrh@users.noreply.github.com>
4 years ago
Alicia Cozine
02ea80f6d7
tidies up vars page ( #71339 )
4 years ago
Sayee
4d68efbe24
Writing style updates to Using Variables topic ( #71194 )
...
* updated topic title, underline length for headings, and incorporated peer feedback
4 years ago
Abhijeet Kasurde
ecea018506
Fix 404 links ( #71256 )
...
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
Sayee
4f0bd5de38
a few writing style updates ( #71212 )
4 years ago
Andrew Klychkov
19589db10c
Fix references to Ansible Collections Overview ( #71227 )
4 years ago
Abhijeet Kasurde
0a7ab396c7
filters: minor doc fix ( #71178 )
...
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
Brian Coca
f46b124d65
start of 'data manipulation' examples ( #46979 )
...
Co-authored-by: Klaus Frank <agowa338@users.noreply.github.com>
Co-authored-by: Felix Fontein <felix@fontein.de>
Co-authored-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
kshitijcode
5f8b45a70e
Updating Getting Started with Resources section #68962 ( #71102 )
...
* Updating Getting Started with Resources section #68962
* Add links, including Workshops URL #68962
4 years ago
Liviu Chircu
cb9336ab6d
Docs: Fix typo ( #71119 )
...
Fix typo
4 years ago
Rick Elrod
0d7c144ce4
Allow macOS ACLs to work for unpriv -> unpriv ( #70785 )
...
Change:
- Use `chmod +a` in the fallback chain to allow MacOS to use ACLs to
allow an unprivileged user to become an unprivileged user.
Test Plan:
- CI, new tests
Tickets:
- Fixes #70648
Signed-off-by: Rick Elrod <rick@elrod.me>
4 years ago
Abhijeet Kasurde
a6725d6e2a
docs: Add a note about package requirements for fact gathering ( #70796 )
...
Fixes : #26148
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
4 years ago
Brendon O'Sullivan
9850915bd6
Update intro_getting_started.rst ( #71039 )
...
Added two additional learning resources in the See also: section- forgot closing backticks
4 years ago
Rick Elrod
701c638757
Document string tests a bit more ( #71049 )
...
- Explain how `regex` differs from `match` and `search`.
- Document `multiline` and `ignorecase`.
Signed-off-by: Rick Elrod <rick@elrod.me>
4 years ago
Baptiste Mille-Mathias
8c48366f1c
Document to_json will convert to ASCII strings by default ( #70954 )
...
... as reported in issue #68702
4 years ago
Emilien Macchi
37e9d2278a
Fix a typo in "restart mysql" example ( #70950 )
...
Fix a typo in "restart mysql" example task. It's missing a space between "state:" and "restarted".
4 years ago
Fixmetal
7a42d27462
Proper example for splitext filter in docs ( #70494 )
...
* Update playbooks_filters.rst with a clear example of how to extract its 2 tokens.
Co-authored-by: Sloane Hertel <shertel@redhat.com>
4 years ago
Sandra McCann
24e5d3a51c
fix rstcheck problem and gitignore collections dir ( #70764 )
4 years ago
David Rieger
633c2d0522
Fix misleading documentation for naming blocks ( #68458 )
...
From what I have observed it is the block itself that doesn't support the name attribute rather than the tasks inside the block.
* Update docs/docsite/rst/user_guide/playbooks_blocks.rst
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
4 years ago