Aracılığıyla paylaş

App Service kaynağı oluşturmak için Azure CLI kullanma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Bu makalede, bot sağlama ve yayımlama işleminin bir parçası olarak Azure CLI ve Azure Resource Manager şablonu (ARM şablonu) ile App Service kaynağının nasıl oluşturulacağı açıklanır. Uygulama hizmeti bazen bir web uygulaması olarak adlandırılır.

Önemli

Python botları, Windows hizmetlerini veya botlarını içeren bir kaynak grubuna dağıtılamaz. Aynı kaynak grubuna birden çok Python botu dağıtılabilir; ancak, başka bir kaynak grubunda başka hizmetler (Azure AI hizmetleri gibi) oluşturmanız gerekir.

  • İşlemin tamamı hakkında bilgi için bkz . Bot sağlama ve yayımlama.
  • Azure Bot kaynağı oluşturma hakkında bilgi için bkz . Azure Bot kaynağı oluşturmak için Azure CLI kullanma.

Not

Bot Framework JavaScript, C# ve Python SDK'ları desteklenmeye devam edecektir, ancak Java SDK'sı son uzun vadeli destek Kasım 2023'te sona erecek şekilde kullanımdan kaldırılacaktır.

Java SDK ile oluşturulan mevcut botlar çalışmaya devam edecektir.

Yeni bot derlemesi için Microsoft Copilot Studio'yu kullanmayı göz önünde bulundurun ve doğru copilot çözümünü seçme hakkında bilgi edinin.

Daha fazla bilgi için bkz . Bot oluşturmanın geleceği.

Önkoşullar

Botları sağlamak ve yayımlamak için Azure CLI'yı kullanmak için şunları yapmanız gerekir:

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

  • Azure CLI yüklemesi.

    Programlama diliniz için Azure CLI'nın aşağıdaki sürümünü kullanın. Bazı adımlar CLI'nın sonraki sürümlerinde çalışmaz.

    Dil CLI sürümü
    C# ve JavaScript 2.39.0 veya üzeri
    Python 2.55.0 veya üzeri
    Java 2.29.2

  • Bu işlem, botunuz için app service kaynağı oluşturmak için bir Azure Resource Manager şablonu (ARM şablonu) kullanır.

    Geçerli şablonlarınız yoksa, bot projenizde deploymentTemplates klasörünün bir kopyasını oluşturun: C#, JavaScript, Python veya Java.

İpucu

Bu, bot sağlama ve yayımlama işleminin daha büyük bir parçasıdır. Önkoşulların tam listesi için bot sağlama ve yayımlama bölümüne bakın.

Parametre dosyasını düzenle

ARM şablonunun parametre dosyasını, kullanmak istediğiniz değerleri içerecek şekilde düzenleyin.

Önemli

App Service ve Azure Bot kaynaklarınız için aynı appType değeri kullanmanız gerekir.

Projeniz henüz en son ARM şablonu ve parametre dosyalarını içermiyorsa, bunları diliniz için Bot Framework SDK deposundan kopyalayabilirsiniz: C#, JavaScript, Python veya Java.

Bu tabloda, komut seçeneğiyle kullanılmak üzere parametre dosyasındaki parameters dağıtım parametreleri açıklanmaktadır. Varsayılan olarak parametre dosyasının adı parameters-for-template-BotApp-with-rg.json.

Parametre Tür Veri Akışı Açıklaması
appServiceName String Gerekli. App Service'in genel olarak benzersiz adı.
existingAppServicePlanName String isteğe bağlı. Bot için app service'in oluşturulacağı mevcut bir app service planının adı.
existingAppServicePlanLocation String isteğe bağlı. Mevcut app service planının konumu.
newAppServicePlanName String isteğe bağlı. Yeni app service planının adı.
newAppServicePlanLocation String isteğe bağlı. Yeni app service planının konumu.
newAppServicePlanSku Object isteğe bağlı. Yeni app service planının SKU'su. Varsayılan olarak S1 (Standart) hizmet planı kullanılır.
appType String Gerekli. Bot kaynaklarınızın kimliklerinin nasıl yönetildiğini öğrenin. İzin verilen değerler: "MultiTenant", "SingleTenant" ve "UserAssignedMSI". Varsayılan değer "MultiTenant"tır.
appId String Gerekli. Daha önce oluşturduğunuz kimlik kaynağından istemci kimliği veya uygulama kimliği. Bu, uygulama hizmetinin Microsoft uygulama kimliği olarak kullanılır.
appSecret String isteğe bağlı. Tek kiracılı ve çok kiracılı uygulama türleri için kimlik kaynağının parolası.
UMSIName String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik uygulama türleri için kimlik kaynağının adı.
UMSIResourceGroupName String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik uygulama türleri için, kimlik kaynağının kaynak grubu.
tenantId String isteğe bağlı. Kullanıcı tarafından atanan yönetilen kimlik ve tek kiracılı uygulama türleri için, kimlik kaynağının Microsoft Entra Id kiracı kimliği.

Tüm parametreler tüm uygulama türleri için geçerli değildir.

  • , UMSIResourceGroupNameve tenantIdiçin UMSINamedeğerler sağlayın.
  • Boş bırakın appSecret .

Bazı parametreler, mevcut veya yeni bir app service planının kullanılmasına özeldir.

  • ve existingAppServicePlanLocationdeğerlerini existingAppServicePlanName sağlayın.
  • , newAppServicePlanLocationve newAppServicePlanSku boş bırakınnewAppServicePlanName.

Uygulama hizmetini oluşturma

Botunuz için app service'i oluşturun.

az deployment group create --resource-group <resource-group> --template-file <template-file-path> --parameters "@<parameters-file-path>"
Seçenek Açıklama
resource-group App Service'in oluşturulacağı Azure kaynak grubunun adı.
şablon dosyası Uygulama hizmeti için ARM şablonunun yolu. Yol göreli veya mutlak olabilir.
parametreler ARM şablonuyla kullanılacak parametre dosyasının yolu. Yol göreli veya mutlak olabilir.

En son oluşturucularla oluşturulan projeler için ARM şablonu ve parametre dosyaları projenin içindeki DeploymentTemplates\DeployUseExistResourceGroup klasöründe bulunur. Varsayılan dosya adları template-BotApp-with-rg.json ve parameters-for-template-BotApp-with-rg.json.

İpucu

  • App service'inizin temel URL'si, app service adını temel alır: https:<app-service-name>.azurewebsites.net.
  • Botunuzun mesajlaşma uç noktası temel URL artı /api/messageshttps:<app-service-name>.azurewebsites.net/api/messagesgibi olur.

Ek bilgi

ARM şablonları hakkında daha fazla bilgi için bkz . ARM şablonları nedir? ve Azure Resource Manager (ARM) dağıtım şablonlarını Azure CLI ile kullanma.

Sonraki adımlar

App Service'i bir bot dağıtımının parçası olarak oluşturduysanız işleme devam etmek için bkz . ARM şablonlarıyla kaynak oluşturma.