Azure Functions（二）整合 Azure Blob Storage 儲存檔案

一，引言

　　上一篇文章有介紹到什麼是 SeverLess ，ServerLess 都有哪些特點，以及多雲環境下 ServerLess 都有哪些解決方案。在這眾多解決方案中就包括 Function App（Azure 下的ServerLess），今天我們結合之前所講的 Azure Functions 以及 Azure Blob Storage 的相關知識，從實踐出發，再次回顧之前的知識點，以下是構想的基礎資源架構圖

--------------------Azure Functions 系列--------------------

1，使用 Visual Studio 開發、測試和部署 Azure Functions（一）開發

2，使用 Visual Studio 開發、測試和部署 Azure Functions（二）測試，部署

3，使用Azure Functions 在web 應用中啟用自動更新（一）分析基於輪詢的 Web 應用的限制

4，Azure Functions（一）什麼是 ServerLess

5，Azure Functions（二）整合 Azure Blob Storage 儲存檔案

二，正文

1，建立 Function App

Azure Portal，點選“Create a resource”，搜尋框中輸入 “Function App”。

點選 “Create”，建立 Function App

輸入相關引數：

Resource Group 選擇建立新的資源組：“Web_Test_Functions_RG”

Function App name：“cnbateblogweb”

Publicsh 釋出方式：Code（程式碼）

Runtime stack 選擇：“.NET”

Version：“3.1”

Region 選擇：“East  Asia”

點選 “Next：Hosting” 設定承載

接下來 “Hosting” 相關引數

Storage：當我們在建立函式應用時，必須建立或連結到支援的Blob，Queue，Table Storage 的常規用途的 Azure 儲存賬號

Storage Account 選擇建立新的：cnbatestorageaccount

Operation system 選擇：“Windows”

Plan 選擇：Consumption(ServerLess) 消耗(無伺服器)

點選 “Next：Monitoring >” 設定監視資訊

接下來我們需要自身的需要 選擇是否開啟 Application Insights（用於在應用程式中提供詳細的可觀測性）

Enable Application Insights：“Yes”

Application Insights 選擇建立新的：“cnbateblogweb”

點選 “Review + create”，建立預覽。

預校驗完成後，點選 “Create” 進行建立。

稍等片刻，我們回到 “Web_Test_Functions_RG” 這個資源組可以檢視到我們建立好的資源

最後，我們需要建立用於儲存圖片的 Blob Container

選擇 “Blob service =》Container”，點選箭頭所指的 “+ Container”

輸入建立新的容器的相關引數：

Name：“picturecontainer”

Public access level 選擇預設：“Private（no anonymous access）”

點選 “Create” 

建立完成後，就可以在當前頁面上看到 “picturecontainer” 的 Blob Container

2，Azure FunctionApp 新增對 Blob Storage 的使用方法

2.1，新增相關 Nuget  依賴包引用

使用程式包管理器控制檯進行安裝

Install-Package Azure.Storage.Blobs -Version 12.8.0
Install-Package Microsoft.AspNetCore.StaticFiles -Version 2.2.0
Install-Package Microsoft.Azure.Functions.Extensions -Version 1.1.0
Install-Package Microsoft.Extensions.DependencyInjection -Version 5.0.1
Install-Package Microsoft.NET.Sdk.Functions -Version 3.0.11

這裡要注意的是 "Microsoft.Extensions.DependencyInjection"、"Microsoft.NET.Sdk.Functions"、"Microsoft.Azure.Functions.Extensions" ，主要是想在 Azure Functions 中使用一倆注入（DI）

大家可以自行參考 Use dependency injection in .NET Azure Functions

2.2，IBlobService 介面方法定義，BlobService 具體實現和 Http觸發器

public interface IBlobService
    {
        Task UploadImagesBlobAsync(string filePath, string filename);

        Task UploadFileBlobAsync(string filePath, string filename);

        Task UploadContentBlobAsync(string content, string filename);
    }

public class BlobService : IBlobService
    {
        private readonly BlobServiceClient _blobServiceClient;
        
        public BlobService(BlobServiceClient blobServiceClient)
        {
            this._blobServiceClient = blobServiceClient;
        }

        #region 02，抓取網路圖片，根據圖片URL和圖片名稱+async Task UploadFileBlobAsync(string filePath, string filename)
        /// <summary>
        /// 上傳圖片流，根據圖片URL和圖片名稱
        /// </summary>
        /// <param name="filePath">圖片URL</param>
        /// <param name="filename">圖片名稱</param>
        /// <returns></returns>
        public async Task UploadImagesBlobAsync(string filePath, string filename)
        {
            var containerClient = _blobServiceClient.GetBlobContainerClient("picturecontainer");
            var blobClient = containerClient.GetBlobClient(filename);

            #region 獲取圖片流
            var response = FeatchPictureClient.GetWebResponse(filePath);
            var bytes = FeatchPictureClient.GetResponseStream(response);
            await using var memoryStream = new MemoryStream(bytes);

            //上傳圖片流
            await blobClient.UploadAsync(memoryStream, new BlobHttpHeaders() { ContentType = filename.GetContentType() });
            #endregion
        }
        #endregion

      #region 03，上傳圖片，根據檔案路徑和檔名稱+async Task UploadFileBlobAsync(string filePath, string filename)
        /// <summary>
        /// 上傳圖片流，根據檔案路徑和檔名稱
        /// </summary>
        /// <param name="filePath">檔案路徑</param>
        /// <param name="filename">檔名稱</param>
        /// <returns></returns>
        public async Task UploadFileBlobAsync(string filePath, string filename)
        {
            var containerClient = _blobServiceClient.GetBlobContainerClient("picturecontainer");
            var blobClient = containerClient.GetBlobClient(filename);
            await blobClient.UploadAsync(filePath, new BlobHttpHeaders { ContentType = filePath.GetContentType() });
        }
        #endregion

        #region 04，上傳檔案內容，根據檔案內容和檔名稱+async Task UploadContentBlobAsync(string content, string filename)
        /// <summary>
        /// 上傳檔案流，根據檔案內容和檔名稱
        /// </summary>
        /// <param name="content">檔案內容</param>
        /// <param name="filename">檔名稱</param>
        /// <returns></returns>
        public async Task UploadContentBlobAsync(string content, string filename)
        {
            var containerClient = _blobServiceClient.GetBlobContainerClient("picturecontainer");
            var blobClient = containerClient.GetBlobClient(filename);
            var bytes = Encoding.UTF8.GetBytes(content);
            await using var memoryStream = new MemoryStream(bytes);
            await blobClient.UploadAsync(memoryStream, new BlobHttpHeaders() { ContentType = filename.GetContentType() });
        }
        #endregion

    }

public class UpLoadTrigger
    {
        private readonly IBlobService _blobSergvice;

        public UpLoadTrigger(IBlobService blobSergvice)
        {
            _blobSergvice = blobSergvice;
        }

        [FunctionName("UpLoadTrigger")]
        public async Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Function, "post", Route = null)] BlobViewModel req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            await _blobSergvice.UploadImagesBlobAsync(req.FilePath, req.FileName);
            return new OkObjectResult("ok");
        }
    }

2.3，FileExtensions 方法和 FeatchpictureClient 網路請求方法

public static class FileExtensions
    {
        private static readonly FileExtensionContentTypeProvider provider = new FileExtensionContentTypeProvider();

        public static string GetContentType(this string fileName)
        {
            if (!provider.TryGetContentType(fileName, out var contentType))
            {
                contentType = "application/octet-stream";
            }
            return contentType;
        }
    }

public class FeatchPictureClient
    {
        /// <summary>
        /// 獲取URL響應物件
        /// </summary>
        /// <param name="url"></param>
        /// <returns></returns>
        public static WebResponse GetWebResponse(string url)
        {
            System.Net.HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
            request.CookieContainer = new CookieContainer();
            request.KeepAlive = true;
            WebResponse res = request.GetResponse();
            return res;
        }

        public static byte[] GetResponseStream(WebResponse response)
        {
            Stream smRes = response.GetResponseStream();
            byte[] resBuf = new byte[10240];
            int nReaded = 0;
            MemoryStream memSm = new MemoryStream();
            while ((nReaded = smRes.Read(resBuf, 0, 10240)) != 0)
            {
                memSm.Write(resBuf, 0, nReaded);
            }
            byte[] byResults = memSm.ToArray();
            memSm.Close();
            return byResults;
        }
    }

2.4，新增對 BlobService 以及BlobServiceClient 的依賴注入

大家需要注意，我們需要配置Blob Storage 的訪問金鑰

找到建立 Function App 時一起建立出來的 Storage Account "cnbatestorageaccount "

選擇 “Settings =》Access keys”，複製圖中圈中的 “Connection string” 貼上到對應的程式碼中。

using Azure.Storage.Blobs;
using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Collections.Generic;
using System.Text;
using UploadImages;
using UploadImages.Service;

[assembly: FunctionsStartup(typeof(Startup))]

namespace UploadImages
{
    public class Startup : FunctionsStartup
    {
        //public Startup(IConfiguration configuration)
        //{
        //    Configuration = configuration;
        //}

        //public IConfiguration Configuration { get; }

        public override void Configure(IFunctionsHostBuilder builder)
        {
            //builder.Services.AddSingleton(x => new BlobServiceClient("storageaccount_connection"));
            builder.Services.AddSingleton(x => new BlobServiceClient("DefaultEndpointsProtocol=https;AccountName=cnbateblogaccount;AccountKey=f9n+Cm3brR+39SVhNMzzMPj54f6KD7rINi9G2OlxVkk2oUfi3o7ZGdDS8SHkF8H8G5pSmedOOMmOhc95uRNZxA==;EndpointSuffix=core.windows.net"));
            builder.Services.AddTransient<IBlobService, BlobService>();
        }
    }
}

3，測試！觸發 HttpTrigger，通過網路請求圖片URL，經過處理，將圖片儲存在Blob Storage

F5執行，可以看到控制中顯示 Function App 中的 UpLoadTrigger URL：http://localhost:7071/api/UpLoadTrigger

Postman 中輸入 HttpTrigger 的請求連結，輸入 FilePath，FileName 兩個引數

回到控制檯中，我們可以看到 Http 觸發器已經成功的處理了請求

同樣的，我們也可以在 Blob Container 中找到上傳到的網路圖片

Bingo！！！大功告成。使用 Vistual Studio 開發，測試Azure Function App 應用完結

三，結尾

　　Azure Functions 用來處理很方便，直接將應用級別的專案縮小到方法級別上，在具體的的方法中處理業務，資料。並且 Azure Function 是按照使用付費定價模型：也就是僅僅為執行程式碼所用的時間而付費，這一點比某雲還是好一些。下一篇繼續講解/分享 Azure Function 例項程式碼。以上也是自己的學習的過程，謝謝各位指點。

參考資料：Azure Functions 簡介，在 .NET Azure Functions 中使用依賴項注入

github:https://github.com/yunqian44/Azure.Functions.Upload.git

作者：Allen 

版權：轉載請在文章明顯位置註明作者及出處。如發現錯誤，歡迎批評指正。