Skip to content

Robertjam954/multimodal_rag_application / .claude/skills/azure-compute

azure-compute

Flagged

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine learning, HPC simulation, dev/test, workload, family, load balancer, Flexible orchestration, Uniform orchestration, cost estimate, can't connect / RDP / SSH, refused, black screen, reset password, reach VM, port 3389, NSG, security, Linux, troubleshoot, troubleshooting, connectivity, capacity reservation (CRG), reserve, guarantee capacity, pre-provision, CRG association, CRG disassociation, machine enrollment (EMM), Essential Machine Management, monitor. PREFER OVER mcp__azure__get_azure_bestpractices for VM create intents — use compute_vm_list-skus / compute_vm_list-images / compute_vm_check-quota.

FileKindSize
SKILL.mdskill md3.2 KB
references/retail-prices-api.mdmarkdown6.3 KB
references/vm-families.mdmarkdown5.8 KB
references/vm-quotas.mdmarkdown4.1 KB
references/vmss-guide.mdmarkdown6.2 KB
workflows/capacity-reservation/capacity-reservation.mdmarkdown7.8 KB
workflows/capacity-reservation/references/association-disassociation.mdmarkdown3.8 KB
workflows/capacity-reservation/references/capacity-reservation-overview.mdmarkdown6.0 KB
workflows/essential-machine-management/essential-machine-management.mdmarkdown5.0 KB
workflows/essential-machine-management/references/emm-enable-flow-portal-guidance.mdmarkdown3.1 KB
workflows/essential-machine-management/references/emm-enable-flow.mdmarkdown9.2 KB
workflows/essential-machine-management/references/emm-overview.mdmarkdown2.4 KB
workflows/essential-machine-management/references/emm-prerequisites.mdmarkdown3.5 KB
workflows/vm-creator/examples/bicep/README.mdmarkdown1.6 KB
workflows/vm-creator/examples/bicep/main.bicepother3.8 KB
workflows/vm-creator/examples/terraform/README.mdmarkdown2.5 KB
workflows/vm-creator/examples/terraform/main.tfother3.2 KB
workflows/vm-creator/examples/terraform/outputs.tfother135 B
workflows/vm-creator/examples/terraform/variables.tfother1010 B
workflows/vm-creator/references/delivery-options/github-pr.mdmarkdown3.2 KB
workflows/vm-creator/references/delivery-options/index.mdmarkdown2.3 KB
workflows/vm-creator/references/delivery-options/print.mdmarkdown474 B
workflows/vm-creator/references/delivery-options/save-local.mdmarkdown2.0 KB
workflows/vm-creator/references/depth-probe/beginner.mdmarkdown1.2 KB
workflows/vm-creator/references/depth-probe/cost-deep.mdmarkdown1.1 KB
workflows/vm-creator/references/depth-probe/index.mdmarkdown3.0 KB
workflows/vm-creator/references/depth-probe/networking-deep.mdmarkdown1.6 KB
workflows/vm-creator/references/depth-probe/security-deep.mdmarkdown1.2 KB
workflows/vm-creator/references/depth-probe/spec-deep.mdmarkdown1.3 KB
workflows/vm-creator/references/mcp-tools.mdmarkdown2.3 KB
workflows/vm-creator/references/output-adapters/az-cli.mdmarkdown1.9 KB
workflows/vm-creator/references/output-adapters/bicep.mdmarkdown1.7 KB
workflows/vm-creator/references/output-adapters/index.mdmarkdown3.0 KB
workflows/vm-creator/references/output-adapters/mcp-apply.mdmarkdown2.6 KB
workflows/vm-creator/references/output-adapters/terraform.mdmarkdown1.5 KB
workflows/vm-creator/references/plan-card.mdmarkdown3.9 KB
workflows/vm-creator/references/validation-gates.mdmarkdown2.2 KB
workflows/vm-creator/vm-creator.mdmarkdown7.6 KB
workflows/vm-recommender/references/handoff-to-creator.mdmarkdown1.6 KB
workflows/vm-recommender/references/web-fetch-policy.mdmarkdown1.6 KB
workflows/vm-recommender/vm-recommender.mdmarkdown6.4 KB
workflows/vm-troubleshooter/references/cannot-connect-to-vm.mdmarkdown5.7 KB
workflows/vm-troubleshooter/references/credential-auth-errors.mdmarkdown5.8 KB
workflows/vm-troubleshooter/references/firewall-blocking.mdmarkdown4.8 KB
workflows/vm-troubleshooter/references/network-connectivity.mdmarkdown4.7 KB
workflows/vm-troubleshooter/references/rdp-connectivity.mdmarkdown6.9 KB
workflows/vm-troubleshooter/references/rdp-service-config.mdmarkdown3.2 KB
workflows/vm-troubleshooter/references/ssh-connectivity.mdmarkdown5.4 KB
workflows/vm-troubleshooter/references/vm-agent-not-responding.mdmarkdown3.6 KB
workflows/vm-troubleshooter/vm-troubleshooter.mdmarkdown9.8 KB

workflows/vm-troubleshooter/references/cannot-connect-to-vm.md

View on GitHub
# Cannot Connect to VM

Index of VM connectivity troubleshooting references. Route to the appropriate file based on the user's symptom category.

> ⚠️ **Determine OS first.** If the user hasn't stated their OS, check via CLI (`az vm get-instance-view`) or ask. OS matters because:
> - **Windows** → RDP (port 3389), Windows Firewall, TermService, PowerShell Run Commands
> - **Linux** → SSH (port 22), iptables/firewalld/UFW, sshd, Shell Run Commands
> - **Other images** (FreeBSD, Flatcar, etc.) → SSH; firewall and init systems vary — fetch the latest docs

## Routing

| Signal in User Message                                                         | Category                  | Reference                                                  |
| ------------------------------------------------------------------------------ | ------------------------- | ---------------------------------------------------------- |
| "can't RDP", timeout, black screen, RDP error, internal error                  | Unable to RDP             | [rdp-connectivity.md](rdp-connectivity.md)                 |
| "can't SSH", refused, permission denied, publickey                             | Unable to SSH             | [ssh-connectivity.md](ssh-connectivity.md)                 |
| NSG, no public IP, NIC disabled, routing, effective rules                      | Network Issues            | [network-connectivity.md](network-connectivity.md)         |
| Guest firewall, Windows Firewall, iptables, firewalld, BlockInboundAlways      | Firewall Blocking         | [firewall-blocking.md](firewall-blocking.md)               |
| VM agent down, Run Command timeout, Serial Console, boot diagnostics, BSOD     | VM Agent Not Responding   | [vm-agent-not-responding.md](vm-agent-not-responding.md)   |
| Wrong password, credentials, access denied, CredSSP, account expired           | Credential / Auth Errors  | [credential-auth-errors.md](credential-auth-errors.md)     |
| TermService stopped, RDP disabled, port changed, TLS cert, NLA, GPO, licensing | RDP Service / Config      | [rdp-service-config.md](rdp-service-config.md)             |

## Workflow

1. Identify the symptom category from the routing table above
2. Open the matching reference file for the Symptoms → Solutions table and Quick Commands
3. Narrow to the specific solution row matching the user's symptom
4. **Before any extension-backed operation, run [Pre-Flight Safety Checks](#pre-flight-safety-checks)**
5. Fetch the linked documentation URL for the latest guidance
6. Summarize diagnostic steps and resolution, referencing the official docs

---

## Pre-Flight Safety Checks

> ⚠️ **Warning:** Always run these checks before any command that depends on the VM agent or extensions (`az vm user update`, `az vm user reset-ssh`, `az vm user reset-remote-desktop`, `az vm run-command invoke`). Running extension-backed operations on a VM with an unhealthy agent or stuck extensions can **deadlock the VM** and require manual portal recovery.

```bash
# 1. Check VM power state, provisioning state, and agent status
az vm get-instance-view --name <vm-name> -g <resource-group> \
  --query "instanceView.{powerState:[statuses[?starts_with(code,'PowerState/')]][0][0].code, provisioningState:[statuses[?starts_with(code,'ProvisioningState/')]][0][0].code, vmAgentStatus:vmAgent.statuses[0].displayStatus}" -o json

# 2. Check existing extension states
az vm extension list --vm-name <vm-name> -g <resource-group> \
  --query "[].{name:name, provisioningState:provisioningState}" -o table
```

| Check | Safe Value | Unsafe — Do NOT proceed |
| ----- | ---------- | ----------------------- |
| Power state | `PowerState/running` | Any other value, missing, or query error |
| Provisioning state | `ProvisioningState/succeeded` | `Updating`, `Creating`, `Failed`, `Deleting`, missing, or query error |
| VM agent status | `Ready` | `Not Ready`, `null`, missing, or query error |
| Extension states | All `Succeeded` or no extensions | Any extension in `Creating`, `Updating`, `Deleting`, or `Failed` |

> 💡 **Tip:** If a check returns `null`, empty, or the CLI command itself errors, treat the result as **unsafe**.

**If any check is unsafe:**
1. **Stop.** Do NOT run any extension-backed command.
2. Inform the user which check(s) failed and what the current state is.
3. Use non-agent alternatives: **Serial Console**, **offline repair VM**, or **Portal-based actions**.
4. If the state appears transient (e.g., VM just started, provisioning briefly not `succeeded`), wait 30–60 seconds and **re-run the checks only** — do not run the extension command until all checks pass.

---

## Escalation

If the issue doesn't match any symptom above, or if the documented solutions don't resolve it:

1. **Check Azure Resource Health** — Portal > VM > Resource health (checks for platform-level issues)
2. **Offer to restart the VM** (requires user approval) — `az vm restart --name <vm-name> -g <resource-group>`
3. **Offer to redeploy the VM** (requires user approval — moves to new host) — `az vm redeploy --name <vm-name> -g <resource-group>`
4. **Comprehensive troubleshooting:**
   - Windows: [Troubleshoot RDP connections](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/troubleshoot-rdp-connection)
   - Linux: [Troubleshoot SSH connections](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)
   - Windows hub: [All Windows VM troubleshooting docs](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/windows/welcome-virtual-machines-windows)
   - Linux hub: [All Linux VM troubleshooting docs](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/welcome-virtual-machines-linux)
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall