Skip to content

Commit 5e5642f

Browse files
authored
update WI migration doc
- Mention proxy is only supported for Linux containers. - Update YAML snippets to fix the labels and annotations
1 parent 0167f73 commit 5e5642f

File tree

1 file changed

+8
-5
lines changed

1 file changed

+8
-5
lines changed

articles/aks/workload-identity-migrate-from-pod-identity.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ If your cluster is already using the latest version of the Azure Identity SDK, p
3737

3838
If your cluster isn't using the latest version of the Azure Identity SDK, you have two options:
3939

40-
- You can use a migration sidecar that we provide within your applications, which proxies the IMDS transactions your application makes over to [OpenID Connect][openid-connect-overview] (OIDC). The migration sidecar isn't intended to be a long-term solution, but a way to get up and running quickly on workload identity. Perform the following steps to:
40+
- You can use a migration sidecar that we provide within your Linux applications, which proxies the IMDS transactions your application makes over to [OpenID Connect][openid-connect-overview] (OIDC). The migration sidecar isn't intended to be a long-term solution, but a way to get up and running quickly on workload identity. Perform the following steps to:
4141

4242
- [Deploy the workload with migration sidecar](#deploy-the-workload-with-migration-sidecar) to proxy the application IMDS transactions.
4343
- Verify the authentication transactions are completing successfully.
@@ -46,6 +46,7 @@ If your cluster isn't using the latest version of the Azure Identity SDK, you ha
4646

4747
> [!NOTE]
4848
> The migration sidecar is **not supported for production use**. This feature is meant to give you time to migrate your application SDK's to a supported version, and not meant or intended to be a long-term solution.
49+
> The migration sidecar is only for Linux containers as pod-managed identities was available on Linux node pools only.
4950
5051
- Rewrite your application to support the latest version of the [Azure Identity][azure-identity-supported-versions] client library. Afterwards, perform the following steps:
5152

@@ -95,8 +96,6 @@ kind: ServiceAccount
9596
metadata:
9697
annotations:
9798
azure.workload.identity/client-id: ${USER_ASSIGNED_CLIENT_ID}
98-
labels:
99-
azure.workload.identity/use: "true"
10099
name: ${SERVICE_ACCOUNT_NAME}
101100
namespace: ${SERVICE_ACCOUNT_NAMESPACE}
102101
EOF
@@ -123,6 +122,7 @@ az identity federated-credential create --name federatedIdentityName --identity-
123122

124123
> [!NOTE]
125124
> The migration sidecar is **not supported for production use**. This feature is meant to give you time to migrate your application SDK's to a supported version, and not meant or intended to be a long-term solution.
125+
> The migration sidecar is only for Linux containers as pod-managed identities was available on Linux node pools only.
126126
127127
If your application is using managed identity and still relies on IMDS to get an access token, you can use the workload identity migration sidecar to start migrating to workload identity. This sidecar is a migration solution and in the long-term applications, you should modify their code to use the latest Azure Identity SDKs that support client assertion.
128128

@@ -142,11 +142,14 @@ metadata:
142142
name: httpbin-pod
143143
labels:
144144
app: httpbin
145+
azure.workload.identity/use: "true"
146+
annotations:
147+
azure.workload.identity/inject-proxy-sidecar: "true"
145148
spec:
146149
serviceAccountName: workload-identity-sa
147150
initContainers:
148151
- name: init-networking
149-
image: mcr.microsoft.com/oss/azure/workload-identity/proxy-init:v0.13.0
152+
image: mcr.microsoft.com/oss/azure/workload-identity/proxy-init:v1.1.0
150153
securityContext:
151154
capabilities:
152155
add:
@@ -164,7 +167,7 @@ spec:
164167
ports:
165168
- containerPort: 80
166169
- name: proxy
167-
image: mcr.microsoft.com/oss/azure/workload-identity/proxy:v0.13.0
170+
image: mcr.microsoft.com/oss/azure/workload-identity/proxy:v1.1.0
168171
ports:
169172
- containerPort: 8000
170173
```

0 commit comments

Comments
 (0)