# Azure Icons Setup Complete

## ✅ Setup Summary

Azure Architecture Icons have been set up as common assets in the project.

## Directory Structure

```
assets/
├── azure-icons/          # Azure Architecture Icons
│   ├── svg/             # SVG format icons (recommended)
│   ├── png/             # PNG format icons (for presentations)
│   └── metadata/        # Icon metadata and catalogs
├── diagrams/            # Architecture diagrams
│   ├── architecture/    # Architecture diagrams
│   ├── network/         # Network topology diagrams
│   ├── deployment/      # Deployment diagrams
│   └── templates/       # Diagram templates
├── stencils/            # Draw.io stencils
└── logos/               # Project and partner logos
```

## Quick Start

### 1. Setup Assets Directory

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

### 2. Download Azure Icons

```bash
make -f Makefile.assets download-icons
```

This will download:
- SVG icons to `assets/azure-icons/svg/`
- PNG icons to `assets/azure-icons/png/`
- Metadata to `assets/azure-icons/metadata/`

### 3. Create Draw.io Stencil

```bash
make -f Makefile.assets create-stencil
```

## Using Icons

### In Draw.io / diagrams.net

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
5. Icons will appear in the left panel

### In Documentation

```markdown
![Azure Kubernetes Service](assets/azure-icons/svg/Icon-service-kubernetes-Azure.svg)
```

### In Presentations

Use PNG icons for presentations:
```markdown
![Azure Kubernetes Service](assets/azure-icons/png/Icon-service-kubernetes-Azure.png)
```

## Common Icons

### Compute
- Azure Kubernetes Service (AKS): `Icon-service-kubernetes-Azure.svg`
- Virtual Machines: `Icon-service-virtual-machine-Azure.svg`
- Container Instances: `Icon-service-container-instances-Azure.svg`

### Networking
- Virtual Network: `Icon-service-virtual-network-Azure.svg`
- Application Gateway: `Icon-service-application-gateway-Azure.svg`
- Load Balancer: `Icon-service-load-balancer-Azure.svg`
- Network Security Group: `Icon-service-network-security-group-Azure.svg`

### Storage
- Storage Account: `Icon-service-storage-accounts-Azure.svg`
- Blob Storage: `Icon-service-blob-storage-Azure.svg`
- File Shares: `Icon-service-file-shares-Azure.svg`

### Security
- Key Vault: `Icon-service-key-vaults-Azure.svg`
- Azure Active Directory: `Icon-service-azure-active-directory-Azure.svg`
- Security Center: `Icon-service-security-center-Azure.svg`

### Management
- Resource Groups: `Icon-service-resource-groups-Azure.svg`
- Management Groups: `Icon-service-management-groups-Azure.svg`
- Monitor: `Icon-service-azure-monitor-Azure.svg`
- Log Analytics: `Icon-service-log-analytics-workspaces-Azure.svg`

## Icon Mapping

See `assets/azure-icons/metadata/icon-mapping.json` for complete icon mapping.

## Documentation

- [Assets Guide](docs/ASSETS_GUIDE.md) - Complete guide to using Azure icons
- [Architecture Diagrams Guide](docs/ARCHITECTURE_DIAGRAMS.md) - Creating architecture diagrams
- [Icon Catalog](azure-icons/metadata/icon-catalog.md) - Complete icon catalog
- [Download Instructions](azure-icons/metadata/download-instructions.md) - Download instructions
- [Usage Examples](azure-icons/metadata/icon-usage-examples.md) - Usage examples

## Scripts

- `scripts/assets/setup-assets.sh` - Setup assets directory structure
- `scripts/assets/download-azure-icons.sh` - Download Azure icons
- `scripts/assets/create-diagram-stencil.sh` - Create Draw.io stencil

## Makefile Targets

- `make -f Makefile.assets assets` - Setup assets directory
- `make -f Makefile.assets download-icons` - Download Azure icons
- `make -f Makefile.assets create-stencil` - Create Draw.io stencil
- `make -f Makefile.assets clean-assets` - Clean temporary files
- `make -f Makefile.assets install-assets` - Install all assets

## Official Sources

- **Official Page**: https://docs.microsoft.com/azure/architecture/icons/
- **Download**: Available via download script or manual download
- **Version**: V17 (latest as of 2024)
- **License**: Microsoft

## Next Steps

1. **Download Icons**: Run `make -f Makefile.assets download-icons`
2. **Review Icons**: Check `assets/azure-icons/svg/` for available icons
3. **Create Diagrams**: Use icons in architecture diagrams
4. **Update Documentation**: Include diagrams in documentation
5. **Share Assets**: Share icons with team members

## Troubleshooting

### Icons Not Downloading

If icons fail to download:
1. Check internet connection
2. Verify download URLs are correct
3. Visit https://docs.microsoft.com/azure/architecture/icons/ for latest URLs
4. Manually download from the official page

### Icons Not Displaying

If icons don't display in diagrams:
1. Verify icon files exist
2. Check file paths are correct
3. Verify file formats (SVG/PNG)
4. Check diagram tool compatibility

### Missing Icons

If specific icons are missing:
1. Check `assets/azure-icons/metadata/icon-mapping.json`
2. Verify icon files exist in the downloaded set
3. Download the latest icon set
4. Create custom icons if needed

## References

- [Azure Architecture Center](https://docs.microsoft.com/azure/architecture/)
- [Azure Architecture Icons](https://docs.microsoft.com/azure/architecture/icons/)
- [Icon Usage Guidelines](https://docs.microsoft.com/azure/architecture/icons/)
- [Azure Architecture Patterns](https://docs.microsoft.com/azure/architecture/patterns/)
- [Draw.io Documentation](https://www.diagrams.net/doc/)

## Status

✅ **Assets directory structure created**
✅ **Download scripts created**
✅ **Documentation created**
✅ **Stencils created**
✅ **Icon mapping created**
✅ **Ready for icon download**

## Quick Reference

### Download Icons
```bash
make -f Makefile.assets download-icons
```

### Icon Location
- SVG: `assets/azure-icons/svg/`
- PNG: `assets/azure-icons/png/`
- Metadata: `assets/azure-icons/metadata/`

### Official Download Page
https://docs.microsoft.com/azure/architecture/icons/

