Azure PowerShell을 사용하여 봇 만들기 및 게시

적용 대상: SDK v4

이 문서에서는 Azure PowerShell을 사용하여 봇을 만들고 기존 Microsoft Entra ID 애플리케이션 등록을 사용하여 Azure에 등록하는 방법을 보여줍니다.

Azure Bot 리소스를 사용하여 봇을 호스트합니다. 봇을 로컬로 만들고 개발하여 Azure 또는 다른 플랫폼에서 호스트합니다. Azure에 봇을 등록하는 방법에 설명된 단계를 따릅니다. 봇을 등록할 때 봇이 호스트되는 웹 주소를 제공합니다. Azure에서 계속 호스트할 수 있습니다.

Azure CloudShell을 사용하여 로컬로, Azure PowerShell을 사용하거나, Azure Portal을 통해 원격으로 이러한 명령을 실행할 수 있습니다. Azure CloudShell에 대한 자세한 내용은 Azure Cloud Shell 개요를 참조하세요.

Important

Az.BotService PowerShell 모듈은 미리 보기 상태이지만 cmdlet을 Install-Module 사용하여 별도로 설치해야 합니다.

Azure AI Bot Service를 사용하여 봇을 만들고 로컬로 봇을 만드는 것은 봇을 만드는 독립적인 병렬 방법입니다.

필수 조건

  • Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

  • 모든 Microsoft Entra ID 테넌트에서 사용할 수 있는 기존 Microsoft Entra ID 애플리케이션 등록입니다.

    • 이 빠른 시작을 완료하려면 애플리케이션 등록에 대한 앱 ID와 비밀이 필요합니다.
  • Az PowerShell 모듈을 설치합니다. 이는 Az.BotService 모듈이 미리 보기 상태이기 때문에 필요합니다.

    Install-Module -Name Az.BotService -AllowClobber
    
  • Azure PowerShell을 로컬로 사용하도록 선택한 경우:

    • 커넥트-AzAccount cmdlet을 사용하여 Azure 계정에 커넥트.

구독 선택

여러 Azure 구독이 있는 경우 리소스를 청구해야 하는 적절한 구독을 선택합니다.

  1. 액세스할 수 있는 구독을 나열하려면 Get-AzSubscription cmdlet을 사용합니다.

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

    애플리케이션 등록과 동일한 구독을 봇에 사용해야 합니다.

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

리소스 그룹 만들기

봇에 사용할 Azure 리소스 그룹이 아직 없는 경우 New-AzResourceGroup cmdlet을 사용하여 새 리소스 그룹을 만듭니다.

  • 리소스 그룹은 Azure 리소스가 그룹으로 배포되고 관리되는 논리 컨테이너입니다.

다음 예제에서는 지정된 이름과 지정된 위치에 리소스 그룹을 만듭니다.

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

새 봇 서비스 만들기

봇에 대한 새 봇 서비스를 만들려면 New-AzBotService cmdlet을 사용합니다. 다음 예제에서는 지정된 값을 사용하여 새 봇 서비스를 만듭니다.

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을 사용합니다. 다음 예제에서는 지정된 리소스 그룹의 모든 리소스 목록을 가져옵니다.

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

프로젝트 폴더 초기화

프로젝트 파일 폴더를 초기화하려면 Initialize-AzBotServicePrepareDeploy cmdlet을 사용합니다. 다음 예제에서는 지정된 폴더에서 지정된 파일을 초기화합니다.

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

Azure에 봇 서비스 게시

Azure에 봇 서비스를 게시하려면 Publish-AzBotServiceApp cmdlet을 사용합니다. 다음 예제에서는 지정된 봇 서비스를 Azure에 게시합니다.

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

코드 다운로드

코드를 다운로드하여 로컬로 작동하려면 Export-AzBotServiceApp cmdlet을 사용합니다. 다음 예제에서는 지정된 리소스 그룹에서 지정된 봇 서비스 앱에 대한 코드를 다운로드합니다.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

리소스 정리

이 문서에서 만든 리소스가 필요하지 않은 경우 다음 예제를 실행하여 삭제할 수 있습니다.

Bot Service 삭제

리소스 그룹에서 Bot Service를 삭제하려면 Remove-AzBotService cmdlet을 사용합니다. 다음 예제에서는 지정된 리소스 그룹에서 봇 서비스를 삭제합니다.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

리소스 그룹 삭제

주의

다음 예제에서는 지정된 리소스 그룹 및 해당 그룹에 포함된 모든 리소스를 삭제합니다. 이 문서의 범위를 벗어난 리소스가 지정된 리소스 그룹에 있으면 해당 리소스도 삭제됩니다.

Remove-AzResourceGroup -Name myResourceGroup

다음 단계

코드를 다운로드한 후 컴퓨터에서 로컬로 봇을 계속 개발할 수 있습니다. 봇을 테스트하고 Azure Portal에 봇 코드를 업로드할 준비가 되면 연속 배포 설정 항목 아래에 나열된 지침에 따라 변경한 후 코드를 자동으로 업데이트합니다.