Mengedit pengaturan host serta aplikasi untuk aplikasi logika di Azure Logic Apps penyewa tunggal

Berlaku pada: Azure Logic Apps (Standar)

Di Azure Logic Apps penyewa tunggal, pengaturan aplikasi untuk aplikasi logika Standar menentukan opsi konfigurasi global yang memengaruhi semua alur kerja di aplikasi logika tersebut. Namun, pengaturan tersebut hanya berlaku saat alur kerja tersebut berjalan di lingkungan pengembangan lokal Anda. Alur kerja yang berjalan secara lokal dapat mengakses pengaturan aplikasi ini sebagai variabel lingkungan lokal, yang digunakan oleh alat pengembangan lokal untuk nilai yang sering kali dapat berubah di antara lingkungan. Misalnya, nilai-nilai tersebut dapat berisi string koneksi. Saat Anda menyebarkan ke Azure, pengaturan aplikasi diabaikan dan tidak disertakan dengan penyebaran Anda.

Aplikasi logika Anda juga memiliki pengaturan host, yang menentukan pengaturan konfigurasi runtime bahasa umum dan nilai yang berlaku untuk semua alur kerja di aplikasi logika tersebut, misalnya, nilai default untuk throughput, kapasitas, ukuran data, dan sebagainya, apakah nilai tersebut berjalan secara lokal atau di Azure.

Pengaturan adalah pasangan kunci-nilai yang menentukan nama dan nilai pengaturan.

Pengaturan, parameter, dan penyebaran aplikasi

Di Azure Logic Apps multipenyewa, penyebaran bergantung pada templat Azure Resource Manager (templat ARM), yang menggabungkan dan menangani provisi sumber daya untuk aplikasi logika dan infrastruktur. Desain ini menimbulkan tantangan saat Anda harus mempertahankan variabel lingkungan untuk aplikasi logika di berbagai lingkungan pengembangan, pengujian, dan produksi. Semua yang ada dalam templat ARM ditentukan saat penyebaran. Jika Anda hanya perlu mengubah satu variabel, Anda harus menyebarkan ulang semuanya.

Di Azure Logic Apps penyewa tunggal, penyebaran menjadi lebih mudah karena Anda dapat memisahkan provisi sumber daya antara aplikasi dan infrastruktur. Anda dapat menggunakan parameter untuk mengabstraksi nilai yang mungkin berubah antar lingkungan. Dengan menentukan parameter yang akan digunakan dalam alur kerja, Anda dapat terlebih dahulu fokus pada mendesain alur kerja Anda, lalu menyisipkan variabel khusus lingkungan Anda nanti. Anda dapat memanggil dan mereferensikan variabel lingkungan Anda saat runtime bahasa umum dengan menggunakan pengaturan dan parameter aplikasi. Dengan begitu, Anda tidak perlu menyebarkan ulang sesering mungkin.

Pengaturan aplikasi terintegrasi dengan Azure Key Vault. Anda dapat langsung mereferensikan string aman, seperti kunci dan string koneksi. Mirip dengan templat Azure Resource Manager (templat ARM), tempat Anda dapat menentukan variabel lingkungan pada waktu penyebaran, Anda dapat menentukan pengaturan aplikasi dalam definisi alur kerja aplikasi logika Anda. Anda kemudian dapat mengambil nilai infrastruktur yang dihasilkan secara dinamis, seperti titik akhir koneksi, string penyimpanan, dan banyak lagi. Namun, pengaturan aplikasi memiliki batasan ukuran dan tidak dapat direferensikan dari area tertentu di Azure Logic Apps.

Untuk informasi selengkapnya tentang menyiapkan aplikasi logika untuk penyebaran, lihat dokumentasi berikut ini:

• Membuat parameter untuk nilai yang berubah dalam alur kerja antar lingkungan untuk Azure Logic Apps penyewa tunggal
• Ringkasan penyebaran DevOps untuk aplikasi logika berbasis penyewa tunggal
• Menyiapkan penyebaran Azure DevOps untuk aplikasi logika berbasis penyewa tunggal

Struktur proyek Visual Studio Code

Dalam Visual Studio Code, proyek aplikasi logika Anda memiliki salah satu dari jenis berikut:

• Berbasis bundel ekstensi (Node.js), yang merupakan jenis default
• Berbasis paket NuGet (.NET), yang dapat Anda konversi dari jenis default

Berdasarkan jenis ini, proyek Anda menyertakan folder dan file yang sedikit berbeda. Proyek berbasis NuGet menyertakan folder .bin yang berisi paket dan pustaka lainnya. Proyek berbasis bundel tidak menyertakan folder .bin dan file lainnya. Beberapa skenario memerlukan proyek berbasis NuGet untuk menjalankan aplikasi Anda, misalnya, saat Anda ingin mengembangkan dan menjalankan operasi bawaan kustom. Untuk informasi selengkapnya tentang mengonversi proyek Anda untuk menggunakan NuGet, tinjau Mengaktifkan penulisan konektor bawaan.

Untuk proyek berbasis bundel default, proyek Anda memiliki folder dan struktur file yang mirip dengan contoh berikut:

MyBundleBasedLogicAppProjectName
| .vscode
| Artifacts
  || Maps 
     ||| MapName1
     ||| ...
  || Schemas
     ||| SchemaName1
     ||| ...
| WorkflowName1
  || workflow.json
  || ...
| WorkflowName2
  || workflow.json
  || ...
| workflow-designtime
| .funcignore
| connections.json
| host.json
| local.settings.json

Di tingkat akar proyek, Anda dapat menemukan file dan folder berikut dengan item lain:

Referensi untuk pengaturan aplikasi - local.settings.json

Di Visual Studio Code, di tingkat akar proyek aplikasi logika Anda, file local.settings.json berisi opsi konfigurasi global yang memengaruhi semua alur kerja di aplikasi logika tersebut saat berjalan di lingkungan pengembangan lokal Anda. Saat alur kerja Anda berjalan secara lokal, pengaturan tersebut diakses sebagai variabel lingkungan lokal, dan nilainya sering kali dapat berubah antar berbagai lingkungan tempat Anda menjalankan alur kerja Anda. Untuk menampilkan dan mengelola pengaturan tersebut, ulas Mengelola pengaturan aplikasi - local.settings.json.

Pengaturan aplikasi di Azure Logic Apps bekerja mirip dengan pengaturan aplikasi di Azure Functions atau Azure Web Apps. Jika Anda pernah menggunakan layanan lain tersebut sebelumnya, Anda mungkin sudah terbiasa dengan pengaturan aplikasi. Untuk informasi selengkapnya, ulas Referensi pengaturan aplikasi untuk Azure Functions dan Bekerja dengan Azure Functions Core Tools - File pengaturan lokal.

Agar alur kerja Anda berjalan dengan benar, beberapa pengaturan aplikasi diperlukan.

Mengelola pengaturan aplikasi - local.settings.json

Untuk menambahkan, memperbarui, atau menghapus pengaturan aplikasi, pilih dan tinjau bagian berikut untuk templat portal Azure, Visual Studio Code, Azure CLI, atau ARM (Bicep). Untuk pengaturan aplikasi khusus untuk aplikasi logika, ulas panduan referensi untuk pengaturan aplikasi yang tersedia - local.settings.json.

az logicapp config appsettings list --name MyLogicApp --resource-group MyResourceGroup

az logicapp config appsettings set --name MyLogicApp --resource-group MyResourceGroup --settings CUSTOM_LOGIC_APP_SETTING=12345 

Referensi untuk pengaturan host - host.json

Di Visual Studio Code, di tingkat akar proyek aplikasi logika Anda, file metadata host.json berisi pengaturan runtime bahasa umum dan nilai default yang berlaku untuk semua alur kerja dalam sumber daya aplikasi logika baik yang berjalan secara lokal maupun di Azure. Untuk menampilkan dan mengelola pengaturan tersebut, ulas Mengelola pengaturan host - host.json. Anda juga dapat menemukan informasi batas terkait di dokumentasi Batas dan konfigurasi untuk Azure Logic Apps.

Throughput orkestrasi pekerjaan

Pengaturan ini memengaruhi throughput dan kapasitas untuk Azure Logic Apps penyewa tunggal untuk menjalankan operasi alur kerja.

Kedua pengaturan berikut digunakan untuk menghentikan dan segera menghapus alur kerja yang ditentukan secara manual di aplikasi logika Standar.

Contoh berikut menunjukkan sintaks untuk pengaturan ini di mana setiap ID alur kerja diikuti oleh titik dua (:) dan dipisahkan oleh titik koma (;):

"Jobs.CleanupJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:",
"Jobs.SuspendedJobPartitionPrefixes": "<workflow-ID-1>:; <workflow-ID-2>:"

Pemicu berbasis pengulangan

Memicu konkurensi

Pengaturan berikut hanya berfungsi untuk alur kerja yang dimulai dengan pemicu berbasis pengulangan untuk konektor berbasis penyedia layanan bawaan. Untuk alur kerja yang dimulai dengan pemicu berbasis fungsi, Anda mungkin mencoba menyiapkan batching jika didukung. Namun, batching tidak selalu menjadi solusi yang benar. Misalnya, dengan pemicu Azure Bus Layanan, batch mungkin menyimpan pesan di luar durasi kunci. Akibatnya, tindakan apa pun, seperti selesai atau abaikan, gagal pada pesan tersebut.

Jalankan retensi durasi dan riwayat

Menjalankan tindakan

Input dan output

Penentuan halaman

Chunking

Menyimpan konten sebaris atau menggunakan blob

Perulangan For each

Perulangan Until

Variabel

Operasi HTTP bawaan

Operasi Http Webhook bawaan

Operasi Azure Storage bawaan

Penyimpanan Blob

Penyimpanan antrean dan tabel

Berbagi file

Operasi Azure Functions bawaan

Operasi Azure Service Bus bawaan

Operasi SFTP bawaan

Operasi konektor terkelola

Kebijakan percobaan kembali untuk semua operasi lainnya

Batasan

• Ukuran konten maksimum

  Secara default, pemicu bawaan, seperti HTTP atau Permintaan, terbatas pada ukuran pesan yang dijelaskan dalam Batas dan referensi konfigurasi - Pesan. Untuk menangani file yang lebih besar dari batas, coba unggah konten Anda sebagai blob ke Azure Blob Storage, lalu dapatkan konten Anda menggunakan konektor Azure Blob.

Mengelola pengaturan host - host.json

Anda dapat menambahkan, memperbarui, atau menghapus pengaturan host, yang menentukan setelan konfigurasi runtime bahasa umum dan nilai yang berlaku untuk semua alur kerja di aplikasi logika tersebut, seperti nilai default untuk throughput, kapasitas, ukuran data, dan sebagainya, apakah dijalankan secara lokal atau di Azure. Untuk pengaturan host khusus untuk aplikasi logika, ulas panduan referensi untuk pengaturan runtime bahasa umum dan penyebaran yang tersedia - host.json.

Portal Azure - host.json

Untuk mengulas pengaturan host untuk aplikasi logika berbasis penyewa tunggal Anda di portal Azure, ikuti langkah-langkah berikut:

1. Di kotak pencarian portal Azure, temukan dan buka aplikasi logika Anda.

2. Pada menu sumber daya, di bawah Alat Pengembangan, pilih Alat Tingkat Lanjut.

3. Di panel Alat Tingkat Lanjut, pilih Buka, yang membuka lingkungan Kudu untuk aplikasi logika.

4. Di toolbar Kudu, buka menu Konsol debug, dan pilih CMD.

   Jendela konsol terbuka sehingga Anda dapat menelusuri ke folder wwwroot menggunakan perintah. Atau, Anda dapat menelusuri struktur direktori yang muncul di atas jendela konsol.

5. Telusuri di sepanjang jalur berikut ke folder wwwroot: ...\home\site\wwwroot.

6. Di atas jendela konsol, di tabel direktori, di samping file host.json, pilih Edit.

7. Setelah file host.json terbuka, ulas semua pengaturan host yang sebelumnya ditambahkan untuk aplikasi logika Anda.

   Untuk informasi selengkapnya tentang pengaturan host, ulas panduan referensi untuk pengaturan host yang tersedia - host.json.

Untuk menambahkan pengaturan, ikuti langkah-langkah berikut:

1. Sebelum Anda menambahkan atau mengedit pengaturan, hentikan aplikasi logika Anda di portal Azure.

   1. Di menu sumber daya, pilih Gambaran Umum.

   2. Di toolbar panel Gambaran Umum, pilih Hentikan.

2. Jika file host.json sudah terbuka, kembali ke file host.json. Jika tidak, ikuti langkah-langkah sebelumnya untuk membuka file host.json .

3. Di bawah objek extensionBundle, tambahkan objek extensions, yang menyertakan objek workflow dan settings, misalnya:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

4. Dalam objek settings, tambahkan daftar rata dengan pengaturan host yang ingin Anda gunakan untuk semua alur kerja di aplikasi logika Anda, baik alur kerja tersebut berjalan secara lokal maupun di Azure, misalnya:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

5. Setelah selesai, ingatlah untuk memilih Simpan.

6. Sekarang, hidupkan ulang aplikasi logika Anda. Kembali ke halaman Gambaran Umum, dan pilih Hidupkan Ulang.

Visual Studio Code - host.json

Untuk mengulas pengaturan host untuk aplikasi logika Anda di Visual Studio Code, ikuti langkah-langkah berikut:

1. Di proyek aplikasi logika Anda, di tingkat proyek akar, temukan dan buka file host.json.

2. Di objek extensions, di bawah workflows dan settings, ulas semua pengaturan host yang sebelumnya ditambahkan untuk aplikasi logika Anda. Jika tidak, objek extensions tidak akan muncul dalam file.

   Untuk informasi selengkapnya tentang pengaturan host, ulas panduan referensi untuk pengaturan host yang tersedia - host.json.

Untuk menambahkan pengaturan host, ikuti langkah-langkah berikut:

1. Di file host.json, di bawah objek extensionBundle, tambahkan objek extensions, yang menyertakan objek workflow dan settings, misalnya:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
            }
         }
      }
   }
   

2. Dalam objek settings, tambahkan daftar rata dengan pengaturan host yang ingin Anda gunakan untuk semua alur kerja di aplikasi logika Anda, baik alur kerja tersebut berjalan secara lokal maupun di Azure, misalnya:

   {
      "version": "2.0",
      "extensionBundle": {
         "id": "Microsoft.Azure.Functions.ExtensionBundle",
         "version": "[1.*, 2.0.0)"
      },
      "extensions": {
         "workflow": {
            "settings": {
               "Runtime.Trigger.MaximumWaitingRuns": "100"
            }
         }
      }
   }
   

Langkah berikutnya

• Membuat parameter untuk nilai yang berubah dalam alur kerja antar lingkungan untuk Azure Logic Apps penyewa tunggal
• Menyiapkan penyebaran Azure DevOps untuk Azure Logic Apps penyewa tunggal