Membuat fungsi pertama Anda di Azure Arc (pratinjau)

Dalam panduan mulai cepat ini, Anda akan membuat proyek Azure Functions dan menyebarkannya ke aplikasi fungsi yang berjalan pada kluster Kubernetes yang mendukung Azure Arc. Untuk mempelajari selengkapnya, lihat Layanan Aplikasi, Fungsi, dan Aplikasi Logika di Azure Arc. Skenario ini hanya mendukung aplikasi fungsi yang berjalan di Linux.

Catatan

Dukungan untuk menjalankan fungsi pada kluster Kube dengan dukungan Azure Arc saat ini sedang dalam pratinjau.

Pemublikasian proyek fungsi PowerShell ke kluster Kubernetes yang mendukung Azure Arc saat ini tidak didukung. Jika Anda perlu menyebarkan fungsi PowerShell ke kluster Kubernetes yang mendukung Azure Arc, buat aplikasi fungsi Anda dalam kontainer.

Jika Anda perlu menyesuaikan kontainer tempat aplikasi fungsi Anda berjalan, lihat Membuat fungsi kontainer pertama Anda di Azure Arc (pratinjau).

Prasyarat

Di komputer lokal:

C#

• .NET 6.0 SDK
• Azure CLI versi 2.4 atau yang lebih baru

JavaScript

• Node.js versi 18. Node.js versi 14 juga didukung.
• Azure CLI versi 2.4 atau yang lebih baru

Python

• Versi Python yang didukung oleh Azure Functions
• Azure CLI versi 2.4 atau yang lebih baru

PowerShell

• PowerShell 7
• Azure CLI versi 2.4 atau yang lebih baru
• PowerShell 7 memerlukan versi 1.2.5 dari ekstensi Azure CLI yang tersambung, atau versi yang lebih baru. Hal ini juga memerlukan versi 0.1.3 dari ekstensi appservice-kube Azure CLI, atau versi yang lebih baru. Pastikan Anda menginstal versi yang benar dari kedua ekstensi ini saat Anda menyelesaikan artikel mulai cepat ini.

Instal Azure Functions Core Tools

Cara yang disarankan untuk menginstal Core Tools tergantung pada sistem operasi komputer pengembangan lokal Anda.

Windows

Langkah-langkah berikut menggunakan penginstal Windows (MSI) untuk menginstal Core Tools v4.x. Untuk informasi selengkapnya tentang penginstal berbasis paket lainnya, lihat Core Tools readme.

Unduh dan jalankan penginstal Core Tools, berdasarkan versi Windows Anda:

• v4.x - Windows 64-bit (Disarankan. penelusuran kesalahan Visual Studio Code memerlukan 64-bit.)
• v4.x - Windows 32-bit

Jika sebelumnya Anda menggunakan penginstal Windows (MSI) untuk menginstal Core Tools di Windows, Anda harus menghapus instalan versi lama dari Tambahkan Hapus Program sebelum menginstal versi terbaru.

macOS

Langkah-langkah berikut menggunakan Homebrew untuk menginstal Core Tools di macOS.

1. Instal Homebrew, jika belum terinstal.

2. Instal paket Core Tools:

   brew tap azure/functions
   brew install azure-functions-core-tools@4
   # if upgrading on a machine that has 2.x or 3.x installed:
   brew link --overwrite azure-functions-core-tools@4
   

Linux

Langkah-langkah berikut menggunakan APT untuk menginstal Core Tools pada distribusi Linux Ubuntu/Debian Anda. Untuk distribusi Linux lainnya, lihat readme Core Tools.

1. Instal kunci GPG repositori paket Microsoft, untuk memvalidasi integritas paket:

   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
   sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg
   

2. Siapkan daftar sumber APT sebelum melakukan pembaruan APT.

   Ubuntu

   sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-$(lsb_release -cs)-prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
   

   Debian

   sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/debian/$(lsb_release -rs | cut -d'.' -f 1)/prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list'
   

3. /etc/apt/sources.list.d/dotnetdev.list Periksa file untuk salah satu string versi Linux yang sesuai dalam tabel berikut:

   Distribusi Linux	Versi
   Debian 11	bullseye
   Debian 10	buster
   Debian 9	stretch
   Ubuntu 22.04	jammy
   Ubuntu 20.04	focal
   Ubuntu 19.04	disco
   Ubuntu 18.10	cosmic
   Ubuntu 18.04	bionic
   Ubuntu 17.04	zesty
   Ubuntu 16.04/Linux Mint 18	xenial

4. Mulai pembaruan sumber APT:

   sudo apt-get update
   

5. Instal paket Core Tools:

   sudo apt-get install azure-functions-core-tools-4
   

Buat lingkungan Kubernetes App Service

Sebelum memulai, Anda harus membuat lingkungan Kubernetes App Service untuk kluster Kubernetes yang mendukung Azure Arc.

Catatan

Saat Anda membuat lingkungan, pastikan untuk mencatat nama lokasi kustom dan nama grup sumber daya yang berisi lokasi kustom. Anda dapat menggunakannya untuk menemukan ID lokasi kustom, yang akan Anda perlukan saat membuat aplikasi fungsi di lingkungan.

Jika Anda tidak membuat lingkungan, tanyakan kepada administrator kluster Anda.

Menambahkan ekstensi Azure CLI

Luncurkan lingkungan Bash di Azure Cloud Shell.

Karena perintah CLI ini belum menjadi bagian dari set CLI inti, tambahkan dengan perintah berikut:

az extension add --upgrade --yes --name customlocation
az extension remove --name appservice-kube
az extension add --upgrade --yes --name appservice-kube

Membuat proyek fungsi lokal

Di Azure Functions, proyek fungsi adalah unit penyebaran untuk satu atau beberapa fungsi individual yang masing-masing merespons pemicu tertentu. Semua fungsi dalam proyek memiliki konfigurasi lokal dan hosting yang sama. Di bagian ini, Anda membuat proyek fungsi yang berisi satu fungsi.

1. Jalankan perintah func init, sebagai berikut, untuk membuat proyek fungsi dalam folder bernama LocalFunctionProj dengan runtime bahasa umum yang ditentukan:

   C#

   func init LocalFunctionProj --dotnet
   

   JavaScript

   func init LocalFunctionProj --javascript
   

   Python

   Python memerlukan lingkungan virtual yang perintahnya berbeda antara bash dan baris perintah Windows.

   • bash:

     python -m venv .venv
     source .venv/bin/activate
     

   • baris perintah:

     py -m venv .venv
     .venv\scripts\activate
     

   Sekarang, Anda dapat membuat proyek di dalam lingkungan virtual.

   func init LocalFunctionProj --python
   

   PowerShell

   func init LocalFunctionProj --powershell
   

2. Navigasi ke folder proyek:

   cd LocalFunctionProj
   

   Folder ini berisi berbagai file untuk proyek, termasuk file konfigurasi bernama local.settings.json dan host.json. Secara default, file local.settings.json dikecualikan dari kontrol sumber dalam file .gitignore. Pengecualian ini dikarenakan file dapat berisi rahasia yang diunduh dari Azure.

3. Tambahkan fungsi ke proyek Anda dengan menggunakan perintah berikut, yang mana argumen --name adalah nama unik fungsi Anda (HttpExample) dan argumen --template menentukan pemicu fungsi (HTTP).

   func new --name HttpExample --template "HTTP trigger" --authlevel "anonymous"
   

Jalankan fungsi secara lokal

1. Jalankan fungsi Anda dengan memulai host runtime Azure Functions lokal dari folder LocalFunctionProj.

   func start
   

   Menjelang akhir output, baris berikut harus muncul:

   

   Catatan

   Jika HttpExample tidak muncul seperti yang ditunjukkan di atas, Anda mungkin memulai hosting dari luar folder akar proyek. Dalam kasus tersebut, gunakan Ctrl+C untuk menghentikan hosting, buka folder akar proyek, dan jalankan kembali perintah sebelumnya.

2. Salin URL fungsi HTTP Anda dari output ini ke browser dan tambahkan string ?name=<YOUR_NAME>kueri , membuat URL lengkap seperti http://localhost:7071/api/HttpExample?name=Functions. Browser akan menampilkan pesan tanggapan yang mengulang nilai string kueri Anda. Terminal tempat Anda memulai proyek juga menunjukkan output log saat Anda membuat permintaan.

3. Jika sudah selesai, tekan Ctrl + C dan ketik y untuk menghentikan hosting fungsi.

Mendapatkan lokasi kustom

Agar dapat membuat aplikasi fungsi di lokasi kustom, Anda harus mendapatkan informasi tentang lingkungan.

Dapatkan informasi berikut tentang lokasi kustom dari admin kluster (lihat Membuat lokasi kustom).

customLocationGroup="<resource-group-containing-custom-location>"
customLocationName="<name-of-custom-location>"

Dapatkan ID lokasi kustom untuk langkah berikutnya.

customLocationId=$(az customlocation show \
    --resource-group $customLocationGroup \
    --name $customLocationName \
    --query id \
    --output tsv)

Membuat sumber daya Azure

Sebelum dapat menyebarkan kode fungsi ke lingkungan App Service Kubernetes baru, Anda harus membuat dua sumber daya lainnya:

• Akun penyimpanan. Meskipun artikel ini membuat akun penyimpanan, dalam beberapa kasus akun penyimpanan mungkin tidak diperlukan. Untuk informasi selengkapnya, lihat kluster yang dengan dukungan Azure Arc di artikel pertimbangan penyimpanan.
• Aplikasi fungsi, yang menyediakan konteks untuk menjalankan kode fungsi Anda. Aplikasi fungsi berjalan di lingkungan App Service Kubernetes dan dipetakan ke proyek fungsi lokal Anda. Aplikasi fungsi memungkinkan Anda untuk mengelompokkan fungsi sebagai unit logis untuk manajemen, penyebaran, dan berbagi sumber daya yang lebih mudah.

Catatan

Aplikasi fungsi berjalan di lingkungan App Service Kubernetes pada paket Khusus (App Service). Saat Anda membuat aplikasi fungsi tanpa paket yang ada, paket yang benar akan dibuat untuk Anda.

Membuat Akun penyimpanan

Gunakan perintah az storage account create untuk membuat akun penyimpanan dengan tujuan umum di grup dan wilayah sumber daya Anda:

az storage account create --name <STORAGE_NAME> --location westeurope --resource-group myResourceGroup --sku Standard_LRS

Catatan

Dalam beberapa kasus, akun penyimpanan mungkin tidak diperlukan. Untuk informasi selengkapnya, lihat kluster yang dengan dukungan Azure Arc di artikel pertimbangan penyimpanan.

Di contoh sebelumnya, ganti <STORAGE_NAME> dengan nama yang sesuai untuk Anda dan unik di Azure Storage. Nama harus berisi tiga hingga 24 karakter angka dan huruf kecil saja. Standard_LRS menentukan akun tujuan umum, yang didukung oleh Functions. Nilai --location merupakan wilayah Azure standar.

Buat aplikasi fungsi

Jalankan perintah buat functionapp az untuk membuat aplikasi fungsi baru di lingkungan.

C#

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime dotnet 

JavaScript

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime node --runtime-version 18

Python

az functionapp create --resource-group MyResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime python --runtime-version 3.8

PowerShell

az functionapp create --resource-group myResourceGroup --name <APP_NAME> --custom-location <CUSTOM_LOCATION_ID> --storage-account <STORAGE_NAME> --functions-version 4 --runtime powershell --runtime-version 7.0

Dalam contoh ini, ganti <CUSTOM_LOCATION_ID> dengan ID lokasi kustom yang Anda tentukan untuk lingkungan App Service Kubernetes. Selain itu, ganti <STORAGE_NAME> dengan nama akun yang Anda gunakan di langkah sebelumnya, dan ganti <APP_NAME> dengan nama unik global yang sesuai untuk Anda.

Menyebarkan proyek fungsi ke Azure

Setelah berhasil membuat aplikasi fungsi di Azure, kini Anda siap untuk menyebarkan proyek fungsi lokal Anda menggunakan perintah func fungsi azureapp publish.

Dalam contoh berikut, ganti <APP_NAME> dengan nama aplikasi Anda.

func azure functionapp publish <APP_NAME>

Perintah terbitkan menunjukkan hasil yang mirip dengan output berikut (dipotong agar sederhana):

...

Getting site publishing info...
Creating archive for current directory...
Performing remote build for functions project.

...

Deployment successful.
Remote build succeeded!
Syncing triggers...
Functions in msdocs-azurefunctions-qs:
    HttpExample - [httpTrigger]
        Invoke url: https://msdocs-azurefunctions-qs.azurewebsites.net/api/httpexample

Karena perlu beberapa waktu agar penyebaran penuh untuk diselesaikan pada kluster Kubernetes dengan dukungan Azure Arc, Anda mungkin ingin menjalankan kembali perintah berikut untuk memverifikasi fungsi yang dipublikasikan:

func azure functionapp list-functions

Menggunakan fungsi pada Azure

Karena fungsi Anda menggunakan pemicu HTTP, Anda memanggilnya dengan membuat permintaan HTTP ke URL-nya di browser atau dengan alat seperti curl.

Browser

Salin Panggilan URL lengkap yang ditampilkan dalam output perintah terbitkan ke bilah alamat browser, menambahkan parameter kueri ?name=Functions. Browser harus menampilkan output yang sama seperti saat Anda menjalankan fungsi secara lokal.

curl

Jalankan curldengan Panggilan URL, menambahkan parameter ?name=Functions. Output dari perintah harus berupa teks, "Hello Functions."

Langkah berikutnya

Setelah aplikasi fungsi berjalan di kontainer pada lingkungan App Service Kube dengan dukungan Azure Arc, Anda dapat menyambungkannya ke Azure Storage dengan menambahkan pengikatan output Queue Storage.

C#

Menyambungkan ke antrean Azure Storage

JavaScript

Menyambungkan ke antrean Azure Storage

Python

Menyambungkan ke antrean Azure Storage

PowerShell

Menyambungkan ke antrean Azure Storage