Bagikan melalui

Mulai cepat: Membuat aplikasi PowerShell Durable Functions

Gunakan Durable Functions, fitur Azure Functions, untuk menulis fungsi stateful di lingkungan tanpa server. Anda menginstal Durable Functions dengan menginstal ekstensi Azure Functions di Visual Studio Code. Ekstensi mengelola status, titik pemeriksaan, dan memulai ulang di aplikasi Anda.

Dalam mulai cepat ini, Anda menggunakan ekstensi Durable Functions di Visual Studio Code untuk membuat dan menguji aplikasi Durable Functions "halo dunia" secara lokal di Azure Functions. Aplikasi Durable Functions mengatur dan menyatukan panggilan ke fungsi lain. Kemudian, Anda menerbitkan kode fungsi ke Azure. Alat yang Anda gunakan tersedia melalui ekstensi Visual Studio Code.

Menjalankan aplikasi Durable Functions di Azure.

Prasyarat

Untuk menyelesaikan mulai cepat ini, Anda memerlukan:

Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

Membuat proyek lokal Anda

Di bagian ini, gunakan Visual Studio Code untuk membuat proyek Azure Functions lokal.

  1. Di Visual Studio Code, pilih F1 (atau pilih Ctrl/Cmd+Shift+P) untuk membuka palet perintah. Pada perintah (>), masukkan lalu pilih Azure Functions: Buat Proyek Baru.

    Cuplikan layar yang memperlihatkan perintah Buat fungsi.

  2. Pilih Telusur. Dalam dialog Pilih Folder, buka folder yang akan digunakan untuk proyek Anda, lalu pilih Pilih.

  3. Pada perintah, berikan informasi berikut:

    Cepat Tindakan Deskripsi
    Pilih bahasa untuk proyek aplikasi fungsi Anda Pilih PowerShell. Membuat proyek PowerShell Functions lokal.
    Pilih versi Pilih Azure Functions v4. Anda hanya melihat opsi ini saat Core Tools belum diinstal. Dalam hal ini, Core Tools diinstal saat pertama kali Anda menjalankan aplikasi.
    Pilih templat untuk fungsi pertama proyek Anda Pilih Lewati untuk saat ini.
    Pilih bagaimana Anda ingin membuka proyek Anda Pilih Buka di jendela saat ini. Membuka Visual Studio Code di folder yang Anda pilih.

Visual Studio Code menginstal Azure Functions Core Tools jika diperlukan untuk membuat proyek. Selain itu membuat proyek aplikasi fungsi dalam folder. Proyek ini berisi file konfigurasihost.jsondanlocal.settings.json.

File package.json juga dibuat di folder akar.

Konfigurasikan aplikasi fungsi untuk menggunakan PowerShell 7.4 dan Durable Functions SDK mandiri.

Buka file local.settings.json dan konfirmasikan bahwa pengaturan bernama FUNCTIONS_WORKER_RUNTIME_VERSION diatur ke 7.4 dan pengaturan bernama ExternalDurablePowerShellSDK diatur ke true. Jika hilang atau jika diatur ke nilai lain, perbarui konten file.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "7.4",
    "ExternalDurablePowerShellSDK": "true"
  }
}

Selanjutnya, tentukan entri untuk DF SDK dalam file Anda requirements.psd1 , seperti pada contoh di bawah ini:

# This file enables modules to be automatically managed by the Functions service.
# See https://aka.ms/functionsmanageddependency for additional information.
#
@{
    # For latest supported version, go to 'https://www.powershellgallery.com/packages/AzureFunctions.PowerShell.Durable.SDK/'.
    'AzureFunctions.PowerShell.Durable.SDK' = '2.*'
}

Pastikan Anda menggunakan versi terbaru modul AzureFunctions.PowerShell.Durable.SDK . Penentu 2.* versi memastikan Anda mendapatkan versi 2.x stabil terbaru.

Tambahkan baris berikut ke file Anda profile.ps1 (biasanya, di akhir file):

Import-Module AzureFunctions.PowerShell.Durable.SDK -ErrorAction Stop

Membuat fungsi Anda

Aplikasi Durable Functions paling dasar memiliki tiga fungsi:

  • Fungsi orkestrator: Alur kerja yang mengatur fungsi lain.
  • Fungsi aktivitas: Fungsi yang dipanggil oleh fungsi orkestrator, melakukan pekerjaan, dan secara opsional mengembalikan nilai.
  • Fungsi klien: Fungsi reguler di Azure yang memulai fungsi orkestrator. Contoh ini menggunakan fungsi yang dipicu HTTP.

Fungsi orkestrator

Gunakan templat untuk membuat kode aplikasi Durable Functions di proyek Anda.

  1. Di palet perintah, masukkan lalu pilih Azure Functions: Buat Fungsi.

  2. Pada perintah, berikan informasi berikut:

    Cepat Tindakan Deskripsi
    Pilih templat untuk fungsi Anda Masukkan orkestrator Durable Functions. Membuat orkestrasi aplikasi Durable Functions.
    Berikan nama fungsi Masukkan HelloOrchestrator. Nama untuk fungsi tahan lama Anda.

Anda menambahkan orkestrator untuk mengoordinasikan fungsi aktivitas. Buka HelloOrchestrator/run.ps1 untuk melihat fungsi orkestrator. Setiap panggilan ke cmdlet Invoke-ActivityFunction memanggil fungsi aktivitas bernama Hello.

Selanjutnya, Anda menambahkan fungsi aktivitas yang dirujuk Hello .

Fungsi aktivitas

  1. Di palet perintah, masukkan lalu pilih Azure Functions: Buat Fungsi.

  2. Pada perintah, berikan informasi berikut:

    Cepat Tindakan Deskripsi
    Pilih templat untuk fungsi Anda Pilih aktivitas Durable Functions. Membuat fungsi aktivitas.
    Berikan nama fungsi Masukkan Halo. Nama fungsi aktivitas Anda.

Anda menambahkan Hello fungsi aktivitas yang dipanggil oleh orkestrator. Buka Hello/run.ps1 untuk melihat bahwa itu mengambil nama sebagai input dan mengembalikan salam. Fungsi aktivitas adalah tempat Anda melakukan tindakan seperti melakukan panggilan database atau melakukan komputasi.

Terakhir, Anda menambahkan fungsi yang dipicu HTTP yang memulai orkestrasi.

Fungsi klien (starter HTTP)

  1. Di palet perintah, masukkan lalu pilih Azure Functions: Buat Fungsi.

  2. Pada perintah, berikan informasi berikut:

    Cepat Tindakan Deskripsi
    Pilih templat untuk fungsi Anda Pilih starter HTTP Durable Functions. Membuat fungsi starter HTTP.
    Berikan nama fungsi Masukkan HttpStart. Nama fungsi aktivitas Anda.
    Tingkat otorisasi Pilih Anonim. Untuk tujuan demo, nilai ini memungkinkan fungsi dipanggil tanpa menggunakan autentikasi.

Anda menambahkan fungsi yang dipicu HTTP yang memulai orkestrasi. Buka HttpStart/run.ps1 untuk memeriksa apakah menggunakan cmdlet Start-NewOrchestration untuk memulai orkestrasi baru. Kemudian menggunakan cmdlet New-OrchestrationCheckStatusResponse untuk mengembalikan respons HTTP yang berisi URL yang dapat digunakan untuk memantau dan mengelola orkestrasi baru.

Anda sekarang memiliki aplikasi Durable Functions yang dapat Anda jalankan secara lokal dan menyebarkan ke Azure.

Petunjuk / Saran

Panduan memulai cepat ini menggunakan SDK PowerShell Durable Functions mandiri, yang sudah tersedia umum dan menyediakan kinerja terbaik serta fitur terbaru. Untuk informasi selengkapnya tentang SDK dan migrasi dari versi bawaan warisan, lihat panduan PowerShell SDK mandiri.

Uji fungsi secara lokal

Azure Functions Core Tools memberi Anda kemampuan untuk menjalankan proyek Azure Functions di komputer pengembangan lokal Anda. Anda diminta untuk menginstal alat-alat ini saat pertama kali memulai fungsi di Visual Studio.

  1. Untuk menguji fungsi Anda, atur titik henti dalam Hello kode fungsi aktivitas (di Hello/run.ps1). Pilih F5 atau pilih Debug: Mulai Debugging di palet perintah untuk memulai proyek aplikasi fungsi. Output dari Core Tools muncul di panel terminal.

    Catatan

    Untuk informasi selengkapnya tentang penelusuran kesalahan, lihat Diagnostik Durable Functions.

  2. Durable Functions memerlukan akun penyimpanan Azure untuk dijalankan. Saat Visual Studio Code meminta Anda untuk memilih akun penyimpanan, pilih Pilih akun penyimpanan.

    Cuplikan layar yang memperlihatkan perintah Buat akun penyimpanan.

  3. Pada perintah, berikan informasi berikut untuk membuat akun penyimpanan baru di Azure.

    Cepat Tindakan Deskripsi
    Pilih langganan Pilih nama langganan Anda. Langganan Azure Anda.
    Pilih akun penyimpanan Pilih Buat akun penyimpanan baru.
    Masukkan nama akun penyimpanan baru Masukkan nama yang unik. Nama akun penyimpanan yang akan dibuat.
    Pilih grup sumber daya Masukkan nama yang unik. Nama grup sumber daya yang akan dibuat.
    Pilih lokasi Pilih wilayah Azure. Pilih wilayah yang dekat dengan Anda.

  4. Di panel terminal, salin titik akhir URL fungsi yang dipicu HTTP Anda.

    Cuplikan layar output lokal Azure.

  5. Gunakan browser Anda atau alat uji HTTP untuk mengirim permintaan HTTP POST ke titik akhir URL.

    Ganti segmen terakhir dengan nama fungsi orkestrator (HelloOrchestrator). URL-nya harus sama dengan http://localhost:7071/api/orchestrators/HelloOrchestrator.

    Responsnya adalah hasil awal fungsi HTTP. Ini memungkinkan Anda tahu bahwa orkestrasi tahan lama berhasil dimulai. Ini belum menampilkan hasil akhir orkestrasi. Respons mencakup beberapa URL yang berguna. Untuk saat ini, kueri status orkestrasi.

  6. Salin nilai URL untuk statusQueryGetUri, tempelkan di bilah alamat browser, dan jalankan permintaan. Anda juga dapat terus menggunakan alat uji HTTP Anda untuk mengeluarkan permintaan GET.

    Permintaan meminta instans orkestrasi untuk status tersebut. Anda harus mendapatkan respons akhir, yang menunjukkan instans selesai dan menyertakan output atau hasil fungsi tahan lama. Sepertinya contoh ini:

    {
    "name": "HelloOrchestrator",
    "instanceId": "9a528a9e926f4b46b7d3deaa134b7e8a",
    "runtimeStatus": "Completed",
    "input": null,
    "customStatus": null,
    "output": [
        "Hello Tokyo!",
        "Hello Seattle!",
        "Hello London!"
    ],
    "createdTime": "2020-03-18T21:54:49Z",
    "lastUpdatedTime": "2020-03-18T21:54:54Z"
}

  7. Untuk menghentikan penelusuran kesalahan, di Visual Studio Code, pilih Shift+F5.

Setelah Anda memverifikasi bahwa fungsi berjalan dengan benar di komputer lokal Anda, saatnya untuk menerbitkan proyek ke Azure.

Masuk ke Azure

Sebelum dapat membuat sumber daya Azure atau menerbitkan aplikasi, Anda harus masuk ke Azure.

  1. Jika Anda belum masuk, di bilah Aktivitas, pilih ikon Azure. Lalu di bawah Sumber Daya, pilih Masuk ke Azure.

    Cuplikan layar jendela masuk ke Azure di Visual Studio Code.

    Jika sudah masuk dan dapat melihat langganan Anda yang ada, buka bagian berikutnya. Jika Anda belum memiliki akun Azure, pilih Buat Akun Azure. Siswa dapat memilih Buat Akun Azure for Students.

  2. Saat Diminta di browser, pilih akun Azure Anda dan masuk dengan menggunakan kredensial akun Azure Anda. Jika membuat akun baru, Anda dapat masuk setelah akun berhasil dibuat.

  3. Setelah berhasil masuk, Anda dapat menutup jendela browser baru. Langganan milik akun Azure Anda ditampilkan di bilah samping.

Membuat aplikasi fungsi di Azure

Di bagian ini, Anda membuat aplikasi fungsi dalam paket Konsumsi Flex bersama dengan sumber daya terkait di langganan Azure Anda. Banyak keputusan pembuatan sumber daya dibuat untuk Anda berdasarkan perilaku default. Untuk kontrol lebih lanjut atas sumber daya yang dibuat, Anda harus membuat aplikasi fungsi dengan opsi tingkat lanjut.

  1. Di Visual Studio Code, pilih F1 untuk membuka palet perintah. Pada perintah (>), masukkan lalu pilih Azure Functions: Buat Aplikasi Fungsi di Azure.

  2. Pada perintah, berikan informasi berikut:

    Cepat Tindakan
    Pilih langganan Pilih langganan Azure yang akan digunakan. Perintah tidak muncul saat Anda hanya memiliki satu langganan yang terlihat di bawah Sumber Daya.
    Masukkan nama aplikasi fungsi baru Masukkan nama unik global yang valid di jalur URL. Nama yang Anda masukkan divalidasi untuk memastikan bahwa nama tersebut unik di Azure Functions.
    Pilih lokasi untuk sumber daya baru Pilih wilayah Azure. Untuk performa yang lebih baik, pilih wilayah di dekat Anda. Hanya wilayah yang didukung oleh paket Konsumsi Flex yang ditampilkan.
    Pilih tumpukan runtime Pilih versi bahasa yang saat ini Anda jalankan secara lokal.
    Pilih jenis autentikasi sumber daya Pilih Identitas terkelola, yang merupakan opsi paling aman untuk menyambungkan ke akun penyimpanan host default.

    Di panel Azure: Log Aktivitas, ekstensi Azure memperlihatkan status sumber daya individual saat dibuat di Azure.

    Cuplikan layar yang memperlihatkan log pembuatan sumber daya Azure.

  3. Saat aplikasi fungsi dibuat, sumber daya terkait berikut dibuat di langganan Azure Anda. Sumber daya dinamai berdasarkan nama yang Anda masukkan untuk aplikasi fungsi Anda.

    • Grup sumber daya, yang merupakan kontainer logis untuk sumber daya terkait.
    • Aplikasi fungsi, menyediakan lingkungan untuk menjalankan kode fungsi Anda. Aplikasi fungsi memungkinkan Anda mengelompokkan fungsi sebagai unit logis untuk memudahkan pengelolaan, penerapan, dan berbagi sumber daya dalam paket hosting yang sama.
    • Paket Azure App Service, yang menentukan host yang mendasar untuk aplikasi fungsi Anda.
    • Akun Azure Storage standar, yang digunakan oleh host Functions untuk mempertahankan status dan informasi lain tentang aplikasi fungsi Anda.
    • Instans Application Insights yang terhubung ke aplikasi fungsi, dan yang melacak penggunaan fungsi Anda di aplikasi.
    • Identitas terkelola yang ditetapkan oleh pengguna yang ditambahkan ke peran Kontributor Data Blob Penyimpanan di akun penyimpanan host default yang baru.

    Notifikasi ditampilkan setelah aplikasi fungsi Anda dibuat dan paket penyebaran diterapkan.

    Petunjuk / Saran

    Secara default, sumber daya Azure yang diperlukan oleh aplikasi fungsi Anda dibuat berdasarkan nama yang Anda masukkan untuk aplikasi fungsi Anda. Secara default, sumber daya dibuat dengan aplikasi fungsi dalam grup sumber daya baru yang sama. Jika Anda ingin menyesuaikan nama sumber daya terkait atau menggunakan kembali sumber daya yang ada, terbitkan proyek dengan opsi buat tingkat lanjut.

Menyebarkan proyek ke Azure

Penting

Penyebaran ke aplikasi fungsi yang ada selalu menimpa konten aplikasi tersebut di Azure.

  1. Di palet perintah, masukkan lalu pilih Azure Functions: Sebarkan ke Aplikasi Fungsi.

  2. Pilih aplikasi fungsi yang baru saja Anda buat. Saat diminta untuk menimpa penyebaran sebelumnya, pilih Sebarkan untuk menyebarkan kode fungsi Anda ke sumber daya aplikasi fungsi baru.

  3. Saat penyebaran selesai, pilih Tampilkan Output untuk melihat hasil pembuatan dan penyebaran, termasuk sumber daya Azure yang Anda buat. Jika Anda melewatkan pemberitahuan, pilih ikon bel di sudut kanan bawah untuk melihatnya lagi.

    Cuplikan layar jendela Tampilan Output.

Uji fungsi Anda di Azure

  1. Pastikan pengaturan aplikasi bernama ExternalDurablePowerShellSDK diatur ke true.

  2. Salin URL pemicu HTTP dari panel output. URL yang memanggil fungsi yang dipicu HTTP Anda harus dalam format ini:

    https://<functionappname>.azurewebsites.net/api/orchestrators/HelloOrchestrator

  3. Tempelkan URL baru untuk permintaan HTTP di bilah alamat browser Anda. Saat menggunakan aplikasi yang diterbitkan, Anda dapat mengharapkan untuk mendapatkan respons status yang sama dengan yang Anda dapatkan saat diuji secara lokal.

Aplikasi PowerShell Durable Functions yang Anda buat dan terbitkan dengan menggunakan Visual Studio Code siap digunakan.

Membersihkan sumber daya

Jika Anda tidak lagi memerlukan sumber daya yang Anda buat untuk menyelesaikan mulai cepat, untuk menghindari biaya terkait di langganan Azure Anda, hapus grup sumber daya dan semua sumber daya terkait.

Konten terkait

  • Last updated on