Skip to content

[docs] Pin AKS credential command to the deployment subscription #1476

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aspire-repo-bot wants to merge 2 commits into
base: release/13.5
Choose a base branch
from
+6 −2
Open

[docs] Pin AKS credential command to the deployment subscription #1476

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9857f09
docs: pin AKS credential command to deployment subscription
aspire-repo-bot[bot] Aug 12, 2026
94a368c
Apply suggestions from code review
IEvangelist Aug 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 6 additions & 2 deletions src/frontend/src/content/docs/deployment/kubernetes/aks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -568,12 +568,16 @@ See [Install external Helm charts](/deployment/kubernetes/helm-charts/) for a fu

### AKS cluster not reachable after deploy

After `aspire deploy` provisions the AKS cluster, your local `kubectl` context is configured automatically. If you can't reach the cluster, ensure your Azure CLI session is active and fetch credentials:
After `aspire deploy` provisions the AKS cluster, your local `kubectl` context is configured automatically. If you can't reach the cluster, ensure your Azure CLI session is active and then manually fetch the right credentials, pinning the request to the subscription you deployed to:

```bash title="Get AKS credentials"
az aks get-credentials --resource-group <resource-group> --name <cluster-name>
az aks get-credentials --resource-group <resource-group> --name <cluster-name> --subscription <subscription-id>
```

<Aside type="tip">
Always pass `--subscription` explicitly when fetching credentials manually. In multi-subscription tenants or CI agents, your Azure CLI's default subscription often differs from the one Aspire deployed to. For this reason, running `az aks get-credentials` without `--subscription` can fail with a confusing "cluster not found" error. Alternatively, it can silently fetch credentials for a same-named cluster in a different subscription, which can be even more difficult to troubleshoot. You can check your default subscription by running `az account show`. The exact reconnect command, including the `--subscription` option, is printed in the deploy summary output under **🔑 Connect to cluster**.
</Aside>

### Image pull failures

If pods fail with `ImagePullBackOff`, verify that the AKS cluster has the correct role assignment to pull from the provisioned ACR:
Expand Down
Loading