From 8d665a1a8ef513913fe4d9cf5a2cd107991780a4 Mon Sep 17 00:00:00 2001 From: Samuel Gaist Date: Tue, 4 Oct 2022 10:47:24 +0200 Subject: [PATCH] docs: replace latin terms with english in network (#79013) fixes #78999 by removing Latin usage in network docs --- .../rst/network/getting_started/first_inventory.rst | 2 +- docs/docsite/rst/network/getting_started/index.rst | 2 +- .../network/user_guide/network_debug_troubleshooting.rst | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/docsite/rst/network/getting_started/first_inventory.rst b/docs/docsite/rst/network/getting_started/first_inventory.rst index d3d1528efc0..1562ed42c65 100644 --- a/docs/docsite/rst/network/getting_started/first_inventory.rst +++ b/docs/docsite/rst/network/getting_started/first_inventory.rst @@ -394,7 +394,7 @@ This is an example using an extract from a YAML inventory, as the INI format do ... To use an inline vaulted variables with an INI inventory you need to store it in a 'vars' file in YAML format, -it can reside in host_vars/ or group_vars/ to be automatically picked up or referenced from a play via ``vars_files`` or ``include_vars``. +it can reside in host_vars/ or group_vars/ to be automatically picked up or referenced from a play through ``vars_files`` or ``include_vars``. To run a playbook with this setup, drop the ``-k`` flag and add a flag for your ``vault-id``: diff --git a/docs/docsite/rst/network/getting_started/index.rst b/docs/docsite/rst/network/getting_started/index.rst index d9638a5c9a6..bf9f2eb01b7 100644 --- a/docs/docsite/rst/network/getting_started/index.rst +++ b/docs/docsite/rst/network/getting_started/index.rst @@ -8,7 +8,7 @@ Ansible collections support a wide range of vendors, device types, and actions, - Automate repetitive tasks to speed routine network changes and free up your time for more strategic work - Leverage the same simple, powerful, and agentless automation tool for network tasks that operations and development use -- Separate the data model (in a playbook or role) from the execution layer (via Ansible modules) to manage heterogeneous network devices +- Separate the data model (in a playbook or role) from the execution layer (through Ansible modules) to manage heterogeneous network devices - Benefit from community and vendor-generated sample playbooks and roles to help accelerate network automation projects - Communicate securely with network hardware over SSH or HTTPS diff --git a/docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst b/docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst index ef56aa8722e..05e37388bf5 100644 --- a/docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst +++ b/docs/docsite/rst/network/user_guide/network_debug_troubleshooting.rst @@ -322,7 +322,7 @@ Error: "Authentication failed" **Platforms:** Any -Occurs if the credentials (username, passwords, or ssh keys) passed to ``ansible-connection`` (via ``ansible`` or ``ansible-playbook``) can not be used to connect to the remote device. +Occurs if the credentials (username, passwords, or ssh keys) passed to ``ansible-connection`` (through ``ansible`` or ``ansible-playbook``) can not be used to connect to the remote device. @@ -336,7 +336,7 @@ For example: Suggestions to resolve: -If you are specifying credentials via ``password:`` (either directly or via ``provider:``) or the environment variable `ANSIBLE_NET_PASSWORD` it is possible that ``paramiko`` (the Python SSH library that Ansible uses) is using ssh keys, and therefore the credentials you are specifying are being ignored. To find out if this is the case, disable "look for keys". This can be done like this: +If you are specifying credentials through ``password:`` (either directly or through ``provider:``) or the environment variable `ANSIBLE_NET_PASSWORD` it is possible that ``paramiko`` (the Python SSH library that Ansible uses) is using ssh keys, and therefore the credentials you are specifying are being ignored. To find out if this is the case, disable "look for keys". This can be done like this: .. code-block:: yaml @@ -724,9 +724,9 @@ Example Ansible inventory file ansible_password=!vault... -.. note:: Using ``ProxyCommand`` with passwords via variables +.. note:: Using ``ProxyCommand`` with passwords through variables - By design, SSH doesn't support providing passwords via environment variables. + By design, SSH doesn't support providing passwords through environment variables. This is done to prevent secrets from leaking out, for example in ``ps`` output. We recommend using SSH Keys, and if needed an ssh-agent, rather than passwords, where ever possible.