# Azure Architecture Icons - Download Instructions

## Official Source

Azure Architecture Icons are provided by Microsoft and are available from:

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

## Download Methods

### Method 1: Automated Download (Recommended)

Use the provided script to download icons:

```bash
./scripts/assets/download-azure-icons.sh
```

This script will:
1. Create the assets directory structure
2. Download SVG icons
3. Download PNG icons
4. Extract icons to appropriate directories
5. Create icon catalog and metadata

### Method 2: Manual Download

1. Visit https://docs.microsoft.com/azure/architecture/icons/
2. Click "Download" to get the icon set
3. Extract the ZIP file
4. Copy SVG icons to `assets/azure-icons/svg/`
5. Copy PNG icons to `assets/azure-icons/png/`

### Method 3: GitHub Repository

Icons are also available from the Microsoft Cloud Adoption Framework repository:

```bash
# Clone the repository (large repository)
git clone https://github.com/microsoft/CloudAdoptionFramework.git

# Copy icons from the repository
cp -r CloudAdoptionFramework/ready/Azure-Icons/* assets/azure-icons/
```

## Icon Formats

### SVG (Recommended)
- **Format**: Scalable Vector Graphics
- **Use**: Diagrams, documentation, web
- **Advantages**: Scalable, small file size, editable
- **Location**: `assets/azure-icons/svg/`

### PNG
- **Format**: Portable Network Graphics
- **Use**: Presentations, documents
- **Advantages**: Compatible with all tools
- **Location**: `assets/azure-icons/png/`

## Icon Organization

Icons are organized by service category:
- Compute (AKS, VMs, Containers)
- Networking (VNet, Gateway, Load Balancer)
- Storage (Storage Account, Blob, File Share)
- Security (Key Vault, AAD, Firewall)
- Management (Resource Groups, Monitor, Log Analytics)
- Database (Azure Database, Cosmos DB, SQL Database)
- Integration (API Management, Service Bus, Event Grid)

## Icon Naming Convention

Azure icons follow this naming pattern:
- `Icon-service-{service-name}-Azure.svg`
- `Icon-service-{service-name}-Azure.png`

Examples:
- `Icon-service-kubernetes-Azure.svg`
- `Icon-service-virtual-machine-Azure.svg`
- `Icon-service-key-vaults-Azure.svg`

## Usage Guidelines

1. **Use Official Icons**: Always use official Azure icons from Microsoft
2. **Maintain Consistency**: Use the same icon set across all diagrams
3. **Respect Licensing**: Follow Microsoft's icon usage guidelines
4. **Keep Updated**: Regularly update icons to the latest version
5. **Use SVG Format**: Prefer SVG for scalability

## Troubleshooting

### Download Fails

If the automated download fails:

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
5. Extract to `assets/azure-icons/`

### Icons Not Found

If specific icons are not found:

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 (for blockchain components)

### 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
5. Try importing icons manually

## 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/)
- [Cloud Adoption Framework](https://docs.microsoft.com/azure/cloud-adoption-framework/)

## Quick Reference

### Download Icons
```bash
./scripts/assets/download-azure-icons.sh
```

### Setup Assets
```bash
./scripts/assets/setup-assets.sh
```

### 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/

