Felix Fontein
039eb892ba
Second batch for _facts -> _info rename ( #57020 )
...
* Second batch of _facts -> _info.
* Forgot one reference.
2019-06-10 13:04:07 +02:00
Felix Fontein
ef2d70a806
Rename ali_instance_facts -> ali_instance_info ( #57036 )
...
* Rename ali_instance_facts -> ali_instance_info.
* Add changelog.
2019-06-10 12:40:50 +02:00
Zim Kalinowski
93a85b6c86
Additional rename fixes ( #57527 )
...
* adding symbolic link
* missing renames
* reverted version_added
2019-06-07 18:22:17 -07:00
Sandra McCann
152202ceb0
add info about hwaddr conversion formats ( #57491 )
2019-06-06 12:56:10 -05:00
pratikgadiya12
72297db686
Renames Digital Ocean cloud _facts modules to _info ( #57315 )
...
Fixes : #57276
2019-06-06 19:33:19 +02:00
smile37773
c6097a268c
rename modules azure_rm_..._facts to azure_rm_..._info ( #57395 )
2019-06-06 12:10:27 +08:00
Sandra McCann
3136007032
update docsite breadcrumbs from sphinx_rtd_theme ( #57316 )
...
* improve breadcrumbs
* get edit on github working again
2019-06-05 14:26:34 -05:00
Sandra McCann
96693600f9
2.9 roadmap dates ( #57420 )
...
* add dates to 2.9 roadmap, remove alpha phase
2019-06-05 14:25:43 -05:00
Sviatoslav Sydorenko
dfaa72297c
Fix an RST link to the changelog config in docs
2019-06-05 15:08:09 +02:00
Abhijeet Kasurde
ee8a607cca
ipaddr: Handle network address in ipmath ( #57149 )
...
* Updated testcase, documentation
Fixes : #54457
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2019-06-04 14:01:18 +05:30
Felix Fontein
7b40b569b2
Rename memset_*_facts to memset_*_info ( #57030 )
...
* Rename memset_*_facts to memset_*_info
* Add changelog.
2019-06-03 21:19:49 +02:00
Abhijeet Kasurde
5162d21ea3
VMware: vSphere Automation SDK installation docs ( #57280 )
...
* VMware: adds instructions for installing vSphere Automation SDK to the dynamic inventory scenario
2019-06-03 13:52:30 -05:00
Ilya Reshetnikov
bf0e846a39
Update playbooks_filters.rst ( #57200 )
...
* Update playbooks_filters.rst to show JSON in the "JSON Query Filter" example data structure
2019-06-03 11:15:11 -05:00
Thad Guidry
78b003858d
Mention other ways to handle private key files ( #57238 )
...
Often when I am helping others learn Ansible, they are using nodes spun up on Amazon/Google/etc. where private key files (pem) are needed. Mentioning just a bit more on how to handle those private key files on the intro_getting_started page will help more folks get started faster.
I even reviewed the changes with my learning team and they all agreed this helped clarify immediately for them how to really get started with Ansible from a practical perspective.
2019-06-03 10:17:13 -05:00
Bill Nottingham
c493593b4b
Adjust assorted terminology and wording around product offerings. ( #57242 )
...
* Adjust assorted terminology and wording around product offerings.
* Update docs/docsite/rst/dev_guide/style_guide/trademarks.rst
* Update docs/docsite/rst/user_guide/modules_support.rst
* Update docs/docsite/rst/reference_appendices/tower.rst
2019-05-31 14:24:44 -05:00
Sviatoslav Sydorenko
49ec681a73
Fix ansible_async_dir in the migration doc
2019-05-31 00:15:13 +02:00
Felix Fontein
c47e9d22b4
Rename one_image_facts -> one_image_info ( #57035 )
...
* Rename one_image_facts -> one_image_info.
* Add changelog.
* Forgot symlink.
2019-05-29 21:23:25 +02:00
Sviatoslav Sydorenko
5183f84016
📝 Mention the minumum cherry-picker version in doc ( #57139 )
2019-05-29 13:39:10 -05:00
Remon van de Kamp
dea9644d21
Use correct variable for run_once regardless of batch example ( #57077 )
...
Changes example to `when: inventory_hostname == ansible_play_hosts_all[0]` to really run run_once regardless of serial.
2019-05-29 12:24:12 -05:00
Takashi Sugimura
e17434c19f
Correct repository name to install ( #56991 )
2019-05-28 11:13:36 -04:00
Felix Fontein
61b48778a7
Rename _facts -> _info ( #57028 )
2019-05-28 13:43:04 +02:00
Felix Fontein
7a0af34ba9
First batch _facts -> _info rename. ( #56822 )
2019-05-27 18:17:42 +02:00
Jonathan Bride
db6407d6bf
Correct typo in playbooks_intro.rst ( #56919 )
...
Typo in code block line: ansible-lint veryify-apache.yml should be
ansible-lint verify-apache.yml
2019-05-24 09:53:00 -05:00
Anatoly Kamchatnov
9a563f8947
Windows FAQ: fix reference ( #56909 )
2019-05-24 09:39:49 -05:00
Sam Doran
50b1a66649
Update instructions for running module directly ( #56883 )
...
The internals of AnsiballZ changed silghtly
2019-05-23 17:20:29 -05:00
Alicia Cozine
fc94d79c47
CLI docs include license not copyright ( #56871 )
2019-05-23 14:53:07 -05:00
Sandra McCann
f9b43a0f68
Copyright fix for 2018 ( #56860 )
...
* update copyright in footer
* remove extraneous copyright from cli commands
2019-05-23 13:10:22 -05:00
Sandra McCann
3129fc0b17
Update RHEL repo for Ansible 2.8 ( #56859 )
2019-05-23 11:31:12 -05:00
Abhijeet Kasurde
26d38dd642
VMware: Add folder param in vmware_datastore_cluster
...
* Make datacenter as alias and optional
* Add folder param to place datastore cluster in specific folder
* Updated examples
* Updated tests
Fixes : #48010
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2019-05-23 09:12:10 -04:00
Abhijeet Kasurde
459776eb82
VMware: Add folder option for vmware_dvswitch ( #56707 )
...
* Added folder param
* Mark datacenter as optional parameter
* Updated docs
* Updated tests
Fixes : #54986
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2019-05-22 11:40:09 +05:30
CsilLAB
6900378766
[WIP] Tip to see the content of a single encrypted var ( #37887 )
...
* Tip to see the content of a single var encrypted with Ansible Vault
2019-05-21 15:37:25 -05:00
Felix Fontein
53ec9c8019
Clarify that GPLv3+ module_utils need core team approval ( #56740 )
...
* Clarify that GPLv3+ module_utils need core team approval.
* Update docs/docsite/rst/dev_guide/shared_snippets/licensing.txt
Co-Authored-By: Sam Doran <sdoran@redhat.com>
* More 'module_util' -> 'file in module_utils'.
2019-05-21 15:15:55 -05:00
Sandra McCann
388f5d0b2b
Add links to quickstart guides ( #56722 )
...
* shell of quickstart
* link to existing quickstart guides
2019-05-21 10:48:50 -05:00
Seth Hochberg
66bfa27685
Replace deprecated ansible-container references ( #56427 )
...
Link to ansible-bender instead of the deprecated ansible-container.
Co-Authored-By: Felix Fontein <felix@fontein.de>
2019-05-20 15:38:38 -05:00
Felix Fontein
abca3f1956
Clarify documentation on _info vs. _facts modules ( #56611 )
...
* Clarify documentation on _info vs. _facts modules.
* Expand with examples for facts and non-facts.
2019-05-20 13:52:43 -05:00
Kevin Breit
4742897635
Move backport guide to 2.8 ( #56578 )
...
The backport guide should refer to Ansible 2.8 instead of 2.7 as the target branch, since 2.8 is out.
2019-05-17 21:16:36 -05:00
Matt Martz
3f4a22d8ef
Add compat tojson filter for jinja2 versions missing it ( #56596 )
2019-05-17 20:36:41 -05:00
Sandra McCann
a3c3fd91f8
move too old version to 2.3 ( #56540 )
2019-05-16 20:31:01 -05:00
s-hamann
730456b402
Add seed parameter to random_mac filter ( #51841 )
2019-05-16 13:41:08 -04:00
Alicia Cozine
f88b660717
adds 2.9 roadmap, reversed local TOC order ( #56371 )
2019-05-16 09:28:33 -05:00
Alicia Cozine
118cf3ece6
Cloud dev docs to rst ( #56485 )
...
* Moves developer docs for AWS, ovirt, and openstack modules out of lib/ansible/, integrates them with dev_guide, with abadger's fix to make python snippets pass rstcheck
2019-05-16 09:05:12 -05:00
Sandra McCann
635931051b
[Doc-Release-2.8] fixed broken module links in 2.8 porting guide ( #56494 )
...
* fixed broken module links
2019-05-15 20:35:14 -05:00
Sandra McCann
4bf134756b
changed version to 2.8 ( #56487 )
2019-05-15 14:59:21 -05:00
Sandra McCann
f097dca60d
update release table for 2.8 ( #56486 )
2019-05-15 14:58:53 -05:00
thomas.boussekey
d55823b013
Update of Ansible 2.8 roadmap (add RC2 & RC3) ( #56436 )
...
##### SUMMARY
* Remove **if needed** for RC2 & RC3
* Set correct release date for RC3
2019-05-15 14:17:10 -04:00
Matt Clay
f9b56a5b56
Add sanity test to check for unwanted files.
2019-05-14 09:13:51 -07:00
Pilou
b3ab83bc70
[doc] fix example: always trigger the handler ( #56384 )
...
by default, debug task result isn't changed - add 'changed_when: yes' to trigger handler
2019-05-14 09:02:40 -05:00
Sandra McCann
88be323bcd
Fix 2.8 changlog url and reverse order porting guides TOC ( #56373 )
...
* fixed url for 2.8 changelog, fixed spelling issues, reversed TOC order
2019-05-14 08:43:47 -05:00
Felix Fontein
6948e04276
Add myself to committer list. ( #56363 )
2019-05-13 19:22:02 +02:00
Isaac
85fa65e5f0
docs: Update scopes value example ( #56362 )
...
Existing example in GCE guide returns "invalid scope" error; value needs "https://" prefix
2019-05-13 12:11:49 -05:00
Sam Doran
c1ebc8d9c2
Update default roles_path documentation ( #56320 )
2019-05-13 11:32:52 -05:00
Alicia Cozine
3c8d8b1509
should have gone into 52373 ( #56306 )
2019-05-10 10:59:50 -04:00
Reginald Davis
dd0b0ae47b
Lack of "--update" flag in older Ubuntu distros ( #56283 )
...
When installing Ansible on older Ubuntu distributions be aware of the lack of ``-u`` or ``--update`` flag.
+label: docsite_pr
2019-05-09 19:09:41 -05:00
Dag Wieers
eac7f1fb58
dev_guide: Various small updates ( #53273 )
...
* Document the clarifications that I usually remark when doing reviews
* Update docs/docsite/rst/dev_guide/developing_modules_documenting.rst
Co-Authored-By: dagwieers <dag@wieers.com>
2019-05-09 18:44:28 -05:00
stroebitzer
dae5564e2b
Fix var naming ( #55796 )
...
* Fix var naming in GCE guide
2019-05-08 13:51:18 -05:00
Brian Coca
8ff27c4e0c
more info on how vaults work ( #56183 )
...
also add warning about what it covers.
2019-05-07 14:53:34 -05:00
Lindsay Hill
53ed1bfc49
Improve rendering of default lists ( #56041 )
2019-05-07 10:35:36 -05:00
Jim Rollenhagen
86e98c5213
Note that by default the regex test is identical to match, but can do much more ( #50205 )
...
* Note that the regex test behaves like 'match', with default settings
2019-05-07 10:00:00 -05:00
Matthew Davis
7d5ada7161
add doc example of multiline failed_when with OR ( #56007 )
...
* add doc example of multiline failed_when with OR
* add variety to multiple OR failed_when doc example
2019-05-06 09:11:27 -05:00
Toshio Kuratomi
edafa71f42
Developer documentation update involving module invocation ( #55747 )
...
* Update docs for the 2.7 change to AnsiballZ which invokes modules with one
less Python interpreter
* Add a section on how module results are returned and on trust between modules, action plugins, and the executor.
* Update docs/docsite/rst/dev_guide/developing_program_flow_modules.rst
Co-Authored-By: abadger <a.badger@gmail.com>
2019-05-01 18:52:22 -05:00
Mark Zhitomirski
b14f477bee
docsite: correct path, list requirements for testing module docs, etc. ( #52008 )
...
* dev_guide: correct path, list requirements, etc.; module HTML docs are in '_build/html/module' subdir
2019-05-01 15:19:02 -05:00
Brian Coca
5d4c73e197
unite poll defaults ( #55470 )
...
* unite poll defaults and update docs
2019-05-01 13:47:50 -05:00
Klaas Demter
76dba7aa4f
Add faq note about ssh ServerAliveInterval ( #55568 )
2019-05-01 12:04:40 -05:00
Alicia Cozine
8542459b95
Docs: edits & expands module_utils & search path info in dev guide ( #55931 )
...
* Update docs/docsite/rst/dev_guide/developing_module_utilities.rst
2019-05-01 07:52:34 -05:00
Alicia Cozine
5439eb8bd8
Clarifies how Ansible processes multiple failed_when
conditions ( #55941 )
...
Docs: Clarify that multiple failed_when conditions join with AND not OR to counter third-party pages online incorrectly stating that it uses `OR`. ([example](https://groups.google.com/d/msg/ansible-project/cIaQTmY3ZLE/c5w8rlmdHWIJ )).
2019-05-01 07:31:59 -05:00
Sam Doran
b3ce3fc5eb
Restore ansible --version output ( #55728 )
...
* Add custom action class for version info
* Use args from CLI as prog for ArgumentParser object
* Make prog a required parameter of create_base_parser() and update all uses to pass in the newly required parameter.
* Add unit test for checking ansible --version
* Update other related unit tests
2019-04-29 16:38:31 -04:00
Sandra McCann
47a440774f
Speed up the Sphinx documentation build ( #55593 )
...
* speeds up the docs build by changing the navigation collapse setting
2019-04-29 15:34:02 -05:00
stroebitzer
943f7334c5
Fix var naming ( #55795 )
...
Make vars match tasks in Google Compute guide.
2019-04-26 10:15:51 -05:00
Alicia Cozine
9d5b5d7ddd
correct description of modules vs plugins ( #55784 )
2019-04-26 09:32:42 -05:00
Alicia Cozine
bb5059f2c7
Add security group info and example to AWS guide ( #55783 )
...
* expand documentation on how to use lookup plugin aws_service_ip_ranges with ec2_group module
* fix rst syntax error
2019-04-26 09:31:49 -05:00
tacatac
dbc64ae64c
Clarify poll value behaviour in playbook async doc ( #54929 )
...
Clarify the documentation for `async` and `poll`; describe the behavior when `poll` = 0 and when it does not.
* Update docs/docsite/rst/user_guide/playbooks_async.rst
* Update the default poll value in async doc
Co-Authored-By: tacatac <taca@kadisius.eu>
2019-04-25 17:23:13 -05:00
hiyokotaisa
7b86208fcd
Add Microsoft Document URL for WinRM Memory Hotfix ( #55680 )
...
* Add microsoft document for memory hotfix
* Update docs/docsite/rst/user_guide/windows_setup.rst
Co-Authored-By: hiyokotaisa <thel.vadam2485@gmail.com>
2019-04-25 10:56:34 -05:00
Lars Kellogg-Stedman
a5cb47d697
Improve consistency of loop documentation ( #55674 )
...
There were a series of sections with subheadings in the loop
documentation, but the most recent additions did not follow the same
pattern.
2019-04-23 16:39:14 -05:00
tacatac
79198cad7a
Clarify the Vault guide and add Vault ID examples ( #55111 )
...
updates docs/docsite/rst/user_guide/vault.rst
* Add reference to single variable vault encryption
* rST ref to jump to the section
* Clarify the two targets of vault encryption, with notes about advantages and drawbacks of each
* Add the default form for --vault-id
* Add Vault ID examples for normal operations
Co-Authored-By: tacatac <taca@kadisius.eu>
2019-04-23 16:36:39 -05:00
Matt Martz
db6cc60352
Migrate command line parsing to argparse ( #50610 )
...
* Start of migration to argparse
* various fixes and improvements
* Linting fixes
* Test fixes
* Fix vault_password_files
* Add PrependAction for argparse
* A bunch of additional tweak/fixes
* Fix ansible-config tests
* Fix man page generation
* linting fix
* More adhoc pattern fixes
* Add changelog fragment
* Add support for argcomplete
* Enable argcomplete global completion
* Rename PrependAction to PrependListAction to better describe what it does
* Add documentation for installing and configuring argcomplete
* Address rebase issues
* Fix display encoding for vault
* Fix line length
* Address rebase issues
* Handle rebase issues
* Use mutually exclusive group instead of handling manually
* Fix rebase issues
* Address rebase issue
* Update version added for argcomplete support
* -e must be given a value
* ci_complete
2019-04-23 13:54:39 -05:00
Xaroth
a9f24e097f
Add ansible_parent_role_names magic variable ( #46687 )
...
-Add: Test cases for ansible_parent_role_names and ansible_parent_role_paths
-Add: ansible_parent_role_names/paths variables for when a role is being included by another role.
2019-04-23 11:55:05 -04:00
Sandra McCann
cca365061c
add how to create HttpApi plugins for network modules ( #54340 )
...
* initial port over from gdoc
* crosslink httpapi pages
* Add some examples?
* Add quick example of using Connection
* Fix indentation of python code blocks
* moved to a full developer guide for networks
* Try to clarify some examples
* Fix typos
How did I even do that?
2019-04-22 13:21:21 -04:00
spellis
6ea3eca8ff
Update windows_setup.rst ( #55535 )
...
Wrong protocol and port in command.
+label: docsite_pr
2019-04-22 11:34:13 -05:00
Gregor Dschung
158452661a
Correct link to Thomas' GitHub account ( #55587 )
...
Thomas renamed his account from tstringer to trstringer
2019-04-22 09:37:00 -05:00
Faisal Shaikh
0330ea616e
Removed misleading padding from highlighted results of a search query ( #55464 )
2019-04-18 11:26:10 -05:00
Alex Stephen
e298de0986
GCP deprecations ( #53355 )
...
* gcdns_record deprecation
* gcdns_zone deprecation
* gcp_forwarding_rule deprecation
* gcp_url_map deprecation
* gcspanner deprecation
* gcp_healthcheck deprecation
* porting guide
* test failures
* forgot to rename
* deprecating
* porting guide changes
* unit test fixes
* changing ignores
2019-04-18 15:30:27 +01:00
Jordan Borean
8542f16fa9
SCP filename validation docs ( #55399 )
...
* SCP filename validation docs
* Update docs/docsite/rst/reference_appendices/faq.rst
Co-Authored-By: jborean93 <jborean93@gmail.com>
* Update docs/docsite/rst/reference_appendices/faq.rst
Co-Authored-By: jborean93 <jborean93@gmail.com>
* Update docs/docsite/rst/reference_appendices/faq.rst
Co-Authored-By: jborean93 <jborean93@gmail.com>
* edits to scp FAQ entry
* zeut alors I have missed one
* incorporate jborean feedback
* adds link to bug report
2019-04-18 12:02:09 +10:00
Alicia Cozine
d7f6493084
adds better links to tips and pitfalls page ( #55458 )
2019-04-17 14:30:34 -04:00
Matt Martz
9f83139dcb
Don't register tests as filters ( #55332 )
...
* Don't register tests as filters. Fixes #55319
* Remove tests for deprecated functionality
* Remove no-tests-as-filters sanity tests
* Remove docs too
* Revert "Remove docs too"
This reverts commit 7daf457a74
.
* Make no-tests-as-filters doc an orphan
2019-04-16 14:10:14 -05:00
Michelle Perz
960df24272
include windows server 2019 in supported hosts ( #55367 )
...
<!--- Your description here -->
+label: docsite_pr
2019-04-16 14:00:33 -05:00
James McClune
da1f86a40f
docs/docsite: minor fixes in docs/docsite/README.md ( #55356 )
...
Added inline markup to important references. Fixed minor spelling error.
Signed-off-by: James McClune <jmcclune@mcclunetechnologies.net>
2019-04-16 11:46:01 -05:00
Felix Fontein
395d471065
Docs: adding stub page for module/plugin aliases ( #54448 )
...
* Adding stub pages for deprecated module/plugin aliases.
2019-04-16 11:37:28 -05:00
Kevin Breit
521e62aa38
Update set_module_args in unit test docs ( #55244 )
...
* Update docs/docsite/rst/dev_guide/testing_units_modules.rst
`set_unit_args()` should be imported and used in the unit test documentation.
Co-Authored-By: kbreit <kevin.breit@kevinbreit.net>
2019-04-15 17:27:27 -05:00
Alex Stephen
91a664a93e
Gce migration docs ( #51838 )
...
* migration docs for gce, with example playbook
* Update docs/docsite/rst/scenario_guides/guide_gce.rst
Co-Authored-By: rambleraptor <alexstephen@google.com>
2019-04-15 16:30:36 -05:00
Kevin Breit
a005dcfbbd
Add example for full path on unit tests ( #55243 )
...
Docs: adds an example when a full path is needed for unit tests, with module_utils, etc.
2019-04-15 16:20:14 -05:00
Jiri Tyr
7efb952825
Adding missing comma ( #55254 )
2019-04-15 15:02:26 -05:00
Abhijeet Kasurde
3003954415
Update unit testing docs ( #55272 )
...
* Updated links
* Updated indentation
* Fixed typos
Fixes : #55242
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>
2019-04-15 14:27:06 -05:00
Toshio Kuratomi
b4f41fd9e2
Document replacements ( #55226 )
...
* Document replacements
Document suggested replacement moduels for kubernetes, oc, and ec2_ami_find
modules in the porting guide
* remember the _module suffix
2019-04-12 13:50:41 -07:00
Toshio Kuratomi
a1c8fc37e8
Remove modules which have ended their deprecation cycle
...
* Remove code but leave the metadata so that they can be listed as
removed in documentation.
* Remove removed modules from validate-modules ignore
* Remove unittests for the removed nodules
* Remove links to removed modules and add list of removed moduels to the
2.9 porting guide
2019-04-12 12:57:35 -07:00
Toshio Kuratomi
e5a31e81b6
Add a script to generate a new porting guide
...
* porting-guide.py is allowed to be Python-3.6+ as it will only be run
by release engineers
2019-04-12 12:57:35 -07:00
Keith Maxwell
04220478da
Fewer examples use connection: local in docs ( #55133 )
...
* Fewer connection: local lines in module examples and scenario guides
The line 'connection: local' is not required. See
./docs/docsite/rst/inventory/implicit_localhost.rst
2019-04-11 16:28:14 -05:00
Sandra McCann
7a1e2ef746
Clarify platform EOS and NXOS table settings ( #55096 )
2019-04-11 10:32:50 -05:00
Sam Doran
f7ed194bc9
Clarify how to use variables with handlers ( #54928 )
...
* Add clarification on handler names
Add example on how to use variables in handlers
* Update docs/docsite/rst/user_guide/playbooks_intro.rst
2019-04-11 10:23:08 -05:00
Keith Maxwell
be09f420de
Add a title to the installation guide ( #55138 )
...
Also remove placeholder text.
2019-04-11 12:33:43 +01:00
John R Barker
424747e50b
porting_guide_2.8 - fix broken links ( #55092 )
...
* porting_guide_2.8 - fix broken links in deprecated modules section
2019-04-10 11:40:55 -05:00