로컬 개발환경에서 Azure Storage Emulator (Azurite) 사용하기

Microsoft에서는 Azure Storage를 로컬환경에서 실행 할 수 있는 Azurite를 제공해주고 있습니다. Azurite를 이용해서 로컬환경에서 Azure Blob, Table, Queue Storage 를 이용한 개발 및 테스트 할 수 있습니다.

참고: 개발 및 테스트에 Azure Storage 에뮬레이터 사용(사용되지 않음) | Microsoft Learn

본 포스팅에서는 Visual Studio Code에서 Azurite을 설치하고 사용하는 방법에 대해서 소개하도록 하겠습니다.

준비사항
설정방법
  1. 프로젝트 생성 후, Visual Studio Code를 실행합니다.

2. Azurite Extension을 검색 후 설치합니다.

3. Azurite 설치 후 Extension Settings을 선택합니다.

4. Settings에서 Azure Storage Emulator의 설정 값 (listening endpoint, port)을 변경 할 수 있습니다.

Azurite의 Location은 Azurite의 데이터가 저장될 위치를 의미합니다. 여기에서는 ./azureStorage로 설정하였습니다.

5. Azurite에서 Blob Service를 실행합니다.

Blob Service를 실행하면 Visual Studio Code 우측 하단에 Azurite Blob Service Successfully… 라는 메시지를 확인 할 수 있습니다.

Azurite의 사용법은 다음과 같습니다.

6. Azurite이 정상적으로 실행되면 프로젝트 폴더아래 azureStorage 폴더가 생성된 것을 확인 할 수 있습니다. Azurite 설정에서 다른 Location을 설정하면 해당 폴더가 생성된 것을 확인 할 수 있습니다.

7. Azure Storage Explorer를 실행 후 Emulator 와 연결합니다.

Azure Storage Emulator의 Account name과 Account key 정보는 다음과 같습니다.

  • Account name: devstoreaccount1
  • Account key: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

참고: Use Azurite emulator for local Azure Storage development | Microsoft Learn

8. 새로운 Blob Container를 생성합니다. 본 예제에서는 test-container로 생성했습니다.

9. 생성된 test-container에 Upload를 합니다.

여기에서는 test.txt 파일을 업로드하였습니다.

업로드가 완료되면 다음과 같은 화면을 볼 수 있습니다.

10. Visual Studio Code의 File Explorer를 보면 azureStaoge아래 __blobstorage__아래 새로운 파일이 생성된 것을 확인 할 수 있습니다. 해당 내용을 확인해보면 위에서 업로드했던 test.txt와 동일한 내용이 있는 것을 확인 할 수 있습니다.

11. 사용 후에는 Visual Studio Code 에서 Azurite을 종료 할 수 있습니다.

Storage Explore를 통해서 정상 종료 된 것을 확인 할 수 있습니다.

코드

마무리

본 포스팅에서는 Visual Studio Code에서 Azurite을 설치하고 사용하는 방법에 대해서 살펴보았습니다. Azurite을 이용하면 클라우드 리소스가 아닌 로컬환경에서 Azure Blob, Queue, Table Storage를 사용할 수 있습니다.

참고자료
  1. Upload file to Storage – Azure | Microsoft Learn
  2. Use Azurite emulator for local Azure Storage development | Microsoft Learn

Leave a Comment