# Azure Architecture Icons Catalog

Complete catalog of Azure Architecture Icons available in this project.

## Icon Sets

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

### PNG Icons
- **Location**: `assets/azure-icons/png/`
- **Format**: Portable Network Graphics
- **Use**: Presentations, documents
- **Recommended**: For presentations only

## Icon Categories

### Compute

#### Azure Kubernetes Service (AKS)
- **SVG**: `Icon-service-kubernetes-Azure.svg`
- **PNG**: `Icon-service-kubernetes-Azure.png`
- **Description**: Azure Kubernetes Service for container orchestration
- **Used in**: AKS deployment diagrams

#### Virtual Machines
- **SVG**: `Icon-service-virtual-machine-Azure.svg`
- **PNG**: `Icon-service-virtual-machine-Azure.png`
- **Description**: Azure Virtual Machines
- **Used in**: VM deployment diagrams

#### Container Instances
- **SVG**: `Icon-service-container-instances-Azure.svg`
- **PNG**: `Icon-service-container-instances-Azure.png`
- **Description**: Azure Container Instances
- **Used in**: Container deployment diagrams

#### App Service
- **SVG**: `Icon-service-app-service-Azure.svg`
- **PNG**: `Icon-service-app-service-Azure.png`
- **Description**: Azure App Service
- **Used in**: Web application diagrams

#### VM Scale Sets
- **SVG**: `Icon-service-virtual-machine-scale-sets-Azure.svg`
- **PNG**: `Icon-service-virtual-machine-scale-sets-Azure.png`
- **Description**: Azure Virtual Machine Scale Sets
- **Used in**: Scalable VM deployment diagrams

### Networking

#### Virtual Network
- **SVG**: `Icon-service-virtual-network-Azure.svg`
- **PNG**: `Icon-service-virtual-network-Azure.png`
- **Description**: Azure Virtual Network
- **Used in**: Network architecture diagrams

#### Application Gateway
- **SVG**: `Icon-service-application-gateway-Azure.svg`
- **PNG**: `Icon-service-application-gateway-Azure.png`
- **Description**: Azure Application Gateway
- **Used in**: Gateway and load balancing diagrams

#### Load Balancer
- **SVG**: `Icon-service-load-balancer-Azure.svg`
- **PNG**: `Icon-service-load-balancer-Azure.png`
- **Description**: Azure Load Balancer
- **Used in**: Load balancing diagrams

#### Network Security Group
- **SVG**: `Icon-service-network-security-group-Azure.svg`
- **PNG**: `Icon-service-network-security-group-Azure.png`
- **Description**: Azure Network Security Group
- **Used in**: Security architecture diagrams

#### VPN Gateway
- **SVG**: `Icon-service-vpn-gateway-Azure.svg`
- **PNG**: `Icon-service-vpn-gateway-Azure.png`
- **Description**: Azure VPN Gateway
- **Used in**: VPN connectivity diagrams

#### Private Endpoint
- **SVG**: `Icon-service-private-endpoint-Azure.svg`
- **PNG**: `Icon-service-private-endpoint-Azure.png`
- **Description**: Azure Private Endpoint
- **Used in**: Private connectivity diagrams

### Storage

#### Storage Account
- **SVG**: `Icon-service-storage-accounts-Azure.svg`
- **PNG**: `Icon-service-storage-accounts-Azure.png`
- **Description**: Azure Storage Account
- **Used in**: Storage architecture diagrams

#### Blob Storage
- **SVG**: `Icon-service-blob-storage-Azure.svg`
- **PNG**: `Icon-service-blob-storage-Azure.png`
- **Description**: Azure Blob Storage
- **Used in**: Data storage diagrams

#### File Shares
- **SVG**: `Icon-service-file-shares-Azure.svg`
- **PNG**: `Icon-service-file-shares-Azure.png`
- **Description**: Azure File Shares
- **Used in**: File storage diagrams

#### Managed Disks
- **SVG**: `Icon-service-managed-disks-Azure.svg`
- **PNG**: `Icon-service-managed-disks-Azure.png`
- **Description**: Azure Managed Disks
- **Used in**: Disk storage diagrams

### Security

#### Key Vault
- **SVG**: `Icon-service-key-vaults-Azure.svg`
- **PNG**: `Icon-service-key-vaults-Azure.png`
- **Description**: Azure Key Vault
- **Used in**: Security architecture diagrams

#### Azure Active Directory
- **SVG**: `Icon-service-azure-active-directory-Azure.svg`
- **PNG**: `Icon-service-azure-active-directory-Azure.png`
- **Description**: Azure Active Directory
- **Used in**: Identity and access management diagrams

#### Security Center
- **SVG**: `Icon-service-security-center-Azure.svg`
- **PNG**: `Icon-service-security-center-Azure.png`
- **Description**: Azure Security Center
- **Used in**: Security monitoring diagrams

#### Firewall
- **SVG**: `Icon-service-azure-firewall-Azure.svg`
- **PNG**: `Icon-service-azure-firewall-Azure.png`
- **Description**: Azure Firewall
- **Used in**: Network security diagrams

### Management

#### Resource Groups
- **SVG**: `Icon-service-resource-groups-Azure.svg`
- **PNG**: `Icon-service-resource-groups-Azure.png`
- **Description**: Azure Resource Groups
- **Used in**: Resource organization diagrams

#### Management Groups
- **SVG**: `Icon-service-management-groups-Azure.svg`
- **PNG**: `Icon-service-management-groups-Azure.png`
- **Description**: Azure Management Groups
- **Used in**: Governance diagrams

#### Subscriptions
- **SVG**: `Icon-service-subscriptions-Azure.svg`
- **PNG**: `Icon-service-subscriptions-Azure.png`
- **Description**: Azure Subscriptions
- **Used in**: Subscription management diagrams

#### Monitor
- **SVG**: `Icon-service-azure-monitor-Azure.svg`
- **PNG**: `Icon-service-azure-monitor-Azure.png`
- **Description**: Azure Monitor
- **Used in**: Monitoring diagrams

#### Log Analytics Workspace
- **SVG**: `Icon-service-log-analytics-workspaces-Azure.svg`
- **PNG**: `Icon-service-log-analytics-workspaces-Azure.png`
- **Description**: Azure Log Analytics Workspace
- **Used in**: Logging and analytics diagrams

### Database

#### Azure Database
- **SVG**: `Icon-service-azure-database-Azure.svg`
- **PNG**: `Icon-service-azure-database-Azure.png`
- **Description**: Azure Database
- **Used in**: Database architecture diagrams

#### Cosmos DB
- **SVG**: `Icon-service-azure-cosmos-db-Azure.svg`
- **PNG**: `Icon-service-azure-cosmos-db-Azure.png`
- **Description**: Azure Cosmos DB
- **Used in**: NoSQL database diagrams

#### SQL Database
- **SVG**: `Icon-service-azure-sql-database-Azure.svg`
- **PNG**: `Icon-service-azure-sql-database-Azure.png`
- **Description**: Azure SQL Database
- **Used in**: SQL database diagrams

#### PostgreSQL
- **SVG**: `Icon-service-azure-database-for-postgresql-server-Azure.svg`
- **PNG**: `Icon-service-azure-database-for-postgresql-server-Azure.png`
- **Description**: Azure Database for PostgreSQL
- **Used in**: PostgreSQL database diagrams

### Integration

#### API Management
- **SVG**: `Icon-service-api-management-Azure.svg`
- **PNG**: `Icon-service-api-management-Azure.png`
- **Description**: Azure API Management
- **Used in**: API architecture diagrams

#### Service Bus
- **SVG**: `Icon-service-service-bus-Azure.svg`
- **PNG**: `Icon-service-service-bus-Azure.png`
- **Description**: Azure Service Bus
- **Used in**: Messaging architecture diagrams

#### Event Grid
- **SVG**: `Icon-service-event-grid-Azure.svg`
- **PNG**: `Icon-service-event-grid-Azure.png`
- **Description**: Azure Event Grid
- **Used in**: Event-driven architecture diagrams

#### Logic Apps
- **SVG**: `Icon-service-logic-apps-Azure.svg`
- **PNG**: `Icon-service-logic-apps-Azure.png`
- **Description**: Azure Logic Apps
- **Used in**: Workflow diagrams

### Blockchain (Custom)

#### Hyperledger Besu
- **SVG**: `custom-hyperledger-besu.svg`
- **PNG**: `custom-hyperledger-besu.png`
- **Description**: Hyperledger Besu blockchain client
- **Note**: Custom icon (not official Azure icon)

#### Validator Node
- **SVG**: `custom-validator-node.svg`
- **PNG**: `custom-validator-node.png`
- **Description**: Blockchain validator node
- **Note**: Custom icon (not official Azure icon)

#### RPC Node
- **SVG**: `custom-rpc-node.svg`
- **PNG**: `custom-rpc-node.png`
- **Description**: Blockchain RPC node
- **Note**: Custom icon (not official Azure icon)

#### Oracle Node
- **SVG**: `custom-oracle-node.svg`
- **PNG**: `custom-oracle-node.png`
- **Description**: Blockchain oracle node
- **Note**: Custom icon (not official Azure icon)

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

### In Diagrams

1. **Use SVG Icons**: Prefer SVG for scalability
2. **Maintain Consistency**: Use the same icon set across all diagrams
3. **Label Components**: Label all components clearly
4. **Show Relationships**: Show connections and data flows
5. **Include Legends**: Add legends for complex diagrams

### In Documentation

1. **Use SVG Icons**: Prefer SVG for web documentation
2. **Provide Alt Text**: Include descriptive alt text
3. **Link to Sources**: Link to Azure documentation
4. **Maintain Consistency**: Use consistent icon usage

### In Presentations

1. **Use PNG Icons**: Use PNG for presentations
2. **Maintain Size**: Keep icon sizes consistent
3. **Use High Quality**: Use high-resolution icons
4. **Include Labels**: Label all components

## Finding Icons

### By Service Name

Search for 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*"
```

### By Category

Use `icon-mapping.json` to find icons by category:

```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'
```

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

