azure-storage-lib

• azure-storage 중 blob 을 사용하여 upload, delete, get file download url 등의 기능이 포함되어 있는 utility를 구현
• 블록 Blob 은 문서 및 미디어 파일과 같은 텍스트 또는 이진 파일을 저장하기에 적합하다
• 해당 프로젝트를 정상적으로 실행하기 위해서는 application.properties의 azure.storage.connection-string 값을 추가하여야 한다. (7번 참고)

1. Azure CLI 사용

• Azure CLI는 Azure 리소스를 관리할 수있는 커맨드 라인 도구이다.
• 따로 로컬에 Azure CLI를 설치하고 싶지 않다면 Azure Cloud Shell 을 사용해도 된다.
• Azure CLI 설치 링크
• Azure CLI에서 작업을 실행하기 위해서는 로그인 인증이 필요하다. 커맨드 라인에 $az login 이라고 입력하면 특정 코드를 응답으로 준다. 이 코드를 https://microsoft.com/devicelogin 페이지에 접속하여 입력 한 후, 특정 계정과 연결하면 로컬에서도 azure 서비스를 사용할 수 있다.

$ az login
>> To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code {코드명} to authenticate.

2. 저장소 계정 생성

• 저장소 계정 만들기 참고

3. Azure CLI를 사용하여 blob 업로드, 다운로드, 리스트 조회

• Azure CLI를 사용하여 BLOB 업로드, 다운로드 및 나열

4. Azure용 Spring Boot Starter

• Azure용 Spring Boot Starter 참고

5. Blob 저장소에 관한 문서

• Azure Blob 저장소는 최대 블록 크기가 4MB이다.
• 모든 블록은 Azure에 업로드되고 개별적으로 저장되어 모든 블록이 성공적으로 전송되면 논리적으로 결합되고 정렬된다.
• 그러므로 순차적으로 한번에 4MB의 블록만을 업로드 한다면 시간이 오래 걸린다.
• Blob 저장소 소개

6. 대용량의 Blob을 빠르게 업로드할 경우

• 블록을 병렬로 업로드 해야한다.
• 해당 예제에서는 BlobRequestOptions.setConcurrentRequestCount()을 사용하여, 동시에 업로드 할 요청의 수를 설정한다.
• default 요청의 수는 1이다.
• 154MB의 파일을 업로드 했을 때, concurrentRequestCount의 숫자가 1일 경우에는 약 17.4초, concurrentRequestCount의가 8일 경우에는 약 5.2초가 소요되었다.
• Azure Storage 성능 및 확장성

7. azure.storage.connection-string 값

• application.properties의 azure.storage.connection-string 값을 구하기 위해 다음과 같이 실행

$ az storage account show-connection-string --name {저장소} --resource-group {리소스그룹명}

8. SAS

• 공유 액세스 서명을 사용하면 클라이언트에게 제한된 엑세스 권한을 부여할 수 있다.
• 읽기 및 쓰기 권한 부여, 만료 시간, IP 주소 제한, 프로토콜 제한 등의 제어가 가능하다
• SAS URI = Storage Resource URI + SAS Token
• SAS의 만료 시간과 시작 시간은 UTC로 표시해야 한다.
• SAS(공유 엑세스 서명) 참고

9. 용어 설명

• CloudStorageAccount : Azure Storage 계정 관련 클래스. CloudStorageAccount.createCloudBlobClient() 메소드를 통해 blob 서비스 클라이언트를 생성할 수 있다.
• CloudBlobClient : Azure Blob 서비스에 액세스 할 수 있는 클라이언트 정보를 가지고 있는 클래스

참고

• Azure Blob Storage - Java Examples