Bagikan melalui

Cara menyiapkan Azure CLI untuk layanan migrasi di server fleksibel Azure Database for PostgreSQL

Azure CLI adalah sekumpulan perintah yang digunakan di seluruh layanan Azure untuk membuat dan mengelola sumber daya. Ini menyediakan kemampuan yang sama dengan portal Azure tetapi dioptimalkan untuk pengguna yang lebih suka bekerja dalam lingkungan baris perintah. Untuk mulai bermigrasi menggunakan Azure CLI, Anda perlu menginstal Azure CLI di komputer lokal Anda.

Prasyarat

  • Instal Azure CLI: Bergantung pada sistem operasi Anda, unduh dan instal Azure CLI. Ini tersedia untuk Windows, macOS, dan Linux.

  • Panduan Penginstalan Azure CLI: Ikuti instruksi yang disediakan dalam dokumentasi Resmi Azure untuk menginstal Azure CLI - Cara menginstal Azure CLI.

  • Periksa Versi Azure CLI: Pastikan versi Azure CLI Anda setidaknya 2.56.0 atau lebih tinggi, karena ini diperlukan untuk layanan migrasi. Gunakan perintah az --version untuk memeriksa versi Anda saat ini.

  • Masuk ke Azure: Setelah penginstalan, jalankan az login untuk mengautentikasi. Ini membuka browser default Anda untuk menyelesaikan proses masuk dengan kredensial Azure Anda.

Langkah-langkah ini mempersiapkan lingkungan Anda untuk menggunakan Azure CLI untuk mengelola layanan migrasi di Azure Database for PostgreSQL secara efektif. Selalu lihat dokumentasi Azure terbaru untuk pembaruan atau perubahan apa pun pada proses penginstalan.

Menyiapkan perintah CLI untuk layanan migrasi

Semua perintah CLI dimulai dengan az postgres flexible-server migration. Ada juga pernyataan bantuan yang disediakan untuk membantu Anda memahami berbagai opsi dan mem-framing sintaks yang benar untuk perintah CLI.

Langkah-langkah untuk menyiapkan perintah CLI

  1. Instal Azure CLI: Ikuti instruksi yang disediakan dalam dokumentasi Azure resmi untuk menginstal Azure CLI - Cara menginstal Azure CLI.

  2. Periksa Versi Azure CLI: Pastikan versi Azure CLI Anda setidaknya 2.56.0 atau lebih tinggi. Gunakan perintah az --version untuk memeriksa versi Anda saat ini.

  3. Masuk ke Azure: Setelah penginstalan, jalankan az login untuk mengautentikasi. Ini membuka browser default Anda untuk menyelesaikan proses masuk dengan kredensial Azure Anda.

Setelah CLI diinstal, buka prompt perintah dan masuk ke akun Azure menggunakan perintah berikut.

az login

Memigrasikan perintah

Layanan migrasi menyediakan perintah berikut untuk membantu Anda memigrasikan instans PostgreSQL ke server fleksibel Azure Database for PostgreSQL.

Perintah Bantuan

--help Perintah di Azure CLI adalah opsi berharga yang menyediakan dokumentasi terperinci tentang perintah dan subperintahnya, termasuk kata kerja yang diperlukan untuk operasi. Perintah –-helpmenampilkan perintah yang diperlukan dan tindakan terkaitnya untuk layanan migrasi di Azure Database for PostgreSQL.

az postgres flexible-server migration –-help

Output memandu Anda melalui langkah dan parameter yang diperlukan untuk mengelola migrasi database Anda secara efektif menggunakan Azure CLI.

Perintah buat

az postgres flexible-server migration create Perintah di Azure CLI digunakan untuk memulai alur kerja migrasi baru. Ini memfasilitasi migrasi database dari instans PostgreSQL sumber ke instans server fleksibel Azure Database for PostgreSQL target. Perintah ini menyiapkan parameter dan konfigurasi yang diperlukan untuk memastikan proses migrasi yang lancar dan efisien.

Untuk informasi selengkapnya, lihat az postgres flexible-server migration create

Perintah daftar

Perintah az postgres flexible-server migration list ini digunakan untuk mencantumkan semua upaya migrasi yang dilakukan ke target Azure Database for PostgreSQL. Perintah ini memberikan gambaran umum tentang migrasi yang dimulai, memungkinkan Anda melacak status dan detail setiap upaya migrasi.

Untuk informasi selengkapnya, lihat az postgres flexible-server migration list

Perlihatkan perintah

Perintah ini az postgres flexible-server migration show membantu Anda memantau migrasi yang sedang berlangsung dan memberikan status dan substat migrasi saat ini. Detail ini mencakup informasi tentang status saat ini dan sub-status dari migrasi.

Untuk informasi selengkapnya, lihat az postgres flexible-server migration show

Beberapa kemungkinan status migrasi:

Status migrasi

Provinsi Deskripsi
InProgress Penyiapan infrastruktur migrasi sedang berlangsung, atau migrasi data aktual sedang berlangsung.
Canceled Migrasi dibatalkan atau dihapus.
Gagal Migrasi gagal.
Validasi Gagal Validasi gagal.
Berhasil Migrasi berhasil dan selesai.
WaitingForUserAction Hanya berlaku untuk migrasi online. Menunggu tindakan pengguna untuk melakukan cutover.

Sub-status migrasi

Substate Deskripsi
PerformingPreRequisiteSteps Penyiapan infrastruktur sedang berlangsung untuk migrasi data.
Validasi sedang Berlangsung Validasi dalam proses.
MigratingData Migrasi data sedang berlangsung.
CompletingMigration Migrasi sedang dalam tahap akhir penyelesaian.
Selesai Migrasi selesai.
Gagal Migrasi gagal.

Substatus validasi

Substate Deskripsi
Gagal Validasi gagal.
Berhasil Validasi berhasil.
Peringatan Validasi sedang dalam peringatan.

Perintah Perbarui

Perintah az postgres flexible-server migration update ini digunakan untuk mengelola proses migrasi ke server fleksibel Azure Database for PostgreSQL. Secara khusus, ini dapat digunakan untuk:

  • Pemindahan: Ini menyelesaikan proses migrasi dengan mengalihkan lalu lintas data dari server sumber ke server target yang fleksibel.

    • Setelah migrasi data dasar selesai, tugas migrasi berpindah ke WaitingForCutoverTrigger substat. Dalam status ini, pengguna dapat memicu cutover dari portal dengan memilih nama migrasi di kisi migrasi atau melalui CLI.
    • Sebelum memulai cutover, penting untuk memastikan bahwa:
      • Penulisan ke sumber dihentikan
      • latency nilai berkurang menjadi 0 atau mendekati 0
      • latency nilai menunjukkan kapan target terakhir disinkronkan dengan sumber. Pada titik ini, penulisan ke sumber dapat dihentikan dan cutover dimulai. Jika ada lalu lintas padat di sumbernya, harus menghentikan semua aktivitas penulisan data lebih dulu sehingga Latency dapat mendekati 0, dan kemudian peralihan dimulai.
      • Operasi Cutover menerapkan semua perubahan yang tertunda dari Sumber ke Target dan menyelesaikan migrasi. Jika Anda memicu "Cutover" bahkan dengan nonzero Latency, replikasi berhenti sampai titik waktu tersebut. Semua data pada sumber hingga titik cutover kemudian diterapkan pada target. Katakanlah latensi adalah 15 menit di titik cutover, sehingga semua data yang diubah dalam 15 menit terakhir berlaku untuk target.

  • Batalkan migrasi: Jika diperlukan, opsi ini memungkinkan Anda menghentikan proses migrasi.

  • Menyiapkan replikasi logis di sumber: Ini berguna ketika server sumber adalah Azure Database for PostgreSQL - Server Tunggal, karena menyiapkan server untuk replikasi data ke server fleksibel.

Untuk informasi selengkapnya, lihat az postgres flexible-server migration update

Ringkasan

Tabel berikut ini meringkas parameter yang digunakan oleh perintah migrasi:

Parameter Perintah yang relevan Deskripsi
subscription membuat, mencantumkan, menampilkan, memperbarui ID Langganan server Fleksibel PostgreSQL
resource-group membuat, mencantumkan, menampilkan, memperbarui Grup sumber daya server Fleksibel PostgreSQL
name buat, cantumkan, perlihatkan Nama server Fleksibel PostgreSQL
migration-name buat, perlihatkan, perbarui Pengidentifikasi unik untuk upaya migrasi ke server fleksibel. Bidang ini hanya menerima karakter alfanumerik dan tidak menerima karakter khusus apa pun kecuali tanda hubung (-). Nama tidak dapat dimulai dengan -, dan dua migrasi ke target server fleksibel tidak dapat memiliki nama yang sama.
filter list Untuk memfilter migrasi, dua nilai didukung - Aktif dan Semua
help membuat, mencantumkan, menampilkan, memperbarui Menyediakan informasi tentang setiap perintah.
migration-mode buat Ini adalah parameter opsional. Nilai yang Diizinkan adalah - offline, online. Nilai default: Offline.
migration-option buat Memungkinkan Anda melakukan validasi sebelum memicu migrasi. Defaultnya adalah ValidateAndMigrate. Nilai yang diizinkan adalah - Migrasi, Validasi, ValidateAndMigrate.
properties buat Jalur absolut ke file JSON yang memiliki informasi tentang sumber, server target, database untuk dimigrasikan, mode SSL, menentukan jenis sumber

Detail file JSON

Perintah ini az postgres flexible-server migration create memerlukan jalur file JSON sebagai bagian --properties dari parameter, yang berisi detail konfigurasi untuk migrasi, seperti ID sumber daya server database sumber, info masuk admin, database untuk dimigrasikan, dan pengaturan penting lainnya. Berikut ini adalah properti yang berbeda:

Nama Properti Deskripsi
sourceDbServerResourceId Detail server sumber dalam format untuk lokal, komputer virtual (VM), layanan PostgreSQL berbasis cloud - <<hostname or IP address>>:<<port>>@<<username>>. Jika server sumber adalah Azure Database for PostgreSQL - Server tunggal maka ID sumber daya dalam format - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/servers/<<PostgreSQL Single Server name>>
adminCredentials Parameter ini mencantumkan kata sandi untuk pengguna admin untuk server sumber dan server fleksibel PostgreSQL target. Kata sandi ini membantu mengautentikasi terhadap server sumber serta target. Ini termasuk dua subproperti, sourceServerPassword dan targetServerPassword
targetServerUserName Nilai default adalah pengguna admin yang dibuat selama pembuatan server fleksibel target PostgreSQL, dan kata sandi yang disediakan digunakan untuk autentikasi terhadap pengguna ini.
dbsToMigrate Tentukan daftar database yang ingin Anda migrasikan ke server fleksibel. Anda bisa menyertakan maksimal delapan nama database secara bersamaan. Menyediakan daftar database dalam format array.
overwriteDBsInTarget Ketika diatur ke true (default), jika server target kebetulan memiliki database yang sudah ada dengan nama yang sama dengan yang coba Anda migrasikan, layanan migrasi secara otomatis menimpa database
migrationRuntimeResourceId Diperlukan jika server runtime perlu digunakan untuk migrasi. Formatnya adalah - /subscriptions/<<Subscription ID>>/resourceGroups/<<Resource Group Name>>/providers/Microsoft.DBforPostgreSQL/flexibleServers/<<PostgreSQL flexible server name>>
sourceDBServerFullyQualifiedDomainName Diperlukan hanya jika sumbernya adalah Server tunggal dan berada di belakang server DNS kustom, namespace DNS kustom, FQDN kustom, atau perlu diakses melalui IP.
targetDBServerFullyQualifiedDomainName Diperlukan hanya jika target berada di belakang server DNS kustom, namespace DNS kustom, FQDN kustom, atau perlu diakses melalui IP.
sourceType Parameter wajib. Nilai dapat berupa - lokal, AWS_RDS, AWS_AURORA, GCP_CloudSQL, AzureVM, PostgreSQLSingleServer
sslMode Mode SSL untuk migrasi. Mode SSL untuk PostgreSQLSingleServer adalah VerifyFull dan Prefer/Require untuk jenis sumber lainnya.

Konten terkait

  • Last updated on