Memigrasikan instans API Management yang tidak disuntikkan VNet ke platform komputasi stv2

BERLAKU UNTUK: Pengembang | Dasar | Standar | Premi

Artikel ini menyediakan langkah-langkah untuk memigrasikan instans API Management yang dihosting pada stv1 platform komputasi di tempat ke stv2 platform ketika instans tidak disuntikkan (disebarkan) di VNet eksternal atau internal. Untuk skenario ini, migrasikan instans Anda menggunakan portal Azure atau Migrasi ke REST API stv2. Cari tahu apakah Anda perlu melakukan ini.

Jika Anda perlu memigrasikan API Management yang disuntikkan VNet yang dihosting di stv1 platform, lihat Memigrasikan instans API Management yang disuntikkan VNet ke platform stv2.

Apa yang terjadi selama migrasi?

Migrasi platform API Management dari stv1 ke stv2 melibatkan pembaruan komputasi yang mendasar saja dan tidak berdampak pada konfigurasi layanan/API yang bertahan di lapisan penyimpanan. Untuk instans yang tidak disebarkan di VNet:

• Anda dapat memilih apakah alamat VIP instans akan berubah, atau apakah alamat VIP asli dipertahankan.
• Proses peningkatan melibatkan pembuatan komputasi baru secara paralel dengan komputasi lama.
• Status API Management di portal akan diperbarui.
• Jika Anda memilih untuk mempertahankan alamat VIP, migrasi menyertakan langkah tambahan untuk memindahkan VIP dari komputasi lama ke komputasi baru di mana API tidak akan responsif.
• Azure mengelola DNS titik akhir manajemen, dan memperbarui komputasi baru segera pada migrasi yang berhasil.
• Gateway default dan DNS portal segera menunjuk ke komputasi baru.
• Jika Anda memilih agar instans API Management menerima alamat VIP baru, Anda harus memperbarui dependensi jaringan untuk menggunakan alamat VIP baru.

Prasyarat

• Instans API Management yang dihosting di platform komputasi stv1 . Untuk mengonfirmasi bahwa instans Anda dihosting di stv1 platform, lihat Bagaimana cara mengetahui platform mana yang menghosting instans API Management saya?

• Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.

  

• Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.

  • Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.

  • Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.

  • Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.

Memigrasikan instans ke platform stv2

Opsi alamat IP publik

Anda dapat memilih apakah alamat IP virtual API Management akan berubah, atau apakah alamat VIP asli dipertahankan.

• Alamat IP virtual baru - Jika Anda memilih mode ini, permintaan API tetap responsif selama migrasi. Konfigurasi infrastruktur (seperti domain kustom, lokasi, dan sertifikat CA) akan dikunci selama 30 menit. Setelah migrasi, Anda harus memperbarui dependensi jaringan apa pun termasuk DNS, aturan firewall, dan VNet untuk menggunakan alamat VIP baru.

• Pertahankan alamat IP - Jika Anda mempertahankan alamat VIP, permintaan API tidak akan responsif selama sekitar 15 menit saat alamat IP dimigrasikan ke infrastruktur baru. Konfigurasi infrastruktur (seperti domain kustom, lokasi, dan sertifikat CA) akan dikunci selama 45 menit. Tidak diperlukan konfigurasi lebih lanjut setelah migrasi.

Alamat IP yang dibuat sebelumnya untuk migrasi

Untuk instans API Management yang dapat dijangkau oleh alamat IP publik, API Management telah membuat alamat IP publik untuk proses migrasi. Temukan alamat IP yang dibuat sebelumnya di output JSON dari properti instans API Management Anda. Di bawah customProperties, alamat IP yang dibuat sebelumnya adalah nilai Microsoft.WindowsAzure.ApiManagement.Stv2MigrationPreCreatedIps properti . Untuk penyebaran multi-wilayah, nilainya adalah daftar alamat IP yang dipisahkan koma yang dibuat sebelumnya.

Gunakan alamat IP (atau alamat) yang dibuat sebelumnya untuk membantu Anda mengelola proses migrasi:

• Saat Anda memigrasikan dan mempertahankan alamat VIP, alamat IP yang dibuat sebelumnya ditetapkan untuk sementara ke penyebaran baru stv2 , sebelum alamat IP asli ditetapkan ke stv2 penyebaran. Jika Anda memiliki aturan firewall yang membatasi akses ke instans API Management, misalnya, Anda dapat menambahkan alamat IP yang dibuat sebelumnya ke daftar yang diizinkan untuk mempertahankan kelangsungan akses klien selama migrasi. Setelah migrasi selesai, Anda dapat menghapus alamat IP yang dibuat sebelumnya dari daftar yang diizinkan.
• Saat Anda memigrasikan dan menghasilkan alamat VIP baru, alamat IP yang dibuat sebelumnya ditetapkan ke penyebaran baru stv2 selama migrasi dan bertahan setelah migrasi selesai. Gunakan alamat IP yang dibuat sebelumnya untuk memperbarui dependensi jaringan Anda, seperti aturan DNS dan firewall, untuk menunjuk ke alamat IP baru.

Langkah migrasi

APIM_NAME={name of your API Management instance}
# In PowerShell, use the following syntax: $APIM_NAME={name of your API Management instance}
RG_NAME={name of your resource group}
# Get resource ID of API Management instance
APIM_RESOURCE_ID=$(az apim show --name $APIM_NAME --resource-group $RG_NAME --query id --output tsv)
# Call REST API to migrate to stv2 and preserve VIP address
az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "PreserveIp"}'
# Alternate call to migrate to stv2 and change VIP address
# az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "NewIp"}'

Verifikasi migrasi

Untuk memverifikasi bahwa migrasi berhasil, saat status berubah menjadi Online, periksa versi platform instans API Management Anda. Setelah migrasi berhasil, nilainya adalah stv2 atau stv2.1.

Kembalikan secara otomatis jika migrasi gagal

Jika ada kegagalan selama proses migrasi, instans akan secara otomatis kembali ke stv1 platform. Jika migrasi berhasil diselesaikan (versi platform instans ditampilkan sebagai stv2 atau stv2.1 dan status sebagai Online), Anda tidak dapat kembali ke stv1 platform.

Untuk bantuan jika migrasi gagal, hubungi dukungan Azure.

Jika Anda memerlukan kemampuan untuk kembali secara manual, rekomendasinya adalah menyebarkan instans baru stv2 secara berdampingan dengan instans API Management asli Anda.

Memperbarui dependensi jaringan

Setelah migrasi berhasil ke alamat VIP baru, perbarui dependensi jaringan apa pun termasuk DNS, aturan firewall, dan VNet untuk menggunakan alamat VIP baru.

Bantuan dan dukungan

Kami di sini untuk membantu Anda bermigrasi ke stv2 platform dengan gangguan minimal pada layanan Anda.

Jika Anda memiliki pertanyaan, dapatkan jawaban cepat dari pakar komunitas di Microsoft Q&A. Jika Anda memiliki rencana dukungan dan memerlukan bantuan teknis, buat permintaan dukungan.

1. Untuk Ringkasan, tulis deskripsi masalah Anda, misalnya, "penghentian stv1".
2. Di Jenis masalah, pilih Teknis.
3. Di Langganan, pilih langganan Anda.
4. Di Layanan, pilih Layanan saya, lalu pilih Layanan API Management.
5. Di Sumber daya, pilih sumber daya Azure tempat Anda membuat permintaan dukungan.
6. Untuk Jenis masalah, pilih Administrasi dan Manajemen.
7. Untuk Subjenis masalah, pilih Peningkatan, Penskalaan, atau Perubahan SKU.

Tanya jawab umum

• Informasi apa yang kita butuhkan untuk memilih jalur migrasi?

  • Apa mode jaringan instans API Management?
  • Apakah domain kustom dikonfigurasi?
  • Apakah firewall terlibat?
  • Setiap dependensi yang diketahui diambil oleh hulu/hilir pada IP yang terlibat?
  • Apakah penyebaran multi-wilayah?
  • Dapatkah kita memodifikasi instans yang ada atau diperlukan penyiapan paralel?
  • Bisakah ada waktu henti?
  • Dapatkah migrasi dilakukan dalam jam nonbusiness?

• Apa saja prasyarat untuk migrasi?

  Untuk instans yang tidak disuntikkan VNet, tidak diperlukan prasyarat. Jika Anda bermigrasi mempertahankan alamat IP publik Anda, ini akan membuat instans API Management Anda tidak responsif selama sekitar 15 menit. Mungkin tidak ada waktu henti jika Anda memilih opsi Alamat IP virtual baru yang membuat API Management tersedia di IP baru. Instans yang dikonfigurasi dengan domain kustom menggunakan catatan A dan/atau memiliki dependensi jaringan pada alamat IP virtual publik akan mengalami waktu henti saat alamat IP virtual baru diminta.

• Apakah migrasi akan menyebabkan waktu henti?

  Untuk instans yang tidak disuntikkan VNet, ada waktu henti sekitar 15 menit hanya jika Anda memilih untuk mempertahankan alamat IP asli. Namun, tidak ada waktu henti jika Anda bermigrasi dengan alamat IP baru dan tidak memiliki dependensi jaringan pada IP baru. Dependensi jaringan mencakup nama domain kustom tanpa CNAME, daftar izin IP, aturan firewall, dan VNet.

• Dapatkah kehilangan data atau konfigurasi terjadi oleh/selama migrasi?

  stv1 untuk stv2 migrasi melibatkan pembaruan platform komputasi saja dan lapisan penyimpanan internal tidak diubah. Oleh karena itu semua konfigurasi aman selama proses migrasi. Ini termasuk identitas terkelola yang ditetapkan sistem, yang jika diaktifkan dipertahankan.

• Bagaimana cara mengonfirmasi bahwa migrasi selesai dan berhasil?

  Migrasi dianggap selesai dan berhasil ketika status di halaman gambaran umum berbunyi Online bersama dengan versi platform baik stv2 atau stv2.1. Verifikasi juga bahwa status jaringan di bilah jaringan menunjukkan warna hijau untuk semua konektivitas yang diperlukan.

• Dapatkah saya melakukan migrasi menggunakan portal?

  Ya, bilah migrasi Platform di panduan portal Azure melalui migrasi untuk instans yang tidak disuntikkan VNet.

• Dapatkah saya mempertahankan alamat IP instans?

  Ya, alamat IP dapat dipertahankan, tetapi akan ada waktu henti sekitar 15 menit.

• Apakah ada jalur migrasi tanpa memodifikasi instans yang ada?

  Ya, Anda memerlukan migrasi berdampingan. Itu berarti Anda membuat instans API Management baru secara paralel dengan instans Anda saat ini dan menyalin konfigurasi ke instans baru.

• Apa yang terjadi jika migrasi gagal?

  Jika instans API Management Anda tidak menampilkan versi platform sebagai stv2 atau stv2.1 dan status sebagai Online setelah Anda memulai migrasi, mungkin gagal. Layanan Anda secara otomatis digulung balik ke instans lama dan tidak ada perubahan yang dilakukan. Jika Anda mengalami masalah (seperti jika status diperbarui selama lebih dari 2 jam), hubungi dukungan Azure.

• Fungsionalitas apa yang tidak tersedia selama migrasi?

  Untuk instans yang tidak disuntikkan VNet:

  • Jika Anda memilih untuk mempertahankan alamat IP asli: Permintaan API tidak responsif selama sekitar 15 menit saat alamat IP dimigrasikan ke infrastruktur baru. Konfigurasi infrastruktur (seperti domain kustom, lokasi, dan sertifikat CA) dikunci selama 45 menit.
  • Jika Anda memilih untuk bermigrasi ke alamat IP baru: Permintaan API tetap responsif selama migrasi. Konfigurasi infrastruktur (seperti domain kustom, lokasi, dan sertifikat CA) dikunci selama 30 menit. Setelah migrasi, Anda harus memperbarui dependensi jaringan apa pun termasuk DNS, aturan firewall, dan VNet untuk menggunakan alamat VIP baru.

• Berapa lama migrasi akan berlangsung?

  Durasi yang diharapkan untuk seluruh migrasi adalah sekitar 45 menit. Indikator untuk memeriksa apakah migrasi sudah dilakukan adalah memeriksa apakah Status instans Anda kembali ke Online dan tidak Memperbarui. Jika tertulis Memperbarui selama lebih dari 2 jam, hubungi dukungan Azure.

• Dapatkah saya mengembalikan migrasi jika diperlukan?

  Jika ada kegagalan selama proses migrasi, instans akan secara otomatis kembali ke stv1 platform. Namun, setelah layanan berhasil bermigrasi, Anda tidak dapat kembali ke stv1 platform.

• Apakah ada perubahan yang diperlukan di domain kustom/zona DNS privat?

  Untuk instans yang disuntikkan non-VNet, tidak ada perubahan yang diperlukan jika IP dipertahankan. Jika memilih IP baru, domain kustom yang mengacu pada IP harus diperbarui.

• Instans stv1 saya disebarkan ke beberapa wilayah Azure (multi-wilayah). Bagaimana cara meningkatkan ke stv2?

  Untuk API Management yang tidak disuntikkan di VNet, ikuti langkah-langkah migrasi menggunakan portal atau Azure CLI. Semua wilayah akan dimigrasikan ke stv2.

• Apa yang harus kita pertimbangkan untuk gateway yang dihost sendiri?

  Anda tidak perlu melakukan apa pun di gateway yang dihost sendiri. Anda hanya perlu memigrasikan instans API Management yang berjalan di Azure yang terpengaruh oleh stv1 penghentian platform. Perhatikan bahwa mungkin ada IP baru untuk titik akhir Konfigurasi instans API Management, dan batasan jaringan apa pun yang disematkan ke IP harus diperbarui.

• Bagaimana portal pengembang terpengaruh oleh migrasi?

  Tidak ada dampak pada portal pengembang. Jika domain kustom digunakan, catatan DNS harus diperbarui dengan IP yang efektif, pascamigrasi. Namun, jika domain default sedang digunakan, domain tersebut secara otomatis diperbarui pada migrasi yang berhasil. Tidak ada waktu henti untuk portal pengembang selama migrasi.

• Apakah ada dampak pada biaya setelah kami bermigrasi ke stv2?

  Model penagihan tetap sama untuk stv2 dan tidak akan ada biaya lagi yang dikeluarkan selama dan setelah migrasi.

• Izin RBAC apa yang diperlukan untuk migrasi stv1 ke stv2?

  Pengguna/proses yang melakukan migrasi memerlukan akses tulis ke instans API Management.

Konten terkait

• Bagaimana cara mengetahui platform mana yang menghosting instans API Management saya?

• Manfaat platform komputasi stv2 untuk API Management

• penghentian platform stv1 - Azure global (Agustus 2024)

• penghentian platform stv1 - Azure Government dan Azure dioperasikan oleh 21Vianet (Februari 2025)