Skip to content

Commit 3b4c01c

Browse files
updated customer facing wording
1 parent 72e3dba commit 3b4c01c

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

articles/virtual-machines/linux/image-builder-troubleshoot.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,39 @@ The template already exists.
8888

8989
If you submit an image configuration template and the submission fails, a failed template artifact still exists. Delete the failed template.
9090

91+
### Updating or resetting MSI on image templates
92+
93+
#### Error
94+
95+
```text
96+
The assigned managed identity cannot be used. Please re-assign an identity. For more troubleshooting steps go to https://aka.ms/azvmimagebuilderts
97+
```
98+
99+
#### Cause
100+
101+
There are cases where [Managed Service Identities (MSI)](/azure/virtual-machines/linux/image-builder-permissions-cli#create-a-user-assigned-managed-identity) assigned to the image template cannot be used:
102+
103+
1. MSI is deleted before the image template is deleted (custom rg scenario)
104+
1. MSI credentials URL is lost and therefore can't get credentials for the MSI
105+
1. Other cases where the assigned MSI doesn't work
106+
107+
108+
#### Solution
109+
110+
Use Azure CLI to reset identity on the image template. Ensure you [update](/azure/update-azure-cli) Azure CLI to the latest 2.45.0 version.
111+
112+
Remove the managed identity from the target image builder template
113+
114+
```azurecli-interactive
115+
az image bulider identity remove -g <template rg> -n <template name> -- user-assigned <identity resource id>
116+
```
117+
118+
Re-assign identity to the target image builder template
119+
120+
```azurecli-interactive
121+
az image bulider identity assign -g <template rg> -n <template name> -- user-assigned <identity resource id>
122+
```
123+
91124
### The resource operation finished with a terminal provisioning state of "Failed"
92125

93126
#### Error

0 commit comments

Comments
 (0)