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

bu makalede, HTTP isteklerine yanıt veren bir C# sınıf kitaplığı tabanlı işlev oluşturmak için Visual Studio Code kullanırsınız. Kodu yerel olarak test ettikten sonra, sunucusuz ortam Azure İşlevleri.

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.

1. ortamınızı yapılandırın

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

• Azure account etkin bir aboneliği. Ücretsiz hesap oluşturun.

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

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

• Visual Studio Code için C# uzantısı.

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

2. yerel projenizi oluşturun

bu bölümde, yerel bir kayıt oluşturmak için Visual Studio Code kullanacaksınız Azure Işlevleri projesi C# dilinde. Bu makalenin ilerleyen bölümlerinde işlev kodunu Azure'da yayımlayacaksınız.

1. İçindeki Azure simgesini seçin Etkinlik çubuğu, ardından Azure: Functions 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: C# öğ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.

   • Bir ad alanı sağlayın: My.Functions 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üzeyleri 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 ile bir Azure işlevleri projesi oluşturur Tetikleyicinin. 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.

5. projeyi Azure 'da yayımlayın

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

1. Etkinlik çubuğunda Azure simgesini seçin, sonra Azure: işlevler alanında, işlev uygulamasına dağıt uygulama... düğmesini seçin.

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

   • Klasör seçin: çalışma alanınızdan bir klasör seçin veya işlev uygulamanızı içeren bir klasöre gidin. Zaten açılmış geçerli bir işlev uygulamanız varsa bunu göremezsiniz.

   • Abonelik seçin: kullanılacak aboneliği seçin. Yalnızca bir aboneliğiniz varsa bunu göremezsiniz.

   • Azure'daki işlev uygulamasını seçin: + Create new Function App öğesini seçin. ( Advanced Bu makalede kapsanmayan seçeneğini seçmeyin.)

   • İşlev uygulaması için genel olarak benzersiz bir ad girin: URL yolunda geçerli olan bir ad yazın. Yazdığınız ad, olduğundan emin olmak için onaylanır Azure Işlevlerinde benzersiz.

   • 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şturulmakta olan ayrı kaynakların durumunu gösterir.

   

3. Tamamlandığında, aşağıdaki Azure kaynakları, işlev uygulamanızın adına göre adlar kullanılarak aboneliğinizde 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ı dahil olmak üzere oluşturma ve dağıtım sonuçlarını görüntülemek için bu bildirimde çıktıyı görüntüle ' yi seçin. Bildirimi kaçırırsanız, sağ alt köşedeki zil simgesini seçerek tekrar görüntüleyin.

   

6. işlevi Azure 'da çalıştırın

1. Yan çubuktaki Azure: Functions alanına geri döndüğünüzde aboneliğinizi, yeni işlev uygulamanızı ve işlevlerinizi genişletin. iş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.

5. Kaynakları Temizleme

Bir sonraki adıma devam edip bir Azure Depolama kuyruğu çıktı bağlama işlevinizde, daha önce 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

HTTP ile tetiklenen basit bir işlevi kullanarak bir işlev uygulaması oluşturmak için Visual Studio Code’u kullandınız. Sonraki makalede, bir çıkış ekleyerek bu işlevi genişletmelisiniz bağlama. bu bağlama, HTTP isteğinden dizeyi bir Azure kuyruğu Depolama sırasındaki bir iletiye yazar.