로컬 Azure Storage 개발에 Azurite 에뮬레이터 사용

Azurite 오픈 소스 에뮬레이터는 클라우드 기반 애플리케이션을 테스트하기 위한 무료 로컬 환경을 제공합니다. 애플리케이션이 로컬로 작동하는 방식에 만족하는 경우 클라우드에서 Azure Storage 계정 사용으로 전환합니다.

Azurite는 JavaScript로 작성된 경량 스토리지 에뮬레이터이며 로컬 개발을 위해 Azure Storage 서비스를 시뮬레이션하는 Node.js 실행됩니다. Blob, Queue 및 Table Storage 서비스를 지원하고 Windows, Linux 및 macOS에서 플랫폼 간 지원을 제공합니다. Azurite 설치 및 실행에 대한 도움말은 Azurite 에뮬레이터 설치 및 실행을 참조하세요.

또한 Azurite를 사용하면 개발자가 로컬 스토리지 환경에 대한 테스트를 실행하여 통합 및 엔드투엔드 테스트에 중요한 Azure의 동작을 시뮬레이션할 수 있습니다. 자동화된 테스트에 Azurite를 사용하는 방법에 대한 자세한 내용은 Azurite를 사용하여 자동화된 테스트를 실행하는 방법을 참조하세요.

Azurite는 Azure Storage Emulator를 대체하여 Azure Storage API의 최신 버전을 지원하도록 계속 업데이트됩니다.

Azurite와 Azure Storage의 차이점

Azurite의 로컬 인스턴스와 클라우드의 Azure Storage 계정 간에는 기능적 차이점이 있습니다.

엔드포인트 및 연결 URL

Azurite의 서비스 엔드포인트는 Azure Storage 계정의 엔드포인트와 다릅니다. 로컬 컴퓨터에서 도메인 이름 확인을 수행하지 않으므로 Azuite 엔드포인트가 로컬 주소여야 합니다.

Azure Storage 계정의 리소스 주소를 지정하는 경우 계정 이름은 URI 호스트 이름의 일부입니다. 주소가 지정되는 리소스는 URI 경로의 일부입니다.

<http|https>://<account-name>.<service-name>.core.windows.net/<resource-path>

다음 URI는 Azure Storage 계정의 Blob에 대한 유효한 주소입니다.

https://myaccount.blob.core.windows.net/mycontainer/myblob.txt

IP 스타일 URL

로컬 컴퓨터에서 도메인 이름 확인을 수행하지 않으므로 계정 이름이 호스트 이름 대신 URI 경로에 포함됩니다. 다음 URI 형식을 Azurite의 리소스에 사용합니다.

http://<local-machine-address>:<port>/<account-name>/<resource-path>

Azurite에서 Blob에 액세스하는 데 다음 주소를 사용할 수 있습니다.

http://127.0.0.1:10000/myaccount/mycontainer/myblob.txt

프로덕션 스타일 URL

필요에 따라 프로덕션 스타일 URL을 사용하여 계정에 액세스하도록 호스트 파일을 수정할 수 있습니다.

먼저 호스트 파일에 하나 이상의 줄을 추가합니다. 다음은 그 예입니다.

127.0.0.1 account1.blob.localhost
127.0.0.1 account1.queue.localhost
127.0.0.1 account1.table.localhost

다음으로, 사용자 지정된 스토리지 계정 및 키를 사용하도록 환경 변수를 설정합니다.

set AZURITE_ACCOUNTS="account1:key1:key2"

계정을 더 추가할 수 있습니다. Azurite에 연결 문서의 사용자 지정 스토리지 계정 및 키 섹션을 참조하세요.

Azurite를 시작하고 사용자 지정된 연결 문자열을 사용하여 계정에 액세스합니다. 다음 예제에서는 연결 문자열이 기본 포트를 사용한다고 가정합니다.

DefaultEndpointsProtocol=http;AccountName=account1;AccountKey=key1;BlobEndpoint=http://account1.blob.localhost:10000;QueueEndpoint=http://account1.queue.localhost:10001;TableEndpoint=http://account1.table.localhost:10002;

Azure Storage Explorer에서는 이 방법으로 기본 계정에 액세스하지 마세요. Storage Explorer가 항상 URL 경로에 계정 이름을 추가하여 오류가 발생하는 버그가 있습니다.

기본적으로 프로덕션 스타일 URL과 함께 Azurite를 사용하는 경우 계정 이름은 http://devstoreaccount1.blob.localhost:10000/container와 같은 정규화된 도메인 이름의 호스트 이름이어야 합니다. http://foo.bar.com:10000/devstoreaccount1/container와 같은 URL 경로 형식의 계정 이름에 프로덕션 스타일 URL을 사용하려면 Azurite를 시작할 때 --disableProductStyleUrl 매개 변수를 사용해야 합니다.

host.docker.internal을 요청 Uri 호스트로 사용하는 경우(예: http://host.docker.internal:10000/devstoreaccount1/container) Azurite는 요청 Uri 경로에서 계정 이름을 가져옵니다. 이 동작은 Azurite를 시작할 때 --disableProductStyleUrl 매개 변수를 사용하는지 여부에 관계없이 항상 적용됩니다.

스케일링 및 성능

Azurite는 많은 수의 연결된 클라이언트를 지원하지 않습니다. 성능을 보장하지 않습니다. Azurite는 개발 및 테스트용으로 사용됩니다.

오류 처리

Azurite는 Azure Storage 오류 처리 논리와 일치하지만 차이점이 있습니다. 예를 들어 오류 상태 코드가 일치하지만 오류 메시지가 다를 수 있습니다.

RA-GRS

Azurite는 RA-GRS(읽기 액세스 지역 중복 복제)를 지원합니다. 스토리지 리소스의 경우 -secondary를 계정 이름에 추가하여 보조 위치에 액세스합니다. 예를 들어 Azurite에서 읽기 전용 보조 계정을 사용하여 Blob에 액세스하는 데 다음 주소를 사용할 수 있습니다.

http://127.0.0.1:10000/devstoreaccount1-secondary/mycontainer/myblob.txt

테이블 지원

Azurite의 테이블에 대한 지원은 현재 미리 보기로 제공됩니다. 자세한 내용은 Azurite V3 Table 프로젝트를 참조하세요.

지속성 함수를 지원하려면 테이블이 필요합니다.

오픈 소스인 Azurite

Azurite에 대한 기여와 제안을 환영합니다. 예정된 기능 및 버그 수정을 추적하기 위해 마일스톤 및 작업 항목을 확인하려면 Azurite GitHub 프로젝트 페이지 또는 GitHub 문제로 이동합니다. 자세한 작업 항목은 GitHub에서도 추적됩니다.

작업 영역 구조

Azurite를 초기화하면 작업 영역 위치에서 다음 파일 및 폴더를 만들 수 있습니다.

• __blobstorage__ - Azurite Blob service 지속형 이진 데이터가 포함된 디렉터리
• __queuestorage__ - Azurite 큐 서비스 지속형 이진 데이터가 포함된 디렉터리
• __tablestorage__ - Azurite 테이블 서비스 지속형 이진 데이터가 포함된 디렉터리
• __azurite_db_blob__.json - Azurite Blob service 메타데이터 파일
• __azurite_db_blob_extent__.json - Azurite Blob service 익스텐트 메타데이터 파일
• __azurite_db_queue__.json - Azurite 큐 서비스 메타데이터 파일
• __azurite_db_queue_extent__.json - Azurite 큐 서비스 익스텐트 메타데이터 파일
• __azurite_db_table__.json - Azurite 테이블 서비스 메타데이터 파일
• __azurite_db_table_extent__.json - Azurite 테이블 서비스 익스텐트 메타데이터 파일

Azurite를 정리하려면 파일 및 폴더를 삭제하고 에뮬레이터를 다시 시작합니다.

다음 단계

• Azurite 에뮬레이터 설치 및 실행 은 로컬 컴퓨터에서 Azurite를 설치하고 실행하는 방법을 설명합니다.
• SDK 및 도구를 사용하여 Azurite에 연결 하여 다양한 Azure Storage SDK 및 도구를 사용하여 Azurite에 연결하는 방법을 설명합니다.
• 개발 및 테스트에 Azure Storage 에뮬레이터 사용은 Azurite로 대체되는 레거시 Azure Storage 에뮬레이터에 대해 설명합니다.