Hızlı başlangıç: Visual Studio Code kullanarak Azure 'da PowerShell işlevi oluşturma

bu makalede, HTTP isteklerine yanıt veren bir PowerShell işlevi oluşturmak için Visual Studio Code kullanırsınız. Kodu yerel olarak test ettikten sonra, Azure Işlevlerinin sunucusuz ortamına dağıtırsınız.

Bu hızlı başlangıcı tamamlamak, Azure hesabınızda birkaç ABD Doları veya daha kısa bir ücret doğurur.

Bu makalenin CLI tabanlı bir sürümü de vardır.

Ortamınızı yapılandırma

Başlamadan önce, aşağıdaki gereksinimlerin yerinde olduğundan emin olun:

• Etkin aboneliği olan bir Azure hesabı. Ücretsiz hesap oluşturun.

• Azure Functions Core Tools sürüm 3. x.

• PowerShell 7

• Hem .net core 3,1 çalışma zamanı hem de .NET Core 2,1 çalışma zamanı

• Desteklenen platformlardan birinde çalışan Visual Studio Code.

• Visual Studio Code Için PowerShell uzantısı.

• Visual Studio Code için Azure İşlevleri uzantısı.

Yerel projenizi oluşturma

bu bölümde, PowerShell 'de yerel bir Azure işlevleri projesi oluşturmak için Visual Studio Code kullanırsınız. Bu makalenin ilerleyen bölümlerinde işlev kodunu Azure'da yayımlayacaksınız.

1. Etkinlik çubuğundan Azure simgesini seçtikten sonra Azure: İşlevler alanında Yeni proje oluştur... simgesini seçin.

   

2. Projenizin çalışma alanı için bir dizin konumu seçtikten sonra Seç'i belirleyin.

   Not

   Bu adımlar, bir çalışma alanının dışında tamamlanacak şekilde tasarlandı. Bu örnekte, bir çalışma alanının parçası olan bir proje klasörünü seçmeyin.

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

   • İşlev projeniz için bir dil seçin: PowerShell öğesini seçin.

   • Projenizin ilk işlevi için bir şablon seçin: HTTP trigger öğesini seçin.

   • Bir işlev adı sağlayın: HttpExample yazın.

   • Yetkilendirme düzeyi: Anonymous herhangi bir kişinin işlev uç noktanızı çağırmasını sağlayan öğesini seçin. Yetkilendirme düzeyi hakkında bilgi edinmek için bkz. Yetkilendirme anahtarları.

   • Projenizi nasıl açmak istediğinizi seçin: Add to workspace öğesini seçin.

4. bu bilgileri kullanarak, Visual Studio Code HTTP tetikleyicisiyle bir Azure işlevleri projesi oluşturur. Yerel proje dosyalarını Gezgin içinde görüntüleyebilirsiniz. Oluşturulan dosyalar hakkında daha fazla bilgi edinmek için bkz. oluşturulan proje dosyaları.

İşlevi yerel olarak çalıştırma

Visual Studio Code, Azure'Azure İşlevleri yayımlamadan önce bu projeyi yerel geliştirme bilgisayarınızda çalıştırmanıza izin vermenizi sağlar.

1. İşlevini çağırarak F5 tuşuna basarak işlev uygulaması projesini başlatabilirsiniz. Temel Araçlar’daki çıktı, Terminal panelinde görüntülenir. Uygulamanız Terminal panelinden başlar. HTTP ile tetiklenen işlevinizin URL uç noktasının yerel olarak çalıştır çalıştırıi olduğunu görüyorsunuz.

   

   Windows'da çalıştırma konusunda sorun Visual Studio Code için varsayılan terminalin WSL Bash olarak ayarsız olduğundan emin olun.

2. Core Tools çalışıyorken Azure: İşlevler alanına gidin. İşlevler'in altında Yerel İşlevler'Project > genişletin. İşleve sağ tıklayın (Windows) veya Ctrl tuşunu basılı tutarak (macOS) HttpExample tıklayın ve İşlevi Şimdi Yürüt... seçeneğini seçin.

   

3. İstek gövdeyi girin içinde istek iletisi gövdesi değerinin olduğunu { "name": "Azure" } görüyorsunuz. Bu istek iletiyi işlevinize göndermek için Enter tuşuna basın.

4. İşlev yerel olarak yürütülür ve yanıt döndürülürken, bir bildirim Visual Studio Code. İşlev yürütmesi hakkında bilgiler Terminal panelinde gösterilir.

5. Core Tools'ı durdurmak ve hata ayıklayıcının bağlantısını kesmek için Ctrl + C tuşlarına basın.

işlevin yerel bilgisayarınızda düzgün çalıştığını doğruladıktan sonra, projeyi doğrudan Azure 'da yayımlamak için Visual Studio Code kullanma zamanı vardır.

Azure'da oturum açma

Uygulamanızı yayımlamadan önce Azure’da oturum açmanız gerekir.

1. Henüz oturum açmadıysanız etkinlik çubuğunda Azure simgesini seçin, sonra Azure: işlevler alanında Azure 'da oturum aç' ı seçin... Henüz bir hesabınız yoksa ücretsiz bir Azure hesabı oluşturabilirsiniz. Öğrenciler, öğrenciler için ücretsiz bir Azure hesabı oluşturabilir.

   

   Zaten oturum açtıysanız sonraki bölüme gidin.

2. Tarayıcıda istendiğinde, Azure hesabınızı seçin ve Azure hesabı kimlik bilgilerinizi kullanarak oturum açın.

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

Projeyi Azure'da yayımlama

Bu bölümde, Azure aboneliğinize bir işlev uygulaması ve ilgili kaynaklar oluşturun ve kodunuzu dağıtın.

1. Etkinlik çubuğunda Azure simgesini ve ardından Azure: İşlevler alanında İşlev uygulamasına dağıt... düğmesini seçin.

   

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

   • Klasör seçin: Çalışma alanınıza bir klasör seçin veya işlev uygulamanızı içeren klasöre göz atabilirsiniz. Zaten açık geçerli bir işlev uygulaması varsa bunu görmeyebilirsiniz.

   • Abonelik seçin: Kullanmak istediğiniz aboneliği seçin. Yalnızca bir aboneliğiniz varsa bunu görmeyebilirsiniz.

   • Azure'daki işlev uygulamasını seçin: - Create new Function App öğesini seçin. Varsayılan olarak, PowerShell uygulaması İşlev Uygulaması'Windows dağıtılır. Linux İşlevi uygulamasını kullanmak için seçeneğini Advanced belirtin.

   • İşlev uygulaması için genel olarak benzersiz bir ad girin: URL yolunda geçerli bir ad yazın. Bu adın, Azure İşlevleri'da benzersiz olduğundan emin olmak için, Azure İşlevleri.

   • Yeni kaynaklar için bir konum seçin: Daha iyi performans için size yakın bir bölge seçin.

   Uzantı, bildirim alanında Azure'da oluşturulan tek tek kaynakların durumunu gösterir.

   

3. Tamamlandığında, işlevinizin uygulama adına göre adlar kullanılarak aboneliğiniz içinde aşağıdaki Azure kaynakları oluşturulur:

   • İlgili kaynaklar için mantıksal kapsayıcı olan bir kaynak grubu.
   • Projeleriniz hakkında durum ve diğer bilgileri tutan standart bir Azure depolama hesabı.
   • Sunucusuz işlev uygulamanız için temel Konağı tanımlayan bir tüketim planı.
   • İş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 bir mantıksal birim olarak gruplandırmanıza olanak tanır.
   • Sunucusuz işlevinizin kullanımını izleyen işlev uygulamasına bağlı 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 tarafından gereken Azure kaynakları, sağladığınız işlev uygulaması adına göre oluşturulur. Varsayılan olarak, aynı zamanda işlev uygulamasıyla aynı yeni kaynak grubunda de oluşturulur. Bu kaynakların adlarını özelleştirmek veya mevcut kaynakları yeniden kullanmak istiyorsanız, projeyi gelişmiş oluşturma seçenekleriyle yayımlamanızgerekir.

4. Oluşturduğunuz Azure kaynakları da dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için bu bildirimde Çıkışı Görüntüle'yi seçin. Bildirimi kaçırırsanız sağ alt köşedeki zil simgesini seçerek tekrar görüntüleyeceksiniz.

   

İşlevi Azure 'da çalıştırma

1. Yan çubuktaki Azure: Functions alanına geri döndüğünüzde aboneliğinizi, yeni işlev uygulamanızı ve işlevlerinizi genişletin. İşlevi sağ tıklatın (Windows) veya CTRL + tıklatın (MacOS) HttpExample ve Şimdi işlevi Çalıştır... seçeneğini belirleyin.

   

2. İstek gövdesi gir bölümünde istek iletisi gövdesi değerini görürsünüz { "name": "Azure" } . Bu istek iletisini işlevinizde göndermek için ENTER tuşuna basın.

3. İşlev Azure 'da yürütüldüğünde ve bir yanıt döndürdüğünde, Visual Studio Code bir bildirim oluşturulur.

Kaynakları temizleme

Bir sonraki adıma devam edip işlevlerinize bir Azure depolama kuyruğu bağlama eklediğinizde, zaten yapmış olduğunuz şeyi oluşturmak için tüm kaynaklarınızı saklamanız gerekir.

Aksi takdirde, daha fazla maliyet ödemeden kaçınmak için işlev uygulamasını ve ilgili kaynaklarını silmek için aşağıdaki adımları kullanabilirsiniz.

1. Visual Studio Code ' de, F1 tuşuna basarak komut paletini açın. Komut paletinde, araması yapın ve seçin Azure Functions: Open in portal .

2. İşlev uygulamanızı seçin ve ENTERtuşuna basın. İşlev uygulaması sayfası Azure portal açılır.

3. Genel bakış sekmesinde kaynak grubu' nun yanındaki adlandırılmış bağlantıyı seçin.

   

4. Kaynak grubu sayfasında, dahil edilen kaynakların listesini gözden geçirin ve silmek istediğiniz kaynakların bunlar olduğunu doğrulayın.

5. Kaynak grubunu sil’i seçin ve yönergeleri izleyin.

   Silme işlemi birkaç dakika sürebilir. İşlem tamamlandığında, birkaç saniye boyunca bir bildirim görüntülenir. Bildirimi görüntülemek için sayfanın üst kısmındaki zil simgesini de seçebilirsiniz.

Işlev maliyetleri hakkında daha fazla bilgi edinmek için bkz. Tüketim planı maliyetlerini tahminetme.

Sonraki adımlar

basit bir HTTP ile tetiklenen işlevi olan bir işlev uygulaması oluşturmak için Visual Studio Code kullandınız. sonraki makalede, bu işlevi Azure Depolama 'e bağlanarak genişletmelisiniz. Diğer Azure hizmetlerine bağlanma hakkında daha fazla bilgi edinmek için bkz. Azure işlevleri 'nde var olan bir işleve bağlama ekleme.