120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
# 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
|
|
```
|