Skip to content

Commit 522a242

Browse files
authored
Update custom-data.md
1 parent 52a1156 commit 522a242

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

articles/virtual-machines/custom-data.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Custom data is only made available to the VM during first boot/initial setup, we
2121
## Passing custom data to the VM
2222
To use custom data, you must base64 encode the contents first before passing it to the API, unless you are using a CLI tool that does the conversion for you, such as AZ CLI. The size cannot exceed 64 KB.
2323

24-
This is a CLI example, where you can pass your custom data as a file, and it will be converted to base64.
24+
In CLI, you can pass your custom data as a file, and it will be converted to base64.
2525
```bash
2626
az vm create \
2727
--resource-group myResourceGroup \
@@ -63,23 +63,23 @@ Custom data is placed in %SYSTEMDRIVE%\AzureData\CustomData.bin as a binary file
6363
On Linux OS's, custom data is passed to the VM via the ovf-env.xml file, which is copied to the /var/lib/waagent directory during provisioning. Newer versions of the Microsoft Azure Linux Agent will also copy the base64-encoded data to /var/lib/waagent/CustomData as well for convenience.
6464

6565
Azure currently supports two provisioning agents:
66-
* Linux Agent - By default the agent will not process custom data, you will need to build a custom image with this enabled. These are the relevant settings, as per the [documentation](https://github.com/Azure/WALinuxAgent#configuration):
66+
* Linux Agent - By default the agent will not process custom data, you will need to build a custom image with it enabled. These are the relevant settings, as per the [documentation](https://github.com/Azure/WALinuxAgent#configuration):
6767
* Provisioning.DecodeCustomData
6868
* Provisioning.ExecuteCustomData
6969

7070
When you enable custom data, and execute a script, it will delay the VM reporting that is it ready or that provisioning has succeeded until the script has completed. If the script exceeds the total VM provisioning time allowance of 40 mins, the VM Create will fail. Note, if the script fails to execute, or errors during executing, this is not deemed a fatal provisioning failure, you will need to create a notification path to alert you for the completion state of the script.
7171

7272
To troubleshoot custom data execution, review */var/log/waagent.log*
7373

74-
* cloud-init - By default will process custom data by default, cloud-init accepts [multiple formats](https://cloudinit.readthedocs.io/en/latest/topics/format.html) of custom data, such as cloud-init configuration, scripts etc. Similar to the Linux Agent, when cloud-init processes the custom data. If there are errors during execution of the configuration processing or scripts, this is not deemed a fatal provisioning failure, and you will need to create a notification path to alert you for the completion state of the script. However, different to the Linux Agent, cloud-init does not wait on user custom data configurations to complete before reporting to the platform that the VM is ready. For more information on cloud-init on azure, please review the [documentation](https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init).
74+
* cloud-init - By default will process custom data by default, cloud-init accepts [multiple formats](https://cloudinit.readthedocs.io/en/latest/topics/format.html) of custom data, such as cloud-init configuration, scripts etc. Similar to the Linux Agent, when cloud-init processes the custom data. If there are errors during execution of the configuration processing or scripts, this is not deemed a fatal provisioning failure, and you will need to create a notification path to alert you for the completion state of the script. However, different to the Linux Agent, cloud-init does not wait on user custom data configurations to complete before reporting to the platform that the VM is ready. For more information on cloud-init on azure, review the [documentation](https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init).
7575

7676

7777
To troubleshoot custom data execution, review the troubleshooting [documentation](https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init#troubleshooting-cloud-init).
7878

7979

8080
## FAQ
8181
### Can I update custom data after the VM has been created?
82-
For single VMs, custom data in the VM model cannot be updated, but for VMSS, you can update VMSS custom data via REST API (this does not work for the PS or AZ CLI clients). When you update custom data in the VMSS model, this will happen:
82+
For single VMs, custom data in the VM model cannot be updated, but for VMSS, you can update VMSS custom data via REST API (this will not work for the PS or AZ CLI clients). When you update custom data in the VMSS model, this will happen:
8383
* Existing instances in the VMSS will not get the updated custom data, only until they are reimaged.
8484
* Existing instances in the VMSS that are upgraded will not get the updated custom data.
8585
* New instances will receive the new custom data.
@@ -88,4 +88,4 @@ For single VMs, custom data in the VM model cannot be updated, but for VMSS, you
8888
<We need to get a CELA answer for this>
8989

9090
### Is custom data made available in IMDS?
91-
No, this not currently available.
91+
No, this is not currently available.

0 commit comments

Comments
 (0)