پلتفرم .Net

(.Net Platform)

اتصال به ذخیره‌سازی ابری

بدون شک اتصال برنامه به یک ذخیره‌سازی ابری مطمئن برای نگهداری و ارائه فایل‌های استاتیک وب‌سایت یا داده‌های آپلود شده توسط کاربران، باعث اطمینان خاطر صاحبان کسب و کار و بهبود عملکرد برنامه‌ می‌شود.

فهرست عناوین:

• نصب AWS SDK
• تنظیم کلیدها
• نحوه‌ی استفاده

در صورتی که تمایلی به خواندن آموزش متنی ندارید می‌توانید ویدیوی آموزشی زیر ‌را مشاهده کنید.

نصب AWS SDK

از آنجا که ذخیره‌سازی ابری لیارا یک سرویس Object storage سازگار با پروتکل S3 است، شما می‌توانید با استفاده از AWS SDK‌، در زبان‌ها و فریم‌ورک‌های مختلفی این فضای ذخیره‌سازی را مدیریت کنید. حال برای اتصال به ذخیره‌سازی ابری در .Net باید با اجرای دستور زیر، پکیج AWSSDK.S3 را نصب کنید.

dotnet add package AWSSDK.S3

تنظیم کلیدها

در مرحله‌ی بعد، به‌منظور امنیت و کنترل راحت‌تر مقادیر باید مشخصات فضای ذخیره‌سازی ابری اعم از کلیدها و آدرس اتصال به این سرویس را در بخش متغیرهای برنامه تنظیم کنید.

LIARA_ENDPOINT=https://<Liara Bucket Endpoint>
LIARA_BUCKET_NAME=<Bucket Name>
LIARA_ACCESS_KEY=<Access Key>
LIARA_SECRET_KEY=<Secret Key>

اگر که از فایل env. برای بارگذاری متغیرهای محیطی در پروژه اصلی استفاده می‌کنید؛ می‌توانید با استفاده از دستور زیر، پکیج DotEnv را نصب کنید.

dotnet add package dotenv.net

نحوه‌ی استفاده

برنامه نمونه‌ای برای مدیریت باکت‌ها در لیارا در زیر آمده است؛ می‌توانید با استفاده از دستورات زیر، از برنامه استفاده کنید:

• اجرای دستور dotnet run listبرای نمایش آیتم‌های موجود در یک باکت
• اجرای دستور dotnet run download برای دانلود یک فایل مشخص از باکت و ذخیره آن
• اجرای دستور dotnet run upload برای آپلود یک فایل مشخص درون باکت
• اجرای دستور dotnet run geturls برای دریافت لینک موقت یک ساعته تمام فایل‌های موجود در باکت
• اجرای دستور dotnet run listbuckets برای نمایش باکت‌های موجود ساخته شده در لیارا توسط ما

using System;
using System.Collections.Generic;
using Amazon;
using Amazon.S3;
using Amazon.S3.Model;
using DotNetEnv;
using System.IO;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        // loading env variables
        Env.Load();

        // setting env variables
        string accessKey = Env.GetString("LIARA_ACCESS_KEY");
        string secretKey = Env.GetString("LIARA_SECRET_KEY");
        string bucketName = Env.GetString("LIARA_BUCKET_NAME");
        string endpoint = Env.GetString("LIARA_ENDPOINT");

        // making s3 connections
        var config = new AmazonS3Config
        {
            ServiceURL = endpoint,
            ForcePathStyle = true,
            SignatureVersion = "4"
        };
        var credentials = new Amazon.Runtime.BasicAWSCredentials(accessKey, secretKey);
        using var client = new AmazonS3Client(credentials, config);

        if (args.Length > 0)
        {
            string command = args[0];

            if (command == "list")
            {
                // listing items from bucket   
                ListObjectsV2Request request = new ListObjectsV2Request
                {
                    BucketName = bucketName
                };
                ListObjectsV2Response response = client.ListObjectsV2Async(request).Result;

                foreach (S3Object entry in response.S3Objects)
                {
                    Console.WriteLine($"File: {entry.Key} (Size: {entry.Size} bytes)");
                }
            }
            else if (command == "download")
            {
                string objectKey = "wordpress.png"; 
                string filePath = "downloaded_file.png";
                try
                {
                    GetObjectRequest request = new GetObjectRequest
                    {
                        BucketName = bucketName,
                        Key = objectKey
                    };

                    using GetObjectResponse response = await client.GetObjectAsync(request);
                    using Stream responseStream = response.ResponseStream;
                    using FileStream fileStream = File.Create(filePath);
                    await responseStream.CopyToAsync(fileStream);
                    Console.WriteLine($"File '{objectKey}' downloaded successfully.");
                }
                catch (AmazonS3Exception e)
                {
                    Console.WriteLine($"Error: {e.Message}");
                }
            }
            else if (command == "upload")
            {
                string filePath = "downloaded_file.png"; // مسیر فایل محلی
                string objectKey = "uploaded.png"; // نام فایل در سبد

                try
                {
                    using FileStream fileStream = new FileStream(filePath, FileMode.Open);

                    PutObjectRequest request = new PutObjectRequest
                    {
                        BucketName = bucketName,
                        Key = objectKey,
                        InputStream = fileStream
                    };

                    await client.PutObjectAsync(request);

                    Console.WriteLine($"File '{objectKey}' uploaded successfully.");
                }
                catch (AmazonS3Exception e)
                {
                    Console.WriteLine($"Error: {e.Message}");
                }
            }
            else if (command == "geturls")
            {
                ListObjectsV2Request request = new ListObjectsV2Request
                {
                    BucketName = bucketName
                };
                ListObjectsV2Response response = client.ListObjectsV2Async(request).Result;

                foreach (S3Object entry in response.S3Objects)
                {
                    GetPreSignedUrlRequest urlRequest = new GetPreSignedUrlRequest
                    {
                        BucketName = bucketName,
                        Key = entry.Key,
                        Expires = DateTime.Now.AddHours(1) // زمان انقضا (یک ساعت)
                    };
                    string url = client.GetPreSignedURL(urlRequest);
                    Console.WriteLine($"File: {entry.Key}, URL: {url}");
                }
            }
            else if (command == "listbuckets")
            {
                ListBucketsResponse response = client.ListBucketsAsync().Result;

                Console.WriteLine("Available Buckets:");
                foreach (S3Bucket bucket in response.Buckets)
                {
                    Console.WriteLine(bucket.BucketName);
                }
            }
            else
            {
                Console.WriteLine("Invalid command. Available commands: list, download, upload, geturls, getpermanenturls, listbuckets");
            }
        }
        else
        {
            Console.WriteLine("Please provide a command. Available commands: list, download, upload, geturls, getpermanenturls, listbuckets");
        }
    }
}