Hızlı Başlangıç: PowerShell Dayanıklı İşlevler uygulaması oluşturma

Sunucusuz bir ortamda durum bilgisi olan işlevleri yazmak için Azure İşlevleri özelliği olan Dayanıklı İşlevler kullanın. Visual Studio Code'da Azure İşlevleri uzantısını yükleyerek Dayanıklı İşlevler yüklersiniz. Uzantı, uygulamanızdaki durumu, denetim noktalarını ve yeniden başlatmaları yönetir.

Bu hızlı başlangıçta Visual Studio Code'daki Dayanıklı İşlevler uzantısını kullanarak Azure İşlevleri'de yerel olarak bir "merhaba dünya" Dayanıklı İşlevler uygulaması oluşturup test edebilirsiniz. Dayanıklı İşlevler uygulaması diğer işlevlere çağrıları düzenler ve zincirler. Ardından işlev kodunu Azure'da yayımlarsınız. Kullandığınız araçlar Visual Studio Code uzantısı aracılığıyla kullanılabilir.

Önkoşullar

Bu hızlı başlangıcı tamamlamak için şunlar gerekir:

• Visual Studio Code yüklü.

• Visual Studio Code uzantısı Azure İşlevleri yüklendi.

• Azure İşlevleri Core Tools'un en son sürümü yüklü.

• Azure aboneliği. Dayanıklı İşlevler kullanmak için bir Azure Depolama hesabınız olmalıdır.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Yerel projenizi oluşturma

Bu bölümde, yerel bir Azure İşlevleri projesi oluşturmak için Visual Studio Code'u kullanacaksınız.

1. Visual Studio Code'da komut paletini açmak için F1'i seçin (veya Ctrl/Cmd+Shift+P'yi seçin). İstemde ()> girin ve Azure İşlevleri: Yeni Proje Oluştur'u seçin.

   

2. Göz At'ı seçin. Klasör Seç iletişim kutusunda, projeniz için kullanılacak klasöre gidin ve Seç'i seçin.

3. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşlev uygulaması projeniz için bir dil seçin	PowerShell'i seçin.	Yerel bir PowerShell İşlevleri projesi oluşturur.
   Bir sürüm seçin	Azure İşlevleri v4'i seçin.	Bu seçeneği yalnızca Çekirdek Araçlar henüz yüklü olmadığında görürsünüz. Bu durumda, uygulamayı ilk kez çalıştırdığınızda Core Tools yüklenir.
   Projenizin ilk işlevi için bir şablon seçin	Şimdilik atla'yı seçin.
   Projenizi nasıl açmak istediğinizi seçin	Geçerli pencerede aç'ı seçin.	Seçtiğiniz klasörde Visual Studio Code'un açılmasını sağlar.

Visual Studio Code, proje oluşturmak için gerekliyse Azure İşlevleri Temel Araçları yükler. Ayrıca bir klasörde bir işlev uygulaması projesi oluşturur. Bu proje host.json ve local.settings.json yapılandırma dosyalarını içerir.

Kök klasörde bir package.json dosyası da oluşturulur.

İşlev uygulamasını PowerShell 7 kullanacak şekilde yapılandırma

local.settings.json dosyasını açın ve adlı FUNCTIONS_WORKER_RUNTIME_VERSION ayarın olarak ~7ayarlandığını onaylayın. Eksikse veya başka bir değere ayarlanmışsa dosyanın içeriğini güncelleştirin.

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "",
    "FUNCTIONS_WORKER_RUNTIME": "powershell",
    "FUNCTIONS_WORKER_RUNTIME_VERSION" : "~7"
  }
}

İşlevlerinizi oluşturma

En temel Dayanıklı İşlevler uygulamasının üç işlevi vardır:

• Orchestrator işlevi: Diğer işlevleri düzenleyen bir iş akışı.
• Etkinlik işlevi: Orchestrator işlevi tarafından çağrılan, iş gerçekleştiren ve isteğe bağlı olarak bir değer döndüren işlev.
• İstemci işlevi: Azure'da düzenleyici işlevi başlatan normal bir işlevdir. Bu örnekte HTTP ile tetiklenen bir işlev kullanılır.

Orchestrator işlevi

Projenizde Dayanıklı İşlevler uygulama kodunu oluşturmak için bir şablon kullanın.

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	Dayanıklı İşlevler düzenleyici girin.	Dayanıklı İşlevler uygulama düzenlemesi oluşturur.
   İşlev adı belirtin	HelloOrchestrator girin.	Dayanıklı işlevinizin adı.

Etkinlik işlevlerini koordine etmek için bir düzenleyici eklediniz. Orchestrator işlevini görmek için HelloOrchestrator/run.ps1 dosyasını açın. Invoke-ActivityFunction cmdlet'ine yapılan her çağrı adlı Hellobir etkinlik işlevini çağırır.

Ardından, başvuruda Hello bulunan etkinlik işlevini eklersiniz.

Activity işlevi

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	Dayanıklı İşlevler etkinliği seçin.	Etkinlik işlevi oluşturur.
   İşlev adı belirtin	Merhaba yazın.	Etkinlik işlevinizin adı.

Düzenleyici tarafından çağrılan etkinlik işlevini eklediniz Hello . Giriş olarak bir ad alıp selamlama döndürdüğünü görmek için Hello/run.ps1 dosyasını açın. Etkinlik işlevi, veritabanı çağrısı yapma veya hesaplama gerçekleştirme gibi eylemleri gerçekleştirdiğiniz yerdir.

Son olarak, düzenlemeyi başlatan HTTP ile tetiklenen bir işlev eklersiniz.

İstemci işlevi (HTTP starter)

1. Komut paletine girin ve Azure İşlevleri: İşlev Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem	Açıklama
   İşleviniz için şablon seçme	HTTP başlatıcı Dayanıklı İşlevler seçin.	BIR HTTP starter işlevi oluşturur.
   İşlev adı belirtin	HttpStart girin.	Etkinlik işlevinizin adı.
   Yetkilendirme düzeyi	Anonim'i seçin.	Tanıtım amacıyla bu değer, işlevin kimlik doğrulaması kullanılmadan çağrılmasını sağlar.

Düzenlemeyi başlatan HTTP ile tetiklenen bir işlev eklediniz. Yeni bir düzenleme başlatmak için Start-NewOrchestration cmdlet'ini kullanıp kullanmadığını denetlemek için HttpStart/run.ps1 dosyasını açın. Ardından New-OrchestrationCheckStatusResponse cmdlet'ini kullanarak yeni düzenlemeyi izlemek ve yönetmek için kullanılabilecek URL'leri içeren bir HTTP yanıtı döndürür.

Artık yerel olarak çalıştırabileceğiniz ve Azure'a dağıtabileceğiniz bir Dayanıklı İşlevler uygulamanız var.

Not

Dayanıklı İşlevler PowerShell uygulamasının sonraki sürümü artık önizleme aşamasındadır. PowerShell Galerisi indirebilirsiniz. Bu konuda daha fazla bilgi edinin ve tek başına PowerShell SDK'sı kılavuzunda nasıl deneyeceğinizi öğrenin. Etkinleştirmek için bu hızlı başlangıçla uyumlu yönergeler için kılavuzun yükleme bölümünü izleyebilirsiniz.

İşlevi yerel olarak test etme

Azure İşlevleri Temel Araçları, yerel geliştirme bilgisayarınızda bir Azure İşlevleri projesi çalıştırma olanağı sağlar. Visual Studio'da ilk kez bir işlev başlattığınızda bu araçları yüklemeniz istenir.

1. İşlevinizi test etmek için etkinlik işlev kodunda Hello (Hello/run.ps1 içinde) bir kesme noktası ayarlayın. İşlev uygulaması projesini başlatmak için F5'i seçin veya komut paletinde Hata Ayıkla: Hata Ayıklamayı Başlat'ı seçin. Temel Araçlar'dan alınan çıkış, terminal panelinde görünür.

   Not

   Hata ayıklama hakkında daha fazla bilgi için bkz. tanılama Dayanıklı İşlevler.

2. Dayanıklı İşlevler çalıştırmak için bir Azure depolama hesabı gerekir. Visual Studio Code bir depolama hesabı seçmenizi isterken Depolama hesabı seç'i seçin.

   

3. İstemlerde, Azure'da yeni bir depolama hesabı oluşturmak için aşağıdaki bilgileri sağlayın.

   İstem	Eylem	Açıklama
   Aboneliği seçin	Aboneliğinizin adını seçin.	Azure aboneliğiniz.
   Depolama hesabı seçme	Yeni depolama hesabı oluştur'u seçin.
   Yeni depolama hesabının adını girin	Benzersiz bir ad girin.	Oluşturulacak depolama hesabının adı.
   Kaynak grubu seçme	Benzersiz bir ad girin.	Oluşturulacak kaynak grubunun adı.
   Konum seçin	Bir Azure bölgesi seçin.	Size yakın bir bölge seçin.

4. Terminal panelinde HTTP ile tetiklenen işlevinizin URL uç noktasını kopyalayın.

   

5. URL uç noktasına HTTP POST isteği göndermek için tarayıcınızı veya bu HTTP test araçlarından birini kullanın:

   • Visual Studio Market'ten uzantılı Visual Studio Code
   • PowerShell Invoke-RestMethod
   • Microsoft Edge - Ağ Konsolu aracı
   • Bruno
   • Curl

   Dikkat

   Kimlik bilgileri, gizli diziler, erişim belirteçleri, API anahtarları ve diğer benzer bilgiler gibi hassas verileriniz olduğu senaryolarda, verilerinizi gerekli güvenlik özellikleriyle koruyan, çevrimdışı veya yerel olarak çalışan, verilerinizi bulutla eşitlemeyen ve çevrimiçi bir hesapta oturum açmanızı gerektirmeyen bir araç kullandığınızdan emin olun. Bu şekilde, hassas verileri herkese açık hale getirmekle ilgili riski azaltırsınız.

   Son segmenti orchestrator işlevinin (HelloOrchestrator) adıyla değiştirin. URL ile benzer http://localhost:7071/api/orchestrators/HelloOrchestratorolmalıdır.

   Yanıt, HTTP işlevinin ilk sonucudur. Dayanıklı düzenlemenin başarıyla başladığını size bildirir. Henüz düzenlemenin sonunu görüntülemez. Yanıt birkaç yararlı URL içerir. Şimdilik düzenlemenin durumunu sorgula.

6. url statusQueryGetUrideğerini kopyalayın, tarayıcının adres çubuğuna yapıştırın ve isteği yürütür. AYRıCA, GET isteğini vermek için HTTP test aracınızı kullanmaya devam edebilirsiniz.

   İstek, durum için düzenleme örneğini sorgular. Örneğin tamamlandığını gösteren ve dayanıklı işlevin çıkışlarını veya sonuçlarını içeren nihai bir yanıt almanız gerekir. Şu örneğe benzer:

   {
       "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. Hata ayıklamayı durdurmak için Visual Studio Code'da Shift+F5'i seçin.

İşlevin yerel bilgisayarınızda doğru şekilde çalıştığını doğruladıktan sonra projeyi Azure'da yayımlamanın zamanı geldi.

Azure'da oturum açma

Azure kaynakları oluşturabilmeniz veya uygulamanızı yayımlayabilmeniz için önce Azure'da oturum açmanız gerekir.

1. Henüz oturum açmadıysanız Etkinlik çubuğunda Azure simgesini seçin. Ardından Kaynaklar'ın altında Azure'da oturum aç'ı seçin.

   

   Zaten oturum açtıysanız ve mevcut aboneliklerinizi görebiliyorsanız sonraki bölüme gidin. Henüz bir Azure hesabınız yoksa Azure Hesabı Oluştur'u seçin. Öğrenciler Öğrenciler için Azure Hesabı Oluştur'u seçebilir.

2. Tarayıcıda sorulduğunda Azure hesabınızı seçin ve Azure hesabı kimlik bilgilerinizi kullanarak oturum açın. Yeni bir hesap oluşturursanız, hesabınız oluşturulduktan sonra oturum açabilirsiniz.

3. Başarıyla oturum açtığınızda yeni tarayıcı penceresini kapatabilirsiniz. Azure hesabınıza ait abonelikler yan çubukta görüntülenir.

Azure'da işlev uygulamasını oluşturma

Bu bölümde, Azure aboneliğinizde bir işlev uygulaması ve ilgili kaynaklar oluşturacaksınız. Kaynak oluşturma kararlarının çoğu sizin için varsayılan davranışlara göre yapılır.

1. Visual Studio Code'da F1'i seçerek komut paletini açın. İstemde ()> girin ve Azure İşlevleri: Azure'da İşlev Uygulaması Oluştur'u seçin.

2. İstemlerde aşağıdaki bilgileri sağlayın:

   İstem	Eylem
   Aboneliği seçin	Kullanılacak Azure aboneliğini seçin. Kaynaklar altında yalnızca bir aboneliğiniz görünür olduğunda istem görünmez.
   İşlev uygulaması için genel olarak benzersiz bir ad girin	URL yolunda geçerli bir ad girin. Girdiğiniz ad, Azure İşlevleri benzersiz olduğundan emin olmak için doğrulanır.
   Çalışma zamanı yığını seçme	Şu anda yerel olarak çalıştırdığınız dil sürümünü seçin.
   Yeni kaynaklar için bir konum seçin	Bir Azure bölgesi seçin. Daha iyi performans için size yakın bir bölge seçin.

   Azure: Etkinlik Günlüğü panelinde Azure uzantısı, Azure'da oluşturulan tek tek kaynakların durumunu gösterir.

   

3. İşlev uygulaması oluşturulduğunda, Azure aboneliğinizde aşağıdaki ilgili kaynaklar oluşturulur. Kaynaklar, işlev uygulamanız için girdiğiniz ada göre adlandırılır.

   • İlgili kaynaklar için mantıksal bir kapsayıcı olan kaynak grubu.
   • Projeleriniz hakkındaki durumu ve diğer bilgileri koruyan standart bir Azure Depolama hesabı.
   • İşlev kodunuzu yürütmek için ortam sağlayan bir işlev uygulaması. İşlev uygulaması, aynı barındırma planı içindeki 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.
   • İşlev uygulamanız için temel konağı tanımlayan bir Azure Uygulaması Hizmeti planı.
   • İşlev uygulamasına bağlı olan ve uygulamadaki işlevlerinizin kullanımını izleyen bir Application Insights örneği.

   İşlev uygulamanız oluşturulduktan sonra bir bildirim görüntülenir ve dağıtım paketi uygulanır.

   İpucu

   Varsayılan olarak, işlev uygulamanız için gereken Azure kaynakları işlev uygulamanız için girdiğiniz ada göre oluşturulur. Varsayılan olarak, kaynaklar işlev uygulamasıyla aynı, yeni kaynak grubunda oluşturulur. İlişkili kaynakların adlarını özelleştirmek veya mevcut kaynakları yeniden kullanmak istiyorsanız, projeyi gelişmiş oluşturma seçenekleriyle yayımlayın.

Projeyi Azure’a dağıtma

Önemli

Mevcut bir işlev uygulamasına dağıtılması her zaman Azure'da bu uygulamanın içeriğinin üzerine yazılır.

1. Komut paletine girin ve Azure İşlevleri: İşlev Uygulamasına Dağıt'ı seçin.

2. Yeni oluşturduğunuz işlev uygulamasını seçin. Önceki dağıtımların üzerine yazmanız istendiğinde, işlev kodunuzu yeni işlev uygulaması kaynağına dağıtmak için Dağıt'ı seçin.

3. Dağıtım tamamlandığında, oluşturduğunuz Azure kaynakları da dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için Çıkışı Görüntüle'yi seçin. Bildirimi kaçırırsanız, yeniden görmek için sağ alt köşedeki zil simgesini seçin.

   

Azure'da işlevinizi test etme

1. Çıkış panelinden HTTP tetikleyicisinin URL'sini kopyalayın. HTTP ile tetiklenen işlevinizi çağıran URL şu biçimde olmalıdır:

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

2. HTTP isteğinin yeni URL'sini tarayıcınızın adres çubuğuna yapıştırın. Yayımlanan uygulamayı kullandığınızda, yerel olarak test ettiğinizde elde ettiğiniz durum yanıtının aynısını almayı bekleyebilirsiniz.

Visual Studio Code kullanarak oluşturduğunuz ve yayımladığınız PowerShell Dayanıklı İşlevler uygulaması kullanıma hazırdır.

Kaynakları temizleme

Hızlı başlangıcı tamamlamak için oluşturduğunuz kaynaklara artık ihtiyacınız yoksa, Azure aboneliğinizde ilgili maliyetleri önlemek için kaynak grubunu ve tüm ilgili kaynakları silin.

İlgili içerik

• Yaygın Dayanıklı İşlevler uygulama desenleri hakkında bilgi edinin.