Bu yazımızda, AWS’nin storage hizmeti olan Amazon S3 Storage ve .NET SDK’sını kullanarak dosyalarımızı nasıl yöneteceğimizi inceleyeceğiz.
Bir web uygulamasında, sıklıkla dosya yükleme kullanılıyorsa, sunucuda tutulan bu dosyaların saklama, arşivleme ve hatta yükleme işlerinin bir süre sonra baş ağrıtan bir problem haline gelme ihtimali epey yüksektir. Amazon’un S3 Storage hizmeti ya da benzeri ürünler, scalability, arşivleme ve analitik konularında pratik ve kolay uygulanabilir çözümleri güvenli bir yolla kullanıma sunuyor. Bu yüzden, web uygulamalarının deploy edildiği klasörler içinde yazma – okuma işini, S3 bucket’larına devredebiliriz.
AWS Console üzerinden S3 servisine gidiyoruz ve yeni bir bucket oluşturuyoruz. Bucket adımız, AWS üzerindeki tüm bucketlar içinde tekil olmalıdır.
AWS, bize bir sonraki kısımda versiyonlama, loglama ve tag kullanıp kullanmayacağımızı soruyor, şimdi her birinin ne işe yaradığına kısaca bakalım;
Versiyonlama
Versiyonlamayı aktif etmek demek, bucket içinde tuttuğumuz bir objenin farklı çeşitlerinin bir versionID ile birlikte tutulması anlamına gelir. Bu özellik ile aynı objenin tekrar yüklenmesi ve silinmesi durumunda ilk haline dönüşü sağlanabilir. Aşağıdaki görselde “h0721u2562x0134v3959” keyName’e sahip bir fotoğrafın ilk haline ulaşacağımız link, version ID ve son değiştirilme tarihi görülmektedir.
Loglama
Yüklenen dosyaların daha detaylı bilgilerine erişmek isteniyorsa loglama özelliği ücretsiz bir şekilde aktif edilebilir. (Ancak AWS log dosyalarını başka bir yere taşımak isterseniz data transfer ile bir tutarak ücret kesiyor.)
Bucket Owner Id
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
Bucket Name
mybucket
Create Date
[06/Feb/2014:00:00:38 +0000]
Remote IP
192.0.2.3
Requester
79a59df900b949e55d96a1e698fbacedfd6e09d98eacf8f8d5218e7cd47ef2be
Request Id (Amazon tarafından her request için oluşturulur.)
3E57427F3EXAMPLE
File Name
keyname
Operation
REST.GET.VERSIONING –
Key
“GET /mybucket?versioning
HTTP/1.1”
200
Bytes Sent
113
Total Time
7
Error Message
“-”
“S3Console/0.4”
Tag Ekleme
Dosya yükleme esnasında, dosyayla bir ya da daha fazla tag ilişkilendirilerek kategorize edilebilir.
3. adımda kullanıcıların bucket içindeki dosyalara olan erişim kurallarını belirlememiz gerekiyor. Bu kısım varsayılan olarak geçilerek bucket’ı oluşturuyoruz ve içine girip Permissions sekmesindeki Bucket Policy alanına giriyoruz. Burada yer alan Policy Generator aracından faydalanarak erişim kurallarımızı belirleyebiliriz.
Burada oluşturduğumuz JSON formatındaki kural setini, Bucket Policy içine kopyalayaıp kaydediyoruz. Artık bucket’ımızı kullanmaya hazırız.
Bu örnekte stream ve path kullanarak fotoğraf yükleme ve silme işlemlerini yapacağız. İlk olarak projemize AWSSDK.S3 paketini yükleyerek başlayabiliriz. Byte dizisi şeklindeki bir fotoğrafı yüklemek istiyorsak, MemoryStream sınıfı ile basit bir şekilde gerçekleştirebiliriz.
public static string UploadImageToAws(string keyName, string bucketName, byte[] imageArray) { try { using (var ms = new MemoryStream()) { client = new AmazonS3Client(ConfigurationManager.AppSettings["AWSAccessKey"], ConfigurationManager.AppSettings["AWSSecretAccessKey"], RegionEndpoint.EUWest1); var tu = new Amazon.S3.Transfer.TransferUtility(client); ms.Write(imageArray, 0, imageArray.Length); ms.Position = 0; var req = new Amazon.S3.Transfer.TransferUtilityUploadRequest(); req.BucketName = bucketName; req.Key = keyName; req.InputStream = ms; tu.Upload(req); return "https://s3.amazonaws.com/" + bucketName + "/" + keyName; } } catch (AmazonS3Exception amazonS3Exception) { Console.WriteLine(amazonS3Exception.Message); } catch (Exception ex) { throw (ex); } return string.Empty; }
Mevcut bir fotoğrafı silmek içinse aşağıdaki gibi DeleteObject() metodunu çağırmak yeterli.
public static bool DeleteImageToAws(string keyName, string bucketName) { using (client = new AmazonS3Client(ConfigurationManager.AppSettings["AWSAccessKey"], ConfigurationManager.AppSettings["AWSSecretAccessKey"], RegionEndpoint.EUWest1)) { DeleteObjectRequest dor = new DeleteObjectRequest() { BucketName = bucketName, Key = keyName }; client.DeleteObject(dor); } return true; }