1fb7266469
- Introduced Aggregator.sol for Chainlink-compatible oracle functionality, including round-based updates and access control. - Added OracleWithCCIP.sol to extend Aggregator with CCIP cross-chain messaging capabilities. - Created .gitmodules to include OpenZeppelin contracts as a submodule. - Developed a comprehensive deployment guide in NEXT_STEPS_COMPLETE_GUIDE.md for Phase 2 and smart contract deployment. - Implemented Vite configuration for the orchestration portal, supporting both Vue and React frameworks. - Added server-side logic for the Multi-Cloud Orchestration Portal, including API endpoints for environment management and monitoring. - Created scripts for resource import and usage validation across non-US regions. - Added tests for CCIP error handling and integration to ensure robust functionality. - Included various new files and directories for the orchestration portal and deployment scripts.
200 lines
6.0 KiB
Markdown
200 lines
6.0 KiB
Markdown
# 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
|
|
|
|
```
|
|
|
|
### In Presentations
|
|
|
|
Use PNG icons for presentations:
|
|
```markdown
|
|
|
|
```
|
|
|
|
## 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/
|
|
|