ml
c9c84594d8
Docs: Fix k8s_config_resource_name YAML example ( #74129 )
...
The `name` key should be beneath `metadata`:
4 years ago
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>
4 years ago
yuri
5f391a72ee
Update playbooks_filters.rst ( #74242 )
...
##### SUMMARY
Make the `random` filter description more clear.
4 years ago
Baptiste Mille-Mathias
99a2b5f300
Provide results to examples ( #73984 )
4 years ago
Brian Coca
7b39ee361d
corrected epmhasis line ( #74254 )
...
need to be careful when adding lines as you create a different offset
4 years ago
Brian Coca
270f109bb3
fix see_also formatting ( #74252 )
4 years ago
Matthew Cengia
c7473828c7
Docs: Remove duplicate word ( #74223 )
...
The word "to" was erroneously used twice consecutively.
Signed-off-by: Matthew Cengia <mattcen@mattcen.com>
4 years ago
Alicia Cozine
05662fd2ab
Docs: clarify role docs - vars vs params, dependencies ( #74104 )
4 years ago
Baptiste Mille-Mathias
6b33864a2c
Clarify tags on tasks are applied with OR and not AND ( #74038 )
...
Co-authored-by: flowerysong <junk+github@flowerysong.com>
4 years ago
Felix Fontein
af7f3fc266
Revert "Add duplicated set filter and documentation ( #72729 )" ( #74053 )
...
This reverts commit 99a6627c60
.
* ci_complete
4 years ago
Baptiste Mille-Mathias
99a6627c60
Add duplicated set filter and documentation ( #72729 )
...
Co-authored-by: Kerry <kerry@flatline-studios.com>
4 years ago
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
4 years ago
saruter
73c08df2db
Docs: Add filter "urlencode" with example ( #74034 )
...
* Add example for URLENCODE filter
4 years ago
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>
4 years ago
Brian Coca
ccd9a992cf
complex data example using value and default from list of dicts ( #73937 )
4 years ago
Alicia Cozine
b57444af14
Rebased pr73824 ( #73934 )
...
Co-authored-by: Eugene <k.evgen61@gmail.com>
Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
4 years ago
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>
4 years ago
David Shrewsbury
78d3810fdf
Auto cleanup of async cache file ( #73760 )
...
* Auto cleanup of async cache file
* Add changelog
4 years ago
Brian Williams
1f2f292290
Fix invalid yaml in collections_using.rst ( #73727 )
...
Fix invalid quoting.
4 years ago
Brian Coca
91b42d62fa
another useful example ( #73728 )
4 years ago
Viktor Ekholm
b28abdfbdb
Fixed typo in vault documentation ( #73666 )
...
Example variable was named `my_encrytped_var`. Renamed it to `my_encrypted_var`.
4 years ago
David Shrewsbury
c8ee186e11
Remove warning about role validation with deps ( #73653 )
...
* Remove warning about role validation with deps
* add changelog
* update cl
4 years ago
Willams de Lima
fa05af8321
Fixing ad-hoc commands #73636 ( #73646 )
4 years ago
Lydie
4059b37ab1
Conscious language added to user guide, development guide, and Ansible community guide, ( #73574 )
...
* Added conscious language note to index pages of guides
4 years ago
David Shrewsbury
f0ec10dbc3
Role arg spec validation implementation ( #73152 )
...
* Initial import of modified version of alikins' code
* Add unit testing for new Role methods
* Fix validate_arg_spec module for sanity test. Add test_include_role_fails.yml integration test from orig PR.
* Add testing of suboptions
* Use new ArgumentSpecValidator class instead of AnsibleModule
* fix for roles with no tasks, use FQ name of new plugin
* Add role dep warning
4 years ago
Brian Coca
1cb753225c
added perf note to inc/imp diffs ( #73371 )
4 years ago
Matt Martz
d3441bc313
Add new split filter ( #73532 )
...
* Add version added
4 years ago
Sloane Hertel
bd18be6c0c
Fix ansible-galaxy collection subdir searching and update documentation ( #73406 )
...
* Ensure there is a single source of collection metadata
* Allow collection subdirs to be detected by a galaxy.yml or MANIFEST.json
* Add documentation about installing and downloading collection directories
* Add an example for downloading a git repository
* Update documented valid metadata sources for installing git repositories
Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua>
Co-authored-by: Alicia Cozine <879121+acozine@users.noreply.github.com>
4 years ago
Abhijeet Kasurde
7f6fcc3407
json_query: Update documentation ( #73302 )
4 years ago
luto
51e00c5e86
Fix documentation for slaac filter ( #73294 )
...
##### SUMMARY
One of the parameters to the slaac filter was unquoted causing a crash:
```
template error while templating string: expected token 'end of print statement', got ':'. String: {{ fdcf:1894:23b5:d38c:0000:0000:0000:0000 | slaac('c2:31:b3:83:bf:2b') }}
```
This adds the missing quotes.
##### ISSUE TYPE
- Docs Pull Request
+label: docsite_pr
4 years ago
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