Aicrosoft.Extensions.Azure 8.0.0-beta.260130.2

Aicrosoft.Extensions.Azure

Aicrosoft.Extensions.Azure is an extension library for the Aicrosoft framework, designed to simplify interactions with Azure cloud services. it provides a centralized way to manage Azure SDK clients and offers convenient extension methods for common Azure tasks like Resource Management, Key Vault, Blob Storage, and Microsoft Graph.

Design Goals

1. Centralized Client Management: Provide a unified IAzureClientService to manage authenticated instances of ArmClient, GraphServiceClient, and SecretClient.
2. Simplified Azure SDK Operations: Offer easy-to-use wrappers and extension methods for common tasks (e.g., uploading to Blob Storage, fetching secrets from Key Vault) to reduce boilerplate code.
3. Deployment Automation Support: Include components to facilitate Azure Resource Manager (ARM) template deployments and service configuration.
4. Microsoft Graph Integration: Simplify complex Graph API operations such as managing applications, service principals, and app role assignments.
5. Seamless Hosting Integration: Integrated with Aicrosoft.Extensions.Hosting through AzureServiceBase, allowing for consistent service patterns in Azure-aware applications.

Key Features

• IAzureClientService: A single point of access for various Azure SDK clients, handled with appropriate authentication.
• AzureServiceBase: A base class for business services that require Azure access, leveraging dependency injection.
• Key Vault Extensions: GetOrDefaultAsync and SetSecretAsync methods to simplify secret management.
• Blob Storage Helpers: Simple static methods for uploading and downloading blobs.
• Graph API Extensions: Extended functionality for Microsoft.Graph.Models.Application and ServicePrincipal to manage permissions and roles easily.
• Azure WebApp Deployment: Tools like WebAppDeployer for automating web application deployments to Azure.

Usage

1. Installation

Reference the Aicrosoft.Extensions.Azure package in your project.

2. Implementing an Azure-ready Service

Inherit from AzureServiceBase to gain access to Azure clients:

using Aicrosoft.AzureDeploy.Services;

public class MyAzureService : AzureServiceBase
{
    public MyAzureService(IServiceProvider serviceProvider) : base(serviceProvider)
    {
    }

    public async Task DoSomething()
    {
        // Access ARM Client
        var armClient = AzClient.ArmClient;
        
        // Access Key Vault Secret
        var secretClient = AzClient.GetSecretClient("my-kv-name");
        var secret = await secretClient.GetOrDefaultAsync("my-secret");
    }
}

3. Using Blob Storage Helpers

using Azure.Blob;

string connStr = "...";
var uri = await BlobContainer.UploadToContainer(connStr, "my-container", "file.txt", "C:\\local\\file.txt");

4. Microsoft Graph Operations

using Microsoft.Graph;

// Assuming you have a GraphServiceClient instance
await graphClient.Applications["id"].AddAppRoleAssignmentAsync(servicePrincipalId, appRoleId);

Related Projects

• Aicrosoft.Extensions.Hosting: Provides the base hosting and DI infrastructure.
• Aicrosoft.Extensions.NLog: Integrated logging support.