서비스 관리 자동화용 Runbook 관리

아티클
11/06/2024

SMA(서비스 관리 자동화) 관리자는 Runbook을 구성하고 실행해야 합니다. Runbook 작업자 설정 및 Runbook 예약 및 추적을 포함한 활동 작성하는 Runbook 외에도 SMA에 포함된 두 개의 시스템 Runbook이 있습니다.

DiscoverAllLocalModules: Runbook Worker를 설치한 직후에 실행됩니다. 이 Runbook은 Runbook Worker가 설치된 Windows Server 시스템의 모든 네이티브 모듈을 검색합니다. Microsoft Azure Pack에서 Runbook을 작성할 때 해당 활동을 사용할 수 있도록 이러한 모듈에 대한 활동 및 활동 메타데이터를 추출합니다.
SetAutomationModuleActivityMetadata: 모듈을 SMA로 가져온 직후에 실행됩니다. 이 Runbook은 새로 가져온 모듈에서 활동 및 활동 메타데이터를 추출하여 Microsoft Azure Pack에서 Runbook을 작성할 때 해당 작업을 사용할 수 있도록 합니다.

Runbook Worker 구성

기본적으로 SMA에서 Runbook 작업을 시작하면 임의 Runbook 작업자가 선택합니다. 그러나 특정 Runbook 작업자를 사용할 수 있습니다. 이렇게 하려면 RunbookWorker 속성을 사용합니다. Runbook 실행에 대해 자세히 알아봅니다.

PowerShell ISE 추가 기능을 사용하여 Runbook 작업자를 지정합니다.

SMA ISE 추가 >기능 구성에서 SMA 계정으로 로그인합니다. 로그인한 후 Runbook 탭에서 Runbook을 볼 수 있습니다 .
Runbook 탭에서 특정 Runbook 작업자에 대해 실행할 하나 이상의 Runbook을 선택합니다.
구성을 선택하고 Runbook 속성 구성의 드롭다운 메뉴에서 Runbook Worker를 선택합니다.
변경 내용을 선택합니다.

SMA PowerShell 모듈을 통해 Runbook 작업자 지정

다음 명령줄 명령을 사용하여 Runbook Worker 속성을 설정할 수도 있습니다.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"
$workerName = "Worker1"

Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -RunbookWorker $workerName

다음과 같이 배포된 모든 Runbook 작업자 목록을 볼 수 있습니다.

$webServer = 'https://MyServer'
$port = 9090

Get-SmaRunbookWorkerDeployment -WebServiceEndpoint $webServer -Port $port

참고 항목

현재 Microsoft Azure 팩 포털을 사용하여 Runbook 작업자를 지정할 수 없습니다. SMA ISE 추가 기능 또는 PowerShell cmdlet을 사용합니다.

Runbook 예약

Runbook이 지정된 시간에 시작되도록 예약하려면 하나 이상의 일정에 연결합니다. 일정을 한 번 실행하도록 구성하거나 되풀이하도록 설정할 수 있습니다. 하나의 Runbook을 여러 일정에 연결할 수 있고 하나의 일정에 여러 Runbook을 연결할 수 있습니다.

일정 만들기

관리 포털 또는 Windows PowerShell을 사용하여 일정을 만들 수 있습니다.

관리 포털에서 일정 만들기

관리 포털에서 자동화를 선택합니다.
자산 탭에서 일정 추가 설정>추가를 선택합니다.
새 일정에 대한 이름과 설명을 입력하고 일회용 또는 매일 실행 여부를 선택합니다.
필요에 따라 시작 시간 및 기타 옵션을 지정합니다. 시작 시간의 표준 시간대는 로컬 컴퓨터의 표준 시간대와 일치합니다.

Windows PowerShell을 사용하여 일정 만들기

Set-SmaSchedule cmdlet을 사용하여 일정을 만들거나 기존 일정을 수정할 수 있습니다. 일정의 시작 시간과 일정이 한 번 또는 반복적으로 실행되어야 하는지를 지정해야 합니다.

다음 샘플에서는 My Daily Schedule이라는 새 일정을 만듭니다. 그것은 현재 날에 시작하고, 정오에 매일 1 년 동안 계속됩니다.

$webServer = 'https://MyServer'
$port = 9090
$scheduleName = 'My Daily Schedule'
$startTime = (Get-Date).Date.AddHours(12)
$expiryTime = $startTime.AddYears(1)

Set-SmaSchedule -WebServiceEndpoint $webServer -Port $port -Name $scheduleName -ScheduleType OneTimeSchedule -StartTime $startTime -ExpiryTime $expiryTime -DayInterval 1

Runbook에 일정 연결

하나의 Runbook을 여러 일정에 연결할 수 있고 하나의 일정에 여러 Runbook을 연결할 수 있습니다. Runbook에 매개 변수가 있는 경우 Runbook이 시작될 때 사용할 값을 제공할 수 있습니다. 모든 필수 매개 변수에 대한 값은 반드시 제공해야 합니다.

관리 포털에서 일정 연결

관리 포털에서 Automation>Runbook을 선택합니다.
예약할 Runbook의 이름을 선택하고 일정 탭을 선택합니다.
Runbook이 현재 일정에 연결된 경우 링크를 선택합니다. 그런 다음 새 일정에 대한 링크를 선택하고 새 일정을 만들거나 기존 일정에 대한 링크를 선택하고 일정을 선택합니다.
Runbook에 매개 변수가 있으면 해당 값을 지정하라는 메시지가 표시됩니다.

Windows PowerShell을 사용하여 일정 연결

Start-SmaRunbook 을 ScheduleName 매개 변수와 함께 사용하여 Runbook에 일정을 연결할 수 있습니다. Parameters 매개 변수를 사용하여 값을 지정할 수 있습니다. 매개 변수 값에 대해 자세히 알아봅니다.

다음 샘플 명령은 Runbook에 일정을 연결하는 방법을 보여 줍니다.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"
$scheduleName = "Sample-DailySchedule"

Start-SmaRunbook -WebServiceEndpoint $webServer -Port $port -Name $runbookName -ScheduleName $scheduleName -Parameters $params

Runbook 추적

SMA에서 Runbook을 시작하면 작업이 만들어집니다. 작업은 Runbook의 단일 실행 인스턴스입니다. 단일 Runbook에는 각각 Runbook 매개 변수에 대한 고유한 값 집합이 있는 여러 작업이 있을 수 있습니다.

Runbook의 RunbookWorker 속성이 채워지면 해당 작업자 서버가 작업을 서비스합니다.
작업자 서버를 사용할 수 없는 경우 작업이 실패하고 오류가 발생합니다.
RunbookWorker 속성이 채워지지 않으면 SMA는 요청을 서비스할 사용 가능한 작업자 서버를 임의로 선택합니다.

다음 다이어그램은 PowerShell 워크플로 Runbook에 대한 Runbook 작업의 수명 주기를 보여 줍니다.

PowerShell 워크플로를 보여 주는 다이어그램

다음 다이어그램은 PowerShell 스크립트 Runbook에 대한 Runbook 작업의 수명 주기를 보여 줍니다.

PowerShell 스크립트를 보여 주는 다이어그램

작업 상태

다음 표에서는 작업에 적용될 수 있는 여러 상태에 대해 설명합니다.

Status	설명
완료됨	작업이 완료되었습니다.
실패함	예외와 함께 작업이 종료되었습니다.
대기 중	작업은 자동화 작업자의 리소스가 사용 가능해져서 작업이 시작될 수 있게 될 때까지 기다립니다.
시작 중	작업이 작업자에게 할당되었으며 시스템에서 작업이 시작되고 있습니다.
Resuming	작업이 일시 중단된 후 시스템에서 작업을 다시 시작하는 중입니다.
실행 중	작업이 실행되고 있습니다.
중지됨	작업이 완료되기 전에 사용자에 의해 중지되었습니다.
중지 중	시스템이 작업을 중지하는 중입니다.
일시 중단됨	작업이 Runbook의 사용자, 시스템 또는 명령에 의해 일시 중단되었습니다. 일시 중단된 작업을 다시 시작할 수 있습니다. 마지막 검사점에서 다시 시작하거나 검사점이 없는 경우 Runbook의 시작 부분에서 다시 시작합니다. Runbook은 다시 시작할 가능성이 있는 예외의 경우에만 시스템에서 일시 중단됩니다. 기본적으로 ErrorActionPreference는 계속으로 설정됩니다. 즉, 예외가 발생할 때 작업이 계속 실행됩니다. 이 변수를 Stop으로 설정하면 예외가 발생하면 작업이 일시 중단됩니다.
Suspending	시스템은 사용자의 요청에 따라 작업을 일시 중단하려고 시도합니다. Runbook은 먼저 다음 검사점을 도달해야만 일시 중단될 수 있습니다. 마지막 검사점을 이미 통과한 경우 일시 중단되기 전에 완료됩니다.

관리 포털에서 작업 상태 보기

Automation 대시보드에는 SMA 환경의 모든 Runbook에 대한 요약이 표시됩니다.

요약 그래프는 지정된 된 일수 또는 시간 동안 각 상태로 전환된 모든 Runbook의 총 작업 수를 보여줍니다.
그래프의 오른쪽 위 구석에서 시간 범위를 선택할 수 있습니다.
선택한 시간 범위 유형에 따라 차트의 시간 축이 변경됩니다.
화면 위쪽에서 클릭하여 특정 상태의 줄을 표시할지 여부를 선택할 수 있습니다.

다음과 같이 대시보드를 표시합니다.

관리 포털에서 자동화를 선택합니다.
대시보드 탭을 선택합니다.

대시보드 표시

Runbook 대시보드는 단일 Runbook에 대한 요약을 보여줍니다. 요약 그래프는 지정된 일 수 또는 시간 동안 각 상태가 된 Runbook의 총 작업 수를 보여 줍니다. 그래프의 오른쪽 위 모서리에서 시간 범위를 선택할 수 있습니다. 선택한 시간 범위 유형에 따라 차트의 시간 축이 변경됩니다. 화면 위쪽에서 클릭하여 특정 상태의 줄을 표시할지 여부를 선택할 수 있습니다.

다음과 같이 대시보드를 표시합니다.

관리 포털에서 자동화를 선택합니다.
Runbook의 이름을 선택합니다.
대시보드 탭을 선택합니다.

작업 세부 정보 보기

특정 Runbook에 대해 만들어진 모든 작업 및 해당 작업의 최신 상태가 나와 있는 목록을 볼 수 있습니다.

작업 상태 및 작업의 마지막 변경 날짜 범위를 기준으로 목록을 필터링할 수 있습니다.
작업의 이름을 선택하여 자세한 정보 및 출력을 봅니다.
작업의 세부 보기에는 해당 작업에 제공된 Runbook 매개 변수의 값이 포함됩니다.
작업 기록에는 레코드를 만들 때의 타임스탬프와 함께 출력, 경고 및 오류 메시지가 포함됩니다.
Runbook 출력 및 메시지에 대해 자세히 알아봅니다.
작업의 원본은 작업이 실행된 워크플로의 소스 코드입니다. 작업 원본이 작업 실행 후에 업데이트된 경우 Runbook의 현재 버전과 같지 않을 수 있습니다.

다음 단계를 수행하여 Runbook의 작업을 볼 수 있습니다.

관리 포털에서 자동화를 선택합니다.
Runbook의 이름을 선택하고 작업 탭을 선택합니다.
작업의 작업 생성 열을 선택하여 세부 정보 및 출력을 봅니다.
기록 탭을 선택하여 작업 기록을 확인합니다. 기록 레코드를 선택하고 화면 아래쪽에서 세부 정보 보기를 선택하여 레코드에 대한 자세한 보기를 확인합니다.
기록 탭에서 원본 보기를 선택합니다.

Windows PowerShell을 사용하여 작업 상태 검색

Get SmaJob 을 사용하여 Runbook에 대해 만들어진 작업과 특정 작업의 세부 정보를 검색할 수 있습니다.

Start-SmaRunbook을 사용하여 Windows PowerShell에서 Runbook을 시작하면 결과 작업이 반환됩니다.
Get-SmaJobOutput을 사용하여 작업의 출력을 가져옵니다.

다음 샘플 명령은 샘플 Runbook의 마지막 작업을 검색하고 해당 상태, Runbook 매개 변수에 제공된 값 및 작업의 출력을 표시합니다.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Test-Runbook"

$job = (Get-SmaJob -WebServiceEndpoint $webServer -Port $port -RunbookName $runbookName | sort LastModifiedDate -desc)[0]
$job.Status
$job.JobParameters
Get-SmaJobOutput -WebServiceEndpoint $webServer -Port $port -Id $job.Id -Stream Output

Runbook 설정 구성

각 Runbook에는 여러 설정이 있습니다. 이러한 설정을 사용하여 Runbook을 찾고 관리할 수 있습니다. 이러한 설정을 구성하여 Runbook 로깅을 변경할 수도 있습니다. 이러한 각 설정은 아래에 설명된 다음 수정 방법에 대한 절차를 따릅니다.

이름 및 설명

Runbook을 만든 후에는 이름을 변경할 수 없습니다. 설명 은 선택 사항이며 최대 512자까지 사용할 수 있습니다.

로깅

기본적으로 자세한 정보 표시 및 진행률 레코드는 작업 기록에 기록되지 않습니다. 이러한 레코드를 기록하려면 특정 Runbook에 대한 설정을 변경하면 됩니다. 이러한 레코드에 대한 자세한 내용은 Runbook 출력 및 메시지를 참조하세요.

지정된 Runbook Worker

기본적으로 Runbook 작업은 실행할 임의 Runbook Worker에 할당됩니다. 특정 Runbook에 대한 설정을 변경하여 특정 Runbook 작업자에서 Runbook을 실행할 수 있습니다.

관리 포털에서 Runbook 설정 변경

Runbook에 대한 구성 페이지에서 관리 포털의 Runbook에 대한 설정을 변경할 수 있습니다.

관리 포털에서 자동화를 선택합니다.
Runbook 탭을 선택합니다.
Runbook의 이름을 선택합니다.
구성 탭을 선택합니다.

PowerShell을 사용하여 Runbook 설정 변경

Set-SmaRunbookConfiguration cmdlet을 사용하여 태그를 제외한 Runbook의 모든 설정을 변경할 수 있습니다. 관리 포털을 사용하여 기존 Runbook에 대한 태그만 변경하고 추가할 수 있습니다. Import-SmaRunbook을 사용하여 Runbook을 가져올 때만 PowerShell을 사용하여 Runbook에 대한 태그를 설정할 수 있습니다.

다음 명령 예제에서는 Rnbook에 대한 속성을 설정하는 방법을 보여 줍니다. 이 샘플에서는 설명을 추가하고 자세한 정보 표시 레코드를 기록해야 한다고 지정합니다.

$webServer = 'https://MyServer'
$port = 9090
$runbookName = "Sample-TestRunbook"

Set-SmaRunbookConfiguration -WebServiceEndpoint $webServer -Port $port -Name $runbookName -Description "Sample runbook" -LogVerbose $true

Runbook Worker 및 SQL Server 연결 암호화

SSL을 사용하여 Runbook 작업자 프로세스와 SQL Server 간의 연결을 보호합니다.

다음 단계

글로벌 자산 관리에 대해 읽어봅니다.
Microsoft Azure 팩 구현에서 SMA의 역할에 대해 알아봅니다.

다음을 통해 공유