Bagikan melalui


Mengekspor alur kerja ISE ke aplikasi logika Standar

Alur kerja aplikasi logika standar, yang berjalan di Azure Logic Apps penyewa tunggal, menawarkan banyak kemampuan baru dan yang ditingkatkan. Misalnya, Anda mendapatkan isolasi komputasi, integrasi jaringan virtual, dan titik akhir privat bersama dengan hosting Lingkungan App Services, pengembangan dan penelusuran kesalahan lokal menggunakan Visual Studio Code, latensi rendah dengan alur kerja tanpa status, dan banyak lagi.

Jika Anda menginginkan manfaat dari alur kerja Standar, tetapi alur kerja Anda berjalan di lingkungan layanan integrasi (ISE), Anda sekarang dapat mengganti ISE Anda dengan Azure Logic Apps penyewa tunggal. Sakelar ini masuk akal untuk sebagian besar skenario yang memerlukan beberapa kemampuan ISE seperti isolasi dan integrasi jaringan, dan dapat membantu menurunkan biaya operasi.

Anda sekarang dapat mengekspor alur kerja aplikasi logika dari ISE ke aplikasi logika Standar. Menggunakan Visual Studio Code dan ekstensi Azure Logic Apps (Standar) terbaru, Anda mengekspor aplikasi logika sebagai alur kerja stateful ke proyek aplikasi logika Standar. Anda kemudian dapat memperbarui, menguji, dan men-debug alur kerja Anda secara lokal untuk menyiapkannya untuk penyebaran ulang. Setelah siap, Anda dapat menyebarkan langsung dari Visual Studio Code atau melalui proses DevOps Anda sendiri.

Catatan

Kemampuan ekspor tidak memigrasikan alur kerja Anda. Sebagai gantinya, alat ini mereplikasi artefak, seperti definisi alur kerja, koneksi, artefak akun integrasi, dan lainnya. Sumber daya aplikasi logika sumber Anda, alur kerja, riwayat pemicu, riwayat eksekusi, dan data lainnya tetap utuh.

Anda mengontrol proses ekspor dan perjalanan migrasi Anda. Anda dapat menguji dan memvalidasi alur kerja yang diekspor sesuai dengan lingkungan tujuan. Anda memilih kapan harus menonaktifkan atau menghapus aplikasi logika sumber Anda.

Artikel ini menyediakan informasi tentang proses ekspor dan menunjukkan cara mengekspor alur kerja aplikasi logika Anda dari ISE ke proyek aplikasi logika Standar lokal di Visual Studio Code.

Masalah dan batasan yang diketahui

  • Alat ekspor tidak mengekspor informasi infrastruktur apa pun, seperti pengaturan akun integrasi.

  • Alat ekspor dapat mengekspor alur kerja aplikasi logika dengan pemicu yang memiliki pengaturan konkurensi. Namun, Azure Logic Apps penyewa tunggal mengabaikan pengaturan ini.

  • Aplikasi logika harus ada di wilayah yang sama jika Anda ingin mengekspornya dalam proyek aplikasi logika Standar yang sama.

  • Secara default, kredensial koneksi tidak dikloning dari alur kerja aplikasi logika sumber. Sebelum alur kerja aplikasi logika anda dapat berjalan, Anda harus mengotoris ulang koneksi ini setelah ekspor.

  • Secara default, jika konektor Azure memiliki versi konektor bawaan, alat ekspor secara otomatis mengonversi konektor Azure ke konektor bawaan. Tidak ada opsi untuk memilih keluar dari perilaku ini.

  • Jika ID koneksi salah diformat, kesalahan akan muncul. Sebelum Anda mengekspor alur kerja, pastikan ID koneksi untuk konektor Anda cocok dengan format berikut:

    subscriptionId/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationServiceEnvironments/{integration-service-environment-name}/managedApis/{managed-api-name}

Jenis operasi yang dapat diekspor

Operasi Jenis JSON
Pemicu Bawaan: Http, HttpWebhook, Recurrence, manual (Permintaan)

Dikelola: ApiConnection ApiConnectionNotification, ApiConnectionWebhook
Perbuatan Bawaan: AppendToArrayVariable, , AppendToStringVariable, ComposeDecrementVariable, , Foreach, Http, HttpWebhookIf, IncrementVariable, InitializeVariable, , JavaScriptCode, Join, ParseJson, Response, Scope, Select, SetVariable, Switch, , Table, Terminate, UntilWait

- Dikelola: ApiConnection, ApiConnectionWebhook

Prasyarat

  • Satu atau beberapa aplikasi logika untuk disebarkan ke langganan yang sama dan wilayah Azure, misalnya, US Timur 2.

  • Akses tingkat langganan pembaca Azure ke langganan tempat aplikasi logika saat ini disebarkan.

  • Akses tingkat grup sumber daya kontributor Azure, jika opsi Sebarkan konektor terkelola dipilih.

  • Tinjau dan penuhi persyaratan tentang cara menyiapkan Visual Studio Code dengan ekstensi Azure Logic Apps (Standar).

Catatan

Pastikan untuk menginstal versi 2.0.16 atau yang lebih tinggi untuk ekstensi Azure Logic Apps (Standar) untuk Visual Studio Code. Beberapa skenario konversi memerlukan perancang alur kerja terbaru, yang tersedia dimulai dengan versi ini.

Aplikasi logika grup untuk ekspor

Dengan ekstensi Azure Logic Apps (Standar), Anda dapat menggabungkan beberapa alur kerja aplikasi logika yang dihosting ISE ke dalam satu proyek aplikasi logika Standar. Di Azure Logic Apps penyewa tunggal, satu sumber daya aplikasi logika Standar dapat memiliki beberapa alur kerja. Dengan pendekatan ini, Anda dapat memvalidasi alur kerja terlebih dahulu sehingga Anda tidak melewatkan dependensi apa pun saat memilih aplikasi logika untuk diekspor.

Pertimbangkan rekomendasi berikut saat Anda memilih aplikasi logika untuk diekspor:

  • Aplikasi logika grup tempat alur kerja berbagi sumber daya yang sama, seperti artefak akun integrasi, peta, dan skema, atau menggunakan sumber daya melalui rantai proses.

  • Untuk organisasi dan jumlah alur kerja per aplikasi logika, tinjau Praktik dan rekomendasi terbaik.

Mengekspor alur kerja ISE ke proyek lokal

Pilih aplikasi logika untuk diekspor

  1. Di Visual Studio Code, masuk ke Azure, jika Anda belum melakukannya.

  2. Pada Bilah Aktivitas Visual Studio Code, pilih Azure untuk membuka jendela Azure (Shift + Alt + A).

    Cuplikan layar memperlihatkan Bilah Aktivitas Visual Studio Code dengan ikon Azure dipilih.

  3. Pada toolbar bagian Ruang Kerja, dari menu Azure Logic Apps , pilih Ekspor Aplikasi Logika.

    Cuplikan layar memperlihatkan jendela Azure, toolbar bagian Ruang Kerja, dan Ekspor Aplikasi Logika dipilih.

  4. Setelah tab Ekspor terbuka, pilih langganan Azure dan instans ISE Anda, lalu pilih Berikutnya.

    Cuplikan layar memperlihatkan tab Ekspor dengan langganan Azure dan instans ISE dipilih.

  5. Pilih aplikasi logika yang akan diekspor. Setiap aplikasi logika yang dipilih muncul di daftar Aplikasi logika yang dipilih di samping. Setelah selesai, pilih Berikutnya.

    Tip

    Anda juga dapat mencari aplikasi logika dan memfilter grup sumber daya.

    Cuplikan layar memperlihatkan bagian 'Pilih aplikasi logika untuk diekspor' dengan aplikasi logika yang dipilih untuk diekspor.

    Alat ekspor mulai memvalidasi apakah aplikasi logika yang Anda pilih memenuhi syarat untuk diekspor.

Meninjau hasil validasi ekspor

  1. Setelah validasi ekspor selesai, tinjau hasilnya dengan memperluas entri untuk setiap aplikasi logika.

    • Aplikasi logika yang memiliki kesalahan tidak memenuhi syarat untuk diekspor. Anda harus menghapus aplikasi logika ini dari daftar ekspor hingga Anda memperbaikinya di sumbernya. Untuk menghapus aplikasi logika dari daftar, pilih Kembali.

      Misalnya, SourceLogicApp2 memiliki kesalahan dan tidak dapat diekspor hingga diperbaiki:

      Cuplikan layar memperlihatkan bagian 'Tinjau status ekspor' dan status validasi untuk alur kerja aplikasi logika dengan kesalahan.

    • Aplikasi logika yang melewati validasi dengan atau tanpa peringatan masih memenuhi syarat untuk diekspor. Untuk melanjutkan, pilih Ekspor jika semua aplikasi berhasil divalidasi, atau pilih Ekspor dengan peringatan jika aplikasi memiliki peringatan.

      Misalnya, SourceLogicApp3 memiliki peringatan, tetapi Anda masih dapat terus mengekspor:

      Cuplikan layar memperlihatkan bagian 'Tinjau status ekspor' dan status validasi untuk alur kerja aplikasi logika dengan peringatan.

    Tabel berikut ini menyediakan informasi selengkapnya tentang setiap ikon dan status validasi:

    Ikon validasi Status validasi
    Ikon Keberhasilan Item lulus validasi, sehingga ekspor dapat dilanjutkan tanpa masalah untuk diselesaikan.
    Ikon gagal Validasi item gagal, sehingga ekspor tidak dapat dilanjutkan.

    Entri validasi untuk item yang gagal secara otomatis muncul diperluas dan memberikan informasi tentang kegagalan validasi.
    Ikon peringatan Item melewati validasi dengan peringatan, tetapi ekspor dapat dilanjutkan dengan resolusi pasca-ekspor yang diperlukan.

    Entri validasi untuk item dengan peringatan secara otomatis muncul diperluas dan memberikan informasi tentang peringatan dan remediasi pasca-ekspor yang diperlukan.
  2. Setelah bagian Selesaikan ekspor muncul, untuk Lokasi ekspor, telusuri dan pilih folder lokal untuk proyek aplikasi logika Standar baru Anda.

    Cuplikan layar memperlihatkan bagian 'Selesaikan ekspor' dan properti 'Ekspor lokasi' dengan folder proyek ekspor lokal yang dipilih.

  3. Jika alur kerja Anda memiliki koneksi terkelola yang ingin Anda sebarkan, yang hanya direkomendasikan untuk lingkungan non-produksi, pilih Sebarkan koneksi terkelola, yang memperlihatkan grup sumber daya yang ada di langganan Azure Anda. Pilih grup sumber daya tempat Anda ingin menyebarkan koneksi terkelola.

    Cuplikan layar memperlihatkan bagian 'Selesaikan ekspor' dengan folder ekspor lokal yang dipilih, 'Sebarkan koneksi terkelola' dipilih, dan grup sumber daya target dipilih.

  4. Di bawah Setelah langkah-langkah ekspor, tinjau langkah-langkah pasca-ekspor yang diperlukan, misalnya:

    Cuplikan layar memperlihatkan bagian 'Setelah langkah-langkah ekspor' dan langkah-langkah pasca-ekspor yang diperlukan, jika ada.

  5. Berdasarkan skenario Anda, pilih Ekspor dan selesaikan atau Ekspor dengan peringatan dan selesai.

    Alat ekspor mengunduh proyek Anda ke lokasi folder yang Anda pilih, memperluas proyek di Visual Studio Code, dan menyebarkan koneksi terkelola apa pun, jika Anda memilih opsi tersebut.

    Cuplikan layar memperlihatkan bagian 'Status ekspor' dengan kemajuan ekspor.

  6. Setelah proses ini selesai, Visual Studio Code membuka ruang kerja baru. Anda sekarang dapat menutup jendela ekspor dengan aman.

  7. Dari proyek aplikasi logika Standar Anda, buka dan tinjau file README.md untuk langkah-langkah pasca-ekspor yang diperlukan.

    Cuplikan layar memperlihatkan proyek aplikasi logika Standar baru dengan file README.md dibuka.

Langkah-langkah pasca-ekspor

Langkah remediasi

Beberapa alur kerja aplikasi logika yang diekspor memerlukan langkah-langkah remediasi pasca-ekspor untuk dijalankan pada platform Standar.

  1. Dari proyek aplikasi logika Standar Anda, buka file README.md, dan tinjau langkah-langkah remediasi untuk alur kerja yang diekspor. Alat ekspor menghasilkan file README.md, yang berisi semua langkah pasca-ekspor yang diperlukan.

  2. Sebelum Anda membuat perubahan pada alur kerja aplikasi logika sumber, pastikan untuk menguji sumber daya dan alur kerja aplikasi logika Standar baru Anda.

Tindakan dan pengaturan akun integrasi

Jika Anda mengekspor tindakan yang bergantung pada akun integrasi, Anda harus menyiapkan aplikasi logika Standar secara manual dengan tautan referensi ke akun integrasi yang berisi artefak yang diperlukan. Untuk informasi selengkapnya, tinjau Menautkan akun integrasi ke aplikasi logika Standar.

Jika Anda memiliki akun integrasi Standar yang dibuat dari dalam ISE, Anda dapat mengekspor akun integrasi tersebut ke akun integrasi Premium yang ada.

Tindakan dan pengaturan batch

Jika Anda mengekspor tindakan yang menggunakan tindakan Batch dengan beberapa konfigurasi yang disimpan di akun integrasi, Anda harus mengonfigurasi tindakan Batch anda secara manual dengan nilai yang benar setelah ekspor. Untuk informasi selengkapnya, tinjau Kirim, terima, dan batch pesan proses di Azure Logic Apps.

Struktur folder proyek

Setelah proses ekspor selesai, proyek aplikasi logika Standar Anda berisi folder dan file baru bersama sebagian besar lainnya dalam proyek aplikasi logika Standar yang khas.

Tabel berikut ini menjelaskan folder dan file baru ini yang ditambahkan oleh proses ekspor:

Folder File Deskripsi
.development\deployment LogicAppStandardConnections.parameters.json File parameter templat Azure Resource Manager untuk menyebarkan konektor terkelola
LogicAppStandardConnections.template.json Definisi templat Azure Resource Manager untuk menyebarkan konektor terkelola
LogicAppStandardInfrastructure.parameters.json File parameter templat Azure Resource Manager untuk menyebarkan sumber daya aplikasi logika Standar
LogicAppStandardInfrastructure.template.json Definisi templat Azure Resource Manager untuk menyebarkan sumber daya aplikasi logika Standar
.logs\export exportReport.json Ekspor file mentah ringkasan laporan, yang mencakup semua langkah yang diperlukan untuk remediasi pasca-ekspor
exportValidation.json File mentah laporan validasi, yang mencakup hasil validasi untuk setiap aplikasi logika yang diekspor.
README.md File markdown dengan ringkasan hasil ekspor, termasuk aplikasi logika yang dibuat dan semua langkah berikutnya yang diperlukan.

Langkah berikutnya