Membuat aplikasi fungsi di kontainer Linux lokal

Artikel
07/31/2024

Artikel ini menunjukkan kepada Anda cara menggunakan alat Azure Functions Core untuk membuat fungsi pertama Anda di kontainer Linux di komputer lokal Anda, memverifikasi fungsi secara lokal, lalu menerbitkan fungsi dalam kontainer ke registri kontainer. Dari registri kontainer, Anda dapat dengan mudah menyebarkan fungsi dalam kontainer ke Azure.

Untuk contoh lengkap penyebaran fungsi dalam kontainer ke Azure, yang menyertakan langkah-langkah dalam artikel ini, lihat salah satu artikel berikut ini:

Anda juga dapat membuat aplikasi fungsi di portal Azure dengan menggunakan aplikasi fungsi kontainer yang ada dari registri kontainer. Untuk informasi selengkapnya, lihat portal Azure membuat menggunakan kontainer.

Memilih bahasa pengembangan Anda

Pertama, Anda menggunakan alat Azure Functions untuk membuat kode proyek Anda sebagai aplikasi fungsi dalam kontainer Docker menggunakan gambar dasar Linux khusus bahasa. Pastikan untuk memilih bahasa pilihan Anda di bagian atas artikel.

Core Tools secara otomatis menghasilkan Dockerfile untuk proyek Anda yang menggunakan versi terbaru dari gambar dasar yang benar untuk bahasa fungsi Anda. Anda harus memperbarui kontainer Anda secara teratur dari gambar dasar terbaru dan menyebarkan ulang dari versi kontainer Anda yang diperbarui. Untuk informasi selengkapnya, lihat Membuat aplikasi fungsi dalam kontainer.

Prasyarat

Sebelum memulai, Anda harus memiliki persyaratan berikut:

Instal .NET 8.0 SDK.
Instal Azure Functions Core Tools versi 4.0.5198, atau versi yang lebih baru.

Instal Azure Functions Core Tools versi 4.x.

Instal versi Node.js yang didukung oleh Azure Functions.

Instal versi Python yang didukung oleh Azure Functions.

Instal SDK .NET 6.

Instal versi Java Developer Kit yang didukung oleh Azure Functions.
Instal Apache Maven versi 3.0 atau lebih tinggi.

Azure CLI versi 2.4 atau versi yang lebih baru.

Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.

Untuk menerbitkan gambar aplikasi fungsi kontainer yang Anda buat ke registri kontainer, Anda memerlukan ID Docker dan Docker yang berjalan di komputer lokal Anda. Jika Anda tidak memiliki ID Docker, Anda dapat membuat akun Docker.

Azure Container Registry
Docker Hub

Anda juga perlu menyelesaikan bagian Buat registri kontainer dari mulai cepat Container Registry untuk membuat instans registri. Catat nama server masuk Anda yang sepenuhnya memenuhi syarat.

Membuat dan mengaktifkan lingkungan virtual

Di folder yang sesuai, jalankan perintah berikut untuk membuat dan mengaktifkan lingkungan virtual bernama .venv. Pastikan untuk menggunakan salah satu versi Python yang didukung oleh Azure Functions.

python -m venv .venv

source .venv/bin/activate

Jika Python tidak memasang paket venv pada distribusi Linux Anda, jalankan perintah berikut:

sudo apt-get install python3-venv

py -m venv .venv

.venv\scripts\activate

py -m venv .venv

.venv\scripts\activate

Anda menjalankan semua perintah berikutnya di lingkungan virtual yang diaktifkan ini.

Membuat dan menguji proyek fungsi lokal

Pada prompt terminal atau perintah, jalankan perintah berikut ini untuk bahasa yang telah dipilih untuk membuat proyek aplikasi fungsi pada folder saat ini:

func init --worker-runtime dotnet-isolated --docker

func init --worker-runtime node --language javascript --docker

func init --worker-runtime powershell --docker

func init --worker-runtime python --docker

func init --worker-runtime node --language typescript --docker

Dalam folder kosong, jalankan perintah berikut ini untuk menghasilkan proyek Azure Functions dari archetype Maven:

mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

mvn archetype:generate "-DarchetypeGroupId=com.microsoft.azure" "-DarchetypeArtifactId=azure-functions-archetype" "-DjavaVersion=8" "-Ddocker"

Parameter -DjavaVersion memberi tahu runtime Functions versi Java mana yang akan digunakan. Gunakan -DjavaVersion=11 jika Anda ingin fungsi Anda berjalan di Java 11. Saat Anda tidak menentukan -DjavaVersion, Maven default ke Java 8. Untuk informasi selengkapnya, lihat versi Java.

Penting

Variabel lingkungan JAVA_HOME harus diatur ke lokasi penginstalan versi JDK yang benar untuk menyelesaikan artikel ini.

Maven meminta nilai yang diperlukan untuk menyelesaikan pembuatan proyek pada penyebaran. Ikuti perintahnya dan berikan informasi berikut:

Prompt	Nilai	Deskripsi
groupId	`com.fabrikam`	Nilai yang secara unik mengidentifikasi proyek Anda dari semua proyek, mengikuti aturan penamaan paket untuk Java.
artifactId	`fabrikam-functions`	Nilai yang merupakan nama jar, tanpa nomor versi.
versi	`1.0-SNAPSHOT`	Harap pilih nilai default.
package	`com.fabrikam.functions`	Nilai yang merupakan paket Java untuk kode fungsi yang dihasilkan. Gunakan default.

Ketik Y atau tekan Enter untuk mengonfirmasi.

Maven membuat file proyek di folder baru dengan nama artifactId, yang dalam contoh ini merupakan fabrikam-functions.

Opsi ini --docker menghasilkan Dockerfile untuk proyek, yang menentukan kontainer yang sesuai untuk digunakan dengan Azure Functions dan runtime yang dipilih.

Navigasi ke folder proyek:

cd fabrikam-functions

Gunakan perintah berikut ini untuk menambahkan fungsi ke proyek Anda, dengan argumen --name merupakan nama unik fungsi Anda dan argumen --template menentukan pemicu fungsi. func new membuat file kode C# dalam proyek Anda.

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

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

Untuk menguji fungsi secara lokal, harap mulai host runtime Azure Functions lokal pada akar folder proyek.

func start

func start

npm install
npm start

mvn clean package  
mvn azure-functions:run

Setelah Anda melihat HttpExample titik akhir yang ditulis ke output, navigasikan ke titik akhir tersebut. Anda akan melihat pesan selamat datang dalam output respons.

Setelah Anda melihat titik akhir yang HttpExample ditulis ke output, navigasikan ke http://localhost:7071/api/HttpExample?name=Functions. Browser harus menampilkan pesan "halo" yang menghasilkan Functions, yaitu nilai yang diberikan ke parameter kueri name.

Tekan Ctrl+C (Command+C di macOS) untuk menghentikan host.

Membangun gambar kontainer dan memverifikasi secara lokal

(Opsional) Memeriksa Dockerfile di akar folder proyek. Dockerfile menjelaskan lingkungan yang dibutuhkan untuk menjalankan aplikasi fungsi di Linux. Daftar lengkap gambar dasar yang didukung untuk Azure Functions dapat ditemukan di halaman gambar dasar Azure Functions.

Di folder proyek akar, jalankan perintah docker build, dan berikan nama azurefunctionsimage dan tag v1.0.0. Ganti <DOCKER_ID> dengan ID akun Docker Hub Anda. Perintah ini menyusun gambar Docker untuk kontainer.

docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .

Ketika perintah selesai, Anda dapat menjalankan kontainer baru secara lokal.

Untuk memverifikasi build, jalankan gambar dalam kontainer lokal menggunakan perintah jalankan docker, ganti <DOCKER_ID> lagi dengan ID akun Docker Hub Anda, dan tambahkan argumen port sebagai -p 8080:80:

docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0

Setelah gambar berjalan pada kontainer lokal, telusuri ke http://localhost:8080/api/HttpExample, yang akan menampilkan pesan sapaan yang sama dengan sebelumnya. Karena fungsi yang terpicu HTTP yang telah Anda buat menggunakan otorisasi anonim, Anda dapat memanggil fungsi yang berjalan di kontainer tanpa harus mendapatkan kunci akses. Untuk informasi selengkapnya, lihat kunci otorisasi.

Setelah gambar berjalan dalam kontainer lokal, telusuri ke http://localhost:8080/api/HttpExample?name=Functions, yang akan menampilkan pesan "halo" yang sama dengan sebelumnya. Karena fungsi yang terpicu HTTP yang telah Anda buat menggunakan otorisasi anonim, Anda dapat memanggil fungsi yang berjalan di kontainer tanpa harus mendapatkan kunci akses. Untuk informasi selengkapnya, lihat kunci otorisasi.

Setelah memverifikasi aplikasi fungsi di kontainer, tekan Ctrl+C (Command+C di macOS) untuk menghentikan eksekusi.

Menerbitkan gambar kontainer ke registri

Untuk membuat gambar kontainer Anda tersedia untuk penyebaran ke lingkungan hosting, Anda harus mendorongnya ke registri kontainer.

Azure Container Registry
Docker Hub

Azure Container Registry adalah layanan registri privat untuk membangun, menyimpan, dan mengelola gambar kontainer dan artefak terkait. Anda harus menggunakan layanan registri privat untuk menerbitkan kontainer Anda ke layanan Azure.

Gunakan perintah ini untuk masuk ke instans registri Anda menggunakan kredensial Azure Anda saat ini:
```
az acr login --name <REGISTRY_NAME>
```
Di perintah sebelumnya, ganti <REGISTRY_NAME> dengan nama instans Container Registry Anda.
Gunakan perintah ini untuk menandai gambar Anda dengan nama server masuk registri Anda yang sepenuhnya memenuhi syarat:
```
docker tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 
```
Ganti <LOGIN_SERVER> dengan nama server masuk registri Anda yang sepenuhnya memenuhi syarat dan <DOCKER_ID> dengan ID Docker Anda.
Gunakan perintah ini untuk mendorong kontainer ke instans registri Anda:
```
docker push <LOGIN_SERVER>/azurefunctionsimage:v1.0.0
```

Docker Hub adalah registri kontainer yang menghosting gambar dan menyediakan layanan gambar dan kontainer.

Jika Anda belum masuk ke Docker, lakukan dengan docker login perintah , ganti <docker_id> dengan ID akun Docker Hub Anda. Perintah ini meminta nama pengguna dan kata sandi Anda. Pesan "Masuk Berhasil" mengonfirmasi bahwa Anda masuk.
```
docker login
```
Setelah Anda masuk, dorong gambar ke Docker Hub dengan menggunakan docker push perintah , ganti <docker_id> lagi dengan ID akun Docker Hub Anda.
```
docker push <DOCKER_ID>/azurefunctionsimage:v1.0.0
```
Tergantung pada kecepatan jaringan Anda, mendorong gambar untuk pertama kalinya mungkin memakan waktu beberapa menit. Perubahan berikutnya didorong lebih cepat.

Langkah berikutnya

Bekerja dengan kontainer dan Azure Functions

Bagikan melalui