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

bu makalede, HTTP isteklerine yanıt veren bir C# 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 makale, her iki tür derlenmiş C# işlevi oluşturmayı destekler:

Bu makale, .NET 6,0 üzerinde çalışan bir HTTP ile tetiklenen işlev oluşturur. Bu makalenin CLI tabanlı bir sürümü de vardır.

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

Ortamınızı yapılandırma

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

• .NET 6,0 SDK

• Sürüm 4. x Azure Functions Core Tools .

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

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

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

Ayrıca etkin bir aboneliğe sahip bir Azure hesabınızın olması gerekir. Ücretsiz hesap oluşturun.

Yerel projenizi oluşturma

bu bölümde, C# ' 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:

   • İşlem içi
   • Yalıtılmış işlem

   İstem	Seçim
   İşlev projeniz için bir dil seçin	C# öğesini seçin.
   .NET çalışma zamanı seçin	.NET 6 öğesini seçin.
   Projenizin ilk işlevi için bir şablon seçin	HTTP trigger öğesini seçin.
   Bir işlev adı girin	HttpExample yazın.
   Ad alanı belirtin	My.Functions yazın.
   Yetkilendirme düzeyi	Tüm Anonymous kişilerin 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.

   Not

   .NET 6 ' yı çalışma zamanı seçeneği olarak görmüyorsanız, aşağıdakileri denetleyin:

   • .NET 6,0 SDK 'sını yüklediğinizden emin olun.
   • F1 tuşuna basın ve yazın Preferences: Open user settings , ardından Azure Functions: Project Runtime varsayılan çalışma zamanı sürümünü için arama yapın ve değiştirin ~4 .

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 ayarlanmay olduğundan emin olun.

2. Core Tools çalışıyorken Azure: İşlevler alanına gidin. İşlevler'in altında, Yerel Project İşlevler'i > 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... öğesini seçin.

   

3. İstek gövdenizi girin içinde, işlevinize bir istek iletisi göndermek için Enter tuşuna basın.

4. İşlev yerel olarak yürütülür ve bir 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ğ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, Azure Işlevlerinde benzersiz olduğundan emin olmak için onaylanır.

   • 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.

   

İş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, Azure Cosmos DB veya Azure kuyruğu Depolama bağlanarak bu işlevi 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.