İlk kapsayıcılı Azure İşlevleri oluşturma
Bu makalede, Linux kapsayıcısında çalışan bir işlev uygulaması oluşturacak ve Azure İşlevleri dağıtacaksınız.
İşlev kodunuzu kapsayıcıdaki Azure İşlevleri dağıtmak için Premium plan veya Ayrılmış (App Service) planı barındırma gerekir. Bu makalenin tamamlanması, Azure hesabınızda birkaç ABD dolarının maliyetine neden olur ve işiniz bittiğinde kaynakları temizleyerek en aza indirebilirsiniz.
İşlev uygulaması kapsayıcınızı Azure'a dağıtmaya yönelik diğer seçenekler şunlardır:
Azure Container Apps: Daha fazla bilgi edinmek için bkz . Azure Container uygulamalarına kapsayıcı dağıtma.
Azure Arc (şu anda önizleme aşamasında): Daha fazla bilgi edinmek için bkz . Azure Arc'a kapsayıcı dağıtma.
Geliştirme dilinizi seçin
İlk olarak, docker kapsayıcısında dile özgü linux temel görüntüsü kullanarak proje kodunuzu işlev uygulaması olarak oluşturmak için Azure İşlevleri araçlarını kullanırsınız. Makalenin üst kısmında istediğiniz dili seçtiğinizden emin olun.
Çekirdek Araçlar, projeniz için otomatik olarak işlev diliniz için doğru temel görüntünün en güncel sürümünü kullanan bir Dockerfile oluşturur. Kapsayıcınızı en son temel görüntüden düzenli olarak güncelleştirmeli ve kapsayıcınızın güncelleştirilmiş sürümünden yeniden dağıtmalısınız. Daha fazla bilgi için bkz . Kapsayıcılı işlev uygulamaları oluşturma.
Önkoşullar
Başlamadan önce aşağıdaki gereksinimleri karşılamanız gerekir:
Azure İşlevleri Core Tools sürüm 4.0.5198'i veya sonraki bir sürümü yükleyin.
- Azure İşlevleri Core Tools sürüm 4.x'i yükleyin.
- Azure İşlevleri tarafından desteklenen bir Node.js sürümü yükleyin.
- Azure İşlevleri tarafından desteklenen bir Python sürümü yükleyin.
Java Geliştirici Seti'nin Azure İşlevleri tarafından desteklenen bir sürümünü yükleyin.
Apache Maven sürüm 3.0 veya üzerini yükleyin.
- Azure CLI sürüm 2.4 veya sonraki bir sürüm.
Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.
Oluşturduğunuz kapsayıcılı işlev uygulaması görüntüsünü bir kapsayıcı kayıt defterinde yayımlamak için yerel bilgisayarınızda çalışan bir Docker Kimliği ve Docker gerekir. Docker kimliğiniz yoksa bir Docker hesabı oluşturabilirsiniz.
Kayıt defteri örneği oluşturmak için Container Registry hızlı başlangıcının Kapsayıcı kayıt defteri oluşturma bölümünü de tamamlamanız gerekir. Tam oturum açma sunucusu adınızı not edin.
Sanal ortam oluşturma ve etkinleştirme
Uygun bir klasörde aşağıdaki komutları çalıştırarak adlı .venv
bir sanal ortam oluşturun ve etkinleştirin. Azure İşlevleri tarafından desteklenen Python sürümlerinden birini kullandığınızdan emin olun.
python -m venv .venv
source .venv/bin/activate
Python venv paketini Linux dağıtımınıza yüklemediyse aşağıdaki komutu çalıştırın:
sudo apt-get install python3-venv
Bu etkinleştirilmiş sanal ortamda sonraki tüm komutları çalıştırırsınız.
Yerel işlevler projesini oluşturma ve test etme
Terminalde veya komut isteminde, geçerli klasörde bir işlev uygulaması projesi oluşturmak için seçtiğiniz dil için aşağıdaki komutu çalıştırın:
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
Boş bir klasörde aşağıdaki komutu çalıştırarak İşlevler projesini bir Maven arketipinden oluşturun:
mvn archetype:generate -DarchetypeGroupId=com.microsoft.azure -DarchetypeArtifactId=azure-functions-archetype -DjavaVersion=8 -Ddocker
parametresi İşlevler -DjavaVersion
çalışma zamanına hangi Java sürümünün kullanılacağını bildirir. İşlevlerinizin Java 11 üzerinde çalışmasını istiyorsanız -DjavaVersion=11
ifadesini kullanın. belirtmediğinizde Maven varsayılan olarak Java 8'i kullanır -DjavaVersion
. Daha fazla bilgi için bkz . Java sürümleri.
Önemli
Bu JAVA_HOME
makaleyi tamamlamak için ortam değişkeni, JDK'nin doğru sürümünün yükleme konumuna ayarlanmalıdır.
Maven, projeyi dağıtımda oluşturma işlemini tamamlamak için gereken değerleri ister. istemleri izleyin ve aşağıdaki bilgileri sağlayın:
İstem | Value | Açıklama |
---|---|---|
groupId | com.fabrikam |
Java için paket adlandırma kurallarını izleyerek projenizi tüm projelerde benzersiz olarak tanımlayan bir değer. |
artifactId | fabrikam-functions |
Sürüm numarası olmayan jar'ın adı olan bir değer. |
version | 1.0-SNAPSHOT |
Varsayılan değeri seçin. |
paket | com.fabrikam.functions |
Oluşturulan işlev kodu için Java paketi olan bir değer. Varsayılan değeri kullanın. |
Onaylamak için Enter tuşuna basın Y
.
Maven, proje dosyalarını artifactId adlı yeni bir klasörde oluşturur. Bu örnekte şöyledirfabrikam-functions
: .
seçeneği--docker
, proje için Azure İşlevleri ve seçilen çalışma zamanıyla kullanmak için uygun bir kapsayıcı tanımlayan bir Dockerfile oluşturur.
Proje klasörüne gidin:
cd fabrikam-functions
Aşağıdaki komutu kullanarak projenize işlev ekleyin. Burada --name
bağımsız değişken işlevinizin benzersiz adıdır ve --template
bağımsız değişken işlevin tetikleyicisini belirtir. func new
projenizde bir C# kod dosyası oluşturur.
func new --name HttpExample --template "HTTP trigger"
Aşağıdaki komutu kullanarak projenize işlev ekleyin. Burada --name
bağımsız değişken işlevinizin benzersiz adıdır ve --template
bağımsız değişken işlevin tetikleyicisini belirtir. func new
, function.json adlı bir yapılandırma dosyası içeren işlev adıyla eşleşen bir alt klasör oluşturur.
func new --name HttpExample --template "HTTP trigger"
İşlevi yerel olarak test etmek için proje klasörünün kökünde yerel Azure İşlevleri çalışma zamanı ana bilgisayarını başlatın.
func start
func start
npm install
npm start
mvn clean package
mvn azure-functions:run
Çıkışa HttpExample
yazılan uç noktayı gördükkten sonra bu uç noktaya gidin. Yanıt çıkışında bir karşılama iletisi görmeniz gerekir.
Çıkışa HttpExample
yazılan uç noktayı gördükkten sonra adresine http://localhost:7071/api/HttpExample?name=Functions
gidin. Tarayıcının, sorgu parametresine sağlanan değeri geri Functions
döndüren bir "hello" iletisi görüntülemesi name
gerekir.
Konağı durdurmak için Ctrl+C (macOS'ta C Komutu+) tuşlarına basın.
Kapsayıcı görüntüsünü oluşturma ve yerel olarak doğrulama
(İsteğe bağlı) Proje klasörünün kökündeki Dockerfile dosyasını inceleyin. Dockerfile, linux üzerinde işlev uygulamasını çalıştırmak için gerekli ortamı açıklar. Azure İşlevleri için desteklenen temel görüntülerin tam listesi Azure İşlevleri temel görüntü sayfasında bulunabilir.
Kök proje klasöründe docker build komutunu çalıştırın, olarak bir ad sağlayın ve olarak azurefunctionsimage
v1.0.0
etiketleyin. <DOCKER_ID>
değerini Docker Hub hesabınızın kimliğiyle değiştirin. Bu komut, kapsayıcı için Docker görüntüsünü derler.
docker build --tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 .
Komut tamamlandığında, yeni kapsayıcıyı yerel olarak çalıştırabilirsiniz.
Derlemeyi doğrulamak için docker run komutunu kullanarak görüntüyü yerel bir kapsayıcıda çalıştırın, yerine <DOCKER_ID>
Docker Hub hesap kimliğinizi yazın ve bağlantı noktaları bağımsız değişkenini olarak -p 8080:80
ekleyin:
docker run -p 8080:80 -it <DOCKER_ID>/azurefunctionsimage:v1.0.0
Görüntü yerel kapsayıcıda başladıktan sonra, öncekiyle aynı karşılama iletisini görüntülemesi gereken öğesine göz atın http://localhost:8080/api/HttpExample
. Oluşturduğunuz HTTP ile tetiklenen işlev anonim yetkilendirme kullandığından, erişim anahtarı almak zorunda kalmadan kapsayıcıda çalışan işlevi çağırabilirsiniz. Daha fazla bilgi için bkz . Yetkilendirme anahtarları.
Görüntü yerel kapsayıcıda başladıktan sonra, öncekiyle aynı "hello" iletisini görüntülemesi gereken öğesine gidin http://localhost:8080/api/HttpExample?name=Functions
. Oluşturduğunuz HTTP ile tetiklenen işlev anonim yetkilendirme kullandığından, erişim anahtarı almak zorunda kalmadan kapsayıcıda çalışan işlevi çağırabilirsiniz. Daha fazla bilgi için bkz . Yetkilendirme anahtarları.
Kapsayıcıdaki işlev uygulamasını doğruladıktan sonra yürütmeyi durdurmak için Ctrl+C (macOS'ta C Komutu+) tuşlarına basın.
Kapsayıcı görüntüsünü kayıt defterinde yayımlama
Kapsayıcı görüntünüzü bir barındırma ortamına dağıtım için kullanılabilir hale getirmek için kapsayıcı kayıt defterine göndermeniz gerekir.
Azure Container Registry, kapsayıcı görüntülerini ve ilgili yapıtları oluşturmaya, depolamaya ve yönetmeye yönelik özel bir kayıt defteri hizmetidir. Kapsayıcılarınızı Azure hizmetlerinde yayımlamak için özel bir kayıt defteri hizmeti kullanmalısınız.
Geçerli Azure kimlik bilgilerinizi kullanarak kayıt defteri örneğinizde oturum açmak için şu komutu kullanın:
az acr login --name <REGISTRY_NAME>
Önceki komutta değerini Container Registry örneğinizin adıyla değiştirin
<REGISTRY_NAME>
.Görüntünüzü kayıt defteri oturum açma sunucunuzun tam adıyla etiketlemek için şu komutu kullanın:
docker tag <DOCKER_ID>/azurefunctionsimage:v1.0.0 <LOGIN_SERVER>/azurefunctionsimage:v1.0.0
değerini kayıt defteri oturum açma sunucunuzun tam adıyla ve
<DOCKER_ID>
Docker kimliğiniz ile değiştirin<LOGIN_SERVER>
.Kapsayıcıyı kayıt defteri örneğine göndermek için şu komutu kullanın:
docker push <LOGIN_SERVER>/azurefunctionsimage:v1.0.0
İşleviniz için destekleyici Azure kaynakları oluşturma
Kapsayıcınızı Azure'a dağıtmadan önce üç kaynak oluşturmanız gerekir:
- İlgili kaynaklar için mantıksal bir kapsayıcı olan kaynak grubu.
- İşlevleriniz hakkındaki durumu ve diğer bilgileri korumak için kullanılan bir Depolama hesabı.
- İşlev kodunuzu yürütmek için ortam sağlayan bir işlev uygulaması. İşlev uygulaması yerel işlev projenize eşler ve kaynakların daha kolay yönetilmesi, dağıtılması ve paylaşılması için işlevleri mantıksal birim olarak gruplandırmanıza olanak tanır.
Bu öğeleri oluşturmak için aşağıdaki komutları kullanın. Hem Azure CLI hem de PowerShell desteklenir. Azure PowerShell kullanarak Azure kaynaklarınızı oluşturmak için Az PowerShell modülü, sürüm 5.9.0 veya üzeri de gereklidir.
Henüz yapmadıysanız Azure'da oturum açın.
az login
Komutu sizi
az login
Azure hesabınızda oturum açar.Seçtiğiniz bölgede adlı
AzureFunctionsContainers-rg
bir kaynak grubu oluşturun.az group create --name AzureFunctionsContainers-rg --location <REGION>
az group create
komutu bir kaynak grubu oluşturur. Yukarıdaki komutta, az account list-locations komutundan döndürülen kullanılabilir bir bölge kodunu kullanarak değerini yakınınızdaki bir bölgeyle değiştirin<REGION>
.Kaynak grubunuz ve bölgenizde genel amaçlı bir depolama hesabı oluşturun.
az storage account create --name <STORAGE_NAME> --location <REGION> --resource-group AzureFunctionsContainers-rg --sku Standard_LRS
az storage account create
komutu depolama hesabını oluşturur.Önceki örnekte değerini size uygun ve Azure Depolama'da benzersiz bir adla değiştirin
<STORAGE_NAME>
. Depolama adları yalnızca 3 ile 24 karakter arasında sayı ve küçük harf içermelidir.Standard_LRS
İşlevler tarafından desteklenen genel amaçlı bir hesap belirtir.komutunu kullanarak Elastik Premium 1 fiyatlandırma katmanında ( ), kendi ve
<REGION>
linux kapsayıcısında (--is-linux
--sku EP1
adlımyPremiumPlan
Azure İşlevleri için bir Premium plan oluşturun.az functionapp plan create --resource-group AzureFunctionsContainers-rg --name myPremiumPlan --location <REGION> --number-of-workers 1 --sku EP1 --is-linux
Premium planı burada kullanırız ve bu plan gerektiğinde ölçeklendirilebilir. Barındırma hakkında daha fazla bilgi için bkz. Azure İşlevleri barındırma planları karşılaştırması. Maliyetleri hesaplama hakkında daha fazla bilgi için İşlevler fiyatlandırma sayfasına bakın.
Komut aynı kaynak grubunda, işlev uygulamanızı izleyip günlükleri görüntüleyebileceğiniz ilişkili bir Azure Uygulaması lication Insights örneği de oluşturur. Daha fazla bilgi için bkz. İzleme Azure İşlevleri. Örnek, siz etkinleştirene kadar ücret ödemez.
Görüntüyle Azure'da işlev uygulaması oluşturma ve yapılandırma
Azure'daki bir işlev uygulaması, Azure İşlevleri barındırma planınızda işlevlerinizin yürütülmesini yönetir. Bu bölümde, önceki bölümde yer alan Azure kaynaklarını kullanarak kapsayıcı kayıt defterindeki bir görüntüden işlev uygulaması oluşturacak ve bunu Azure Depolama'ya bağlantı dizesi yapılandıracaksınız.
Kapsayıcı kayıt defterinize bağlı olarak aşağıdaki komutu kullanarak bir işlev uygulaması oluşturun:
az functionapp create --name <APP_NAME> --storage-account <STORAGE_NAME> --resource-group AzureFunctionsContainers-rg --plan myPremiumPlan --image <LOGIN_SERVER>/azurefunctionsimage:v1.0.0 --registry-username <USERNAME> --registry-password <SECURE_PASSWORD>
Bu örnekte değerini depolama hesabı için önceki bölümde kullandığınız adla değiştirin
<STORAGE_NAME>
. Ayrıca değerini size uygun genel olarak benzersiz bir adla veya<DOCKER_ID>
<LOGIN_SERVER>
sırasıyla Docker Hub hesap kimliğiniz veya Container Registry sunucunuzla değiştirin<APP_NAME>
. Özel bir kapsayıcı kayıt defterinden dağıtım yaparken, görüntü adı kayıt defterinin URL'sini gösterir.İşlev uygulamasını ilk oluşturduğunuzda, ilk görüntüyü Docker Hub'ınızdan çeker. Kapsayıcı kayıt defterinizden Azure'a sürekli dağıtımı etkinleştirebilirsiniz.
İpucu
ANSI denetim karakterlerinin
DisableColor
kapsayıcı günlüklerine yazılmasını önlemek için host.json dosyasındaki ayarı kullanabilirsiniz.Oluşturduğunuz depolama hesabının bağlantı dizesi almak için aşağıdaki komutu kullanın:
az storage account show-connection-string --resource-group AzureFunctionsContainers-rg --name <STORAGE_NAME> --query connectionString --output tsv
Depolama hesabının bağlantı dizesi komutu kullanılarak
az storage account show-connection-string
döndürülür.değerini daha önce oluşturduğunuz depolama hesabının adıyla değiştirin
<STORAGE_NAME>
.ayarı işlev uygulamasına eklemek için aşağıdaki komutu kullanın:
az functionapp config appsettings set --name <APP_NAME> --resource-group AzureFunctionsContainers-rg --settings AzureWebJobsStorage=<CONNECTION_STRING>
az functionapp config appsettings set
komutu ayarı oluşturur.Bu komutta değerini işlev uygulamanızın adıyla ve
<CONNECTION_STRING>
önceki adımdaki bağlantı dizesi ile değiştirin<APP_NAME>
. Bağlantı, ileDefaultEndpointProtocol=
başlayan uzun kodlanmış bir dize olmalıdır.İşlev artık depolama hesabına erişmek için bu bağlantı dizesi kullanabilir.
Azure'da işlevlerinizi doğrulama
Görüntü Azure'daki işlev uygulamanıza dağıtıldığında artık HTTP istekleri aracılığıyla işlevi çağırabilirsiniz.
Yeni işlevinizin URL'sini almak için aşağıdaki
az functionapp function show
komutu çalıştırın:az functionapp function show --resource-group AzureFunctionsContainers-rg --name <APP_NAME> --function-name HttpExample --query invokeUrlTemplate
değerini işlev uygulamanızın adıyla değiştirin
<APP_NAME>
.
- Sorgu dizesini
?name=Functions
ekleyerek işlev uç noktasını çağırmakHttpExample
için az önce aldığınız URL'yi kullanın.
- İşlev uç noktasını çağırmak için az önce aldığınız URL'yi
HttpExample
kullanın.
Bu URL'ye gittiğinizde, tarayıcının işlevi yerel olarak çalıştırdığınızdakine benzer bir çıkış görüntülemesi gerekir.
Kaynakları temizleme
Bu makalede oluşturduğunuz kaynakları kullanarak Azure İşlevi ile çalışmaya devam etmek istiyorsanız, tüm bu kaynakları yerinde bırakabilirsiniz. Azure İşlevleri için bir Premium Plan oluşturduğunuz için devam eden maliyetler için günde bir veya iki ABD doları ücretlendirilirsiniz.
Devam eden maliyetleri önlemek için kaynak grubunu silip AzureFunctionsContainers-rg
bu gruptaki tüm kaynakları temizleyin:
az group delete --name AzureFunctionsContainers-rg