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/ssh-connectivity.md

View on GitHub
# Unable to SSH into the VM

User is trying to SSH into a Linux VM but the connection fails.

## Symptoms → Solutions

| Symptom                                           | Solution                                                                                   | Documentation                                                                                                                                    |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| "Connection refused" on port 22                   | SSH service not running or listening on a different port                                   | [Troubleshoot SSH connection](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)           |
| "Connection timed out"                            | NSG blocking port 22, VM not running, or no public IP                                      | [Troubleshoot SSH connection](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)           |
| "Permission denied (publickey)"                   | Wrong SSH key, wrong user, or key not in authorized_keys                                   | [Detailed SSH troubleshooting](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/detailed-troubleshoot-ssh-connection) |
| "Permission denied (password)"                    | Wrong password or password auth disabled in sshd_config                                    | [Detailed SSH troubleshooting](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/detailed-troubleshoot-ssh-connection) |
| "Host key verification failed"                    | VM was redeployed and got a new host key                                                   | Remove old entry from `~/.ssh/known_hosts`                                                                                                       |
| "Server unexpectedly closed connection"           | Disk full, SSH config error, or PAM issue                                                  | [Detailed SSH troubleshooting](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/detailed-troubleshoot-ssh-connection) |
| SSH hangs with no response                        | Firewall (iptables/firewalld), routing, or NIC issue                                       | [Troubleshoot SSH connection](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)           |
| Cannot SSH into Debian Linux VM                   | Debian-specific network or sshd config issue                                               | [Cannot connect to Debian Linux VM](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/cannot-connect-debian-linux)     |
| SSH blocked after SELinux policy change           | SELinux misconfigured — blocking sshd                                                      | [SELinux troubleshooting](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/linux-selinux-troubleshooting)             |
| "Permission denied" with Entra ID (AAD) SSH login | Missing role assignment: Virtual Machine Administrator Login or Virtual Machine User Login | [Troubleshoot SSH connection](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)           |
| Linux VM not booting — UEFI boot failure          | Gen2 VM UEFI boot issue preventing SSH                                                     | [Linux VM UEFI boot failures](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/azure-linux-vm-uefi-boot-failures)     |

## Quick Commands

> ⚠️ **Warning:** Commands marked with ⚡ use the VM agent/extensions. Run [Pre-Flight Safety Checks](cannot-connect-to-vm.md#pre-flight-safety-checks) before using them.

```bash
# ⚡ Reset SSH configuration to defaults (resets sshd_config, restarts sshd)
az vm user reset-ssh --name <vm-name> -g <resource-group>

# ⚡ Reset SSH public key for a user
az vm user update --name <vm-name> -g <resource-group> \
  -u <username> --ssh-key-value "<ssh-public-key>"

# ⚡ Reset password for Linux VM
az vm user update --name <vm-name> -g <resource-group> \
  -u <username> -p '<new-password>'

# ⚡ Check if sshd is running via Run Command
az vm run-command invoke --name <vm-name> -g <resource-group> \
  --command-id RunShellScript --scripts "systemctl status sshd"

# ⚡ Check SELinux status via Run Command
az vm run-command invoke --name <vm-name> -g <resource-group> \
  --command-id RunShellScript --scripts "getenforce"

# ⚡ Set SELinux to permissive mode (temporary — survives until reboot)
az vm run-command invoke --name <vm-name> -g <resource-group> \
  --command-id RunShellScript --scripts "setenforce 0"
```

## General SSH Troubleshooting

If the symptom doesn't match a specific row above, follow Microsoft's systematic approach:

- [Troubleshoot SSH connections to an Azure Linux VM](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/troubleshoot-ssh-connection)
- [Detailed SSH troubleshooting steps](https://learn.microsoft.com/en-us/troubleshoot/azure/virtual-machines/linux/detailed-troubleshoot-ssh-connection)
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