# Azure Icons Assets - Quick Reference

## Quick Setup

```bash
# Setup assets directory
make -f Makefile.assets assets

# Download Azure icons
make -f Makefile.assets download-icons

# Create Draw.io stencil
make -f Makefile.assets create-stencil
```

## Icon Locations

- **SVG Icons**: `assets/azure-icons/svg/`
- **PNG Icons**: `assets/azure-icons/png/`
- **Metadata**: `assets/azure-icons/metadata/`

## Common Icons

| Service | SVG File |
|---------|----------|
| Azure Kubernetes Service | `Icon-service-kubernetes-Azure.svg` |
| Virtual Network | `Icon-service-virtual-network-Azure.svg` |
| Application Gateway | `Icon-service-application-gateway-Azure.svg` |
| Key Vault | `Icon-service-key-vaults-Azure.svg` |
| Storage Account | `Icon-service-storage-accounts-Azure.svg` |
| Load Balancer | `Icon-service-load-balancer-Azure.svg` |
| Network Security Group | `Icon-service-network-security-group-Azure.svg` |

## Using Icons

### In Draw.io
1. Open [Draw.io](https://app.diagrams.net/)
2. Click "More Shapes" → "+" → "From Device"
3. Navigate to `assets/azure-icons/svg/`
4. Select icons to import

### In Documentation
```markdown
../../assets/azure-icons/svg/<icon-file>.svg
```

### In Presentations
```markdown
../../assets/azure-icons/png/<icon-file>.png
```

## Finding Icons

### By Service Name
```bash
# Find AKS icon
find assets/azure-icons -name "*kubernetes*"

# Find Key Vault icon
find assets/azure-icons -name "*key-vault*"
```

### Using Icon Mapping
```bash
# View compute icons
cat assets/azure-icons/metadata/icon-mapping.json | jq '.icon_mapping.compute'

# View networking icons
cat assets/azure-icons/metadata/icon-mapping.json | jq '.icon_mapping.networking'
```

## Documentation

- [Assets Guide](ASSETS_GUIDE.md) - Complete guide
- [Architecture Diagrams Guide](../architecture/ARCHITECTURE_DIAGRAMS.md) - Creating diagrams
- [Icon Catalog](../../assets/azure-icons/metadata/icon-catalog.md) - Complete catalog
- [Download Instructions](../../assets/azure-icons/metadata/download-instructions.md) - Download guide

## Official Sources

- **Official Page**: https://docs.microsoft.com/azure/architecture/icons/
- **Version**: V17 (latest as of 2024)
- **License**: Microsoft

## Troubleshooting

### Icons Not Downloading
1. Check internet connection
2. Visit https://docs.microsoft.com/azure/architecture/icons/
3. Manually download if needed

### Icons Not Displaying
1. Verify icon files exist
2. Check file paths
3. Verify file formats (SVG/PNG)

### Missing Icons
1. Check `icon-mapping.json`
2. Download latest icon set
3. Create custom icons if needed

## Quick Commands

```bash
# Setup assets
make -f Makefile.assets assets

# Download icons
make -f Makefile.assets download-icons

# Create stencil
make -f Makefile.assets create-stencil

# Clean temporary files
make -f Makefile.assets clean-assets

# Install all assets
make -f Makefile.assets install-assets
```
