Menggunakan emulator Azurite untuk pengembangan Azure Storage lokal

Emulator sumber terbuka Azurite menyediakan lingkungan lokal gratis untuk menguji aplikasi Azure blob, penyimpanan antrean, dan penyimpanan tabel Anda. Saat Anda merasa puas dengan cara kerja aplikasi Anda secara lokal, beralihlah menggunakan akun Azure Storage di cloud. Emulator menyediakan dukungan lintas platform di Windows, Linux, dan macOS.

Azurite merupakan platform emulator penyimpanan masa depan. Azurite menggantikan Emulator Azure Storage. Azurite akan terus diperbarui untuk mendukung versi terbaru API Azure Storage.

Ada beberapa cara berbeda untuk memasang dan menjalankan Azurite di sistem lokal Anda. Pilih salah satu tab ini.

Instal Azurite

Visual Studio

Azurite tersedia secara otomatis dengan Visual Studio 2022. Jika Anda menjalankan versi Visual Studio yang lebih lama, Anda harus menginstal Azurite dengan menggunakan Node Package Manager, DockerHub, atau dengan mengkloning repositori GitHub Azurite.

Visual Studio Code

Dalam Visual Studio Code, pilih panel EXTENSIONS dan cari Azurite di EXTENSIONS:MARKETPLACE.

Anda juga dapat mengarahkan ke marketplace ekstensi Visual Studio Code di browser Anda. Pilihlah tombol Instal untuk membuka Visual Studio Code dan buka langsung halaman ekstensi Azurite.

Untuk mengonfigurasikan Azurite dalam Visual Studio Code, pilih panel ekstensi. Pilih ikon Kelola (roda gigi) untuk Azurite. Pilihlah Pengaturan Ekstensi.

Pengaturan berikut ini didukung:

• Azurite: Blob Host - Titik akhir mendengarkan Blob service. Pengaturan defaultnya adalah 127.0.0.1.
• Azurite: Blob Port - Port mendengarkan Blob service. Port defaultnya adalah 10000.
• Azurite: Cert - Jalur ke jalur file sertifikat PEM atau PFX yang tepercaya secara lokal untuk mengaktifkan mode HTTPS.
• Azurite: Debug - Melakukan output log debug ke saluran Azurite. Nilai defaultnya adalah salah.
• Azurite: Key - Jalur ke file kunci PEM yang tepercaya secara lokal, diperlukan saat Azurite: Cert menunjuk ke file PEM.
• Azurite: Location - Jalur lokasi ruang kerja. Defaultnya adalah folder aktif Visual Studio Code.
• Azurite: Loose - Mengaktifkan mode longgar yang mengabaikan header dan parameter yang tidak didukung.
• Azurite: Oauth - Tingkat OAuth opsional.
• Azurite: Pwd - Kata sandi untuk file PFX. Diperlukan saat Azurite: Cert menunjuk ke file PFX.
• Azurite: Queue Host - Titik akhir mendengarkan layanan Antrean. Pengaturan defaultnya adalah 127.0.0.1.
• Azurite: Queue Port - Port mendengarkan layanan Antrean. Port defaultnya adalah 10001.
• Azurite: Silent - Mode diam menonaktifkan log akses. Nilai defaultnya adalah salah.
• Azurite: Skip Api Version Check - Melompati pemeriksaan versi API permintaan. Nilai defaultnya adalah salah.
• Azurite: Table Host - Titik akhir mendengarkan layanan Tabel, dengan pengaturan default 127.0.0.1.
• Azurite: Table Port - Port mendengarkan layanan Tabel, dengan default 10002.

npm

Metode penginstalan ini mengharuskan Anda menginstal Node.js versi 8.0 atau yang lebih baru. Node Package Manager (npm) adalah alat manajemen paket yang disertakan dengan setiap penginstalan Node.js. Setelah menginstal Node.js, jalankan perintah npm berikut untuk menginstal Azurite.

npm install -g azurite

Docker Hub

Gunakan DockerHub untuk menarik gambar Azurite terbaru menggunakan perintah berikut:

docker pull mcr.microsoft.com/azure-storage/azurite

Jalankan gambar Azurite Docker:

Perintah berikut ini menjalankan gambar Azurite Docker. Parameter -p 10000:10000 mengalihkan permintaan dari port mesin host 10000 ke instans Docker.

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \
    mcr.microsoft.com/azure-storage/azurite

Tentukan lokasi ruang kerja:

Dalam contoh berikut, parameter -v c:/azurite:/data menentukan c:/azurite sebagai lokasi data tetap azurite. Direktori c:/azurite harus dibuat sebelum menjalankan perintah Docker.

docker run -p 10000:10000 -p 10001:10001 -p 10002:10002 \
    -v c:/azurite:/data mcr.microsoft.com/azure-storage/azurite

Jalankan blob service saja

docker run -p 10000:10000 mcr.microsoft.com/azure-storage/azurite \
    azurite-blob --blobHost 0.0.0.0 --blobPort 10000

Untuk informasi selengkapnya tentang mengonfigurasikan Azurite saat memulai, lihat Opsi baris perintah.

GitHub

Metode instalasi ini mengharuskan Anda menginstal Git dan Node.js versi 8.0 atau yang lebih baru. Klon Repositori GitHub untuk proyek Azurite dengan menggunakan perintah konsol berikut.

git clone https://github.com/Azure/Azurite.git

Setelah melakukan klon kode sumber, jalankan perintah berikut dari root repositori yang diklon untuk membangun dan menginstal Azurite.

npm install
npm run build
npm install -g

Jalankan Azurite

Visual Studio

Dengan beberapa konfigurasi, Azure Functions atau proyek ASP.NET memulai Azurite secara otomatis. Untuk semua jenis proyek lainnya, Anda harus memulai Azurite dari baris perintah.

Menjalankan Azurite dari baris perintah

Anda dapat menemukan file eksekusi Azurite di folder ekstensi instalasi Visual Studio Anda. Lokasi spesifik dapat bervariasi berdasarkan versi Visual Studio yang telah Anda instal. Misalnya, jika Anda telah menginstal edisi profesional Visual Studio 2022 pada komputer Windows atau Mesin Virtual (VM), Anda akan menemukan file eksekusi Azurite di lokasi ini: C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE\Extensions\Microsoft\Azure Storage Emulator.

Setelah Anda menjalankan file yang dapat dieksekusi, Azurite mendengarkan koneksi.

Menjalankan Azurite dari proyek Azure Functions

Di Visual Studio 2022, buat proyek Azure Functions. Saat Anda membuat proyek, pilih Storage Emulator.

Setelah Anda membuat proyek, Azurite dimulai secara otomatis.

Menjalankan Azurite dari proyek ASP.NET

Di Visual Studio 2022, buat proyek Aplikasi Web ASP.NET Core. Kemudian, buka kotak dialog Layanan Terhubung, pilih Tambahkan dependensi layanan, lalu pilih emulator Storage Azurite.

Di kotak dialog Konfigurasikan emulator Storage Azurite, atur bidang Nama string koneksi ke StorageConnectionString, lalu pilih Selesai.

Setelah konfigurasi selesai, pilih Tutup. Emulator Azurite dimulai secara otomatis.

Visual Studio Code

Catatan

Azurite tidak dapat dijalankan dari baris perintah jika Anda hanya menginstal ekstensi Visual Studio Code. Sebaliknya, gunakan palet perintah Visual Studio Code.

Ekstensi mendukung perintah Visual Studio Code berikut. Untuk membuka palet perintah, tekan F1 di Visual Studio Code.

• Azurite: Clean - Mengatur ulang semua data persistensi layanan Azurite
• Azurite: Clean Blob Service - Membersihkan layanan blob
• Azurite: Clean Queue Service - Membersihkan layanan antrean
• Azurite: Clean Table Service - Layanan meja bersih
• Azurite: Close - Menutup semua layanan Azurite
• Azurite: Close Blob Service - Menutup layanan blob
• Azurite: Close Queue Service - Menutup layanan antrean
• Azurite: Close Table Service - Menutup layanan meja
• Azurite: Start - Memulai semua layanan Azurite
• Azurite: Start Blob Service - Memulai layanan blob
• Azurite: Start Queue Service - Memulai layanan antrean
• Azurite: Start Table Service - Memulai layanan tabel

npm

Luncurkan Azurite dengan menerbitkan perintah berikut:

azurite --silent --location c:\azurite --debug c:\azurite\debug.log

Perintah ini meminta Azurite untuk menyimpan semua data di direktori tertentu, c:\azurite. Jika opsi --location dihilangkan, perintah tersebut akan menggunakan direktori kerja saat ini.

Docker Hub

Jalankan blob service saja

docker run -p 10000:10000 mcr.microsoft.com/azure-storage/azurite \
    azurite-blob --blobHost 0.0.0.0 --blobPort 10000

Untuk informasi selengkapnya tentang mengonfigurasikan Azurite saat memulai, lihat Opsi baris perintah.

GitHub

Untuk segera memulai baris perintah, buat direktori yang bernama c:\azurite, kemudian luncurkan Azurite dengan mengeluarkan perintah berikut:

azurite --silent --location c:\azurite --debug c:\azurite\debug.log

Perintah ini meminta Azurite untuk menyimpan semua data di direktori tertentu, c:\azurite. Jika opsi --location dihilangkan, perintah tersebut akan menggunakan direktori kerja saat ini.

Opsi baris perintah

Bagian ini merinci tombol baris perintah yang tersedia saat meluncurkan Azurite.

Bantuan

Opsional - Dapatkan bantuan baris perintah dengan menggunakan tombol -h atau --help.

azurite -h
azurite --help

Host mendengarkan Blob

Opsional - Secara default, Azurite akan mendengarkan 127.0.0.1 sebagai server lokal. Gunakan tombol --blobHost untuk mengatur alamat ke persyaratan Anda.

Terima permintaan pada mesin lokal saja:

azurite --blobHost 127.0.0.1

Izinkan permintaan jarak jauh:

azurite --blobHost 0.0.0.0

Perhatian

Mengizinkan permintaan jarak jauh dapat membuat sistem Anda rentan terhadap serangan eksternal.

Konfigurasi port mendengarkan Blob

Opsional - Secara default, Azurite akan mendengarkan Blob service di port 10000. Gunakan tombol --blobPort untuk menetapkan port mendengarkan yang Anda perlukan.

Catatan

Setelah menggunakan port yang disesuaikan, Anda perlu memperbarui string koneksi atau konfigurasi terkait di alat Azure Storage atau SDK Anda.

Sesuaikan port mendengarkan Blob service:

azurite --blobPort 8888

Biarkan sistem memilih port yang tersedia secara otomatis:

azurite --blobPort 0

Port yang digunakan ditampilkan selama memulai Azurite.

Host mendengarkan Antrean

Opsional - Secara default, Azurite akan mendengarkan 127.0.0.1 sebagai server lokal. Gunakan tombol --queueHost untuk mengatur alamat ke persyaratan Anda.

Terima permintaan pada mesin lokal saja:

azurite --queueHost 127.0.0.1

Izinkan permintaan jarak jauh:

azurite --queueHost 0.0.0.0

Perhatian

Mengizinkan permintaan jarak jauh dapat membuat sistem Anda rentan terhadap serangan eksternal.

Konfigurasi port mendengarkan Antrean

Opsional - Secara default, Azurite akan mendengarkan layanan Antrean di port 10001. Gunakan tombol --queuePort untuk menetapkan port mendengarkan yang Anda perlukan.

Catatan

Setelah menggunakan port yang disesuaikan, Anda perlu memperbarui string koneksi atau konfigurasi terkait di alat Azure Storage atau SDK Anda.

Sesuaikan port mendengarkan layanan Antrean:

azurite --queuePort 8888

Biarkan sistem memilih port yang tersedia secara otomatis:

azurite --queuePort 0

Port yang digunakan ditampilkan selama memulai Azurite.

Host mendengarkan tabel

Opsional - Secara default, Azurite akan mendengarkan 127.0.0.1 sebagai server lokal. Gunakan tombol --tableHost untuk mengatur alamat ke persyaratan Anda.

Terima permintaan pada mesin lokal saja:

azurite --tableHost 127.0.0.1

Izinkan permintaan jarak jauh:

azurite --tableHost 0.0.0.0

Perhatian

Mengizinkan permintaan jarak jauh dapat membuat sistem Anda rentan terhadap serangan eksternal.

Konfigurasi port mendengarkan tabel

Opsional - Secara default, Azurite akan mendengarkan layanan Tabel pada port 10002. Gunakan tombol --tablePort untuk menetapkan port mendengarkan yang Anda perlukan.

Catatan

Setelah menggunakan port yang disesuaikan, Anda perlu memperbarui string koneksi atau konfigurasi terkait di alat Azure Storage atau SDK Anda.

Sesuaikan port mendengarkan layanan Tabel:

azurite --tablePort 11111

Biarkan sistem memilih port yang tersedia secara otomatis:

azurite --tablePort 0

Port yang digunakan ditampilkan selama memulai Azurite.

Jalur ruang kerja

Opsional - Azurite menyimpan data ke disk lokal selama eksekusi. Gunakan tombol -l atau --location untuk menentukan jalur sebagai lokasi ruang kerja. Secara default, direktori kerja proses terkini akan digunakan. Perhatikan huruf kecil 'l'.

azurite -l c:\azurite
azurite --location c:\azurite

Log akses

Opsional - Secara default, log akses ditampilkan di jendela konsol. Nonaktifkan tampilan log akses dengan menggunakan tombol -s atau --silent.

azurite -s
azurite --silent

Log debug

Opsional - Log debug mencakup informasi detail tentang setiap permintaan dan pelacakan tumpukan pengecualian. Aktifkan log debug dengan memberikan jalur file lokal yang valid ke tombol -d atau --debug.

azurite -d path/debug.log
azurite --debug path/debug.log

Mode longgar

Opsional - Secara default, Azurite menerapkan mode ketat untuk memblokir header dan parameter permintaan yang tidak didukung. Nonaktifkan mode ketat dengan menggunakan tombol -L atau --loose. Perhatikan huruf kapital 'L'.

azurite -L
azurite --loose

Versi

Opsional - Tampilkan nomor versi Azurite yang diinstal dengan menggunakan tombol -v atau --version.

azurite -v
azurite --version

Konfigurasi sertifikat (HTTPS)

Opsional - Secara default, Azurite menggunakan protokol HTTP. Aktifkan mode HTTPS dengan memberikan jalur ke file sertifikat Privacy Enhanced Mail (.pem) atau Personal Information Exchange (.pfx) ke tombol --cert.

Saat --cert diberikan untuk file PEM, Anda harus memberikan tombol --key yang sesuai.

azurite --cert path/server.pem --key path/key.pem

Saat --cert diberikan untuk file PFX, Anda harus memberikan tombol --pwd yang sesuai.

azurite --cert path/server.pfx --pwd pfxpassword

Untuk informasi terperinci tentang membuat file PEM dan PFX, lihat Penyiapan HTTPS.

Konfigurasi OAuth

Opsional - Aktifkan autentikasi OAuth untuk Azurite dengan menggunakan tombol --oauth.

azurite --oauth basic --cert path/server.pem --key path/key.pem

Catatan

OAuth memerlukan titik akhir HTTPS. Pastikan HTTPS diaktifkan dengan memberikan tombol --cert bersama dengan tombol --oauth.

Azurite mendukung autentikasi dasar dengan menentukan parameter basic ke tombol --oauth. Azurite akan melakukan autentikasi dasar, seperti memvalidasi token pembawa yang masuk, memeriksa pengeluar sertifikat, audiens, dan kedaluwarsa. Azurite tidak akan memeriksa tanda tangan token atau izin.

Melompati Pemeriksaan Versi API

Opsional - Saat memulai, Azurite memeriksa versi API yang diminta valid. Perintah berikut melompati pemeriksaan versi API:

azurite --skipApiVersionCheck

Otorisasi untuk alat dan SDK

Sambungkan ke Azurite dari SDK Azure Storage atau alat, seperti Azure Storage Explorer dengan menggunakan strategi autentikasi apa pun. Autentikasi diperlukan. Azurite mendukung otorisasi dengan OAuth, Kunci Bersama, dan tanda tangan akses bersama (SAS). Azurite juga mendukung akses anonim ke kontainer publik.

Jika Anda menggunakan Azure SDK, mulai Azurite dengan opsi --oauth basic and --cert --key/--pwd.

Akun dan kunci penyimpanan terkenal

Azurite menerima akun dan kunci terkenal yang sama dengan yang digunakan oleh Emulator Azure Storage warisan.

• Nama akun: devstoreaccount1
• Kunci akun: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Akun dan kunci penyimpanan kustom

Azurite mendukung nama dan kunci akun penyimpanan kustom dengan mengatur variabel lingkungan AZURITE_ACCOUNTS dalam format berikut: account1:key1[:key2];account2:key1[:key2];....

Misalnya, gunakan akun penyimpanan kustom yang memiliki satu kunci:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Atau gunakan beberapa akun penyimpanan dengan setiap akun dua kunci:

set AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

export AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

Secara default, Azurite me-refresh nama dan kunci akun kustom dari variabel lingkungan setiap menit. Dengan fitur ini, Anda dapat memutar kunci akun secara dinamis atau menambahkan akun penyimpanan baru tanpa menghidupkan ulang Azurite.

Catatan

Akun penyimpanan devstoreaccount1 default dinonaktifkan saat Anda mengatur akun penyimpanan kustom.

String koneksi

Cara termudah terhubung ke Azurite dari aplikasi Anda adalah dengan mengonfigurasikan string koneksi di file konfigurasi aplikasi Anda yang mereferensikan pintasan UseDevelopmentStorage=true. Berikut adalah contoh string koneksi dalam file app.config:

<appSettings>
  <add key="StorageConnectionString" value="UseDevelopmentStorage=true" />
</appSettings>

String koneksi HTTP

Anda dapat meneruskan string koneksi berikut ke Azure SDK atau alat, seperti Azure CLI 2.0 atau Penjelajah Penyimpanan.

String koneksi lengkapnya adalah:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

Untuk menyambungkan ke blob service saja, string koneksinya adalah:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;

Untuk menyambungkan ke layanan antrean saja, string koneksinya adalah:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;

Untuk menyambungkan ke layanan tabel saja, string koneksinya adalah:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

String koneksi HTTPS

String koneksi HTTPS lengkapnya adalah:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;

Untuk menggunakan blob service saja, string koneksi HTTPS-nya adalah:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;

Untuk menggunakan layanan antrean saja, string koneksi HTTPS-nya adalah:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;

Untuk menggunakan layanan tabel saja, string koneksi HTTPS-nya adalah:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;

Jika Anda menggunakan dotnet dev-certs untuk membuat sertifikat yang ditandatangani sendiri, gunakan string koneksi berikut.

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://localhost:10000/devstoreaccount1;QueueEndpoint=https://localhost:10001/devstoreaccount1;TableEndpoint=https://localhost:10002/devstoreaccount1;

Perbarui string koneksi saat menggunakan akun dan kunci penyimpanan kustom.

Untuk informasi selengkapnya, lihat Mengonfigurasikan string koneksi Azure Storage.

Azure SDK

Untuk menggunakan Azurite dengan Azure SDK, gunakan opsi OAuth dan HTTPS:

azurite --oauth basic --cert certname.pem --key certname-key.pem

Azure Blob Storage

Anda kemudian dapat membuat instans BlobContainerClient, BlobServiceClient, atau BlobClient.

// With container URL and DefaultAzureCredential
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new BlobContainerClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;", "container-name"
  );

// With account name and key
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Azure Queue Storage

Anda juga dapat membuat instans QueueClient atau QueueServiceClient.

// With queue URL and DefaultAzureCredential
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new QueueClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;", "queue-name"
  );

// With account name and key
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Table Storage Azure

Anda juga dapat menggunakan TableClient atau TableServiceClient.

// With table URL and DefaultAzureCredential
var client = new Client(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new TableClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;", "table-name"
  );

// With account name and key
var client = new TableClient(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Penjelajah Penyimpanan Microsoft Azure

Anda dapat menggunakan Penjelajah Penyimpanan untuk melihat data yang disimpan di Azurite.

Tersambung ke Azurite menggunakan HTTP

Di Penjelajah Penyimpanan, sambungkan ke Azurite dengan mengikuti langkah-langkah berikut:

1. Pilih ikon Kelola Akun
2. Pilih Tambahkan akun
3. Pilih Lampirkan ke emulator lokal
4. Pilih Selanjutnya
5. Edit bidang Nama tampilan menjadi nama pilihan Anda
6. Pilih Selanjutnya lagi
7. Pilih Sambungkan

Tersambung ke Azurite menggunakan HTTPS

Secara default Penjelajah Penyimpanan tidak akan membuka titik akhir HTTPS yang menggunakan sertifikat yang ditandatangani sendiri. Jika Anda menjalankan Azurite dengan HTTPS, Anda mungkin menggunakan sertifikat yang ditandatangani sendiri. Di Penjelajah Penyimpanan, impor sertifikat SSL melalui dialog Edit ->Sertifikat SSL ->Impor Sertifikat.

Mengimpor Sertifikat ke Penjelajah Penyimpanan

1. Temukan sertifikat di mesin lokal Anda.
2. Di Penjelajah Penyimpanan, buka Edit ->Sertifikat SSL ->Impor Sertifikat dan impor sertifikat Anda.

Jika Anda tidak mengimpor sertifikat, Anda akan mendapatkan kesalahan:

unable to verify the first certificate atau self signed certificate in chain

Tambahkan Azurite melalui string koneksi HTTPS

Ikuti langkah-langkah berikut untuk menambahkan HTTPS Azurite ke Penjelajah Penyimpanan:

1. Pilihlah Aktifkan/Nonaktifkan Penjelajah
2. Pilih Lokal & Terlampir
3. Klik kanan pada Akun Penyimpanan dan pilih Sambungkan ke Azure Storage.
4. Pilih Gunakan string koneksi
5. Pilih Selanjutnya.
6. Masukkan nilai di bidang Nama tampilan.
7. Masukkan string koneksi HTTPS dari bagian sebelumnya pada dokumen ini
8. Pilih Selanjutnya
9. Pilih Sambungkan

Struktur ruang kerja

File dan folder berikut dapat dibuat di lokasi ruang kerja saat menginisialisasi Azurite.

• __blobstorage__ - Direktori yang berisi data biner tetap blob service Azurite
• __queuestorage__ - Direktori yang berisi data biner tetap layanan antrean Azurite
• __tablestorage__ - Direktori yang berisi data biner tetap layanan tabel Azurite
• __azurite_db_blob__.json - File metadata blob service Azurite
• __azurite_db_blob_extent__.json - File metadata jangkauan blob service Azurite
• __azurite_db_queue__.json - File metadata layanan antrean Azurite
• __azurite_db_queue_extent__.json - File metadata jangkauan layanan antrean Azurite
• __azurite_db_table__.json - File metadata layanan tabel Azurite
• __azurite_db_table_extent__.json - File metadata jangkauan layanan tabel Azurite

Untuk membersihkan Azurite, hapus file dan folder di atas dan hidupkan ulang emulator.

Perbedaan antara Azurite dan Azure Storage

Ada perbedaan fungsional antara instans lokal Azurite dan akun Azure Storage di cloud.

URL titik akhir dan koneksi

Titik akhir layanan untuk Azurite berbeda dari titik akhir akun Azure Storage. Komputer lokal tidak melakukan resolusi nama domain, mengharuskan titik akhir Azurite menjadi alamat lokal.

Saat Anda menangani sumber daya di akun Azure Storage, nama akun tersebut merupakan bagian dari nama host URI. Sumber daya yang ditangani merupakan bagian dari jalur URI:

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

URI berikut adalah alamat yang valid untuk blob di akun Azure Storage:

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

Karena komputer lokal tidak melakukan resolusi nama domain, nama akun adalah bagian dari jalur URI, bukan nama host. Gunakan format URI berikut ini untuk sumber daya di Azurite:

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

Alamat berikut mungkin digunakan untuk mengakses blob di Azurite:

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

Penskalaan dan performa

Azurite tidak mendukung klien yang tersambung dalam jumlah besar. Tidak ada jaminan performa. Azurite dimaksudkan untuk tujuan pengembangan dan pengujian.

Penanganan kesalahan

Azurite selaras dengan logika penanganan kesalahan Azure Storage, tetapi ada perbedaan. Misalnya, pesan kesalahan mungkin berbeda, sementara kode status kesalahan diselaraskan.

RA-GRS

Azurite mendukung replikasi geo redundan akses baca (RA-GRS). Untuk sumber daya penyimpanan, akses lokasi sekunder dengan menambahkan -secondary ke nama akun. Misalnya, alamat berikut mungkin digunakan untuk mengakses blob menggunakan sekunder baca-saja di Azurite:

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

Dukungan tabel

Dukungan untuk tabel di Azurite saat ini sedang dalam pratinjau. Untuk informasi lebih lanjut, lihat proyek Azurite V3 Table.

Dukungan untuk fungsi yang tahan lama membutuhkan tabel.

Penting

Dukungan Azurite untuk Table Storage saat ini dalam PRATINJAU. Lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure untuk persyaratan hukum yang berlaku pada fitur Azure dalam versi beta, pratinjau, atau belum dirilis secara umum.

Azurite adalah sumber terbuka

Kontribusi dan saran untuk Azurite dipersilakan. Buka halaman proyek GitHub Azurite atau masalah GitHub untuk pencapaian dan item kerja yang kami lacak untuk fitur dan perbaikan bug yang akan datang. Item kerja terperinci juga dilacak di GitHub.

Langkah berikutnya

• Gunakan Emulator Azure Storage untuk pengembangan dan pengujian dokumen Emulator Azure Storage warisan yang digantikan oleh Azurite.
• Mengonfigurasikan string koneksi Azure Storage menjelaskan cara merakit string koneksi Azure Storage yang valid.