Öğretici: Giriş olarak Azure Blob Depolama ile Python işlevi

Bu öğreticide, aşağıdaki görevleri tamamlayarak Giriş olarak Azure Blob depolama ile bir Python işlevini yapılandırmayı öğreneceksiniz:

  • Python işlev projesi oluşturmak için Visual Studio Code'u kullanın.
  • Depolama blobu giriş işlevi bağlaması eklemek için kodları değiştirin.
  • İşlevi yerel olarak çalıştırmak için Visual Studio Code'u kullanın.
  • Azure İşlevi ile Hizmet Bağlayıcısı ile Depolama Blobu arasında bağlantı oluşturmak için Azure CLI'yi kullanın.
  • İşlevinizi dağıtmak için Visual Studio'yu kullanın.

Bu öğreticide işlev projesi bileşenlerine genel bakış:

Proje Bileşeni Seçim / Çözüm
Kaynak Hizmet Azure İşlevi
Hedef Hizmet Azure Depolama Blobu
İşlev Bağlama HTTP tetikleyicisi, Giriş Olarak Depolama Blobu
Yerel Proje Kimlik Doğrulama Türü Bağlantı Dizesi
Bulut İşlevi Kimlik Doğrulama Türü Sistem Tarafından Atanan Yönetilen Kimlik

Uyarı

Microsoft, kullanılabilir en güvenli kimlik doğrulama akışını kullanmanızı önerir. Bu yordamda açıklanan kimlik doğrulama akışı, uygulamada yüksek düzeyde güven gerektirir ve diğer akışlarda mevcut olmayan riskleri taşır. Bu akışı yalnızca yönetilen kimlikler gibi diğer daha güvenli akışlar uygun olmadığında kullanmalısınız.

Önkoşullar

Python işlev projesi oluşturma

Yerel bir Azure İşlevleri projesi oluşturmak için öğreticiyi izleyin. Aşağıdaki bilgileri istenen yerde sağlayın.

İstem Seçim
Dil seçin Python öğesini seçin. (v1 programlama dili modeli)
Sanal ortam oluşturmak için Python yorumlayıcısını seçme Tercih ettiğiniz Python yorumlayıcıyı seçin. Bir seçenek gösterilmiyorsa Python ikili dosyanızın tam yolunu yazın.
Projenizin ilk işlevi için bir şablon seçin HTTP trigger öğesini seçin.
İşlev adı belirtin BlobStorageInputFunc girin.
Yetkilendirme düzeyi herkesin işlev uç noktanızı çağırmasına olanak tanıyan öğesini seçin Anonymous. 

Bu bilgilerle Visual Studio Code, HTTP tetikleyicisi olan bir Python işlev projesi oluşturur.

Blob Depolama giriş bağlaması ekleme

Bağlama öznitelikleri, belirli bir işlev için function.json dosyasında tanımlanır. Bağlama oluşturmak için işlev klasörünüzdeki dosyaya function.json sağ tıklayın ve Bağlama ekle...'yi seçin. Yeni bağlama için aşağıdaki bağlama özelliklerini tanımlamak için istemleri izleyin:

İstem Value Açıklama
Bağlama yönünü seçin in Bağlama bir giriş bağlamasıdır.
Yönü olan bağlamayı seçin... Azure Blob Storage Bağlama bir Azure Depolama blob bağlamasıdır.
Kodunuzda bu bağlamayı tanımlamak için kullanılan ad inputBlob Kodunuzda başvuruda bulunılan bağlama parametresini tanımlayan ad.
Depolama hesabınızda blob'un okunacağı yol testcontainer/test.txt İşlevinizin giriş olarak okuduğu blob yolu. dosya içeriği olarak ile adlı test.txtbir Hello, World! dosya hazırlayın. adlı testcontainer bir kapsayıcı oluşturun ve dosyayı kapsayıcıya yükleyin.
"local.setting.json" ayarı seçin Create new local app settings İşlevinizin giriş olarak okuduğu Depolama Hesabını seçin. Visual Studio Code, yerel proje bağlantısı için bağlantı dizesini alır.

Bağlamanın başarıyla eklendiğini denetlemek için

  1. BlobStorageInputFunc/function.json dosyasını açın ve type: blob ile direction: in içeren yeni bir bağlamanın bu dosyaya eklenip eklenmediğini denetleyin.
  2. local.settings.json Dosyasını açın ve depolama hesabı bağlantı dizenizi içeren yeni bir anahtar-değer çiftinin <your-storage-account-name>_STORAGE: <your-storage-account-connection-string> bu dosyaya eklenip eklendiğini denetleyin.

Bağlama eklendikten sonra, BlobStorageInputFunc/__init__.py dosyasını aşağıdaki Python dosyasıyla değiştirerek işlev kodunuzu bu bağlamayı tüketecek şekilde güncelleyin:

import logging
import azure.functions as func

def main(req: func.HttpRequest, inputBlob: bytes) -> func.HttpResponse:
    logging.info('Python HTTP trigger function processed a request.')
    return func.HttpResponse('The triggered function executed successfully. And read blob content: {}'.format(inputBlob))

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

İşlevi yerel olarak çalıştırmak ve blob girişini doğrulamak için öğreticiyi izleyin.

  1. Depolamaya bağlanmanız istenirse Azure İşlevi kaynağını oluştururken seçtiğiniz depolama hesabını seçin. Bu depolama hesabı Azure İşlevi'nin dahili kullanımı için kullanılır ve giriş için kullandığınız depolama hesabıyla aynı olmayabilir.
  2. İşlevi yerel olarak başlatmak için F5 tuşuna basın veya sol taraftaki Etkinlik çubuğunda Çalıştır ve Hata Ayıkla simgesini seçin.
  3. İşlevin blobu okuyabildiğini doğrulamak için Visual Studio Code Execute Function Now... işleve sağ tıklayın ve işlev yanıtını denetleyin. Yanıt iletisi blob dosyanızdaki içeriği içermelidir.

Service Connector kullanarak bağlantı oluşturma

Son adımda işlevi yerel olarak çalıştırıp yerel projenizin bir bağlantı dizesi kullanarak depolama blobunuza bağlandığını doğruladınız.

Ardından, Azure İşlevi ile Azure Blob Depolama arasındaki bağlantıyı yapılandırmayı öğreneceksiniz. İşleviniz buluta dağıtıldıktan sonra bu bağlantı işlevinizin blobu okumasına olanak tanır. Ardından bulut ortamında sistem tarafından atanan yönetilen kimlik kullanılarak kimlik doğrulamasının nasıl yapılacağını gösteririz.

  1. Yerel projenizde function.json dosyasını açın ve connection özelliğinin değerini MyBlobInputConnection olacak şekilde bindings olarak değiştirin.
  2. Azure İşleviniz ile Azure Depolama alanınız arasında bağlantı oluşturmak için aşağıdaki Azure CLI komutunu çalıştırın.
az functionapp connection create storage-blob --source-id "<your-function-resource-id>" --target-id "<your-storage-blob-resource-id>" --system-identity --customized-keys AZURE_STORAGEBLOB_RESOURCEENDPOINT=MyBlobInputConnection__serviceUri
  • --source-id biçim: /subscriptions/{subscription}/resourceGroups/{source_resource_group}/providers/Microsoft.Web/sites/{site}
  • --target-id biçim: /subscriptions/{subscription}/resourceGroups/{target_resource_group}/providers/Microsoft.Storage/storageAccounts/{account}/blobServices/default

Bu adım, sistem tarafından atanan yönetilen kimlikle Hizmet Bağlayıcısı'nı kullanarak Azure İşlevi ile Azure Blob Depolama arasında bir bağlantı oluşturur.

Hizmet Bağlayıcısı, işlevin depolamaya bağlanmak için işlev bağlama çalışma zamanı tarafından kullanılan uygulama ayarlarında bir MyBlobInputConnection__serviceUri değişken yapılandırdı, böylece işlev blob depolamadan verileri okuyabilir. Service Connector'ın hizmetlere bağlanmaya Azure İşlevleri nasıl yardımcı olduğu hakkında daha fazla bilgi edinebilirsiniz.

İşlevinizi Azure'a dağıtma

Artık işlevinizi Azure'a dağıtabilir ve depolama blobu giriş bağlamasının çalıştığını doğrulayabilirsiniz.

  1. İşlevinizi Azure'a dağıtmak için öğreticiyi izleyin.
  2. İşlevin blobu okuyabildiğini doğrulamak için Visual Studio Code Execute Function Now... görünümünde işleve sağ tıklayın ve işlev yanıtını denetleyin. Yanıt iletisi blob dosyanızdaki içeriği içermelidir.

Sorun giderme

gibi No such host is known (<account-name>.blob.core.windows.net:443)depolama ana bilgisayarıyla ilgili hatalar varsa, Azure Depolama'ya bağlanmak için kullandığınız bağlantı dizesi blob uç noktasını içerip içermediğini denetlemeniz gerekir. Aksi takdirde Azure portalında Azure Depolama'ya gidin, sekmeden Access keys bağlantı dizesini kopyalayın ve değerleri değiştirin.

Projeyi yerel olarak başlattığınızda hata oluşursa dosyayı denetleyin local.settings.json .

İşlevinizi buluta dağıttığınızda hata oluşursa (bu durumda işlev dağıtımı genellikle üzerinde Syncing triggersbaşarısız olur), işlevinizin Uygulama Ayarları'nı denetleyin.

Kaynakları temizleme

Bu projeyi kullanmaya devam etmeyecekseniz, daha önce oluşturduğunuz İşlev Uygulaması kaynağını silin.

  1. Azure portalında İşlev Uygulaması kaynağını açın ve Sil'i seçin.
  2. Uygulama adını girin ve onaylamak için Sil'i seçin.

Sonraki adımlar

Hizmet Bağlayıcısı kavramları ve Azure İşlevleri'nin diğer bulut hizmetlerine bağlanmasına nasıl yardımcı olduğu hakkında daha fazla bilgi edinmek için aşağıdaki makaleleri okuyun.

Hizmet Bağlayıcısı kavramları hakkında bilgi edinin

Azure İşlevleri diğer hizmetlere bağlamak için Hizmet Bağlayıcısı'nı kullanma

  • Last updated on