Azure 데이터 탐색기에 대 한 azure DevOps 작업Azure DevOps Task for Azure Data Explorer

Azure DevOps Services 는 고성능 파이프라인, 무료 개인 Git 리포지토리, 구성 가능한 간판 보드, 광범위 한 자동화 된 연속 테스트 기능 등 개발 공동 작업 도구를 제공 합니다.Azure DevOps Services provides development collaboration tools such as high-performance pipelines, free private Git repositories, configurable Kanban boards, and extensive automated and continuous testing capabilities. Azure Pipelines 은 모든 언어, 플랫폼 및 클라우드에서 작동 하는 고성능 파이프라인을 사용 하 여 코드를 배포 하기 위해 CI/CD를 관리할 수 있는 Azure devops 기능입니다.Azure Pipelines is an Azure DevOps capability that enables you to manage CI/CD to deploy your code with high-performance pipelines that work with any language, platform, and cloud. Azure 데이터 탐색기-관리자 명령은 릴리스 파이프라인을 만들고 azure 데이터 탐색기 데이터베이스에 데이터베이스 변경 내용을 배포 하는 데 사용할 수 있는 Azure Pipelines 작업입니다.Azure Data Explorer - Admin Commands is the Azure Pipelines task that enables you to create release pipelines and deploy your database changes to your Azure Data Explorer databases. Visual Studio Marketplace에서 무료로 사용할 수 있습니다.It's available for free in the Visual Studio Marketplace.

이 문서에서는 Azure 데이터 탐색기 – Admin Commands 작업을 사용 하 여 스키마 변경 내용을 데이터베이스에 배포 하는 방법에 대 한 간단한 예를 설명 합니다.This document describes a simple example on the use of the Azure Data Explorer – Admin Commands task to deploy your schema changes to your database. 전체 CI/CD 파이프라인은 Azure DevOps 설명서를 참조 하세요.For complete CI/CD pipelines, refer to Azure DevOps documentation.

사전 요구 사항Prerequisites

폴더 만들기Create folders

Git 리포지토리에서 다음 샘플 폴더 (함수, 정책, 테이블)를 만듭니다.Create the following sample folders (Functions, Policies, Tables) in your Git repository. 아래 표시 된 대로 여기 에서 해당 폴더에 파일을 복사 하 고 변경 내용을 커밋합니다.Copy the files from here into the respective folders as seen below and commit the changes. 다음 워크플로를 실행 하기 위한 샘플 파일이 제공 됩니다.The sample files are provided to execute the following workflow.

폴더 만들기

사용자 고유의 워크플로를 만들 때 코드를 idempotent 하는 것이 좋습니다.When creating your own workflow, we recommend making your code idempotent. 예를 들어 .create-merge table 대신를 사용 .create table 하 고 함수 .create-or-alter 대신 함수를 사용 .create 합니다.For example, use .create-merge table instead of .create table, and use .create-or-alter function instead of .create function.

릴리스 파이프라인 만들기Create a release pipeline

  1. Azure DevOps 조직에 로그인 합니다.Sign in to your Azure DevOps organization.

  2. Pipelines > 왼쪽 메뉴에서 파이프라인 릴리스 를 선택 하 고 새 파이프라인 을 선택 합니다.Select Pipelines > Releases from left-hand menu and select New pipeline.

    새 파이프라인

  3. 새 릴리스 파이프라인 창이 열립니다.The New release pipeline window opens. 파이프라인 탭의 템플릿 선택 창에서 빈 작업 을 선택 합니다.In the Pipelines tab, in the Select a template pane, select Empty job.

    템플릿 선택

  4. 스테이지 단추를 선택 합니다.Select Stage button. 스테이지 창에서 스테이지 이름을 추가 합니다.In Stage pane, add the Stage name. 저장 을 선택 하 여 파이프라인을 저장 합니다.Select Save to save your pipeline.

    단계 이름

  5. 아티팩트 추가 단추를 선택 합니다.Select Add an artifact button. 아티팩트 추가 창에서 코드가 있는 리포지토리를 선택 하 고 관련 정보를 입력 한 다음 추가 를 클릭 합니다.In the Add an artifact pane, select the repository where your code exists, fill out relevant information, and click Add. 저장 을 선택 하 여 파이프라인을 저장 합니다.Select Save to save your pipeline.

    아티팩트 추가

  6. 변수 탭에서 + 추가 를 선택 하 여 작업에 사용 될 끝점 URL 에 대 한 변수를 만듭니다.In the Variables tab, select + Add to create a variable for Endpoint URL that will be used in the task. 끝점의 이름과 을 씁니다.Write the Name and the Value of the endpoint. 저장 을 선택 하 여 파이프라인을 저장 합니다.Select Save to save your pipeline.

    변수 만들기

    Endpoint_URL를 찾기 위해 Azure Portal에서 azure 데이터 탐색기 클러스터 의 개요 페이지에는 azure 데이터 탐색기 클러스터 URI가 포함 되어 있습니다.To find your Endpoint_URL, the overview page of your Azure Data Explorer Cluster in the Azure portal contains the Azure Data Explorer cluster URI. 다음 형식의 URI를 생성 https://<Azure Data Explorer cluster URI>?DatabaseName=<DBName> 합니다.Construct the URI in the following format https://<Azure Data Explorer cluster URI>?DatabaseName=<DBName>. 예: https: / /kustodocs.westus.kusto.windows.net? DatabaseName = SampleDBFor example, https://kustodocs.westus.kusto.windows.net?DatabaseName=SampleDB

    Azure 데이터 탐색기 클러스터 URI

배포할 작업 만들기Create tasks to deploy

  1. 파이프라인 탭에서 1 작업, 0 작업 을 클릭 하 여 작업을 추가 합니다.In the Pipeline tab, click on 1 job, 0 task to add tasks.

    작업 추가

  2. 테이블, 함수정책을 이 순서로 배포 하는 세 가지 작업을 만듭니다.Create three tasks to deploy Tables, Functions, and Policies, in this order.

  3. 작업 탭에서 + 에이전트 작업 을 선택 합니다.In the Tasks tab, select + by Agent job. Azure 데이터 탐색기 를 검색합니다.Search for Azure Data Explorer. Marketplace 에서 Azure 데이터 탐색기 – Admin 명령 확장을 설치 합니다.In Marketplace, install the Azure Data Explorer – Admin Commands extension. 그런 다음 Azure 데이터 탐색기 실행 명령 에서 추가 를 선택 합니다.Then, select Add in Run Azure Data Explorer Command.

    관리자 명령 추가

  4. 왼쪽에서 Kusto 명령을 클릭 하 고 다음 정보를 사용 하 여 작업을 업데이트 합니다.Click on Kusto Command on the left and update the task with the following information:

    • 표시 이름: 작업의 이름입니다.Display name: Name of the task
    • 파일 경로: 테이블 태스크에서 테이블 생성 파일이 테이블 폴더에 있기 때문 에 테이블 태스크 에서 /proable/. csl을 지정 합니다.File path: In the Tables task, specify /Tables/.csl since the table creation files are in the Table folder.
    • 끝점 URL: EndPoint URL 이전 단계에서 만든 변수를 입력 합니다.Endpoint URL: enter the EndPoint URLvariable created in previous step.
    • 서비스 끝점 사용 을 선택 하 고 + 새로 만들기 를 선택 합니다.Select Use Service Endpoint and select + New.

    Kusto 명령 작업 업데이트

  5. Azure 데이터 탐색기 서비스 연결 추가 창에서 다음 정보를 완료 합니다.Complete the following information in the Add Azure Data Explorer service connection window:

    설정Setting 제안 값Suggested value
    연결 이름Connection name 이 서비스 끝점을 식별 하는 이름 입력Enter a name to identify this service endpoint
    클러스터 UrlCluster Url 값은 Azure Portal의 Azure 데이터 탐색기 클러스터의 개요 섹션에서 찾을 수 있습니다.Value can be found in the overview section of your Azure Data Explorer Cluster in the Azure portal
    서비스 사용자 IdService Principal Id AAD 앱 ID (필수 구성 요소로 만들어짐)를 입력 합니다.Enter the AAD App ID (created as prerequisite)
    서비스 사용자 앱 키Service Principal App Key AAD 앱 키 (필수 구성 요소로 만들어짐)를 입력 합니다.Enter the AAD App Key (created as prerequisite)
    AAD 테 넌 트 IdAAD tenant Id AAD 테 넌 트 (예: microsoft.com, contoso.com)를 입력 합니다.Enter your AAD tenant (such as microsoft.com, contoso.com...)

    모든 파이프라인에서이 연결을 사용 하도록 허용 확인란을 선택 합니다.Select Allow all pipelines to use this connection checkbox. 확인 을 선택합니다.Select OK.

    서비스 연결 추가

  6. 1-5 단계를 두 번 반복 하 여 함수정책 폴더에서 파일을 배포 합니다.Repeat steps 1-5 another two times to deploy files from the Functions and Policies folders. 저장 을 선택합니다.Select Save. 작업 탭에서 만든 세 가지 태스크 인 테이블 배포, 함수 배포정책 배포 를 참조 하세요.In the Tasks tab, see the three tasks created: Deploy Tables, Deploy Functions, and Deploy Policies.

    모든 폴더 배포

  7. + 릴리스 > 만들기 릴리스 를 선택 하 여 릴리스를 만듭니다.Select + Release > Create release to create a release.

    릴리스 만들기

  8. 로그 탭에서 배포 상태가 성공 인지 확인 합니다.In the Logs tab, check the deployment status is successful.

    배포 성공

이제 사전 프로덕션에 세 개의 작업을 배포 하기 위한 릴리스 파이프라인을 만들었습니다.You have now completed creation of a release pipeline for deployment of three tasks to pre-production.