Tutorial: Menyalin data ke penyimpanan Blob Azure Data Box melalui REST API
Perhatian
Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan perencanaan Anda yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.
Tutorial ini menjelaskan prosedur untuk menyambungkan ke penyimpanan Blob Azure Data Box melalui API REST melalui http atau https. Setelah terhubung, langkah-langkah yang diperlukan untuk menyalin data ke penyimpanan Blob Data Box dijelaskan.
Dalam tutorial ini, Anda akan mempelajari cara:
- Prasyarat
- Menyambungkan ke penyimpanan Blob Data Box melalui http atau https
- Menyalin data ke Data Box Heavy
Prasyarat
Sebelum Anda mulai, pastikan bahwa:
- Anda telah menyelesaikan Tutorial: Menyiapkan Azure Data Box Heavy.
- Anda telah menerima Data Box Heavy dan status pesanan Anda di portal Terkirim.
- Anda telah meninjau persyaratan sistem untuk penyimpanan Blob Data Box dan terbiasa dengan versi API, SDK, dan alat yang didukung.
- Anda memiliki akses ke komputer host yang memiliki data yang ingin Anda salin ke Data Box Heavy. Komputer host Anda harus
- Menjalankan Sistem operasi yang didukung.
- Tersambung ke jaringan berkecepatan tinggi. Untuk kecepatan penyalinan tercepat, dua koneksi 40 GbE (satu per simpul) dapat digunakan secara paralel. Jika Anda tidak memiliki koneksi 40 GbE yang tersedia, kami sarankan Anda memiliki setidaknya dua koneksi 10 GbE (satu per simpul).
- Unduh AzCopy 7.1.0 di komputer host Anda. Anda akan menggunakan AzCopy untuk menyalin data ke penyimpanan Blob Azure Data Box dari komputer host Anda.
Menghubungkan melalui http atau https
Anda dapat menghubungkan ke penyimpanan Blob Data Box melalui http atau https.
- Https adalah cara yang aman dan direkomendasikan untuk terhubung ke penyimpanan Blob Data Box.
- Http digunakan ketika menghubungkan melalui jaringan tepercaya.
Langkah-langkah untuk menghubungkan berbeda ketika Anda menghubungkan ke penyimpanan Blob Data Box melalui http atau https.
Menghubungkan melalui http
Koneksi ke REST API penyimpanan Blob Data Box melalui http memerlukan langkah-langkah berikut:
- Tambahkan IP perangkat dan titik akhir layanan blob ke host jarak jauh
- Konfigurasikan perangkat lunak pihak ketiga dan verifikasi koneksi
Masing-masing langkah ini dijelaskan di bagian berikut.
Penting
Untuk Data Box Heavy, Anda harus mengulangi semua instruksi koneksi untuk menghubungkan ke node kedua.
Tambahkan alamat IP perangkat dan titik akhir layanan blob
Masuk ke perangkat Data Box. Pastikan tidak terkunci.
Buka Mengatur antarmuka jaringan. Catat alamat IP perangkat untuk antarmuka jaringan yang digunakan untuk menyambungkan ke klien.
Buka Sambungkan dan salin, lalu klik Istirahat.
Dari dialog Akses akun Penyimpanan dan unggah data, salin Titik Akhir Layanan Blob.
Mulai Notepad sebagai administrator, lalu buka file host yang terletak di
C:\Windows\System32\Drivers\etc
.Tambahkan entri berikut ke file host Anda:
<device IP address> <Blob service endpoint>
Untuk referensi, gunakan gambar berikut. Simpan file host.
Konfigurasi perangkat lunak mitra dan verifikasi koneksi
Konfigurasikan perangkat lunak mitra untuk terhubung ke klien. Untuk menyambungkan ke perangkat lunak mitra, Anda biasanya memerlukan informasi berikut (dapat bervariasi) yang Anda kumpulkan dari halaman Koneksi dan salin UI web lokal di langkah sebelumnya:
- Nama akun penyimpanan
- Kunci akses
- Titik akhir Blob service
Untuk memverifikasi bahwa koneksi berhasil dibuat, gunakan Storage Explorer untuk melampirkan ke akun penyimpanan eksternal. Jika Anda tidak memiliki Storage Explorer, Anda perlu mengunduh dan menginstal.
Saat pertama kali menggunakan Storage Explorer, Anda perlu melakukan langkah-langkah berikut:
Dari bilah perintah atas, buka Edit > Target Azure Stack.
Hidupkan ulang Storage Explorer agar perubahan diterapkan.
Ikuti langkah-langkah ini untuk tersambung ke akun penyimpanan lalu verifikasi koneksi.
Di Penjelajah Penyimpanan, buka dialog Sambungkan ke Azure Storage. Di dialog Sambungkan ke Azure Storage, pilih Gunakan nama dan kunci akun penyimpanan.
Tempelkan Nama akun dan Kunci akun Anda (kunci 1 nilai dari halaman Sambungkan dan salin di antarmuka pengguna web lokal). Pilih Domain titik akhir penyimpanan sebagai Lainnya (masukkan di bawah) lalu berikan titik akhir layanan blob seperti yang ditunjukkan di bawah ini. Centang opsi Gunakan HTTP hanya jika mentransfer melalui http. Jika menggunakan https, biarkan opsi tidak dicentang. Pilih Selanjutnya.
Dalam dialog Ringkasan Koneksi, tinjau informasi yang disediakan. Pilih Sambungkan.
Akun yang berhasil Anda tambahkan ditampilkan di panel kiri Storage Explorer dengan (Eksternal, Lainnya) ditambahkan ke namanya. Pilih Kontainer Blob untuk melihat kontainer.
Menyambungkan melalui https
Sambungan ke REST API penyimpanan Blob Azure Data Box melalui http memerlukan langkah-langkah berikut:
- Ekspor sertifikat dari portal Microsoft Azure
- Impor sertifikat pada klien atau hosting jarak jauh
- Tambahkan IP perangkat dan titik akhir layanan blob ke klien atau host jarak jauh
- Konfigurasikan perangkat lunak pihak ketiga dan verifikasi koneksi
Masing-masing langkah ini dijelaskan di bagian berikut.
Penting
Untuk Data Box Heavy, Anda harus mengulangi semua instruksi koneksi untuk menghubungkan ke node kedua.
Mengunduh sertifikat
Gunakan portal Microsoft Azure untuk mengunduh sertifikat.
Masuk ke Portal Microsoft Azure.
Buka pesanan Data Box Anda dan navigasikan ke detail Perangkat Umum>.
Pada Kredensial perangkat, buka akses API ke perangkat. Klik Unduh. Tindakan ini mengunduh nama> pesanan <Anda.cer file sertifikat. Simpan file ini. Anda akan menginstal sertifikat ini pada komputer klien atau host yang akan Anda gunakan untuk terhubung ke perangkat.
Mengimpor sertifikat
Mengakses penyimpanan Blob Data Box melalui HTTPS memerlukan sertifikat TLS/SSL di perangkat. Bagaimana sertifikat ini tersedia untuk aplikasi klien bervariasi dari satu aplikasi ke aplikasi lain dan antar sistem operasi dan distribusi. Beberapa aplikasi dapat mengakses sertifikat setelah diimpor ke penyimpanan sertifikat sistem, sementara aplikasi lain tidak menggunakan mekanisme tersebut.
Informasi spesifik untuk beberapa aplikasi disebutkan di bagian ini. Untuk informasi lebih lanjut tentang aplikasi lain, periksa dokumentasi untuk aplikasi dan sistem operasi yang digunakan.
Ikuti langkah-langkah ini untuk mengimpor file .cer
ke penyimpanan root klien Windows atau Linux. Pada sistem Windows, Anda bisa menggunakan Windows PowerShell atau UI Windows Server untuk mengimpor dan menginstal sertifikat pada sistem Anda.
Menggunakan Windows PowerShell
Mulai sesi Windows PowerShell sebagai admin.
Pada command prompt, ketik:
Import-Certificate -FilePath C:\temp\localuihttps.cer -CertStoreLocation Cert:\LocalMachine\Root
Menggunakan UI Windows Server
Klik kanan file
.cer
dan pilih Instal sertifikat. Tindakan ini akan memulai Wizard Impor Sertifikat.Untuk Lokasi penyimpanan, pilih Komputer Lokal, lalu klik Berikutnya.
Pilih Tempatkan semua sertifikat pada penyimpanan berikut, lalu klik Telusuri. Arahkan ke penyimpanan root dari host jarak jauh Anda, lalu klik Berikutnya.
Klik Selesai. Akan muncul pesan yang memberi tahu Anda bahwa impor berhasil.
Menggunakan sistem Linux
Metode untuk mengimpor sertifikat bervariasi menurut distribusinya.
Penting
Untuk Data Box Heavy, Anda harus mengulangi semua instruksi koneksi untuk menghubungkan ke node kedua.
Di antaranya, seperti Ubuntu dan Debian, menggunakan perintah update-ca-certificates
.
- Ganti nama file sertifikat berenkode Base64 agar memiliki ekstensi
.crt
dan salin ke dalam/usr/local/share/ca-certificates directory
. - Jalankan perintah
update-ca-certificates
.
RHEL, Fedora, dan CentOS versi terbaru menggunakan perintah update-ca-trust
.
- Salin file sertifikat ke dalam direktori
/etc/pki/ca-trust/source/anchors
. - Jalankan
update-ca-trust
.
Periksa dokumentasi khusus distribusi Anda untuk detailnya.
Tambahkan alamat IP perangkat dan titik akhir layanan blob
Ikuti langkah-langkah yang sama untuk menambahkan alamat IP perangkat dan titik akhir layanan blob saat menyambungkan melalui http.
Konfigurasi perangkat lunak mitra dan verifikasi koneksi
Ikuti langkah-langkah untuk Mengkonfigurasi perangkat lunak mitra yang Anda gunakan saat menyambungkan melalui http. Satu-satunya perbedaan adalah Anda harus membiarkan Opsi gunakan http tidak dicentang.
Menyalin data ke Data Box Heavy
Setelah Anda tersambung ke penyimpanan Blob Data Box, langkah berikutnya adalah menyalin data. Sebelum menyalin data, tinjau pertimbangan berikut:
- Saat menyalin data, pastikan bahwa ukuran data sesuai dengan batas ukuran yang dijelaskan dalam Batas penyimpanan Azure dan Data Box Heavy.
- Jika data yang sedang diunggah oleh Data Box Heavy diunggah secara bersamaan oleh aplikasi lain di luar Data Box Heavy, hal ini dapat mengakibatkan kegagalan proses pengunggahan dan kerusakan data.
Dalam tutorial ini, AzCopy digunakan untuk menyalin data ke penyimpanan Blob Data Box. Anda juga dapat menggunakan Azure Storage Explorer (jika Anda lebih suka alat berbasis GUI) atau perangkat lunak mitra untuk menyalin data.
Prosedur penyalinan menggunakan langkah-langkah berikut:
- Membuat kontainer
- Mengunggah konten folder ke penyimpanan Blob Data Box
- Mengunggah file yang telah diubah ke penyimpanan Blob Data Box
Masing-masing langkah tersebut dijelaskan secara detail di bagian berikut.
Penting
Untuk Data Box Heavy, Anda harus mengulangi semua instruksi penyalinan untuk menyalin data ke node kedua.
Membuat kontainer
Langkah pertama adalah membuat kontainer, karena blob harus selalu diunggah ke dalam kontainer. Kontainer mengatur grup blob seperti Anda mengatur file dalam folder di komputer Anda. Ikuti langkah ini untuk membuat kontainer blob.
Buka Storage Explorer.
Di panel kiri, perluas akun penyimpanan di mana Anda ingin membuat kontainer blob.
Klik kanan Kontainer Blob, dan dari menu pintasan, pilih Buat Kontainer Blob.
Kotak teks muncul di bawah folder Kontainer Blob. Masukkan nama untuk kontainer blob Anda. Lihat Buat kontainer dan atur izin untuk informasi tentang aturan dan pembatasan penamaan kontainer blob.
Tekan Enter bila sudah selesai membuat kontainer blob, atau Esc untuk membatalkan. Setelah kontainer blob berhasil dibuat, kontainer ditampilkan di bawah folder Kontainer Blob untuk akun penyimpanan yang dipilih.
Mengunggah konten folder ke penyimpanan Blob Data Box
Gunakan AzCopy untuk mengunggah semua file dalam folder ke penyimpanan Blob di Windows atau Linux. Untuk mengunggah semua blob dalam folder, masukkan perintah AzCopy berikut:
Linux
azcopy \
--source /mnt/myfolder \
--destination https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
--dest-key <key> \
--recursive
Windows
AzCopy /Source:C:\myfolder /Dest:https://data-box-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S
Ganti <key>
dengan kunci akun Anda. Untuk mendapatkan kunci akun Anda, di portal Microsoft Azure, buka akun penyimpanan Anda. Buka Pengaturan > Kunci akses, pilih kunci, dan tempelkan ke perintah AzCopy.
Jika kontainer tujuan yang ditentukan tidak ada, AzCopy akan membuatnya dan mengunggah file ke dalamnya. Perbarui jalur sumber ke direktori data Anda, dan ganti data-box-storage-account-name
di URL tujuan dengan nama akun penyimpanan yang terkait dengan Data Box Anda.
Untuk mengunggah konten direktori yang ditentukan ke penyimpanan Blob secara rekursif, tentukan opsi --recursive
(Linux) atau /S
(Windows). Jika Anda menjalankan AzCopy dengan salah satu opsi ini, semua subfolder dan filenya juga akan diunggah.
Mengunggah file yang telah diubah ke penyimpanan Blob Data Box
Gunakan AzCopy untuk mengunggah file berdasarkan waktu terakhir dimodifikasi. Untuk mencobanya, ubah atau buat file baru di direktori sumber Anda untuk tujuan pengujian. Untuk hanya mengunggah file yang diperbarui atau baru, tambahkan parameter --exclude-older
(Linux) atau /XO
(Windows) ke perintah AzCopy.
Jika Anda hanya ingin menyalin sumber daya sumber yang tidak ada di tujuan, tentukan parameter baik --exclude-older
dan --exclude-newer
(Linux) atau /XO
dan /XN
(Windows) dalam perintah AzCopy. AzCopy hanya mengunggah data yang diperbarui, berdasarkan stempel waktunya.
Linux
azcopy \
--source /mnt/myfolder \
--destination https://data-box-heavy-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ \
--dest-key <key> \
--recursive \
--exclude-older
Windows
AzCopy /Source:C:\myfolder /Dest:https://data-box-heavy-storage-account-name.blob.device-serial-no.microsoftdatabox.com/container-name/files/ /DestKey:<key> /S /XO
Jika ada kesalahan selama operasi penyambungan atau penyalinan, lihat Memecahkan masalah penyimpanan Blob Data Box.
Langkah berikutnya adalah menyiapkan perangkat Anda untuk mengirim.
Langkah berikutnya
Dalam tutorial ini, Anda mempelajari tentang topik Azure Data Box seperti:
- Prasyarat
- Menyambungkan ke penyimpanan Blob Data Box melalui http atau https
- Menyalin data ke Data Box Heavy
Lanjutkan ke tutorial berikutnya untuk mempelajari cara mengirimkan Data Box Anda kembali ke Microsoft.