Azure - Ruby에서 Blob 저장소를 사용하는 방법

Tech Note 정보: 혀뇽뇽이 님이 작성하신 글입니다.; 카테고리: [ Cloud Computing & MSA ]; 게시됨: 11 May 2016; 작성됨: 12 May 2016; 최종 변경: 11 May 2016; 조회수: 2814

원본 링크: https://azure.microsoft.com/ko-kr/documentation/articles/storage-ruby-how-to-use-blob-storage/

개요

이 가이드에서는 Blob 저장소를 사용하여 일반 시나리오를 수행하는 방법을 보여 줍니다. 샘플은 Ruby API를 사용하여 작성되었습니다. 여기서 다루는 시나리오에는 Blob 업로드, 나열, 다운로드 및 삭제가 포함됩니다.

Blob 저장소 정의

Azure Blob 저장소는 HTTP 또는 HTTPS를 통해 전 세계 어디에서든 액세스할 수 있는 다량의 구조화되지 않은 개체 데이터(예: 텍스트 또는 이진 데이터)를 저장할 수 있는 서비스입니다. Blob 저장소를 사용하여 세상에 공개적으로 표시하거나 응용 프로그램 데이터를 비공개적으로 저장할 수 있습니다.

Blob 저장소의 일반적인 사용은 다음과 같습니다.

브라우저에 직접 이미지 또는 문서 제공
분산 액세스를 위해 파일 저장
동영상 및 오디오 스트리밍
백업 및 복원, 재해 복구 및 보관 데이터 저장
온-프레미스 또는 Azure 호스티드 서비스에서 분석하기 위해 데이터 저장

BLOB 서비스 개념

Blob 서비스에는 다음 구성 요소가 포함됩니다.

Blob1

저장소 계정: Azure 저장소에 대한 모든 액세스는 저장소 계정을 통해 수행됩니다. 이 저장소 계정은 범용 저장소 계정이거나, 개체/Blob 저장용으로 특화된 Blob 저장소 계정이 될 수 있습니다. 저장소 계정에 대한 자세한 내용은 Azure 저장소 계정을 참조하세요.
컨테이너: 컨테이너는 Blob 집합 그룹화를 제공합니다. 모든 Blob은 컨테이너에 있어야 합니다. 한 계정에 포함될 수 있는 컨테이너 수에는 제한이 없습니다. 한 컨테이너에 저장될 수 있는 Blob 수에도 제한이 없습니다. 컨테이너 이름은 소문자여야 합니다.
Blob: 모든 형식과 크기의 파일입니다. Azure 저장소에는 블록 Blob, 페이지 Blob 및 추가 Blob의 세 가지 Blob 유형이 있습니다.

블록 Blob 은 문서 및 미디어 파일과 같은 텍스트 또는 이진 파일을 저장하기에 적합합니다.추가 Blob 은 블록으로 구성된다는 점에서 블록 Blob과 유사하지만 추가 작업에 최적화되었으므로 로깅 시나리오에 유용합니다. 단일 블록 Blob 또는 추가 Blob은 195GB(4MB X 50,000) 이상의 총 크기에 대해 최대 각 4MB의 최대 50,000 블록을 포함할 수 있습니다.

페이지 Blob 은 최대 1TB 크기까지 가능하며 빈번한 읽기/쓰기 작업에 대해 더 효율적입니다. Azure 가상 컴퓨터는 OS 및 데이터 디스크로 페이지 Blob을 사용합니다.

컨테이너 및 Blob를 명명하는 세부 정보는 컨테이너, Blob 및 메타데이터 명명 및 참조를 참조하세요.

Azure 저장소 계정 만들기

첫 번째 Azure 저장소 계정을 가장 쉽게 만드는 방법은 Azure 포털을 사용하는 것입니다. 자세한 내용은 저장소 계정 만들기를 참조하십시오.

Azure PowerShell, Azure CLI 또는 .NET용 저장소 리소스 공급자 클라이언트 라이브러리를 사용하여 Azure 저장소 계정을 만들 수도 있습니다.

또한 이번에 저장소 계정을 만들지 않으려는 경우 Azure 저장소 에뮬레이터를 사용하여 로컬 환경에서 코드를 실행하고 테스트할 수 있습니다. 자세한 내용은 개발 및 테스트에 Azure 저장소 에뮬레이터 사용을 참조하세요.

Ruby 응용 프로그램 만들기

Ruby 응용 프로그램을 만듭니다. 지침은 Azure VM의 Ruby on Rails 웹 응용 프로그램을 참조하세요.

저장소에 액세스하도록 응용 프로그램 구성

Azure 저장소를 사용하려면 저장소 REST 서비스와 통신하는 편리한 라이브러리 집합이 포함된 Ruby Azure 패키지를 다운로드하여 사용해야 합니다.

RubyGems를 사용하여 패키지 가져오기

PowerShell(Windows), Terminal(Mac) 또는 Bash(Unix)와 같은 명령줄 인터페이스를 사용합니다.
명령 창에 "gem install azure"를 입력하여 gem 및 종속성을 설치합니다.

패키지 가져오기

원하는 텍스트 편집기를 사용하여 저장소를 사용하려는 Ruby 파일의 맨 위에 다음을 추가합니다.

require "azure"

Azure 저장소 연결 설정

Azure 모듈은 AZURE_STORAGE_ACCOUNT 및 AZURE_STORAGE_ACCESS_KEY 환경 변수를 읽고 Azure 저장소 계정에 연결하는 데 필요한 정보를 확인합니다. 이러한 환경 변수가 설정되지 않으면 Azure::Blob::BlobService를 사용하기 전에 다음 코드로 계정 정보를 지정해야 합니다.

Azure.config.storage_account_name = "<your azure storage account>"
Azure.config.storage_access_key = "<your azure storage access key>"

Azure 포털의 클래식 또는 ARM 저장소 계정에서 이러한 값을 가져오려면

Azure 포털에 로그인합니다.
사용하려는 저장소 계정으로 이동합니다.
오른쪽의 설정 블레이드에서 액세스 키를 클릭합니다.
나타나는 액세스 키 블레이드에 액세스 키 1 및 액세스 키 2가 표시되어 있습니다. 이 둘 중 하나를 사용할 수 있습니다.
복사 아이콘을 클릭하여 키를 클립보드에 복사합니다.

클래식 포털의 클래식 저장소 계정에서 이러한 값을 가져오려면

클래식 포털에 로그인합니다.
사용하려는 저장소 계정으로 이동합니다.
탐색 창 아래쪽에서 액세스 키 관리를 클릭합니다.
팝업 대화 상자에 저장소 계정 이름, 기본 액세스 키 및 보조 액세스 키가 표시됩니다. 액세스 키의 경우 기본 액세스 키 또는 보조 액세스 키를 사용할 수 있습니다.
복사 아이콘을 클릭하여 키를 클립보드에 복사합니다.

컨테이너 만들기

Azure 저장소의 모든 Blob은 컨테이너에 있어야 합니다. 컨테이너는 Blob 이름의 일부를 형성합니다. 예를 들어 mycontainer은(는) 이러한 샘플 Blob URI에서 컨테이너의 이름입니다.

https://storagesample.blob.core.windows.net/mycontainer/blob1.txt
https://storagesample.blob.core.windows.net/mycontainer/photos/myphoto.jpg

컨테이너 이름은 유효한 DNS 이름이어야 하고 다음 명명 규칙을 따라야 합니다.

컨테이너 이름은 문자 또는 숫자로 시작해야 하며 문자, 숫자 및 대시(-) 문자를 포함할 수 있습니다.
컨테이너 이름에서 모든 대시(-) 문자는 문자 또는 숫자 바로 앞뒤에 와야 하며 연속 대시를 사용할 수 없습니다.
컨테이너 이름의 모든 문자는 소문자여야 합니다.
컨테이너 이름의 길이는 3자 이상, 63자 이하여야 합니다.

중요:

컨테이너의 이름은 항상 소문자여야 합니다. 컨테이너 이름에 대문자를 포함하거나 컨테이너 명명 규칙을 위반하는 경우에 400 오류(잘못된 요청) 메시지를 받을 수 있습니다.

Azure::Blob::BlobService 개체를 통해 컨테이너 및 Blob에 대한 작업을 할 수 있습니다. 컨테이너를 만들려면 create_container() 메서드를 사용합니다.

다음 코드 예제에서는 컨테이너를 만들거나, 컨테이너가 있을 경우 오류를 출력합니다.

azure_blob_service = Azure::Blob::BlobService.new
begin
  container = azure_blob_service.create_container("test-container")
rescue
  puts $!
end

컨테이너 파일을 공용으로 지정하려는 경우 컨테이너의 사용 권한을 설정할 수 있습니다.

: public_access_level옵션 전달하기를 호출하여 create_container ()를 수정할 수 있습니다.

container = azure_blob_service.create_container("test-container",
  :public_access_level => "<public access level>")

유효한 :public_access_level 옵션 값은 다음과 같습니다.

blob: 컨테이너 및 blob 데이터에 대한 전체 공용 읽기 액세스 권한을 지정 합니다. 클라이언트는 익명 요청을 통해 컨테이너 내에서 Blob을 열거할 수 있지만 저장소 계정 내에서 컨테이너를 열거할 수는 없습니다.
컨테이너: blob에 대한 공용 읽기 액세스 권한을 지정 합니다. 이 컨테이너 내의 Blob 데이터는 익명 요청을 통해 읽을 수 있으나 컨테이너 데이터는 읽을 수 없습니다. 클라이언트는 익명 요청을 통해 컨테이너 내의 Blob을 열거할 수 없습니다.

또는 set_container_acl() 메서드로 공용 액세스 수준을 지정하여 컨테이너의 공용 액세스 수준을 수정할 수 있습니다.

다음 코드 예제에서는 공용 액세스 수준을 container로 변경합니다.

azure_blob_service.set_container_acl('test-container', "container")

컨테이너에 Blob 업로드

Blob에 콘텐츠를 업로드하려면 create_block_blob() 메서드를 사용하여 Blob을 만들고 Blob의 콘텐츠로 파일이나 문자열을 사용합니다.

다음 코드에서는 test.png 파일을 "image-blob"이라는 새 Blob으로 컨테이너에 업로드합니다.

content = File.open("test.png", "rb") { |file| file.read }
blob = azure_blob_service.create_block_blob(container.name,
  "image-blob", content)
puts blob.name

컨테이너의 Blob 나열

컨테이너를 나열하려면 list_containers() 메서드를 사용합니다. 컨테이너 내에 Blob을 나열하려면 list_blobs() 메서드를 사용합니다.

이 메서드는 계정에 대해 모든 컨테이너에 있는 모든 Blob의 URL을 출력합니다.

containers = azure_blob_service.list_containers()
containers.each do |container|
  blobs = azure_blob_service.list_blobs(container.name)
  blobs.each do |blob|
    puts blob.name
  end
end

Blob 다운로드

Blob을 다운로드하려면 get_blob() 메서드를 사용하여 콘텐츠를 가져옵니다.

다음 코드 예제에서는 get_blob()을 사용하여 "image-blob"의 콘텐츠를 다운로드하고 그 콘텐츠를 로컬 파일에 쓰는 방법을 보여 줍니다.

blob, content = azure_blob_service.get_blob(container.name,"image-blob")
File.open("download.png","wb") {|f| f.write(content)}

Blob 삭제

마지막으로 Blob을 삭제하려면 delete_blob() 메서드를 사용합니다. 다음 코드 예제에서는 Blob을 삭제하는 방법을 보여 줍니다.

azure_blob_service.delete_blob(container.name, "image-blob")

ID 생성