Gunakan fitur migrasi di tempat untuk memigrasikan App Service Environment v1 dan v2 ke App Service Environment v3
Catatan
Fitur migrasi yang dijelaskan dalam artikel ini digunakan untuk migrasi otomatis di tempat (subnet yang sama) dari Lingkungan App Service v1 dan v2 ke Lingkungan App Service v3. Jika Anda mencari informasi tentang fitur migrasi berdampingan, lihat Migrasi ke Lingkungan App Service v3 dengan menggunakan fitur migrasi berdampingan. Jika Anda mencari informasi tentang opsi migrasi manual, lihat Opsi migrasi manual. Untuk bantuan memutuskan opsi migrasi mana yang tepat untuk Anda, lihat Pohon keputusan jalur migrasi. Untuk informasi selengkapnya tentang Lingkungan App Service v3, lihat Ringkasan App Service Environment v3.
Anda dapat secara otomatis memigrasikan App Service Environment v1 dan v2 ke App Service Environment v3 dengan menggunakan fitur migrasi di tempat. Untuk mempelajari selengkapnya tentang proses migrasi dan untuk melihat apakah Lingkungan App Service Anda mendukung migrasi saat ini, lihat gambaran umum fitur migrasi di tempat.
Penting
Kami menyarankan agar Anda menggunakan fitur ini untuk lingkungan pengembangan sebelum memigrasikan lingkungan produksi apa pun, untuk menghindari masalah yang tidak terduga. Harap berikan umpan balik apa pun yang terkait dengan artikel ini atau fitur dengan menggunakan tombol di bagian bawah halaman.
Prasyarat
Pastikan Anda memahami bagaimana migrasi ke App Service Environment v3 memengaruhi aplikasi Anda. Tinjau proses migrasi untuk memahami garis waktu proses dan di mana dan kapan Anda perlu terlibat. Tinjau juga FAQ, yang dapat menjawab beberapa pertanyaan Anda.
Pastikan bahwa tidak ada kunci di jaringan virtual, grup sumber daya, sumber daya, atau langganan Anda. Mengunci operasi platform blok selama migrasi.
Pastikan bahwa tidak ada kebijakan Azure yang memblokir tindakan yang diperlukan untuk migrasi, termasuk modifikasi subnet dan pembuatan sumber daya Azure App Service. Kebijakan yang memblokir modifikasi dan pembuatan sumber daya dapat menyebabkan migrasi macet atau gagal.
Karena penskalakan diblokir selama migrasi, Anda harus menskalakan lingkungan Anda ke ukuran yang diinginkan sebelum memulai migrasi. Jika Anda perlu menskalakan lingkungan setelah migrasi, Anda dapat melakukannya setelah migrasi selesai.
Kami menyarankan agar Anda menggunakan portal Azure untuk pengalaman migrasi di tempat. Jika Anda memutuskan untuk menggunakan Azure CLI untuk migrasi, ikuti langkah-langkah yang dijelaskan di sini secara berurutan dan seperti yang ditulis, karena Anda melakukan panggilan Azure REST API. Kami menyarankan agar Anda menggunakan Azure CLI untuk melakukan panggilan API ini. Untuk informasi tentang metode lain, lihat Referensi Azure REST API.
Untuk panduan ini, instal Azure CLI atau gunakan Azure Cloud Shell dan gunakan shell Bash.
Catatan
Kami menyarankan agar Anda menggunakan shell Bash untuk menjalankan perintah yang diberikan dalam panduan ini. Perintah mungkin tidak kompatibel dengan konvensi PowerShell dan karakter escape.
1. Dapatkan ID Lingkungan Azure App Service Anda
Jalankan perintah berikut untuk mendapatkan ID Lingkungan App Service Anda dan simpan sebagai variabel lingkungan. Ganti tempat penampung untuk nama dan grup sumber daya dengan nilai Anda untuk Lingkungan App Service yang ingin Anda migrasikan. ASE_RG dan VNET_RG sama jika jaringan virtual dan Lingkungan App Service Anda berada dalam grup sumber daya yang sama.
ASE_NAME=<Your-App-Service-Environment-name>
ASE_RG=<Your-ASE-Resource-Group>
VNET_RG=<Your-VNet-Resource-Group>
ASE_ID=$(az appservice ase show --name $ASE_NAME --resource-group $ASE_RG --query id --output tsv)
2. Validasi bahwa migrasi didukung
Perintah berikut memeriksa apakah Lingkungan App Service Anda didukung untuk migrasi. Jika Anda menerima kesalahan atau jika Lingkungan Azure App Service Anda dalam keadaan tidak sehat atau ditangguhkan, Anda tidak dapat bermigrasi saat ini. Lihat bagian pemecahan masalah untuk deskripsi pesan kesalahan potensial yang bisa Anda dapatkan. Jika lingkungan Anda tidak didukung untuk migrasi menggunakan fitur migrasi di tempat atau Anda ingin bermigrasi ke App Service Environment v3 tanpa menggunakan fitur migrasi di tempat, lihat opsi migrasi manual. Perintah ini juga memvalidasi bahwa Lingkungan App Service Anda berada di versi build yang didukung untuk migrasi. Jika Lingkungan App Service Anda tidak berada pada versi build yang didukung, Anda perlu memulai peningkatan sendiri, yang dapat memakan waktu 8-12 jam atau lebih lama tergantung pada ukuran lingkungan Anda. Untuk informasi selengkapnya tentang peningkatan pramigrasi, lihat Memvalidasi bahwa migrasi didukung menggunakan fitur migrasi di tempat untuk Lingkungan App Service Anda.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=validation"
Jika tidak ada kesalahan, migrasi Anda didukung dan Anda dapat melanjutkan ke langkah berikutnya.
Jika Anda perlu memulai peningkatan untuk meningkatkan Lingkungan App Service Anda ke versi build yang didukung, jalankan perintah berikut. Hanya jalankan perintah ini jika Anda gagal dalam langkah validasi dan Anda diinstruksikan untuk meningkatkan Lingkungan App Service Anda.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=PreMigrationUpgrade"
3. Hasilkan alamat IP untuk sumber daya App Service Environment v3 baru Anda
Jalankan perintah berikut untuk membuat alamat IP baru. Langkah ini membutuhkan waktu sekitar 15 menit untuk diselesaikan. Jangan menskalakan atau membuat perubahan pada Lingkungan Azure App Service yang ada selama waktu ini.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=premigration"
Jalankan perintah berikut untuk memeriksa status langkah ini:
az rest --method get --uri "${ASE_ID}?api-version=2021-02-01" --query properties.status
Jika langkah sedang berlangsung, Anda mendapatkan status Migrating. Setelah Anda mendapatkan status Ready, jalankan perintah berikut untuk melihat IP baru Anda. Jika Anda tidak segera melihat IP baru, tunggu beberapa menit dan coba lagi.
az rest --method get --uri "${ASE_ID}/configurations/networking?api-version=2021-02-01"
Catatan
Karena bug yang diketahui, untuk migrasi LINGKUNGAN App Service ELB, alamat IP masuk dapat berubah lagi setelah langkah migrasi selesai. Bersiaplah untuk memperbarui sumber daya dependen Anda lagi dengan alamat IP masuk baru setelah langkah migrasi selesai. Bug ini sedang ditangani dan akan diperbaiki sesegera mungkin. Buka kasus dukungan jika Anda memiliki pertanyaan atau kekhawatiran tentang masalah ini atau memerlukan bantuan terkait proses migrasi.
4. Perbarui sumber daya dependen dengan IP baru
Dengan menggunakan IP baru, perbarui salah satu sumber daya atau komponen jaringan Anda untuk memastikan bahwa lingkungan baru Anda berfungsi seperti yang dimaksudkan setelah migrasi selesai. Anda bertanggung jawab untuk membuat pembaruan yang diperlukan.
Langkah ini juga merupakan waktu yang tepat untuk meninjau perubahan dependensi jaringan masuk dan keluar saat pindah ke Lingkungan App Service v3. Perubahan ini termasuk perubahan port untuk Azure Load Balancer, yang sekarang menggunakan port 80. Jangan bermigrasi sampai Anda menyelesaikan langkah ini.
5. Delegasikan subnet Lingkungan Azure App Service Anda
Lingkungan App Service v3 membutuhkan subnet untuk memiliki satu delegasi Microsoft.Web/hostingEnvironments. Versi sebelumnya tidak memerlukan delegasi ini. Anda perlu mengonfirmasi bahwa subnet Anda didelegasikan dengan benar dan memperbarui delegasi (jika perlu) sebelum bermigrasi. Anda dapat memperbarui delegasi baik dengan menjalankan perintah berikut atau dengan masuk ke subnet di portal Azure.
az network vnet subnet update --resource-group $VNET_RG --name <subnet-name> --vnet-name <vnet-name> --delegations Microsoft.Web/hostingEnvironments
6. Konfirmasikan tidak ada kunci pada jaringan virtual
Jaringan virtual mengunci operasi platform blok selama migrasi. Jika jaringan virtual Anda memiliki kunci, Anda perlu menghapusnya sebelum bermigrasi. Jika perlu, Anda dapat menambahkan kembali kunci setelah migrasi selesai.
Kunci dapat ada di tiga cakupan: langganan, grup sumber daya, dan sumber daya. Saat Anda menerapkan kunci pada lingkup induk, semua sumber daya dalam lingkup tersebut menerapkan kunci yang sama. Jika Anda memiliki kunci yang diterapkan di langganan, grup sumber daya, atau cakupan sumber daya, Anda perlu menghapusnya sebelum migrasi. Untuk informasi selengkapnya tentang kunci dan mengunci pewarisan, lihat Mengunci sumber daya Anda untuk melindungi infrastruktur Anda.
Gunakan perintah berikut untuk memeriksa apakah jaringan virtual Anda memiliki kunci:
az lock list --resource-group $VNET_RG --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Hapus kunci yang ada dengan menggunakan perintah berikut:
az lock delete --resource-group $VNET_RG --name <lock-name> --resource <vnet-name> --resource-type Microsoft.Network/virtualNetworks
Untuk perintah terkait untuk memeriksa apakah langganan atau grup sumber daya Anda memiliki kunci, lihat referensi Azure CLI untuk kunci.
7. Siapkan konfigurasi Anda
Anda dapat membuat zona sumber daya App Service Environment v3 anda redundan jika lingkungan yang ada berada di wilayah yang mendukung redundansi zona. Anda dapat mengonfigurasi redundansi zona dengan mengatur zoneRedundant properti ke true.
Redundansi zona adalah konfigurasi opsional. Anda hanya dapat mengaturnya selama pembuatan sumber daya App Service Environment v3 baru Anda. Anda tidak dapat menghapusnya di lain waktu. Untuk informasi selengkapnya, lihat Memilih konfigurasi Lingkungan App Service v3 Anda. Jika Anda tidak ingin mengonfigurasi redundansi zona, jangan sertakan parameter zoneRedundant.
Jika Lingkungan App Service yang ada menggunakan akhiran domain kustom, Anda perlu mengonfigurasinya untuk sumber daya App Service Environment v3 baru Anda selama proses migrasi. Migrasi gagal jika Anda tidak mengonfigurasi akhiran domain kustom dan menggunakannya saat ini. Migrasi juga gagal jika Anda mencoba menambahkan akhiran domain kustom selama migrasi ke lingkungan yang tidak memilikinya dikonfigurasi. Untuk informasi selengkapnya tentang akhiran domain kustom App Service Environment v3, termasuk persyaratan, instruksi langkah demi langkah, dan praktik terbaik, lihat Akhiran domain kustom untuk Lingkungan App Service.
Catatan
Jika Anda mengonfigurasi akhiran domain kustom, saat Anda menambahkan izin jaringan di brankas kunci Azure, pastikan brankas kunci Anda mengizinkan akses dari alamat IP keluar baru Lingkungan App Service anda yang dihasilkan di langkah 3. Jika Anda mengakses brankas kunci menggunakan titik akhir privat, pastikan Anda telah mengonfigurasi akses privat dengan benar.
Jika migrasi Anda tidak menyertakan akhiran domain kustom dan Anda tidak mengaktifkan redundansi zona, Anda dapat melanjutkan ke migrasi.
Untuk mengatur konfigurasi ini, buat file yang disebut parameters.json dengan detail berikut berdasarkan skenario Anda. Jangan sertakan properti untuk akhiran domain kustom jika fitur ini tidak berlaku untuk migrasi Anda. Perhatikan nilai zoneRedundant properti, karena konfigurasi ini tidak dapat diubah setelah migrasi. Tetapkan nilai kind properti berdasarkan versi App Service Environment Anda yang sudah ada. Nilai yang kind diterima untuk properti adalah ASEV1 dan ASEV2.
Jika Anda bermigrasi tanpa akhiran domain kustom dan mengaktifkan redundansi zona, gunakan kode ini:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true
}
}
Jika Anda menggunakan identitas terkelola yang ditetapkan pengguna untuk konfigurasi akhiran domain kustom dan Anda mengaktifkan redundansi zona, gunakan kode ini:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"zoneRedundant": true,
"customDnsSuffixConfiguration": {
"dnsSuffix": "internal.contoso.com",
"certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
"keyVaultReferenceIdentity": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/asev3-migration/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ase-managed-identity"
}
}
}
Jika Anda menggunakan identitas terkelola yang ditetapkan sistem untuk konfigurasi akhiran domain kustom dan Anda tidak mengaktifkan redundansi zona, gunakan kode ini:
{
"type": "Microsoft.Web/hostingEnvironments",
"name": "sample-ase-migration",
"kind": "ASEV2",
"location": "westcentralus",
"properties": {
"customDnsSuffixConfiguration": {
"dnsSuffix": "internal.contoso.com",
"certificateUrl": "https://contoso.vault.azure.net/secrets/myCertificate",
"keyVaultReferenceIdentity": "SystemAssigned"
}
}
}
8. Migrasi ke Lingkungan App Service v3 dan periksa status
Setelah menyelesaikan semua langkah sebelumnya, Anda dapat memulai migrasi. Pastikan Anda memahami implikasi migrasi.
Langkah ini membutuhkan waktu tiga hingga enam jam untuk migrasi v2 hingga v3 dan hingga enam jam untuk migrasi v1 hingga v3, tergantung pada ukuran lingkungan. Selama waktu itu, ada sekitar satu jam waktu henti aplikasi. Penskalaan, penyebaran, dan modifikasi pada Lingkungan App Service Anda yang ada diblokir selama langkah ini.
body Sertakan parameter dalam perintah berikut jika Anda mengaktifkan redundansi zona dan/atau mengonfigurasi akhiran domain kustom. Jika tidak ada konfigurasi yang berlaku untuk migrasi, Anda dapat menghapus parameter dari perintah.
az rest --method post --uri "${ASE_ID}/migrate?api-version=2021-02-01&phase=fullmigration" --body @parameters.json
Jalankan perintah berikut untuk memeriksa status terperinci migrasi Anda. Untuk informasi tentang status, lihat deskripsi status migrasi.
Perintah pertama mendapatkan ID operasi untuk migrasi. Salin nilai ID properti .
az rest --method get --uri "${ASE_ID}/operations?api-version=2022-03-01"
Ganti tempat penampung untuk ID operasi dalam perintah berikut dengan nilai yang Anda salin. Perintah ini mengembalikan status terperinci migrasi Anda. Anda dapat menjalankan perintah ini sesering yang diperlukan untuk mendapatkan status terbaru.
az rest --method get --uri "${ASE_ID}/operations/<operation-id>/details/default?api-version=2022-09-01"
Setelah Anda mendapatkan status Ready, migrasi selesai, dan Anda memiliki sumber daya App Service Environment v3. Aplikasi Anda sekarang berjalan di lingkungan baru Anda.
Dapatkan detail lingkungan baru Anda dengan menjalankan perintah berikut atau dengan masuk ke portal Azure.
az appservice ase show --name $ASE_NAME --resource-group $ASE_RG
Catatan
Karena bug yang diketahui, untuk migrasi LINGKUNGAN App Service ELB, alamat IP masuk dapat berubah setelah langkah migrasi selesai. Periksa alamat IP App Service Environment v3 Anda dan buat pembaruan yang diperlukan jika telah ada perubahan sejak langkah pembuatan IP. Buka kasus dukungan jika Anda memiliki pertanyaan atau kekhawatiran tentang masalah ini atau memerlukan bantuan dengan mengonfirmasi IP baru.
1. Validasi bahwa migrasi didukung
Di portal Azure, buka halaman Migrasi untuk Lingkungan App Service yang sedang Anda migrasikan. Anda bisa masuk ke halaman Migrasi dengan memilih banner di bagian atas halaman Gambaran Umum untuk Lingkungan App Service Anda, atau dengan memilih item Migrasi di menu sebelah kiri.
Pada halaman Migrasi , platform memvalidasi apakah migrasi didukung untuk Lingkungan App Service Anda. Pilih Validasi, lalu konfirmasikan bahwa Anda ingin melanjutkan validasi. Proses validasi membutuhkan waktu beberapa detik.
Jika lingkungan Anda tidak didukung untuk migrasi, banner akan muncul di bagian atas halaman dan menyertakan pesan kesalahan dengan alasan tertentu. Untuk deskripsi pesan kesalahan yang dapat muncul jika Anda tidak memenuhi syarat untuk migrasi, lihat Pemecahan Masalah.
Jika Lingkungan App Service Anda tidak didukung untuk migrasi saat ini atau lingkungan Anda dalam status tidak sehat atau ditangguhkan, Anda tidak dapat menggunakan fitur migrasi. Jika lingkungan Anda tidak didukung untuk migrasi dengan fitur migrasi di tempat atau Anda ingin bermigrasi ke App Service Environment v3 tanpa menggunakan fitur migrasi di tempat, lihat opsi migrasi manual.
Jika Anda perlu memulai peningkatan untuk meningkatkan Lingkungan App Service ke versi build yang didukung, Anda diminta untuk memulai peningkatan, yang bisa memakan waktu 8-12 jam atau lebih lama tergantung pada ukuran lingkungan Anda. Pilih Tingkatkan untuk memulai peningkatan. Setelah peningkatan selesai, Anda lulus validasi dan dapat menggunakan fitur migrasi untuk memulai migrasi Anda.
Jika migrasi didukung untuk Lingkungan App Service Anda, lanjutkan ke langkah berikutnya dalam proses. Halaman Migrasi memandu Anda melalui serangkaian langkah untuk menyelesaikan migrasi.
2. Hasilkan alamat IP untuk sumber daya App Service Environment v3 baru Anda
Di bawah Dapatkan alamat IP baru, konfirmasikan bahwa Anda memahami implikasinya dan pilih tombol Mulai . Langkah ini membutuhkan waktu sekitar 15 menit untuk diselesaikan. Anda tidak dapat menskalakan atau membuat perubahan pada Lingkungan App Service yang ada selama waktu ini.
3. Perbarui sumber daya dependen dengan IP baru
Ketika langkah sebelumnya selesai, alamat IP untuk sumber daya App Service Environment v3 baru Anda muncul. Gunakan IP baru untuk memperbarui sumber daya dan komponen jaringan apa pun sehingga lingkungan baru Anda berfungsi seperti yang dimaksudkan setelah migrasi selesai. Anda bertanggung jawab untuk membuat pembaruan yang diperlukan.
Langkah ini juga merupakan waktu yang tepat untuk meninjau perubahan dependensi jaringan masuk dan keluar dalam pindah ke Lingkungan App Service v3. Perubahan ini termasuk perubahan port untuk Azure Load Balancer, yang sekarang menggunakan port 80. Jangan pindah ke langkah berikutnya sampai Anda mengonfirmasi bahwa Anda membuat pembaruan ini.
4. Delegasikan subnet Lingkungan Azure App Service Anda
Lingkungan App Service v3 mengharuskan subnet tempatnya memiliki satu delegasi .Microsoft.Web/hostingEnvironments Versi sebelumnya tidak memerlukan delegasi ini. Anda perlu mengonfirmasi bahwa subnet Anda didelegasikan dengan benar dan memperbarui delegasi (jika perlu) sebelum bermigrasi. Portal menampilkan tautan ke subnet Anda sehingga Anda dapat mengonfirmasi dan memperbarui sesuai kebutuhan.
5. Mengakui perubahan ukuran instans
Paket App Service Anda dikonversi dari Terisolasi ke tingkat Isolated v2 yang sesuai. Misalnya, I2 dikonversi ke I2v2. Aplikasi Anda mungkin provisi berlebihan setelah migrasi, karena tingkat v2 Terisolasi memiliki lebih banyak memori dan CPU per ukuran instans yang sesuai. Anda memiliki kesempatan untuk menskalakan lingkungan Anda sesuai kebutuhan setelah migrasi selesai. Untuk informasi selengkapnya, tinjau detail harga.
6. Konfirmasikan bahwa jaringan virtual tidak memiliki kunci
Jaringan virtual mengunci operasi platform blok selama migrasi. Jika jaringan virtual Anda memiliki kunci, Anda perlu menghapusnya sebelum bermigrasi. Jika perlu, Anda dapat menambahkan kembali kunci setelah migrasi selesai.
Kunci dapat ada di tiga cakupan: langganan, grup sumber daya, dan sumber daya. Saat Anda menerapkan kunci pada lingkup induk, semua sumber daya dalam lingkup tersebut menerapkan kunci yang sama. Jika Anda memiliki kunci yang diterapkan di langganan, grup sumber daya, atau cakupan sumber daya, Anda perlu menghapusnya sebelum migrasi. Untuk informasi selengkapnya tentang kunci dan mengunci pewarisan, lihat Mengunci sumber daya Anda untuk melindungi infrastruktur Anda.
Untuk detail tentang cara memeriksa apakah langganan atau grup sumber daya Anda memiliki kunci, lihat Mengonfigurasi kunci.
7. Pilih konfigurasi Anda
Anda dapat membuat zona sumber daya App Service Environment v3 anda redundan jika lingkungan yang ada berada di wilayah yang mendukung redundansi zona. Redundansi zona adalah konfigurasi opsional. Anda hanya dapat mengaturnya selama pembuatan sumber daya App Service Environment v3 baru Anda. Anda tidak dapat menghapusnya di lain waktu. Untuk informasi selengkapnya, lihat Memilih konfigurasi Lingkungan App Service v3 Anda.
Pilih kotak centang Diaktifkan jika Anda ingin mengonfigurasi redundansi zona.
Jika lingkungan Anda berada di wilayah yang tidak mendukung redundansi zona, kotak centang tidak tersedia. Jika Anda memerlukan sumber daya App Service Environment v3 zona-redundan, gunakan salah satu opsi migrasi manual dan buat sumber daya di salah satu wilayah yang mendukung redundansi zona.
Jika Lingkungan App Service yang ada menggunakan akhiran domain kustom, Anda harus mengonfigurasinya untuk sumber daya App Service Environment v3 baru Anda. Opsi konfigurasi untuk akhiran domain kustom muncul jika situasi ini berlaku untuk Anda. Anda tidak dapat bermigrasi hingga Anda memberikan informasi yang diperlukan.
Jika Anda ingin menggunakan akhiran domain kustom tetapi saat ini tidak memilikinya yang dikonfigurasi, Anda dapat mengonfigurasinya setelah migrasi selesai. Untuk informasi selengkapnya tentang akhiran domain kustom App Service Environment v3, termasuk persyaratan, instruksi langkah demi langkah, dan praktik terbaik, lihat Akhiran domain kustom untuk Lingkungan App Service.
Catatan
Jika Anda mengonfigurasi akhiran domain kustom, saat Anda menambahkan izin jaringan di brankas kunci Azure, pastikan brankas kunci Anda mengizinkan akses dari alamat IP keluar baru Lingkungan App Service anda yang dihasilkan di langkah 2. Jika Anda mengakses brankas kunci menggunakan titik akhir privat, pastikan Anda telah mengonfigurasi akses privat dengan benar.
Setelah Anda menambahkan detail untuk akhiran domain kustom Anda, tombol Migrasi tersedia.
8. Migrasi ke Lingkungan App Service v3
Setelah menyelesaikan semua langkah sebelumnya, Anda dapat memulai migrasi. Pastikan Anda memahami implikasi migrasi, termasuk apa yang terjadi selama waktu ini.
Langkah ini membutuhkan waktu tiga hingga enam jam untuk migrasi v2 hingga v3 dan hingga enam jam untuk migrasi v1 hingga v3, tergantung pada ukuran lingkungan. Penskalaan dan modifikasi pada Lingkungan App Service Anda yang ada diblokir selama langkah ini.
Catatan
Dalam kasus yang jarang terjadi, Anda mungkin melihat pemberitahuan di portal yang mengatakan "Migrasi ke Lingkungan App Service v3 gagal" setelah Anda memulai migrasi. Ada bug yang diketahui yang mungkin memicu pemberitahuan ini meskipun migrasi sedang berlangsung. Periksa log aktivitas untuk Lingkungan App Service untuk menentukan validitas pesan kesalahan ini. Dalam kebanyakan kasus, me-refresh halaman menyelesaikan masalah, dan pesan kesalahan menghilang. Jika pesan kesalahan berlanjut, hubungi dukungan untuk bantuan.
Saat ini, status migrasi terperinci hanya tersedia saat Anda menggunakan Azure CLI. Untuk informasi selengkapnya, lihat bagian Azure CLI untuk bermigrasi ke Lingkungan App Service v3. Anda dapat memeriksa status migrasi dengan CLI meskipun Anda menggunakan portal untuk melakukan migrasi.
Setelah migrasi selesai, Anda memiliki sumber daya App Service Environment v3, dan semua aplikasi Anda berjalan di lingkungan baru Anda. Anda dapat mengonfirmasi versi lingkungan dengan memeriksa halaman Konfigurasi untuk Lingkungan Azure App Service Anda.
Catatan
Karena bug yang diketahui, untuk migrasi LINGKUNGAN App Service ELB, alamat IP masuk dapat berubah setelah langkah migrasi selesai. Periksa alamat IP App Service Environment v3 Anda dan buat pembaruan yang diperlukan jika telah ada perubahan sejak langkah pembuatan IP. Buka kasus dukungan jika Anda memiliki pertanyaan atau kekhawatiran tentang masalah ini atau memerlukan bantuan dengan mengonfirmasi IP baru.
Jika migrasi Anda menyertakan akhiran domain kustom, domain muncul di bagian Esensial di halaman Gambaran Umum portal untuk Lingkungan App Service v1/v2, tetapi tidak lagi muncul di Lingkungan App Service v3. Sebagai gantinya, untuk Lingkungan App Service v3, buka halaman Akhiran domain kustom untuk mengonfirmasi bahwa akhiran domain kustom Anda dikonfigurasi dengan benar. Anda juga dapat menghapus konfigurasi jika Anda tidak lagi membutuhkannya atau mengonfigurasinya jika sebelumnya Anda tidak memilikinya.
Catatan
Jika migrasi Anda menyertakan akhiran domain kustom, konfigurasi akhiran domain kustom Anda mungkin ditampilkan sebagai terdegradasi setelah migrasi selesai karena bug yang diketahui. Lingkungan App Service Anda masih harus berfungsi seperti yang diharapkan. Status yang terdegradasi harus diselesaikan dengan sendirinya dalam waktu 6-8 jam. Jika konfigurasi terdegradasi setelah 8 jam atau jika akhiran domain kustom Anda tidak berfungsi, hubungi dukungan.
