Azure PowerShell 사용하여 봇 만들기 및 게시Create and publish a bot with Azure PowerShell

적용 대상: SDK v4APPLIES TO: SDK v4

이 문서에서는 Azure PowerShell 사용하여 봇을 만들고 기존 azure AD(Azure Active Directory) 애플리케이션 등록을 사용하여 Azure에 등록하는 방법을 보여 드립니다.This article shows you how to use Azure PowerShell to create a bot and register it with Azure using an existing Azure Active Directory (Azure AD) application registration.

봇을 호스트하는 방법에는 다음 두 가지가 있습니다.You have two approaches to hosting your bot:

  1. 웹앱 봇.Web App Bot. 이 문서에 표시된 대로 기존 애플리케이션 등록을 사용하여 봇을 만들고 Azure에 등록합니다.Create a bot and register it with Azure using an existing application registration as shown in this article. 이 방법을 사용하여 Azure에서 봇을 개발하고 호스트합니다.Use this approach to develop and host a bot in Azure.
  2. 봇 채널 등록.Bot Channels Registration. 이 방법을 사용하여 봇을 로컬로 만들고 개발하고 Azure와 다른 플랫폼에서 호스트합니다.Use this approach to create and develop your bot locally and host it on a platform different from Azure. 이렇게 하려면 봇 채널 등록 문서에 설명된 단계를 수행합니다.To do so, follow the steps described in the Bot channels registration article. 봇을 등록할 때 봇이 호스트되는 웹 주소를 제공합니다.When you register your bot, you provide the web address where your bot is hosted. 여전히 Azure에서 호스트할 수 있습니다.You can still host it in Azure.

Azure CloudShell을 사용하여 로컬로, Azure PowerShell 사용하거나, Azure Portal 통해 원격으로 이러한 명령을 실행할 수 있습니다.You can run these commands locally, using Azure PowerShell, or remotely through the Azure portal, using Azure CloudShell. Azure CloudShell에 대한 자세한 내용은 Azure Cloud Shell 개요를참조하세요.For more information about Azure CloudShell, see the Overview of Azure Cloud Shell.

중요

Az.BotService PowerShell 모듈이 미리 보기로 있는 동안 cmdlet을 사용하여 별도로 설치해야 Install-Module 합니다.While the Az.BotService PowerShell module is in preview, you must install it separately using the Install-Module cmdlet.

Azure Bot Service로 봇 만들기 및 로컬에서 봇 만들기는 서로 독립적이고 봇을 생성하기 위한 유사한 방법입니다.Creating a bot with Azure Bot Service and creating a bot locally are independent, parallel ways to create a bot.

필수 구성 요소Prerequisites

  • Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

  • 모든 Azure AD 테넌트에서 사용할 수 있는 기존 Azure AD 애플리케이션 등록입니다.An existing Azure AD application registration that can be used from any Azure AD tenant.

    • 이 빠른 시작은 애플리케이션 등록을 위한 앱 ID와 비밀이 필요합니다.To complete this quickstart, you will need the app ID and secret for the application registration.
  • Az PowerShell 모듈을 설치합니다.Install the Az PowerShell module. 이는 Az.BotService 모듈이 미리 보기에 있기 때문에 필요합니다.This is required because the Az.BotService module is in preview.

    Install-Module -Name Az.BotService -AllowClobber
    
  • Azure PowerShell을 로컬로 사용하도록 선택하는 경우:If you choose to use Azure PowerShell locally:

구독 선택Choose your subscription

여러 Azure 구독이 있는 경우 리소스에 대한 요금이 청구되는 적절한 구독을 선택합니다.If you have multiple Azure subscriptions, choose the appropriate subscription in which the resources should be billed.

  1. 액세스할 수 있는 구독을 나열하려면 Get-AzSubscription cmdlet을 사용합니다.To list the subscriptions you can access, use the Get-AzSubscription cmdlet.

    Get-AzSubscription
    
  2. Set-AzContext cmdlet을 사용하여 특정 구독을 설정합니다.Set the specific subscription using the Set-AzContext cmdlet.

    애플리케이션 등록과 동일한 구독을 봇에 사용해야 합니다.You should use the same subscription for your bot as for the application registration.

    Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
    

리소스 그룹 만들기Create a resource group

봇에 사용할 Azure 리소스 그룹이 아직 없는 경우 New-AzResourceGroup cmdlet을 사용하여 새 리소스 그룹을 만듭니다.If you do not already have an Azure resource group you want to use for your bot, create a new one using the New-AzResourceGroup cmdlet.

  • 리소스 그룹은 Azure 리소스가 그룹으로 배포되고 관리되는 논리 컨테이너입니다.A resource group is a logical container in which Azure resources are deployed and managed as a group.

다음 예제에서는 지정된 이름으로 지정된 위치에 리소스 그룹을 만듭니다.The following example creates a resource group with the specified name and in the specified location.

New-AzResourceGroup -Name <your-resource-group-name> -Location <your-resource-group-location>

새 봇 서비스 만들기Create a new bot service

봇에 대한 새 봇 서비스를 만들려면 New-AzBotService cmdlet을 사용합니다.To create a new bot service for your bot, you use the New-AzBotService cmdlet. 다음 예제에서는 지정된 값을 가진 새 봇 서비스를 만듭니다.The following example creates a new bot service with the specified values.

New-AzBotService -ResourceGroupName <your-resource-group-name> -Name <your-bot-handle> -ApplicationId <your-app-registration-id> -Location <your-bot-service-location> -Sku S1 -Description "<your-bot-description>" -Webapp

봇 서비스의 상태를 검색하려면 Get-AzBotService cmdlet을 사용합니다.To retrieve the status of a bot service, you use the Get-AzBotService cmdlet. 다음 예제에서는 지정된 리소스 그룹의 모든 리소스 목록을 가져옵니다.The following example gets a list of all the resources in the specified resource group.

Get-AzBotService -ResourceGroupName <your-resource-group-name>

프로젝트 폴더 초기화Initialize project folder

프로젝트 파일 폴더를 초기화하려면 Initialize-AzBotServicePrepareDeploy cmdlet을 사용합니다.To initialize the project file folder, you use the Initialize-AzBotServicePrepareDeploy cmdlet. 다음 예에서는 지정된 폴더의 지정된 파일을 초기화합니다.The following example initializes the specified file in the specified folder.

Initialize-AzBotServicePrepareDeploy -CodeDir C:\tmp\MyEchoBot -ProjFileName MyEchoBot.csproj

Azure에 Bot Service 게시Publish bot service to Azure

Azure에 봇 서비스를 게시하려면 Publish-AzBotServiceApp cmdlet을 사용합니다.To publish your bot service to Azure, you use the Publish-AzBotServiceApp cmdlet. 다음 예제에서는 지정된 봇 서비스를 Azure에 게시합니다.The following example publishes the specified bot service to Azure.

Publish-AzBotServiceApp -ResourceGroupName myResourceGroup -CodeDir D:\tmp\MyEchoBot -Name MyEchoBot

코드 다운로드Download code

코드를 로컬로 다운로드하려면 Export-AzBotServiceApp cmdlet을 사용합니다.To download the code to work on it locally, you use the Export-AzBotServiceApp cmdlet. 다음 예제에서는 지정된 리소스 그룹의 지정된 봇 서비스 앱에 대한 코드를 다운로드합니다.The following example downloads the code for the specified bot service app in the specified resource group.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

리소스 정리Clean up resources

이 문서에서 만든 리소스가 필요하지 않은 경우 다음 예제를 실행하여 삭제할 수 있습니다.If the resources created in this article aren't needed, you can delete them by running the following examples.

Bot Service 삭제Delete the Bot Service

리소스 그룹에서 Bot Service 삭제하려면 Remove-AzBotService cmdlet을 사용합니다.To delete the Bot Service from the resource group, you use the Remove-AzBotService cmdlet. 다음 예제에서는 지정된 리소스 그룹에서 봇 서비스를 삭제합니다.The following example deletes the bot service from the specified resource group.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

리소스 그룹 삭제Delete the resource group

주의

다음 예제에서는 지정된 리소스 그룹과 해당 그룹에 포함된 모든 리소스를 삭제합니다.The following example deletes the specified resource group and all resources contained within it. 지정된 리소스 그룹에 이 문서의 범위에 속하지 않는 리소스가 포함된 경우에도 해당 리소스가 삭제됩니다.If resources outside the scope of this article exist in the specified resource group, they will also be deleted.

Remove-AzResourceGroup -Name myResourceGroup

다음 단계Next steps

코드가 다운로드되면 머신에서 봇을 로컬로 계속 개발할 수 있습니다.After you download the code, you can continue to develop the bot locally on your machine. 봇을 테스트하고 Azure Portal 봇 코드를 업로드할 준비가 되면 연속 배포 설정 항목에 나열된 지침에 따라 변경한 후 코드를 자동으로 업데이트합니다.Once you test your bot and are ready to upload the bot code to the Azure portal, follow the instructions listed under set up continuous deployment topic to automatically update code after you make changes.