Replikasi objek secara asinkron menyalin blob blok antara akun penyimpanan sumber dan akun tujuan. Saat mengonfigurasi replikasi objek, Anda membuat kebijakan replikasi yang menentukan akun penyimpanan sumber dan akun tujuan. Kebijakan replikasi mencakup satu atau beberapa aturan yang menentukan kontainer sumber dan kontainer tujuan dan menunjukkan blob blok mana dalam kontainer sumber yang akan direplikasi. Untuk informasi selengkapnya tentang replikasi objek, lihat Replikasi objek untuk blob blok.
Artikel ini menjelaskan cara mengonfigurasi kebijakan replikasi objek Anda dengan menggunakan portal Microsoft Azure, PowerShell, atau Azure CLI. Anda juga dapat menggunakan salah satu pustaka klien penyedia sumber daya Azure Storage untuk mengonfigurasi replikasi objek.
Prasyarat
Sebelum mengonfigurasi replikasi objek, buat akun penyimpanan sumber dan tujuan jika belum ada. Akun sumber dan tujuan dapat berupa akun penyimpanan v2 tujuan umum atau akun blob blok premium. Untuk informasi selengkapnya, lihat Membuat akun Azure Storage.
Replikasi objek mengharuskan penerapan versi blob diaktifkan untuk akun sumber dan tujuan, dan umpan perubahan blob diaktifkan untuk akun sumber. Untuk mempelajari selengkapnya tentang penerapan versi blob, lihat Penerapan versi Blob. Untuk mempelajari selengkapnya tentang umpan perubahan, lihat Dukungan umpan perubahan di Azure Blob Storage. Perlu diingat bahwa mengaktifkan fitur-fitur ini dapat menimbulkan biaya tambahan.
Untuk mengonfigurasi kebijakan replikasi objek akun penyimpanan, Anda harus diberi peran Kontributor Azure Resource Manager, yang mencakup pada tingkat akun penyimpanan atau yang lebih tinggi. Untuk informasi selengkapnya, lihat Peran bawaan Azure dalam dokumentasi kontrol akses berbasis peran Azure (Azure RBAC).
Replikasi objek belum didukung di akun yang mengaktifkan namespace hierarkis.
Konfigurasikan replikasi objek dengan akses ke kedua akun penyimpanan
Jika Anda memiliki akses ke akun penyimpanan sumber dan tujuan, maka Anda dapat mengonfigurasi kebijakan replikasi objek di kedua akun. Contoh berikut menunjukkan cara mengonfigurasi replikasi objek dengan portal Microsoft Azure, PowerShell, atau Azure CLI.
Saat Anda mengonfigurasi replikasi objek di portal Microsoft Azure, Anda hanya perlu mengonfigurasi kebijakan di akun sumber. Portal Microsoft Azure secara otomatis membuat kebijakan di akun tujuan setelah Anda mengonfigurasinya untuk akun sumber.
Untuk membuat kebijakan replikasi di portal Microsoft Azure, ikuti langkah-langkah berikut:
Navigasi ke akun penyimpanan di portal Microsoft Azure.
Di Manajemen data, pilih Replikasi Objek.
Pilih Buat aturan replikasi.
Pilih akun langganan dan penyimpanan tujuan.
Di bagian Detail pasangan kontainer, pilih kontainer sumber dari akun sumber, dan kontainer tujuan dari akun tujuan. Anda dapat membuat hingga 10 pasangan kontainer per kebijakan replikasi dari portal Azure. Untuk mengonfigurasi lebih dari 10 pasangan kontainer (hingga 1000), lihat Mengonfigurasi replikasi objek menggunakan file JSON.
Gambar berikut menunjukkan sekumpulan aturan replikasi.
Jika diinginkan, tentukan satu atau beberapa filter untuk menyalin hanya blob yang cocok dengan pola prefiks. Misalnya, jika Anda menentukan prefiks b, hanya blob yang namanya dimulai dengan huruf tersebut yang direplikasi. Anda dapat menentukan direktori virtual sebagai bagian dari prefiks. Anda dapat menambahkan maksimum hingga lima kecocokan prefiks. String prefiks tidak mendukung karakter wildcard.
Gambar berikut menunjukkan filter yang membatasi blob mana yang disalin sebagai bagian dari aturan replikasi.
Secara default, cakupan salin diatur untuk menyalin hanya objek baru. Untuk menyalin semua objek dalam kontainer atau menyalin objek mulai dari tanggal dan waktu kustom, pilih tautan ubah dan konfigurasikan lingkup salin untuk pasangan kontainer.
Gambar berikut menunjukkan lingkup salin kustom yang menyalin objek dari tanggal dan waktu tertentu dan seterusnya.
Pilih Simpan dan terapkan untuk membuat kebijakan replikasi dan mulai mereplikasi data.
Setelah Anda mengonfigurasi replikasi objek, portal Microsoft Azure menampilkan kebijakan dan aturan replikasi, seperti yang ditunjukkan pada gambar berikut.
Untuk membuat kebijakan replikasi dengan PowerShell, pertama-tama instal versi 2.5.0 atau yang lebih baru dari modul Az.Storage PowerShell. Untuk informasi selengkapnya tentang instalasi PowerShell, lihat Instal Azure PowerShell di Windows dengan PowerShellGet.
Contoh berikut menunjukkan cara membuat kebijakan replikasi terlebih dahulu di akun tujuan, lalu di akun sumber. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
# Sign in to your Azure account.
Connect-AzAccount
# Set variables.
$rgName = "<resource-group>"
$srcAccountName = "<source-storage-account>"
$destAccountName = "<destination-storage-account>"
$srcContainerName1 = "source-container1"
$destContainerName1 = "dest-container1"
$srcContainerName2 = "source-container2"
$destContainerName2 = "dest-container2"
# Enable blob versioning and change feed on the source account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $srcAccountName `
-EnableChangeFeed $true `
-IsVersioningEnabled $true
# Enable blob versioning on the destination account.
Update-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $destAccountName `
-IsVersioningEnabled $true
# List the service properties for both accounts.
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $srcAccountName
Get-AzStorageBlobServiceProperty -ResourceGroupName $rgName `
-StorageAccountName $destAccountName
# Create containers in the source and destination accounts.
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
New-AzStorageContainer $srcContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
New-AzStorageContainer $destContainerName1
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $srcAccountName |
New-AzStorageContainer $srcContainerName2
Get-AzStorageAccount -ResourceGroupName $rgName -StorageAccountName $destAccountName |
New-AzStorageContainer $destContainerName2
# Define replication rules for each container.
$rule1 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName1 `
-DestinationContainer $destContainerName1 `
-PrefixMatch b
$rule2 = New-AzStorageObjectReplicationPolicyRule -SourceContainer $srcContainerName2 `
-DestinationContainer $destContainerName2 `
-MinCreationTime 2021-09-01T00:00:00Z
# Create the replication policy on the destination account.
$destPolicy = Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
-StorageAccountName $destAccountName `
-PolicyId default `
-SourceAccount $srcAccountName `
-Rule $rule1,$rule2
# Create the same policy on the source account.
Set-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
-StorageAccountName $srcAccountName `
-InputObject $destPolicy
Untuk membuat kebijakan replikasi dengan Azure CLI, terlebih dahulu instal Azure CLI versi 2.11.1 atau yang lebih baru. Untuk informasi selengkapnya, lihat Mulai menggunakan Azure CLI.
Selanjutnya, aktifkan penerapan versi blob pada akun penyimpanan sumber dan tujuan, dan aktifkan umpan perubahan pada akun sumber, dengan memanggil perintah az storage account blob-service-properties update. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
az login
az storage account blob-service-properties update \
--resource-group <resource-group> \
--account-name <source-storage-account> \
--enable-versioning \
--enable-change-feed
az storage account blob-service-properties update \
--resource-group <resource-group> \
--account-name <dest-storage-account> \
--enable-versioning
Buat kontainer sumber dan tujuan di akun penyimpanan masing-masing.
Azure Storage menetapkan ID kebijakan untuk kebijakan baru saat dibuat. Untuk menambahkan aturan tambahan ke kebijakan, panggil az storage account or-policy rule add dan berikan ID kebijakan.
Selanjutnya, buat kebijakan pada akun sumber menggunakan ID kebijakan.
az storage account or-policy show \
--resource-group <resource-group> \
--account-name <dest-storage-account> \
--policy-id <policy-id> |
az storage account or-policy create --resource-group <resource-group> \
--account-name <source-storage-account> \
--policy "@-"
Mengonfigurasi replikasi objek menggunakan file JSON
Jika Anda tidak memiliki izin ke akun penyimpanan sumber atau jika ingin menggunakan lebih dari 10 pasangan kontainer, maka Anda dapat mengonfigurasi replikasi objek pada akun tujuan dan memberikan file JSON yang berisi definisi kebijakan kepada pengguna lain untuk membuat kebijakan yang sama di akun sumber. Misalnya, jika akun sumber berada di penyewa Microsoft Entra yang berbeda dari akun tujuan, maka Anda dapat menggunakan pendekatan ini untuk mengonfigurasi replikasi objek.
Untuk informasi tentang cara menulis file JSON yang berisi definisi kebijakan, lihat File definisi kebijakan.
Catatan
Replikasi objek lintas penyewa diizinkan secara default untuk akun penyimpanan. Untuk mencegah replikasi di seluruh penyewa, Anda dapat mengatur properti AllowCrossTenantReplication untuk melarang replikasi objek lintas penyewa untuk akun penyimpanan Anda. Untuk informasi selengkapnya, lihat Mencegah replikasi objek di seluruh penyewa Microsoft Entra.
Contoh di bagian ini menunjukkan cara mengonfigurasi kebijakan replikasi objek pada akun tujuan, lalu mendapatkan file JSON untuk kebijakan tersebut yang dapat digunakan pengguna lain untuk mengonfigurasi kebijakan di akun sumber.
Untuk mengonfigurasi replikasi objek pada akun tujuan dengan file JSON di portal Microsoft Azure, ikuti langkah-langkah berikut:
Buat file JSON lokal yang menentukan kebijakan replikasi pada akun tujuan. Atur bidang policyId ke default sehingga Azure Storage akan menentukan ID kebijakan.
Cara mudah untuk membuat file JSON yang menentukan kebijakan replikasi adalah dengan terlebih dahulu membuat kebijakan replikasi uji antara dua akun penyimpanan di portal Microsoft Azure. Anda lalu dapat mengunduh aturan replikasi dan memodifikasi file JSON sesuai kebutuhan.
Navigasi ke pengaturan Replikasi objek untuk akun tujuan di portal Microsoft Azure.
Pilih Unggah aturan replikasi.
Unggah file JSON. Portal Microsoft Azure menampilkan kebijakan dan aturan yang akan dibuat, seperti yang diperlihatkan dalam gambar berikut.
Pilih Unggah untuk membuat kebijakan replikasi pada akun tujuan.
Anda lalu dapat mengunduh file JSON yang berisi definisi kebijakan yang dapat Anda berikan kepada pengguna lain untuk mengonfigurasi akun sumber. Untuk mengunduh file JSON ini, ikuti langkah-langkah berikut:
Navigasi ke pengaturan Replikasi objek untuk akun tujuan di portal Microsoft Azure.
Pilih tombol Lainnya di samping kebijakan yang ingin Anda unduh, lalu pilih Unduh aturan, seperti yang diperlihatkan dalam gambar berikut.
Simpan file JSON ke komputer lokal Anda untuk dibagikan dengan pengguna lain untuk mengonfigurasi kebijakan pada akun sumber.
File JSON yang diunduh mencakup ID kebijakan yang dibuat Azure Storage untuk kebijakan pada akun tujuan. Anda harus menggunakan ID kebijakan yang sama untuk mengonfigurasi replikasi objek pada akun sumber.
Harap diingat bahwa mengunggah file JSON untuk membuat kebijakan replikasi untuk akun tujuan melalui portal Microsoft Azure tidak secara otomatis membuat kebijakan yang sama di akun sumber. Pengguna lain harus membuat kebijakan pada akun sumber sebelum Azure Storage mulai mereplikasi objek.
Untuk mengunduh file JSON yang berisi definisi kebijakan replikasi untuk akun tujuan dari PowerShell, panggil perintah Get-AzStorageObjectReplicationPolicy untuk mengembalikan kebijakan. Lalu konversikan kebijakan ke JSON dan simpan sebagai file lokal, seperti yang ditunjukkan dalam contoh berikut. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
Untuk menggunakan file JSON demi menentukan kebijakan replikasi pada akun sumber dengan PowerShell, ambil file lokal dan konversikan dari JSON ke objek. Lalu panggil perintah Set-AzStorageObjectReplicationPolicy untuk mengonfigurasi kebijakan pada akun sumber, seperti yang ditunjukkan dalam contoh berikut.
Saat menjalankan contoh, pastikan untuk mengatur parameter -ResourceGroupName ke grup sumber daya untuk akun sumber, dan parameter -StorageAccountName ke nama akun sumber. Selain itu, ingatlah untuk mengganti nilai di kurung sudut dan jalur file dengan nilai Anda sendiri:
Untuk menulis definisi kebijakan replikasi untuk akun tujuan ke file JSON dari Azure CLI, panggil perintah az storage account or-policy show dan output ke file.
Contoh berikut menulis definisi kebijakan ke file JSON bernama policy.json. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
az storage account or-policy show \
--account-name <dest-account-name> \
--policy-id <policy-id> > policy.json
Untuk menggunakan file JSON demi mengonfigurasi kebijakan replikasi pada akun sumber dengan Azure CLI, panggil perintah az storage account or-policy create dan referensikan file policy.json. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
Anda dapat memeriksa status replikasi untuk blob di akun sumber menggunakan portal Microsoft Azure, PowerShell, atau Azure CLI. Properti replikasi objek tidak diisi hingga replikasi selesai atau gagal.
Untuk memeriksa status replikasi untuk blob di akun sumber di portal Microsoft Azure, ikuti langkah-langkah berikut:
Navigasi ke akun sumber di portal Microsoft Azure.
Temukan kontainer yang menyertakan blob sumber.
Pilih blob untuk menampilkan propertinya. Jika blob berhasil direplikasi, Anda akan melihat di bagian Replikasi objek bahwa statusnya terbaca Selesai. ID kebijakan replikasi dan ID untuk aturan yang mengatur replikasi objek untuk kontainer ini juga tercantum.
Untuk memeriksa status replikasi blob di akun sumber dengan PowerShell, dapatkan nilai properti ReplicationStatus replikasi objek, seperti yang ditunjukkan dalam contoh berikut. Ingatlah untuk mengganti nilai di kurung siku dengan nilai Anda sendiri:
Untuk memeriksa status replikasi blob di akun sumber dengan Azure CLI, dapatkan nilai properti status replikasi objek, seperti yang ditunjukkan dalam contoh berikut:
Jika status replikasi blob di akun sumber gagal, selidiki kemungkinan penyebab berikut:
Pastikan bahwa kebijakan replikasi objek telah dikonfigurasi pada akun tujuan.
Pastikan bahwa kontainer tujuan masih ada.
Replikasi objek akan gagal jika blob sumber telah dienkripsi dengan kunci yang disediakan pelanggan sebagai bagian dari operasi tulis. Untuk informasi selengkapnya tentang kunci yang disediakan pelanggan, lihat Menyediakan kunci enkripsi pada permintaan ke penyimpanan Blob.
Hapus kebijakan replikasi
Untuk menghapus kebijakan replikasi dan aturan terkait, gunakan portal Microsoft Azure, PowerShell, atau CLI.
Untuk menghapus kebijakan replikasi di portal Microsoft Azure, ikuti langkah-langkah berikut:
Navigasi ke akun penyimpanan di portal Microsoft Azure.
Di bawah Pengaturan, pilih Replikasi objek.
Klik tombol Lainnya di samping nama kebijakan.
Pilih Hapus Aturan.
Untuk menghapus kebijakan replikasi, hapus kebijakan dari akun sumber dan akun tujuan. Menghapus kebijakan juga menghapus aturan apa pun yang terkait dengannya.
# Remove the policy from the destination account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
-StorageAccountName $destAccountName `
-PolicyId $destPolicy.PolicyId
# Remove the policy from the source account.
Remove-AzStorageObjectReplicationPolicy -ResourceGroupName $rgName `
-StorageAccountName $srcAccountName `
-PolicyId $destPolicy.PolicyId
Untuk menghapus kebijakan replikasi, hapus kebijakan dari akun sumber dan akun tujuan. Menghapus kebijakan juga menghapus aturan apa pun yang terkait dengannya.
