Mengembangkan Azure Functions menggunakan Visual Studio Code

Ekstensi Azure Functions untuk Visual Studio Code memungkinkan Anda mengembangkan fungsi secara lokal dan menyebarkannya ke Azure. Jika ini adalah pengalaman pertama Anda dengan Azure Functions, Anda dapat mempelajari selengkapnya di Pengantar Azure Functions.

Ekstensi Azure Functions memberikan keuntungan ini:

  • Edit, bangun, dan jalankan fungsi di komputer pengembangan lokal Anda.
  • Terbitkan proyek Azure Functions Anda langsung ke Azure.
  • Tulis fungsi Anda dalam berbagai bahasa sambil memanfaatkan keuntungan Visual Studio Code.

Ekstensi ini dapat digunakan dengan bahasa berikut, yang didukung oleh runtime Azure Functions yang dimulai dengan versi 2.x:

*Mengharuskan Anda menetapkan skrip C# sebagai bahasa proyek default Anda.

Dalam artikel ini, contoh saat ini hanya tersedia untuk fungsi pustaka kelas JavaScript (Node.js) dan C#.

Artikel ini menyediakan detail tentang cara menggunakan ekstensi Azure Functions untuk mengembangkan fungsi dan menerbitkannya ke Azure. Sebelum membaca artikel ini, Anda harus membuat fungsi pertama anda dengan menggunakan Visual Studio Code.

Penting

Jangan mencampur pengembangan lokal dan pengembangan portal untuk satu aplikasi fungsi. Saat Anda menerbitkan dari proyek lokal ke aplikasi fungsi, proses penyebaran akan menimpa fungsi apa pun yang Anda kembangkan di portal.

Prasyarat

Jalankan persyaratan lokal

Prasyarat ini hanya diperlukan untuk menjalankan dan menelusuri kesalahan fungsi Anda secara lokal. Mereka tidak diharuskan untuk membuat atau menerbitkan proyek ke Azure Functions.

  • Azure Functions Core Tools versi 2.x atau yang lebih baru. Paket Core Tools diunduh dan dipasang secara otomatis saat Anda memulai proyek secara lokal. Core Tools mencakup seluruh runtime Azure Functions, sehingga pengunduhan dan penginstalan mungkin memakan waktu.

  • Ekstensi C# untuk Visual Studio Code.

  • Alat .NET Core CLI.

Membuat proyek Azure Functions

Ekstensi Functions memungkinkan Anda membuat proyek aplikasi fungsi, bersama dengan fungsi pertama Anda. Langkah-langkah berikut menunjukkan cara membuat fungsi yang dipicu HTTP dalam proyek Functions baru. Pemicu HTTP adalah templat pemicu fungsi paling sederhana untuk ditunjukkan.

    1. Pilih ikon Azure di bilah Aktivitas, lalu di area Ruang Kerja (lokal), pilih tombol +, pilih Buat Fungsi di dropdown. Saat diminta, pilih Buat proyek baru.

    Screenshot of create a new project window.

  1. Pilih lokasi direktori untuk ruang kerja proyek Anda dan pilih Pilih. Anda harus membuat folder baru atau memilih folder kosong untuk ruang kerja proyek. Jangan memilih folder proyek yang sudah menjadi bagian dari ruang kerja.

  2. Saat diminta, Pilih bahasa untuk proyek Anda, dan jika perlu pilih versi bahasa tertentu.

  3. Pilih templat fungsi pemicu HTTP, atau Anda dapat memilih Lewati untuk saat ini untuk membuat proyek tanpa fungsi. Anda selalu bisa menambahkan fungsi ke proyek Anda nanti.

    Screenshot for selecting H T T P trigger.

  4. Ketik HttpExample untuk nama fungsi dan pilih Masukkan, lalu pilih otorisasi Fungsi. Tingkat otorisasi ini mengharuskan Anda untuk menyediakan tombol fungsi ketika Anda memanggil titik akhir fungsi.

    Screenshot for creating function authorization.

  5. Dari daftar dropdown, pilih Tambahkan ke tempat kerja.

     Screenshot for selectIng Add to workplace.

  6. Di jendela Apakah Anda memercayai pembuat file dalam folder ini?, pilih Ya.

    Screenshot to confirm trust in authors of the files.

  7. Fungsi dibuat dalam bahasa yang Anda pilih dan dalam templat untuk fungsi yang dipicu HTTP.

    Screenshot for H T T P-triggered function template in Visual Studio Code.

File proyek yang dihasilkan

Templat proyek membuat proyek dalam bahasa yang Anda pilih dan memasang dependensi yang diperlukan. Untuk bahasa apa pun, proyek baru memiliki file-file ini:

  • host.json: Memungkinkan Anda mengonfigurasi host Functions. Pengaturan ini berlaku saat Anda menjalankan fungsi secara lokal dan saat Anda menjalankannya di Azure. Untuk informasi selengkapnya, lihat referensi host.json.

  • local.settings.json: Mempertahankan pengaturan yang digunakan saat Anda menjalankan fungsi secara lokal. Pengaturan ini hanya digunakan saat Anda menjalankan fungsi secara lokal. Untuk informasi selengkapnya, lihat File pengaturan lokal.

    Penting

    Karena file local.settings.json dapat berisi rahasia, Anda perlu mengecualikannya dari kontrol sumber proyek Anda.

Bergantung pada bahasa Anda, file lain ini dibuat:

Pada titik ini, Anda dapat menambahkan pengikatan input dan output ke fungsi Anda. Anda juga dapat menambahkan fungsi baru ke proyek Anda.

Pasang ekstensi pengikatan

Kecuali untuk pemicu HTTP dan timer, pengikatan diimplementasikan dalam paket ekstensi. Anda harus memasang paket ekstensi untuk pemicu dan pengikatan yang membutuhkannya. Proses pemasangan ekstensi pengikatan tergantung pada bahasa proyek Anda.

Jalankan perintah paket penambahan dotnet di jendela Terminal untuk memasang paket ekstensi yang Anda butuhkan dalam proyek Anda. Contoh berikut menunjukkan cara Anda menambahkan pengikatan untuk pustaka kelas dalam proses:

dotnet add package Microsoft.Azure.WebJobs.Extensions.<BINDING_TYPE_NAME> --version <TARGET_VERSION>

Contoh berikut menunjukkan cara Anda menambahkan pengikatan untuk pustaka kelas proses terisolasi:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.<BINDING_TYPE_NAME> --version <TARGET_VERSION>

Di kasus lainnya, ganti <BINDING_TYPE_NAME> dengan nama paket yang berisi pengikatan yang Anda butuhkan. Anda dapat menemukan artikel referensi pengikatan yang diinginkan dalam daftar pengikatan yang didukung.

Ganti <TARGET_VERSION> dalam contoh dengan versi paket tertentu, seperti 3.0.0-beta5. Versi yang valid tercantum pada halaman paket individu di NuGet.org. Versi utama yang sesuai dengan Functions runtime 1.x atau 2.x ditentukan dalam artikel referensi untuk pengikatan.

Menambahkan fungsi ke proyek Anda

Anda dapat menambahkan fungsi baru ke proyek yang sudah ada dengan menggunakan salah satu templat pemicu Fungsi yang telah ditentukan sebelumnya. Untuk menambahkan pemicu fungsi baru, pilih F1 untuk membuka palet perintah, lalu cari dan jalankan perintah Azure Functions: Buat Fungsi. Ikuti perintah untuk memilih jenis pemicu Anda dan tentukan atribut pemicu yang diperlukan. Jika pemicu Anda memerlukan kunci akses atau string koneksi untuk menyambungkan ke layanan, siapkan sebelum Anda membuat pemicu fungsi.

Hasil tindakan ini bergantung pada bahasa proyek Anda:

File pustaka kelas C# (.cs) baru ditambahkan ke proyek Anda.

Menyambungkan ke layanan

Anda dapat menyambungkan fungsi Anda ke layanan Azure lainnya dengan menambahkan pengikatan input dan output. Pengikatan menghubungkan fungsi Anda ke layanan lain tanpa Anda harus menulis kode koneksi. Proses untuk menambahkan pengikatan tergantung pada bahasa proyek Anda. Untuk mempelajari selengkapnya tentang pengikatan, lihat konsep pengikatan dan pemicu Azure Functions.

Contoh berikut terhubung ke antrean penyimpanan bernama outqueue, dengan string koneksi untuk akun penyimpanan diatur dalam pengaturan aplikasi MyStorageConnection di local.settings.json.

Perbarui metode fungsi untuk menambahkan parameter berikut ke definisi metode Run:

[Queue("outqueue"),StorageAccount("AzureWebJobsStorage")] ICollector<string> msg,

Parameter msg adalah jenis ICollector<T>, yang mewakili koleksi pesan yang ditulis ke pengikatan output saat fungsi selesai. Kode berikut menambahkan pesan ke koleksi:

// Add a message to the output collection.
msg.Add(name);

Pesan dikirim ke antrean ketika fungsi selesai.

Untuk mempelajari lebih lanjut, lihat dokumentasi Artikel referensi pengikatan output penyimpanan antrean. Untuk mempelajari selengkapnya secara umum tentang pengikatan mana yang bisa ditambahkan ke fungsi, lihat Menambahkan pengikatan ke fungsi yang sudah ada di Azure Functions.

Masuk ke Azure

Sebelum dapat memublikasikan aplikasi, Anda harus masuk ke Azure.

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

    Screenshot of the sign-in to Azure window within VS Code.

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

  2. Saat diminta di browser, pilih akun Azure Anda dan masuk 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 sisi.

Buat Sumber Daya Azure

Sebelum dapat menerbitkan proyek Functions ke Azure, Anda harus memiliki aplikasi fungsi dan sumber daya terkait di langganan Azure Anda untuk menjalankan kode. Aplikasi fungsi menyediakan konteks eksekusi untuk fungsi Anda. Saat Anda menerbitkan ke aplikasi fungsi di Azure dari Visual Studio Code, proyek dipaketkan dan disebarkan ke aplikasi fungsi yang dipilih di langganan Azure Anda.

Saat membuat aplikasi fungsi di Azure, Anda dapat memilih jalur pembuatan aplikasi fungsi cepat menggunakan default atau jalur lanjutan. Dengan cara ini Anda akan memiliki kontrol lebih besar atas sumber daya jarak jauh yang dibuat.

Pembuatan aplikasi fungsi cepat

Di bagian ini, Anda membuat aplikasi fungsi dan sumber daya terkait di langganan Azure Anda.

  1. Pilih ikon Azure di bilah Aktivitas. Lalu di area Sumber Daya, pilih ikon + dan pilih opsi Buat Aplikasi Fungsi di Azure.

    Create a resource in your Azure subscription

  2. Berikan informasi berikut saat diminta:

    Perintah Pilihan
    Pilih langganan Pilih langganan yang akan digunakan. Anda tidak akan melihat permintaan ini jika hanya memiliki satu langganan yang terlihat di bawah Sumber Daya.
    Masukkan nama unik global untuk aplikasi fungsi Ketik nama yang valid di jalur URL. Nama yang Anda ketik akan divalidasi untuk memastikan bahwa nama tersebut unik di Azure Functions.
    Pilih tumpukan runtime Pilih versi bahasa pemrogram yang telah Anda jalankan secara lokal.
    Pilih lokasi untuk sumber daya baru Pilih wilayah yang lebih dekat dengan Anda untuk kinerja yang lebih baik.

    Ekstensi ini menampilkan status sumber daya individual saat dibuat di Azure pada panel Azure: Log Aktivitas.

    Log of Azure resource creation

  3. Setelah pembuatan selesai, sumber daya Azure berikut dibuat di langganan Anda. Sumber daya dinamai berdasarkan nama aplikasi fungsi Anda:

    • Grup sumber daya, merupakan kontainer logis untuk sumber daya terkait.
    • Akun Azure Storage standar, memelihara status dan informasi lain tentang proyek Anda.
    • Aplikasi fungsi, yang 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 App Service, menentukan host yang mendasari aplikasi fungsi Anda.
    • Instans Application Insights tersambung ke aplikasi fungsi, yang melacak penggunaan fungsi Anda di aplikasi.

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

    Tip

    Secara default, sumber daya Azure yang diperlukan oleh aplikasi fungsi Anda dibuat berdasarkan nama aplikasi fungsi yang Anda berikan. Secara default, sumber daya ini juga dibuat di grup sumber daya baru yang sama dengan aplikasi fungsi. Jika ingin menyesuaikan nama sumber daya ini atau menggunakan kembali sumber daya yang ada, Anda perlu menerbitkan proyek dengan opsi pembuatan lanjutan.

Menerbitkan proyek ke aplikasi fungsi baru di Azure dengan menggunakan opsi tingkat lanjut

Langkah-langkah berikut menerbitkan proyek Anda ke aplikasi fungsi baru yang dibuat dengan opsi pembuatan tingkat lanjut:

  1. Di palet perintah, masukkan Azure Functions: Buat aplikasi fungsi di Azure...(Tingkat Lanjut).

  2. Jika Anda tidak masuk, Anda akan diminta untuk Masuk ke Azure. Anda juga dapat Membuat akun Azure gratis. Setelah masuk dari browser, kembali ke Visual Studio Code.

  3. Mengikuti perintah, berikan informasi ini:

    Perintah Pilihan
    Masukkan nama yang unik secara global untuk aplikasi fungsi baru. Ketikkan nama unik secara global yang mengidentifikasi aplikasi fungsi baru Anda lalu pilih Masukkan. Karakter yang valid untuk nama aplikasi fungsi adalah a-z, 0-9, dan -.
    Pilih tumpukan runtime. Pilih versi bahasa pemrogram yang telah Anda jalankan secara lokal.
    Pilih OS. Pilih Linux atau Windows. Aplikasi Python harus dijalankan di Linux
    Pilih grup sumber daya untuk sumber daya baru. Pilih Buat grup sumber daya baru dan ketik nama grup sumber daya, sepertimyResourceGroup, lalu pilih masukkan. Anda juga dapat memilih grup sumber daya yang ada.
    Pilih lokasi untuk sumber daya baru. Pilih lokasi di wilayah di dekat Anda atau di dekat layanan lain yang diakses fungsi Anda.
    Pilih paket hosting. Pilih Konsumsi untuk hosting paket Konsumsi tanpa server, di mana Anda hanya dikenakan biaya saat fungsi berjalan.
    Pilih akun penyimpanan. Pilih Buat akun penyimpanan baru dan saat diminta, ketik nama unik secara global untuk akun penyimpanan baru yang digunakan oleh aplikasi fungsi Anda lalu pilih Masukkan. Nama akun penyimpanan harus sepanjang 3 dan 24 karakter dan hanya mengandung angka dan huruf kecil saja. Anda juga dapat memilih akun yang sudah ada.
    Pilih sumber daya Application Insights untuk aplikasi Anda. Pilih Buat sumber daya Application Insights baru dan saat diminta, ketik nama untuk instans yang digunakan untuk menyimpan data runtime dari fungsi Anda.

    Pemberitahuan muncul setelah aplikasi fungsi Anda dibuat dan paket penyebaran diterapkan. Pilih Tampilkan Output dalam pemberitahuan ini untuk melihat hasil pembuatan dan penyebaran, termasuk sumber daya Azure yang Anda buat.

Mendapatkan URL fungsi yang dipicu HTTP di Azure

Untuk memanggil fungsi yang dipicu HTTP dari klien, Anda memerlukan URL fungsi saat disebarkan ke aplikasi fungsi Anda. URL ini mencakup tombol fungsi yang diperlukan. Anda dapat menggunakan ekstensi untuk mendapatkan URL ini untuk fungsi Anda yang disebarkan. Jika Anda hanya ingin menjalankan fungsi jarak jauh di Azure, gunakan fungsi Jalankan sekarang fungsionalitas ekstensi.

  1. Pilih F1 untuk membuka palet perintah, lalu cari dan jalankan perintah Azure Functions: Salin URL Fungsi.

  2. Ikuti perintah untuk memilih aplikasi fungsi Anda di Azure lalu pemicu HTTP tertentu yang ingin Anda panggil.

URL fungsi disalin ke clipboard, bersama dengan kunci yang diperlukan yang diteruskan oleh parameter kueri code. Gunakan alat HTTP untuk mengirimkan permintaan POST, atau browser untuk permintaan GET ke fungsi jarak jauh.

Saat ekstensi mendapatkan URL fungsi di Azure, ekstensi menggunakan akun Azure Anda untuk secara otomatis mengambil kunci yang diperlukan untuk memulai fungsi. Pelajari selengkapnya tentang kunci akses fungsi. Memulai fungsi yang dipicu non-HTTP memerlukan penggunaan kunci admin.

Menyebarkan file proyek

Kami merekomendasikan pengaturan penyebaran berkelanjutan sehingga aplikasi fungsi Anda di Azure diperbarui saat Anda memperbarui file sumber di lokasi sumber tersambung. Anda juga dapat menyebarkan file proyek Anda dari Visual Studio Code.

Saat menerbitkan dari Visual Studio Code, Anda memanfaatkan teknologi penyebaran Zip.

Penting

Menyebarkan aplikasi fungsi yang ada selalu menimpa konten aplikasi di Azure.

  1. Pilih ikon Azure di bilah Aktivitas, lalu di area Ruang Kerja, pilih folder proyek Anda dan pilih tombol Sebarkan....

    Deploy project from the Visual Studio Code workspace

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

    Screenshot of the View Output window.

Jalankan fungsi

Ekstensi Azure Functions memungkinkan Anda menjalankan fungsi individual. Anda dapat menjalankan fungsi baik di proyek Anda di komputer pengembangan lokal atau di langganan Azure Anda.

Untuk fungsi pemicu HTTP, ekstensi memanggil titik akhir HTTP. Untuk jenis pemicu lainnya, ia memanggil API administrator untuk memulai fungsi. Badan pesan dari permintaan yang dikirim ke fungsi bergantung pada jenis pemicu. Saat pemicu memerlukan data pengujian, Anda akan diminta memasukkan data dalam format JSON tertentu.

Menjalankan fungsi di Azure.

Untuk menjalankan fungsi di Azure dari Visual Studio Code.

  1. Di palet perintah, masukkan Azure Functions: Jalankan fungsi sekarang dan pilih langganan Azure Anda.

  2. Pilih aplikasi fungsi Anda di Azure dari daftar. Jika Anda tidak melihat aplikasi fungsi Anda, pastikan Anda masuk ke langganan yang benar.

  3. Pilih fungsi yang ingin Anda jalankan dari daftar dan ketik badan pesan permintaan di Masukkan isi permintaan. Tekan Masukkan untuk mengirim pesan permintaan ini ke fungsi Anda. Teks default dalam Masukkan isi permintaan harus menunjukkan format isi. Jika aplikasi fungsi Anda tidak memiliki fungsi, kesalahan notifikasi akan ditampilkan dengan kesalahan ini.

  4. Saat fungsi dijalankan di Azure dan mengembalikan respons, pemberitahuan akan dimunculkan dalam Visual Studio Code.

Anda juga dapat menjalankan fungsi Anda dari Azure: area Functions dengan mengeklik kanan (Ctrl-mengeklik pada Mac) fungsi yang ingin Anda jalankan dari aplikasi fungsi Anda di langganan Azure Anda dan memilih Jalankan Fungsi Sekarang... .

Saat Anda menjalankan fungsi Anda di Azure dari Visual Studio Code, ekstensi menggunakan akun Azure Anda untuk secara otomatis mengambil kunci yang diperlukan untuk memulai fungsi. Pelajari selengkapnya tentang kunci akses fungsi. Memulai fungsi yang dipicu non-HTTP memerlukan penggunaan kunci admin.

Jalankan fungsi secara lokal

Runtime lokal adalah runtime yang sama yang memandu aplikasi fungsi Anda di Azure. Pengaturan lokal dibaca dari file local.settings.json. Untuk menjalankan proyek Functions Anda secara lokal, Anda harus memenuhi persyaratan lainnya.

Mengonfigurasi proyek untuk berjalan secara lokal

Runtime Functions menggunakan akun Azure Storage secara internal untuk semua jenis pemicu selain HTTP dan webhook. Jadi Anda perlu mengatur kunci Values.AzureWebJobsStorage ke string koneksi akun Penyimpanan Azure yang valid.

Bagian ini menggunakan ekstensi Azure Storage untuk Visual Studio Code dengan Azure Storage Explorer untuk menyambungkan dan mengambil string koneksi penyimpanan.

Untuk mengatur string koneksi akun penyimpanan:

  1. Di Visual Studio, buka Cloud Explorer, luaskan Akun Storage>Akun Storage Anda, lalu pilih Properti dan salin nilai String Koneksi Utama.

  2. Di proyek Anda, buka file local.settings.json dan atur nilai kunci AzureWebJobsStorage ke string koneksi yang Anda salin.

  3. Ulangi langkah sebelumnya untuk menambahkan kunci unik ke larik Nilai untuk koneksi lain yang diperlukan oleh fungsi Anda.

Untuk informasi selengkapnya, lihat File pengaturan lokal.

Menelusuri kesalahan fungsi secara lokal

Untuk menelusuri kesalahan fungsi Anda, pilih F5. Jika Anda belum mengunduh Core Tools, Anda akan diminta untuk melakukannya. Ketika Core Tools dipasang dan berjalan, output ditampilkan di Terminal. Langkah ini sama dengan menjalankan perintah func start Core Tools dari Terminal, tetapi dengan tugas build tambahan dan debugger terlampir.

Ketika proyek berjalan, Anda dapat menggunakan fitur Jalankan Fungsi Sekarang... dari ekstensi untuk memicu fungsi Anda seperti yang Anda lakukan ketika proyek disebarkan ke Azure. Dengan proyek yang berjalan dalam mode debug, titik henti akan tercapai di Visual Studio Code seperti yang Anda harapkan.

  1. Di palet perintah, masukkan Azure Functions: Jalankan fungsi sekarang dan pilih Proyek lokal.

  2. Pilih fungsi yang ingin Anda jalankan dari daftar dan ketik badan pesan permintaan di Masukkan isi permintaan. Tekan Masukkan untuk mengirim pesan permintaan ini ke fungsi Anda. Teks default dalam Masukkan isi permintaan harus menunjukkan format isi. Jika aplikasi fungsi Anda tidak memiliki fungsi, kesalahan notifikasi akan ditampilkan dengan kesalahan ini.

  3. Saat fungsi berjalan secara lokal dan setelah respons diterima, pemberitahuan akan dimunculkan di Visual Studio Code. Informasi tentang eksekusi fungsi ditampilkan di panel Terminal.

Menjalankan fungsi secara lokal tidak perlu menggunakan kunci.

Pengaturan Lokal

Saat menjalankan aplikasi fungsi di Azure, pengaturan yang diperlukan oleh fungsi Anda disimpan dengan aman di pengaturan aplikasi. Selama pengembangan lokal, pengaturan ini malah ditambahkan ke objek Values di file local.settings.json. File local.settings.json juga menyimpan pengaturan yang digunakan oleh alat pengembangan lokal.

Karena local.settings.js mungkin berisi rahasia, seperti string koneksi, Anda tidak boleh menyimpannya di repositori jarak jauh. Untuk mempelajari selengkapnya tentang pengaturan lokal, lihat File pengaturan lokal.

Secara default, pengaturan ini tidak dimigrasikan secara otomatis saat proyek diterbitkan ke Azure. Setelah penerbitan selesai, Anda diberi opsi untuk menerbitkan pengaturan dari local.settings.json ke aplikasi fungsi Anda di Azure. Untuk mempelajari lebih lanjut, lihat Menerbitkan pengaturan aplikasi.

Nilai dalam ConnectionStrings tidak pernah diterbitkan.

Nilai pengaturan aplikasi fungsi juga dapat dibaca dalam kode Anda sebagai variabel lingkungan. Untuk informasi selengkapnya, lihat bagian variabel Lingkungan dari artikel referensi khusus bahasa ini:

Pengaturan aplikasi di Azure

Pengaturan di file local.settings.json di proyek Anda harus sama dengan pengaturan aplikasi di aplikasi fungsi di Azure. Pengaturan apa pun yang Anda tambahkan ke local.settings.json juga harus Anda tambahkan ke aplikasi fungsi di Azure. Pengaturan ini tidak diunggah secara otomatis saat Anda menerbitkan proyek. Demikian juga, pengaturan apa pun yang Anda buat di aplikasi fungsi Anda di portal harus diunduh ke proyek lokal Anda.

Menerbitkan pengaturan aplikasi

Cara termudah untuk menerbitkan pengaturan yang diperlukan ke aplikasi fungsi Anda di Azure adalah dengan menggunakan tautan Unggah pengaturan yang muncul setelah Anda menerbitkan proyek Anda:

Screenshot to upload application settings.

Anda juga dapat menerbitkan pengaturan dengan menggunakan perintah Azure Functions: Unggah Pengaturan Lokal di palet perintah. Anda bisa menambahkan pengaturan individual ke pengaturan aplikasi di Azure dengan menggunakan perintah Azure Functions: Tambahkan Pengaturan Baru.

Tip

Pastikan untuk menyimpan file local.settings.json Anda sebelum Anda menerbitkannya.

Jika file lokal dienkripsi, file tersebut didekripsi, diterbitkan, dan dienkripsi lagi. Jika ada pengaturan yang memiliki nilai yang bertentangan di dua lokasi, Anda akan diminta untuk memilih cara melanjutkan.

Menampilkan pengaturan aplikasi yang sudah ada di area Azure: Functions dengan memperluas langganan, aplikasi fungsi, dan Pengaturan Aplikasi Anda.

 Screenshot for viewing function app settings in Visual Studio Code.

Unduh pengaturan dari Azure

Jika Anda telah membuat pengaturan aplikasi di Azure, Anda dapat mengunduhnya ke file local.settings.json dengan menggunakan perintah Azure Functions: Unduh Pengaturan Jarak Jauh.

Seperti halnya mengunggah, jika file lokal dienkripsi, file tersebut didekripsi, diperbarui, dan dienkripsi lagi. Jika ada pengaturan yang memiliki nilai yang bertentangan di dua lokasi, Anda akan diminta untuk memilih cara melanjutkan.

Fungsi pemantauan

Saat Anda menjalankan fungsi secara lokal, data log dialirkan ke konsol Terminal. Anda juga bisa mendapatkan data log saat proyek Functions berjalan di aplikasi fungsi di Azure. Anda dapat menyambungkan ke log streaming di Azure untuk melihat data log yang hampir real-time. Anda harus mengaktifkan Application Insights untuk pemahaman yang lebih lengkap tentang cara kerja aplikasi fungsi Anda.

Log streaming

Saat Anda mengembangkan aplikasi, seringkali berguna untuk melihat informasi pengelogan hampir secara real time. Anda dapat melihat aliran file log yang dihasilkan oleh fungsi Anda. Output ini adalah contoh log streaming untuk permintaan ke fungsi yang dipicu HTTP:

Screenshot for streaming logs output for H T T P trigger.

Untuk mempelajari lebih lanjut, lihat Log streaming.

Untuk mengaktifkan log streaming untuk aplikasi fungsi Anda di Azure:

  1. Pilih F1 untuk membuka palet perintah, lalu cari dan jalankan perintah Azure Functions: Mulai Log Streaming.

  2. Pilih aplikasi fungsi Anda di Azure, lalu pilih Ya untuk mengaktifkan pengelogan aplikasi untuk aplikasi fungsi.

  3. Pemicu fungsi Anda di Azure. Perhatikan bahwa data log ditampilkan di jendela Output di Visual Studio Code.

  4. Setelah selesai, ingatlah untuk menjalankan perintah Azure Functions: Hentikan Log Streaming untuk menonaktifkan pengelogan untuk aplikasi fungsi.

Catatan

Log streaming hanya mendukung satu instans dari host Functions. Saat fungsi Anda diskalakan ke beberapa instans, data dari instans lain tidak ditampilkan di aliran log. Live Metrics Stream di Application Insights mendukung beberapa instans. Sementara juga hampir real-time, analitik streaming didasarkan pada data sampel.

Application Insights

Kami menyarankan Anda memantau eksekusi fungsi Anda dengan mengintegrasikan aplikasi fungsi Anda dengan Application Insights. Saat Anda membuat aplikasi fungsi di portal Microsoft Azure, integrasi ini terjadi secara default. Saat membuat aplikasi fungsi selama penerbitan Visual Studio, Anda harus mengintegrasikan sendiri Application Insights. Untuk mempelajari caranya, lihat Mengaktifkan integrasi Application Insights.

Untuk mempelajari selengkapnya tentang pemantauan menggunakan Application Insights, lihat Memantau Azure Functions.

Proyek skrip C#

Secara default, semua proyek C# dibuat sebagai proyek pustaka kelas terkompilasi C#. Jika Anda lebih suka bekerja dengan proyek skrip C#, Anda harus memilih skrip C# sebagai bahasa default di pengaturan ekstensi Azure Functions:

  1. Pilih File>Preferensi>Pengaturan.

  2. Buka Pengaturan Pengguna>Ekstensi>Azure Functions.

  3. Pilih C#Script dari Fungsi Azure: Bahasa Proyek.

Setelah Anda menyelesaikan langkah-langkah ini, panggilan yang dilakukan ke Core Tools yang mendasarinya menyertakan opsi --csx, yang menghasilkan dan menerbitkan file proyek skrip C# (.csx). Bila Anda telah menentukan bahasa default ini, semua proyek yang Anda buat secara default ke proyek skrip C#. Anda tidak diminta untuk memilih bahasa proyek saat default diatur. Untuk membuat proyek dalam bahasa lain, Anda harus mengubah pengaturan ini atau menghapusnya dari file settings.json pengguna. Setelah menghapus pengaturan ini, Anda akan kembali diminta untuk memilih bahasa Anda saat membuat proyek.

Referensi palet perintah

Ekstensi Azure Functions menyediakan antarmuka grafis yang berguna di area untuk berinteraksi dengan aplikasi fungsi Anda di Azure. Fungsionalitas yang sama juga tersedia sebagai perintah di palet perintah (F1). Perintah Azure Functions ini tersedia:

Perintah Azure Functions Deskripsi
Tambah Pengaturan Baru Membuat pengaturan aplikasi baru di Azure. Untuk mempelajari lebih lanjut, lihat Menerbitkan pengaturan aplikasi. Anda mungkin juga perlu mengunduh pengaturan ini ke pengaturan lokal Anda.
Mengonfigurasi Sumber Penyebaran Menyambungkan aplikasi fungsi Anda di Azure ke repositori Git lokal. Untuk mempelajari selengkapnya, lihat Penyebaran berkelanjutan untuk Azure Functions.
Menyambungkan ke Repositori GitHub Menyambungkan aplikasi fungsi Anda ke repositori GitHub.
Salin URL Fungsi Mendapatkan URL jarak jauh dari fungsi yang dipicu HTTP yang berjalan di Azure. Untuk mempelajari lebih lanjut, lihat Mendapatkan URL fungsi yang disebarkan.
Membuat aplikasi fungsi di Azure Membuat aplikasi fungsi baru di langganan Anda di Azure. Untuk mempelajari selengkapnya, lihat bagian tentang cara menerbitkan ke aplikasi fungsi baru di Azure.
Pengaturan Dekripsi Mendekripsi pengaturan lokal yang telah dienkripsi oleh Azure Functions: Enkripsi Pengaturan.
Hapus Aplikasi Fungsi Menghapus aplikasi fungsi dari langganan Anda di Azure. Ketika tidak ada aplikasi lain dalam paket App Service, Anda juga diberi opsi untuk menghapusnya. Sumber daya lain, seperti akun penyimpanan dan grup sumber daya, tidak dihapus. Untuk menghapus semua sumber daya, Anda harus menghapus grup sumber daya. Proyek lokal Anda tidak terpengaruh.
Menghapus Fungsi Menghapus fungsi yang sudah ada dari aplikasi fungsi di Azure. Karena penghapusan ini tidak memengaruhi proyek lokal Anda, pertimbangkan untuk menghapus fungsi secara lokal lalu menerbitkan ulang proyek Anda.
Menghapus Proksi Menghapus proksi Azure Functions dari aplikasi fungsi Anda di Azure. Untuk mempelajari selengkapnya tentang proksi, lihat Bekerja dengan Azure Functions Proxies.
Menghapus Pengaturan Menghapus pengaturan aplikasi fungsi di Azure. Penghapusan ini tidak mempengaruhi pengaturan di file local.settings.json.
Memutus sambungan dari Repositori Menghapus koneksi penyebaran berkelanjutan antara aplikasi fungsi di Azure dengan repositori kontrol sumber.
Mengunduh Pengaturan Jarak Jauh Mengunduh pengaturan dari aplikasi fungsi yang dipilih di Azure ke dalam file local.settings.json. Jika file lokal dienkripsi, file tersebut didekripsi, diperbarui, dan dienkripsi lagi. Jika ada pengaturan yang memiliki nilai yang bertentangan di dua lokasi, Anda akan diminta untuk memilih cara melanjutkan. Pastikan untuk menyimpan perubahan ke file local.settings.json Anda sebelum Anda menjalankan perintah ini.
Mengedit pengaturan Mengubah nilai pengaturan aplikasi fungsi yang sudah ada di Azure. Perintah ini tidak mempengaruhi pengaturan di file local.settings.json.
Mengenkripsi pengaturan Mengenkripsi item individual dalam Values array di pengaturan lokal. Dalam file ini, IsEncrypted juga diatur ke true, yang menentukan bahwa runtime lokal akan mendekripsi pengaturan sebelum menggunakannya. Enkripsi pengaturan lokal untuk mengurangi risiko membocorkan informasi berharga. Di Azure, pengaturan aplikasi selalu disimpan terenkripsi.
Menjalankan Fungsi Sekarang Memulai fungsi secara manual menggunakan API admin. Perintah ini digunakan untuk pengujian, baik secara lokal selama penelusuran kesalahan maupun terhadap fungsi yang berjalan di Azure. Saat fungsi di Azure dimulai, ekstensi terlebih dahulu mendapatkan kunci admin secara otomatis, yang digunakan untuk memanggil API admin jarak jauh yang memulai fungsi di Azure. Badan pesan yang dikirim ke API bergantung pada jenis pemicunya. Pemicu timer tidak mengharuskan Anda untuk meneruskan data apa pun.
Menginisialisasi Proyek untuk Digunakan dengan Visual Studio Code Menambahkan file proyek Visual Studio Code yang diperlukan ke proyek Functions yang sudah ada. Gunakan perintah ini untuk bekerja dengan proyek yang Anda buat dengan menggunakan Core Tools.
Memasang atau Memperbarui Azure Functions Core Tools Pemasangan atau pembaruan Azure Functions Core Tools, yang digunakan untuk menjalankan fungsi secara lokal.
Menyebarkan ulang Memungkinkan Anda menyebarkan ulang file proyek dari repositori Git yang terhubung ke penyebaran tertentu di Azure. Untuk menerbitkan ulang pembaruan lokal dari Visual Studio Code, terbitkan ulang proyek Anda.
Mengganti Nama Pengaturan Mengubah nama kunci pengaturan aplikasi fungsi yang sudah ada di Azure. Perintah ini tidak mempengaruhi pengaturan di file local.settings.json. Setelah Anda mengganti nama pengaturan di Azure, Anda harus mengunduh perubahan tersebut ke proyek lokal.
Mulai ulang Memulai ulang aplikasi fungsi di Azure. Menyebarkan pembaruan juga memulai ulang aplikasi fungsi.
Menetapkan AzureWebJobsStorage Menetapkan nilai pengaturan aplikasi AzureWebJobsStorage. Pengaturan ini diperlukan oleh Azure Functions. Ini ditetapkan saat aplikasi fungsi dibuat di Azure.
Mulai Memulai aplikasi fungsi yang dihentikan di Azure.
Memulai Log Streaming Memulai log streaming untuk aplikasi fungsi di Azure. Gunakan log streaming selama pemecahan masalah jarak jauh di Azure jika Anda perlu melihat informasi pengelogan hampir secara real-time. Untuk mempelajari lebih lanjut, lihat Log streaming.
Hentikan Menghentikan aplikasi fungsi yang berjalan di Azure.
Menghentikan Log Streaming Menghentikan log streaming untuk aplikasi fungsi di Azure.
Mengalihkan sebagai Pengaturan Slot Saat diaktifkan, pastikan bahwa pengaturan aplikasi tetap ada untuk slot penyebaran tertentu.
Copot Pemasangan Azure Functions Core Tools Menghapus Azure Functions Core Tools, yang diperlukan oleh ekstensi.
Mengunggah Pengaturan Lokal Mengunggah pengaturan dari file local.settings.json Anda ke aplikasi fungsi yang dipilih di Azure. Jika file lokal dienkripsi, file tersebut didekripsi, diunggah, dan dienkripsi lagi. Jika ada pengaturan yang memiliki nilai yang bertentangan di dua lokasi, Anda akan diminta untuk memilih cara melanjutkan. Pastikan untuk menyimpan perubahan ke file local.settings.json Anda sebelum Anda menjalankan perintah ini.
Menampilkan Komit di GitHub Memperlihatkan kepada Anda komit terbaru dalam penyebaran tertentu saat aplikasi fungsi Anda terhubung ke repositori.
Menampilkan Log Penyebaran Menunjukkan kepada Anda log untuk penyebaran tertentu ke aplikasi fungsi di Azure.

Langkah berikutnya

Untuk informasi selengkapnya tentang Azure Functions Core Tools, lihat Bekerja dengan Azure Functions Core Tools.

Untuk informasi selengkapnya tentang mengembangkan fungsi sebagai pustaka kelas .NET, lihat Referensi pengembang Azure Functions C#. Artikel ini juga menyediakan tautan ke contoh cara menggunakan atribut untuk mendeklarasikan berbagai jenis pengikatan yang didukung oleh Azure Functions.