summaryrefslogtreecommitdiff
path: root/docs/_locale/pt/automation.pot
diff options
context:
space:
mode:
Diffstat (limited to 'docs/_locale/pt/automation.pot')
-rw-r--r--docs/_locale/pt/automation.pot224
1 files changed, 124 insertions, 100 deletions
diff --git a/docs/_locale/pt/automation.pot b/docs/_locale/pt/automation.pot
index 1f130019..ca4ac990 100644
--- a/docs/_locale/pt/automation.pot
+++ b/docs/_locale/pt/automation.pot
@@ -49,7 +49,7 @@ msgstr "#terraform plan"
msgid "#yes"
msgstr "#yes"
-#: ../../automation/cloud-init.rst:363
+#: ../../automation/cloud-init.rst:366
msgid "**NOTE**: be careful while copying and pasting previous commands. Double quotes may need to be corrected."
msgstr "**NOTE**: be careful while copying and pasting previous commands. Double quotes may need to be corrected."
@@ -57,51 +57,51 @@ msgstr "**NOTE**: be careful while copying and pasting previous commands. Double
msgid "**NOTE**: be carefull while copying and pasting previous commands. Doble quotes may need to be corrected."
msgstr "**NOTE**: be carefull while copying and pasting previous commands. Doble quotes may need to be corrected."
-#: ../../automation/cloud-init.rst:305
+#: ../../automation/cloud-init.rst:308
msgid "**meta-data**: empty file (required)."
msgstr "**meta-data**: empty file (required)."
-#: ../../automation/cloud-init.rst:300
+#: ../../automation/cloud-init.rst:303
msgid "**network-config**: file that will indicate to avoid dhcp client on first interface."
msgstr "**network-config**: file that will indicate to avoid dhcp client on first interface."
-#: ../../automation/cloud-init.rst:333
+#: ../../automation/cloud-init.rst:336
msgid "**network-config** file only has configuration that disables the automatic dhcp client on first interface."
msgstr "**network-config** file only has configuration that disables the automatic dhcp client on first interface."
-#: ../../automation/cloud-init.rst:303
+#: ../../automation/cloud-init.rst:306
msgid "**user-data**: includes vyos-commands."
msgstr "**user-data**: includes vyos-commands."
-#: ../../automation/cloud-init.rst:314
+#: ../../automation/cloud-init.rst:317
msgid "**user-data** file must start with ``#cloud-config`` and contains vyos-commands. For example:"
msgstr "**user-data** file must start with ``#cloud-config`` and contains vyos-commands. For example:"
-#: ../../automation/vyos-api.rst:323
+#: ../../automation/vyos-api.rst:355
msgid "/config-file"
msgstr "/config-file"
-#: ../../automation/vyos-api.rst:266
+#: ../../automation/vyos-api.rst:298
msgid "/configure"
msgstr "/configure"
-#: ../../automation/vyos-api.rst:246
+#: ../../automation/vyos-api.rst:278
msgid "/generate"
msgstr "/generate"
-#: ../../automation/vyos-api.rst:184
+#: ../../automation/vyos-api.rst:216
msgid "/image"
msgstr "/image"
-#: ../../automation/vyos-api.rst:165
+#: ../../automation/vyos-api.rst:197
msgid "/poweroff"
msgstr "/poweroff"
-#: ../../automation/vyos-api.rst:147
+#: ../../automation/vyos-api.rst:179
msgid "/reboot"
msgstr "/reboot"
-#: ../../automation/vyos-api.rst:129
+#: ../../automation/vyos-api.rst:161
msgid "/reset"
msgstr "/reset"
@@ -109,7 +109,7 @@ msgstr "/reset"
msgid "/retrieve"
msgstr "/retrieve"
-#: ../../automation/vyos-api.rst:222
+#: ../../automation/vyos-api.rst:254
msgid "/show"
msgstr "/show"
@@ -342,7 +342,7 @@ msgstr "AWS"
msgid "AWS_terraform_ansible_single_vyos_instance"
msgstr "AWS_terraform_ansible_single_vyos_instance"
-#: ../../automation/cloud-init.rst:270
+#: ../../automation/cloud-init.rst:273
msgid "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After cloning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After cloning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
@@ -350,7 +350,7 @@ msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtaine
msgid "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After clonning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
msgstr "A VyOS qcow image with cloud-init options is needed. This can be obtained using `vyos-vm-images`_ repo. After clonning the repo, edit the file **qemu.yml** and comment the **download-iso** role."
-#: ../../automation/cloud-init.rst:63
+#: ../../automation/cloud-init.rst:64
msgid "A cloud-config document is written in YAML. The file must begin with ``#cloud-config`` line. The only supported top-level keys are ``vyos_config_commands`` and ``write_files``. The use of these keys is described in the following two sections."
msgstr "A cloud-config document is written in YAML. The file must begin with ``#cloud-config`` line. The only supported top-level keys are ``vyos_config_commands`` and ``write_files``. The use of these keys is described in the following two sections."
@@ -358,7 +358,7 @@ msgstr "A cloud-config document is written in YAML. The file must begin with ``#
msgid "A simple example is shown below, where the ops command executed in the post-hook script is \"show interfaces\"."
msgstr "A simple example is shown below, where the ops command executed in the post-hook script is \"show interfaces\"."
-#: ../../automation/cloud-init.rst:82
+#: ../../automation/cloud-init.rst:83
msgid "A single-quote symbol is not allowed inside command or value."
msgstr "A single-quote symbol is not allowed inside command or value."
@@ -378,6 +378,10 @@ msgstr "After executing all the commands you will have your VyOS instance on the
msgid "After executing all the commands you will have your VyOS instance on the vSphere with your configuration, it's a very convenient desition. If you need to delete the instance please type the command:"
msgstr "After executing all the commands you will have your VyOS instance on the vSphere with your configuration, it's a very convenient desition. If you need to delete the instance please type the command:"
+#: ../../automation/cloud-init.rst:92
+msgid "After the ``vyos_config_commands`` are executed, cloud-init will automatically perform a ``commit`` and ``save`` operation."
+msgstr "After the ``vyos_config_commands`` are executed, cloud-init will automatically perform a ``commit`` and ``save`` operation."
+
#: ../../automation/vyos-api.rst:15
msgid "All endpoints only listen on HTTP POST requests and the API KEY must set as ``key`` in the formdata."
msgstr "All endpoints only listen on HTTP POST requests and the API KEY must set as ``key`` in the formdata."
@@ -388,7 +392,7 @@ msgstr "All endpoints only listen on HTTP POST requests and the API KEY must set
msgid "All files about the article can be found here_"
msgstr "All files about the article can be found here_"
-#: ../../automation/cloud-init.rst:115
+#: ../../automation/cloud-init.rst:119
msgid "All of these can be overridden using the configuration in user-data."
msgstr "All of these can be overridden using the configuration in user-data."
@@ -396,7 +400,7 @@ msgstr "All of these can be overridden using the configuration in user-data."
msgid "Also, increase the time in the file instance.yml from 300 sec to 500 sec or more. (It depends on your location). Make sure that you have opened access to the instance in the security group."
msgstr "Also, increase the time in the file instance.yml from 300 sec to 500 sec or more. (It depends on your location). Make sure that you have opened access to the instance in the security group."
-#: ../../automation/cloud-init.rst:256
+#: ../../automation/cloud-init.rst:259
msgid "Also, this lab considers:"
msgstr "Also, this lab considers:"
@@ -429,7 +433,7 @@ msgstr "Azure"
msgid "Azure_terraform_ansible_single_vyos_instance"
msgstr "Azure_terraform_ansible_single_vyos_instance"
-#: ../../automation/cloud-init.rst:241
+#: ../../automation/cloud-init.rst:244
msgid "Before starting, please refer to cloud-init `network-config-docs`_ in order to know how to import user and network configurations."
msgstr "Before starting, please refer to cloud-init `network-config-docs`_ in order to know how to import user and network configurations."
@@ -453,11 +457,11 @@ msgstr "Check that salt master can communicate with minions"
msgid "Cloud-config modules"
msgstr "Cloud-config modules"
-#: ../../automation/cloud-init.rst:420
+#: ../../automation/cloud-init.rst:423
msgid "Cloud-init `network-config-docs`_."
msgstr "Cloud-init `network-config-docs`_."
-#: ../../automation/cloud-init.rst:239
+#: ../../automation/cloud-init.rst:242
msgid "Cloud-init on Proxmox"
msgstr "Cloud-init on Proxmox"
@@ -465,7 +469,7 @@ msgstr "Cloud-init on Proxmox"
msgid "Cloud and virtualized instances of VyOS are initialized using the industry-standard cloud-init. Via cloud-init, the system performs tasks such as injecting SSH keys and configuring the network. In addition, the user can supply a custom configuration at the time of instance launch."
msgstr "Cloud and virtualized instances of VyOS are initialized using the industry-standard cloud-init. Via cloud-init, the system performs tasks such as injecting SSH keys and configuring the network. In addition, the user can supply a custom configuration at the time of instance launch."
-#: ../../automation/cloud-init.rst:120
+#: ../../automation/cloud-init.rst:124
msgid "Command Execution at Initial Boot"
msgstr "Command Execution at Initial Boot"
@@ -473,11 +477,11 @@ msgstr "Command Execution at Initial Boot"
msgid "Command Scripting"
msgstr "Command Scripting"
-#: ../../automation/cloud-init.rst:356
+#: ../../automation/cloud-init.rst:359
msgid "Command for generating ``seed.iso``"
msgstr "Command for generating ``seed.iso``"
-#: ../../automation/cloud-init.rst:78
+#: ../../automation/cloud-init.rst:79
msgid "Commands requirements:"
msgstr "Commands requirements:"
@@ -530,19 +534,19 @@ msgstr "Content"
msgid "Content of commands.conf"
msgstr "Content of commands.conf"
-#: ../../automation/cloud-init.rst:337
+#: ../../automation/cloud-init.rst:340
msgid "Content of network-config file:"
msgstr "Content of network-config file:"
-#: ../../automation/cloud-init.rst:351
+#: ../../automation/cloud-init.rst:354
msgid "Create seed.iso"
msgstr "Create seed.iso"
-#: ../../automation/cloud-init.rst:189
+#: ../../automation/cloud-init.rst:193
msgid "Create text files named user-data and meta-data. On linux-based systems, the mkisofs utility can be used to create the seed ISO. The following syntax will add these files to the ISO 9660 file system."
msgstr "Create text files named user-data and meta-data. On linux-based systems, the mkisofs utility can be used to create the seed ISO. The following syntax will add these files to the ISO 9660 file system."
-#: ../../automation/cloud-init.rst:368
+#: ../../automation/cloud-init.rst:371
msgid "Creating the VM"
msgstr "Creating the VM"
@@ -550,7 +554,7 @@ msgstr "Creating the VM"
msgid "Custom scripts are not executed with root privileges (Use sudo inside if this is necessary)."
msgstr "Custom scripts are not executed with root privileges (Use sudo inside if this is necessary)."
-#: ../../automation/cloud-init.rst:113
+#: ../../automation/cloud-init.rst:117
msgid "DHCP on first Ethernet interface if no network configuration is provided."
msgstr "DHCP on first Ethernet interface if no network configuration is provided."
@@ -634,11 +638,11 @@ msgstr "File contents of Terrafom for Azure"
msgid "File contents of Terrafom for vSphere"
msgstr "File contents of Terrafom for vSphere"
-#: ../../automation/cloud-init.rst:284
+#: ../../automation/cloud-init.rst:287
msgid "File generated with previous command: ``/tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2``"
msgstr "File generated with previous command: ``/tmp/vyos-1.3.0-cloud-init-10G-qemu.qcow2``"
-#: ../../automation/cloud-init.rst:347
+#: ../../automation/cloud-init.rst:350
msgid "Finally, file **meta-data** has no content, but it's required."
msgstr "Finally, file **meta-data** has no content, but it's required."
@@ -654,11 +658,15 @@ msgstr "For configuration/upgrade management issues, modification of this script
msgid "For configuration and enabling the API see :ref:`http-api`"
msgstr "For configuration and enabling the API see :ref:`http-api`"
+#: ../../automation/vyos-api.rst:130
+msgid "For example, check an existing path:"
+msgstr "For example, check an existing path:"
+
#: ../../automation/vyos-api.rst:109
msgid "For example, get the addresses of a ``dum0`` interface."
msgstr "For example, get the addresses of a ``dum0`` interface."
-#: ../../automation/vyos-api.rst:226
+#: ../../automation/vyos-api.rst:258
msgid "For example, show which images are installed."
msgstr "For example, show which images are installed."
@@ -666,7 +674,11 @@ msgstr "For example, show which images are installed."
msgid "For more information on the NoCloud data source, visit its `page <https://cloudinit.readthedocs.io/en/latest/reference/datasources/nocloud.html>`_ in the cloud-init documentation."
msgstr "For more information on the NoCloud data source, visit its `page <https://cloudinit.readthedocs.io/en/latest/reference/datasources/nocloud.html>`_ in the cloud-init documentation."
-#: ../../automation/cloud-init.rst:411
+#: ../../automation/cloud-init.rst:221
+msgid "For more information on the NoCloud data source, visit its page `nocloud`_ in the cloud-init documentation."
+msgstr "For more information on the NoCloud data source, visit its page `nocloud`_ in the cloud-init documentation."
+
+#: ../../automation/cloud-init.rst:414
msgid "From cli or GUI, power on VM, and after it boots, verify configuration"
msgstr "From cli or GUI, power on VM, and after it boots, verify configuration"
@@ -678,7 +690,7 @@ msgstr "General commands that we will use for running Terraform scripts"
msgid "Generate Object"
msgstr "Generate Object"
-#: ../../automation/cloud-init.rst:268
+#: ../../automation/cloud-init.rst:271
msgid "Generate qcow image"
msgstr "Generate qcow image"
@@ -690,7 +702,7 @@ msgstr "Getting Started"
msgid "Here is a simple example:"
msgstr "Here is a simple example:"
-#: ../../automation/cloud-init.rst:91
+#: ../../automation/cloud-init.rst:95
msgid "Here is an example cloud-config that appends configuration at the time of first boot."
msgstr "Here is an example cloud-config that appends configuration at the time of first boot."
@@ -710,23 +722,23 @@ msgstr "How to create a single instance and install your configuration using Ter
msgid "How to create a single instance and install your configuration using Terraform+Ansible+vSphere Step by step:"
msgstr "How to create a single instance and install your configuration using Terraform+Ansible+vSphere Step by step:"
-#: ../../automation/cloud-init.rst:377
+#: ../../automation/cloud-init.rst:380
msgid "ISO files storage: ``local`` volume is used for ``.iso`` file storage. In this scenario ``local`` volume type is set to **directory**, abd attached to ``/var/lib/vz``."
msgstr "ISO files storage: ``local`` volume is used for ``.iso`` file storage. In this scenario ``local`` volume type is set to **directory**, abd attached to ``/var/lib/vz``."
-#: ../../automation/cloud-init.rst:81
+#: ../../automation/cloud-init.rst:82
msgid "If command ends in a value, it must be inside single quotes."
msgstr "If command ends in a value, it must be inside single quotes."
-#: ../../automation/cloud-init.rst:250
+#: ../../automation/cloud-init.rst:253
msgid "If no networking configuration is provided, then dhcp client is going to be enabled on first interface. Bare in mind that this configuration will be inyected at an OS level, so don't expect to find dhcp client configuration on vyos cli. Because of this behavior, in next example lab we will disable dhcp-client configuration on eth0."
msgstr "If no networking configuration is provided, then dhcp client is going to be enabled on first interface. Bare in mind that this configuration will be inyected at an OS level, so don't expect to find dhcp client configuration on vyos cli. Because of this behavior, in next example lab we will disable dhcp-client configuration on eth0."
-#: ../../automation/cloud-init.rst:225
+#: ../../automation/cloud-init.rst:228
msgid "If you encounter problems, verify that the cloud-config document contains valid YAML. Online resources such as https://www.yamllint.com/ provide a simple tool for validating YAML."
msgstr "If you encounter problems, verify that the cloud-config document contains valid YAML. Online resources such as https://www.yamllint.com/ provide a simple tool for validating YAML."
-#: ../../automation/cloud-init.rst:153
+#: ../../automation/cloud-init.rst:157
msgid "If you need to gather information from linux commands to configure VyOS, you can execute commands and then configure VyOS in the same script."
msgstr "If you need to gather information from linux commands to configure VyOS, you can execute commands and then configure VyOS in the same script."
@@ -738,7 +750,7 @@ msgstr "If you want to script the configs in a language other than bash you can
msgid "Importing and Disabling Warnings for verify=False"
msgstr "Importing and Disabling Warnings for verify=False"
-#: ../../automation/cloud-init.rst:298
+#: ../../automation/cloud-init.rst:301
msgid "In Proxmox server three files are going to be used for this setup:"
msgstr "In Proxmox server three files are going to be used for this setup:"
@@ -758,15 +770,15 @@ msgstr "In this case, we'll create the necessary files for Terraform and Ansible
msgid "In this case, we'll create the necessary files for Terraform and Ansible next using Terraform we'll create a single instance on the vSphere cloud and make provisioning using Ansible."
msgstr "In this case, we'll create the necessary files for Terraform and Ansible next using Terraform we'll create a single instance on the vSphere cloud and make provisioning using Ansible."
-#: ../../automation/cloud-init.rst:307
+#: ../../automation/cloud-init.rst:310
msgid "In this lab, all files are located in ``/tmp/``. So, before going on, lets move to that directory:"
msgstr "In this lab, all files are located in ``/tmp/``. So, before going on, lets move to that directory:"
-#: ../../automation/cloud-init.rst:274
+#: ../../automation/cloud-init.rst:277
msgid "In this lab, we are using 1.3.0 VyOS version and setting a disk of 10G. Download VyOS .iso file and save it as ``/tmp/vyos.iso``. Command used for generating qcow image:"
msgstr "In this lab, we are using 1.3.0 VyOS version and setting a disk of 10G. Download VyOS .iso file and save it as ``/tmp/vyos.iso``. Command used for generating qcow image:"
-#: ../../automation/cloud-init.rst:71
+#: ../../automation/cloud-init.rst:72
msgid "Initial Configuration"
msgstr "Initial Configuration"
@@ -774,7 +786,7 @@ msgstr "Initial Configuration"
msgid "Initializing a VyDevice Object"
msgstr "Initializing a VyDevice Object"
-#: ../../automation/cloud-init.rst:180
+#: ../../automation/cloud-init.rst:184
msgid "Injecting configuration data is not limited to cloud platforms. Users can employ the NoCloud data source to inject user-data and meta-data on virtualization platforms such as VMware, Hyper-V and KVM."
msgstr "Injecting configuration data is not limited to cloud platforms. Users can employ the NoCloud data source to inject user-data and meta-data on virtualization platforms such as VMware, Hyper-V and KVM."
@@ -802,7 +814,7 @@ msgstr "Make sure that Ansible is pinging from Terrafom."
msgid "Metadata - Metadata is sourced by the cloud platform or hypervisor. In some clouds, there is implemented as an HTTP endpoint at ``http://169.254.169.254``."
msgstr "Metadata - Metadata is sourced by the cloud platform or hypervisor. In some clouds, there is implemented as an HTTP endpoint at ``http://169.254.169.254``."
-#: ../../automation/cloud-init.rst:244
+#: ../../automation/cloud-init.rst:247
msgid "Most important keys that needs to be considered:"
msgstr "Most important keys that needs to be considered:"
@@ -830,11 +842,11 @@ msgstr "Network Topology Diagram"
msgid "Network configuration - This config source informs the system about the network settings like IP addresses, routes, DNS. Available only in several cloud and virtualization platforms."
msgstr "Network configuration - This config source informs the system about the network settings like IP addresses, routes, DNS. Available only in several cloud and virtualization platforms."
-#: ../../automation/cloud-init.rst:248
+#: ../../automation/cloud-init.rst:251
msgid "Networking configurations shouldn't be passed in user-data file."
msgstr "Networking configurations shouldn't be passed in user-data file."
-#: ../../automation/cloud-init.rst:178
+#: ../../automation/cloud-init.rst:182
msgid "NoCloud"
msgstr "NoCloud"
@@ -843,15 +855,15 @@ msgstr "NoCloud"
msgid "Nornir"
msgstr "Nornir"
-#: ../../automation/cloud-init.rst:131
+#: ../../automation/cloud-init.rst:135
msgid "Note that the /opt/vyatta/etc/config is used instead of the /config/scripts directory referenced in the :ref:`command-scripting` section of the documentation because the /config/script directory isn't mounted when the ``write_files`` module executes."
msgstr "Note that the /opt/vyatta/etc/config is used instead of the /config/scripts directory referenced in the :ref:`command-scripting` section of the documentation because the /config/script directory isn't mounted when the ``write_files`` module executes."
-#: ../../automation/cloud-init.rst:370
+#: ../../automation/cloud-init.rst:373
msgid "Notes for this particular example, that may need to be modified in other setups:"
msgstr "Notes for this particular example, that may need to be modified in other setups:"
-#: ../../automation/cloud-init.rst:287
+#: ../../automation/cloud-init.rst:290
msgid "Now, that file needs to be copied to proxmox server:"
msgstr "Now, that file needs to be copied to proxmox server:"
@@ -859,15 +871,15 @@ msgstr "Now, that file needs to be copied to proxmox server:"
msgid "On VyOS this will cause the following problem: After modifying the configuration via script like this once, it is not possible to manually modify the config anymore:"
msgstr "On VyOS this will cause the following problem: After modifying the configuration via script like this once, it is not possible to manually modify the config anymore:"
-#: ../../automation/cloud-init.rst:390
+#: ../../automation/cloud-init.rst:393
msgid "On proxmox server:"
msgstr "On proxmox server:"
-#: ../../automation/cloud-init.rst:353
+#: ../../automation/cloud-init.rst:356
msgid "Once the three files were created, it's time to generate the ``seed.iso`` image, which needs to be mounted to the new VM as a cd."
msgstr "Once the three files were created, it's time to generate the ``seed.iso`` image, which needs to be mounted to the new VM as a cd."
-#: ../../automation/cloud-init.rst:80
+#: ../../automation/cloud-init.rst:81
msgid "One command per line."
msgstr "One command per line."
@@ -896,7 +908,7 @@ msgstr "Please take a look at the Contributing Guide for our :ref:`documentation
msgid "Postconfig on boot"
msgstr "Postconfig on boot"
-#: ../../automation/cloud-init.rst:409
+#: ../../automation/cloud-init.rst:412
msgid "Power on VM and verifications"
msgstr "Power on VM and verifications"
@@ -916,15 +928,15 @@ msgstr "Preparation steps for deploying VyOS on Azure"
msgid "Preparation steps for deploying VyOS on vSphere"
msgstr "Preparation steps for deploying VyOS on vSphere"
-#: ../../automation/cloud-init.rst:296
+#: ../../automation/cloud-init.rst:299
msgid "Prepare cloud-init files"
msgstr "Prepare cloud-init files"
-#: ../../automation/cloud-init.rst:258
+#: ../../automation/cloud-init.rst:261
msgid "Proxmox IP address: **192.168.0.253/24**"
msgstr "Proxmox IP address: **192.168.0.253/24**"
-#: ../../automation/cloud-init.rst:422
+#: ../../automation/cloud-init.rst:425
msgid "Proxmox `Cloud-init-Support`_."
msgstr "Proxmox `Cloud-init-Support`_."
@@ -936,11 +948,11 @@ msgstr "PyVyOS"
msgid "PyVyOS is a Python library for interacting with VyOS devices via their API. This documentation guides you on using PyVyOS to manage your VyOS devices programmatically. The complete PyVyOS documentation is available on [Read the Docs](https://pyvyos.readthedocs.io/en/latest/), and the library can be found on [GitHub](https://github.com/robertoberto/pyvyos) and [PyPI](https://pypi.org/project/pyvyos/)."
msgstr "PyVyOS is a Python library for interacting with VyOS devices via their API. This documentation guides you on using PyVyOS to manage your VyOS devices programmatically. The complete PyVyOS documentation is available on [Read the Docs](https://pyvyos.readthedocs.io/en/latest/), and the library can be found on [GitHub](https://github.com/robertoberto/pyvyos) and [PyPI](https://pypi.org/project/pyvyos/)."
-#: ../../automation/cloud-init.rst:416
+#: ../../automation/cloud-init.rst:419
msgid "References"
msgstr "References"
-#: ../../automation/cloud-init.rst:263
+#: ../../automation/cloud-init.rst:266
msgid "Remove default dhcp client on first interface, and load other configuration during first boot, using cloud-init."
msgstr "Remove default dhcp client on first interface, and load other configuration during first boot, using cloud-init."
@@ -968,7 +980,7 @@ msgstr "Run configuration commands"
msgid "Run operational commands"
msgstr "Run operational commands"
-#: ../../automation/cloud-init.rst:111
+#: ../../automation/cloud-init.rst:115
msgid "SSH is configured on port 22."
msgstr "SSH is configured on port 22."
@@ -980,11 +992,11 @@ msgstr "Salt"
msgid "Salt master configuration:"
msgstr "Salt master configuration:"
-#: ../../automation/vyos-api.rst:345
+#: ../../automation/vyos-api.rst:377
msgid "Save a running configuration to a file."
msgstr "Save a running configuration to a file."
-#: ../../automation/vyos-api.rst:327
+#: ../../automation/vyos-api.rst:359
msgid "Save a running configuration to the startup configuration. When you don't specify the file when saving, it saves to ``/config/config.boot``."
msgstr "Save a running configuration to the startup configuration. When you don't specify the file when saving, it saves to ``/config/config.boot``."
@@ -1030,7 +1042,7 @@ msgstr "Start"
msgid "Start creating an AWS instance and check the result"
msgstr "Start creating an AWS instance and check the result"
-#: ../../automation/cloud-init.rst:260
+#: ../../automation/cloud-init.rst:263
msgid "Storaged used: volume local, which is mounted on directory **/var/lib/vz**, and contains all type of content, including snippets."
msgstr "Storaged used: volume local, which is mounted on directory **/var/lib/vz**, and contains all type of content, including snippets."
@@ -1081,7 +1093,7 @@ msgstr "Structure of files Terrafom for vSphere"
msgid "Structure of files in the standard Terraform project:"
msgstr "Structure of files in the standard Terraform project:"
-#: ../../automation/cloud-init.rst:107
+#: ../../automation/cloud-init.rst:111
msgid "System Defaults/Fallbacks"
msgstr "System Defaults/Fallbacks"
@@ -1099,7 +1111,7 @@ msgstr "Terraform doesn't connect via SSH to your Ansible instance: you have to
msgid "Terraform for VyOS"
msgstr "Terraform for VyOS"
-#: ../../automation/vyos-api.rst:302
+#: ../../automation/vyos-api.rst:334
msgid "The API pushes every request to a session and commit it. But some of VyOS components like DHCP and PPPoE Servers, IPSec, VXLAN, and other tunnels require full configuration for commit. The endpoint will process multiple commands when you pass them as a list to the ``data`` field."
msgstr "The API pushes every request to a session and commit it. But some of VyOS components like DHCP and PPPoE Servers, IPSec, VXLAN, and other tunnels require full configuration for commit. The endpoint will process multiple commands when you pass them as a list to the ``data`` field."
@@ -1111,23 +1123,23 @@ msgstr "The ``/config/scripts/vyos-postconfig-bootup.script`` script is called o
msgid "The ``/config/scripts/vyos-preconfig-bootup.script`` script is called on boot before the VyOS configuration during boot process."
msgstr "The ``/config/scripts/vyos-preconfig-bootup.script`` script is called on boot before the VyOS configuration during boot process."
-#: ../../automation/vyos-api.rst:224
+#: ../../automation/vyos-api.rst:256
msgid "The ``/show`` endpoint is to show everything in the operational mode."
msgstr "The ``/show`` endpoint is to show everything in the operational mode."
-#: ../../automation/vyos-api.rst:248
+#: ../../automation/vyos-api.rst:280
msgid "The ``generate`` endpoint run a ``generate`` command."
msgstr "The ``generate`` endpoint run a ``generate`` command."
-#: ../../automation/vyos-api.rst:131
+#: ../../automation/vyos-api.rst:163
msgid "The ``reset`` endpoint run a ``reset`` command."
msgstr "The ``reset`` endpoint run a ``reset`` command."
-#: ../../automation/cloud-init.rst:84
+#: ../../automation/cloud-init.rst:85
msgid "The commands list produced by the ``show configuration commands`` command on a VyOS router should comply with all the requirements, so it is easy to get a proper commands list by copying it from another router."
msgstr "The commands list produced by the ``show configuration commands`` command on a VyOS router should comply with all the requirements, so it is easy to get a proper commands list by copying it from another router."
-#: ../../automation/cloud-init.rst:88
+#: ../../automation/cloud-init.rst:89
msgid "The configuration specified in the cloud-config document overwrites default configuration values and values configured via Metadata."
msgstr "The configuration specified in the cloud-config document overwrites default configuration values and values configured via Metadata."
@@ -1144,23 +1156,23 @@ msgstr "The default file looks like this:"
msgid "The easiest way to configure the system via user-data is the Cloud-config syntax described below."
msgstr "The easiest way to configure the system via user-data is the Cloud-config syntax described below."
-#: ../../automation/vyos-api.rst:325
+#: ../../automation/vyos-api.rst:357
msgid "The endpoint ``/config-file`` is to save or load a configuration."
msgstr "The endpoint ``/config-file`` is to save or load a configuration."
-#: ../../automation/cloud-init.rst:156
+#: ../../automation/cloud-init.rst:160
msgid "The following example sets the hostname based on the instance identifier obtained from the EC2 metadata service."
msgstr "The following example sets the hostname based on the instance identifier obtained from the EC2 metadata service."
-#: ../../automation/cloud-init.rst:136
+#: ../../automation/cloud-init.rst:140
msgid "The following example shows how to execute commands after the initial configuration."
msgstr "The following example shows how to execute commands after the initial configuration."
-#: ../../automation/cloud-init.rst:74
+#: ../../automation/cloud-init.rst:75
msgid "The key used to designate a VyOS configuration is ``vyos_config_commands``. What follows is VyOS configuration using the \"set-style\" syntax. Both \"set\" and \"delete\" commands are supported."
msgstr "The key used to designate a VyOS configuration is ``vyos_config_commands``. What follows is VyOS configuration using the \"set-style\" syntax. Both \"set\" and \"delete\" commands are supported."
-#: ../../automation/cloud-init.rst:197
+#: ../../automation/cloud-init.rst:201
msgid "The seed.iso file can be attached to the virtual machine. As an example, the method with KVM to attach the ISO as a CD drive follows."
msgstr "The seed.iso file can be attached to the virtual machine. As an example, the method with KVM to attach the ISO as a CD drive follows."
@@ -1168,7 +1180,7 @@ msgstr "The seed.iso file can be attached to the virtual machine. As an example,
msgid "There is a pitfall when working with configuration scripts. It is tempting to call configuration scripts with \"sudo\" (i.e., temporary root permissions), because that's the common way on most Linux platforms to call system commands."
msgstr "There is a pitfall when working with configuration scripts. It is tempting to call configuration scripts with \"sudo\" (i.e., temporary root permissions), because that's the common way on most Linux platforms to call system commands."
-#: ../../automation/cloud-init.rst:109
+#: ../../automation/cloud-init.rst:113
msgid "These are the VyOS defaults and fallbacks."
msgstr "These are the VyOS defaults and fallbacks."
@@ -1180,11 +1192,11 @@ msgstr "This section needs improvements, examples and explanations."
msgid "This will result in the following error message: ``Set failed`` If this happens, a reboot is required to be able to edit the config manually again."
msgstr "This will result in the following error message: ``Set failed`` If this happens, a reboot is required to be able to edit the config manually again."
-#: ../../automation/vyos-api.rst:361
+#: ../../automation/vyos-api.rst:393
msgid "To Load a configuration file."
msgstr "To Load a configuration file."
-#: ../../automation/vyos-api.rst:186
+#: ../../automation/vyos-api.rst:218
msgid "To add or delete an image, use the ``/image`` endpoint."
msgstr "To add or delete an image, use the ``/image`` endpoint."
@@ -1192,6 +1204,10 @@ msgstr "To add or delete an image, use the ``/image`` endpoint."
msgid "To avoid these problems, the proper way is to call a script with the ``vyattacfg`` group, e.g., by using the ``sg`` (switch group) command:"
msgstr "To avoid these problems, the proper way is to call a script with the ``vyattacfg`` group, e.g., by using the ``sg`` (switch group) command:"
+#: ../../automation/vyos-api.rst:128
+msgid "To check existence of a configuration path, use the ``exists`` operation."
+msgstr "To check existence of a configuration path, use the ``exists`` operation."
+
#: ../../automation/vyos-api.rst:48
msgid "To get the whole configuration, pass an empty list to the ``path`` field"
msgstr "To get the whole configuration, pass an empty list to the ``path`` field"
@@ -1200,7 +1216,7 @@ msgstr "To get the whole configuration, pass an empty list to the ``path`` field
msgid "To include VyOS specific functions and aliases you need to ``source /opt/vyatta/etc/functions/script-template`` files at the top of your script."
msgstr "To include VyOS specific functions and aliases you need to ``source /opt/vyatta/etc/functions/script-template`` files at the top of your script."
-#: ../../automation/vyos-api.rst:149
+#: ../../automation/vyos-api.rst:181
msgid "To initiate a reboot use the ``reboot`` endpoint."
msgstr "To initiate a reboot use the ``reboot`` endpoint."
@@ -1212,11 +1228,11 @@ msgstr "To make sure that a script is not accidentally called without the ``vyat
msgid "To only get a part of the configuration, for example ``system syslog``."
msgstr "To only get a part of the configuration, for example ``system syslog``."
-#: ../../automation/vyos-api.rst:167
+#: ../../automation/vyos-api.rst:199
msgid "To power off the system use the ``poweroff`` endpoint."
msgstr "To power off the system use the ``poweroff`` endpoint."
-#: ../../automation/cloud-init.rst:223
+#: ../../automation/cloud-init.rst:226
#: ../../automation/terraform/terraformAWS.rst:264
msgid "Troubleshooting"
msgstr "Troubleshooting"
@@ -1236,6 +1252,10 @@ msgid "User-data"
msgstr "User-data"
#: ../../automation/cloud-init.rst:28
+msgid "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
+msgstr "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
+
+#: ../../automation/cloud-init.rst:28
msgid "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
msgstr "User-data - User-data is specified by the user. This config source offers the ability to insert any CLI configuration commands into the configuration before the first boot."
@@ -1251,15 +1271,15 @@ msgstr "Using PyVyOS"
msgid "Using pyvyos"
msgstr "Using pyvyos"
-#: ../../automation/cloud-init.rst:373
+#: ../../automation/cloud-init.rst:376
msgid "VM ID: in this example, VM ID used is 555."
msgstr "VM ID: in this example, VM ID used is 555."
-#: ../../automation/cloud-init.rst:381
+#: ../../automation/cloud-init.rst:384
msgid "VM Resources: these parameters can be modified as needed."
msgstr "VM Resources: these parameters can be modified as needed."
-#: ../../automation/cloud-init.rst:375
+#: ../../automation/cloud-init.rst:378
msgid "VM Storage: ``local`` volume is used."
msgstr "VM Storage: ``local`` volume is used."
@@ -1279,7 +1299,7 @@ msgstr "VyOS Automation"
msgid "VyOS Terraform"
msgstr "VyOS Terraform"
-#: ../../automation/cloud-init.rst:418
+#: ../../automation/cloud-init.rst:421
msgid "VyOS `cloud-init-docs`_."
msgstr "VyOS `cloud-init-docs`_."
@@ -1287,7 +1307,7 @@ msgstr "VyOS `cloud-init-docs`_."
msgid "VyOS cloud-init"
msgstr "VyOS cloud-init"
-#: ../../automation/cloud-init.rst:246
+#: ../../automation/cloud-init.rst:249
msgid "VyOS configuration commands are defined in user-data file."
msgstr "VyOS configuration commands are defined in user-data file."
@@ -1331,7 +1351,7 @@ msgstr "VyOS supports op-mode and configuration via salt_."
msgid "VyOS supports some napalm_ functions for configuration and op-mode. It requires more tests."
msgstr "VyOS supports some napalm_ functions for configuration and op-mode. It requires more tests."
-#: ../../automation/cloud-init.rst:122
+#: ../../automation/cloud-init.rst:126
msgid "VyOS supports the execution of operational commands and linux commands at initial boot. This is accomplished using ``write_files`` to certain files in the /opt/vyatta/etc/config/scripts directory. Commands specified in opt/vyatta/etc/config/scripts/vyos-preconfig-bootup.script are executed prior to configuration. The /opt/vyatta/etc/config/scripts/vyos-postconfig-bootup.script file contains commands to be executed after configuration. In both cases, commands are executed as the root user."
msgstr "VyOS supports the execution of operational commands and linux commands at initial boot. This is accomplished using ``write_files`` to certain files in the /opt/vyatta/etc/config/scripts directory. Commands specified in opt/vyatta/etc/config/scripts/vyos-preconfig-bootup.script are executed prior to configuration. The /opt/vyatta/etc/config/scripts/vyos-postconfig-bootup.script file contains commands to be executed after configuration. In both cases, commands are executed as the root user."
@@ -1339,7 +1359,7 @@ msgstr "VyOS supports the execution of operational commands and linux commands a
msgid "We need 2 files, commands.conf and script itself."
msgstr "We need 2 files, commands.conf and script itself."
-#: ../../automation/cloud-init.rst:184
+#: ../../automation/cloud-init.rst:188
msgid "While other methods exist, the most straightforward method for using the NoCloud data source is creating a seed ISO and attaching it to the virtual machine as a CD drive. The volume must be formatted as a vfat or ISO 9660 file system with the label \"cidata\" or \"CIDATA\"."
msgstr "While other methods exist, the most straightforward method for using the NoCloud data source is creating a seed ISO and attaching it to the virtual machine as a CD drive. The volume must be formatted as a vfat or ISO 9660 file system with the label \"cidata\" or \"CIDATA\"."
@@ -1391,27 +1411,27 @@ msgstr "You can install PyVyOS using pip:"
msgid "You can install pyvyos using pip:"
msgstr "You can install pyvyos using pip:"
-#: ../../automation/vyos-api.rst:268
+#: ../../automation/vyos-api.rst:300
msgid "You can pass a ``set``, ``delete`` or ``comment`` command to the ``/configure`` endpoint."
msgstr "You can pass a ``set``, ``delete`` or ``comment`` command to the ``/configure`` endpoint."
-#: ../../automation/vyos-api.rst:287
+#: ../../automation/vyos-api.rst:319
msgid "``delete`` a single command"
msgstr "``delete`` a single command"
-#: ../../automation/cloud-init.rst:383
+#: ../../automation/cloud-init.rst:386
msgid "``seed.iso`` was previously created in directory ``/tmp/``. It's necessary to move it to ``/var/lib/vz/template/iso``"
msgstr "``seed.iso`` was previously created in directory ``/tmp/``. It's necessary to move it to ``/var/lib/vz/template/iso``"
-#: ../../automation/vyos-api.rst:271
+#: ../../automation/vyos-api.rst:303
msgid "``set`` a single command"
msgstr "``set`` a single command"
-#: ../../automation/cloud-init.rst:55
+#: ../../automation/cloud-init.rst:56
msgid "``vyos_userdata`` - the module accepts a list of CLI configuration commands in a ``vyos_config_commands`` section, which gives an easy way to configure the system during deployment."
msgstr "``vyos_userdata`` - the module accepts a list of CLI configuration commands in a ``vyos_config_commands`` section, which gives an easy way to configure the system during deployment."
-#: ../../automation/cloud-init.rst:112
+#: ../../automation/cloud-init.rst:116
msgid "``vyos``/``vyos`` credentials if no others specified by data source."
msgstr "``vyos``/``vyos`` credentials if no others specified by data source."
@@ -1431,7 +1451,7 @@ msgstr "`pyvyos Source Code on GitHub <https://github.com/robertoberto/pyvyos>`_
msgid "`pyvyos on PyPI <https://pypi.org/project/pyvyos/>`_ for easy installation via pip, the Python package installer. Execute `pip install pyvyos` in your terminal to install."
msgstr "`pyvyos on PyPI <https://pypi.org/project/pyvyos/>`_ for easy installation via pip, the Python package installer. Execute `pip install pyvyos` in your terminal to install."
-#: ../../automation/vyos-api.rst:188
+#: ../../automation/vyos-api.rst:220
msgid "add an image"
msgstr "add an image"
@@ -1446,11 +1466,11 @@ msgstr "all"
msgid "ansible.cfg"
msgstr "ansible.cfg"
-#: ../../automation/cloud-init.rst:61
+#: ../../automation/cloud-init.rst:62
msgid "cloud-config file format"
msgstr "cloud-config file format"
-#: ../../automation/cloud-init.rst:229
+#: ../../automation/cloud-init.rst:232
msgid "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in determining why the configuration varies from what you expect. You can fetch the most important data filtering output for ``vyos`` keyword:"
msgstr "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in determining why the configuration varies from what you expect. You can fetch the most important data filtering output for ``vyos`` keyword:"
@@ -1458,7 +1478,7 @@ msgstr "cloud-init logs to /var/log/cloud-init.log. This file can be helpful in
msgid "commands.txt"
msgstr "commands.txt"
-#: ../../automation/vyos-api.rst:205
+#: ../../automation/vyos-api.rst:237
msgid "delete an image, for example ``1.3-rolling-202006070117``"
msgstr "delete an image, for example ``1.3-rolling-202006070117``"
@@ -1550,6 +1570,10 @@ msgstr "variables.tf"
msgid "versions.tf"
msgstr "versions.tf"
+#: ../../automation/vyos-api.rst:145
+msgid "versus a non-existent path:"
+msgstr "versus a non-existent path:"
+
#: ../../automation/terraform/terraformAWS.rst:300
#: ../../automation/terraform/terraformAZ.rst:95
#: ../../automation/terraform/terraformvSphere.rst:98