자체 호스팅 통합 런타임 자동 업데이트 및 만료 알림

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!

이 문서에서는 자체 호스팅 통합 런타임을 최신 버전으로 자동 업데이트하는 방법과 ADF(Azure Data Factory)가 자체 호스팅 통합 런타임 버전을 관리하는 방법을 설명합니다.

자체 호스팅 통합 런타임 버전을 확인하는 방법

자체 호스팅 통합 런타임 클라이언트 또는 ADF 포털에서 버전을 확인할 수 있습니다.

자체 호스팅 통합 런타임 자동 업데이트

일반적으로 자체 호스팅 통합 런타임을 로컬 컴퓨터 또는 Azure 가상 머신에 설치하는 경우 자체 호스팅 통합 런타임의 버전을 관리하는 두 가지 옵션인 자동 업데이트 또는 수동 관리가 있습니다. 일반적으로 ADF는 새로운 기능 릴리스, 버그 수정 및 향상된 기능을 포함하는 두 가지 새로운 버전의 자체 호스팅 통합 런타임을 매달 릴리스합니다. 따라서 사용자들은 최신 버전으로 업데이트하는 것이 좋습니다.

가장 편리한 방법은 자체 호스팅 통합 런타임을 만들거나 편집할 때 자동 업데이트를 사용하도록 설정하는 것입니다. 자체 호스팅 통합 런타임은 자동으로 최신 버전으로 업데이트됩니다. 원하는 시간 슬롯에 업데이트를 예약할 수도 있습니다.

자체 호스팅 통합 런타임 클라이언트에서 마지막 업데이트 날짜/시간을 확인할 수 있습니다.

이 PowerShell 명령을 사용하여 자동 업데이트 버전을 다운로드할 수 있습니다.

참고 항목

자체 호스팅 통합 런타임 노드가 여러 개 있는 경우 자동 업데이트 중에 가동이 중지되지 않습니다. 다른 노드에서 작업을 진행하는 동안 한 노드에서 먼저 자동 업데이트가 수행됩니다. 첫 번째 노드에서 업데이트가 완료되면 다른 노드가 업데이트될 때 나머지 작업을 인수합니다. 자체 호스팅 통합 런타임이 하나만 있는 경우 자동 업데이트 중에 약간 가동이 중지됩니다.

자동 업데이트 버전과 최신 버전

자체 호스팅 통합 런타임의 안정성을 보장하기 위해 두 가지 버전이 릴리스되더라도 매달 한 가지 버전만 푸시됩니다. 따라서 경우에 따라 자동 업데이트 버전이 실제 최신 버전보다 이전 버전인 것을 확인할 수 있습니다. 최신 버전을 받으려면 다운로드 센터로 이동하여 수동으로 설치하면 됩니다. 또한 새 버전에 대한 자동 업데이트는 내부적으로 관리됩니다. 변경할 수 없습니다.

현재 버전이 오래된 경우 ADF 포털의 자체 호스팅 통합 런타임 자동 업데이트 페이지에 최신 버전이 표시됩니다. 자체 호스팅 통합 런타임이 온라인 상태인 경우 이 버전이 자동 업데이트 버전이며, 예약된 시간에 자체 호스팅 통합 런타임을 자동으로 업데이트합니다. 그러나 자체 호스팅 통합 런타임이 오프라인인 경우 이 페이지에 최신 버전만 표시됩니다.

노드가 여러 개이고 어떤 이유로 일부 노드가 자동으로 업데이트되지 않는 경우입니다. 그러면 이러한 노드는 자동 업데이트 전에 모든 노드에서 동일했던 버전으로 롤백됩니다.

자체 호스팅 통합 런타임 만료 알림

자체 호스팅 통합 런타임의 버전을 수동으로 제어하려는 경우 자동 업데이트 설정을 해제하고 수동으로 설치할 수 있습니다. 자체 호스팅 통합 런타임의 각 버전은 1년 후에 만료됩니다. 만료 메시지는 ADF 포털 및 자체 호스팅 통합 런타임 클라이언트에 만료 90일 전부터 표시됩니다.

만료된 알림을 받으면 아래 PowerShell 명령을 사용하여 사용자 환경에서 만료되고 만료된 자체 호스팅 통합 런타임을 모두 찾을 수 있습니다. 그런 다음 그에 따라 업그레이드할 수 있습니다.

$upperVersion = "<expiring version>" # the format is [major].[minor]. For example: 5.25
$subscription = "<subscription id>"
 
az login
az account set --subscription "$subscription"
 
$factories = az datafactory list | ConvertFrom-Json
 
$results = @();
for ($i = 0; $i -lt $factories.Count; $i++) {
    $factory = $factories[$i]
    Write-Progress -Activity "Checking data factory '$($factory.name)'" -PercentComplete $($i * 100.0 / $factories.Count)
    $shirs = az datafactory integration-runtime list --factory-name $factory.name --resource-group $factory.resourceGroup | ConvertFrom-Json | Where-Object {$_.properties.type -eq "SelfHosted"}
    for ($j = 0; $j -lt $shirs.Count; $j++) {
        $shir = $shirs[$j]
        Write-Progress -Activity "Checking data factory '$($factory.name)', checking integration runtime '$($shir.name)'" -PercentComplete $($i * 100.0 / $factories.Count + (100.0 * $j / ($factories.Count * $shirs.Count)))
        $status = az datafactory integration-runtime get-status --factory-name $factory.name --resource-group $factory.resourceGroup --integration-runtime-name $shir.name | ConvertFrom-Json
        $shirVersion = $status.properties.version
        $result = @{
            subscription = $subscription
            resourceGroup = $factory.resourceGroup
            factory = $factory.name
            integrationRuntime = $shir.name
            integrationRuntimeVersion = $shirVersion
            expiring_or_expired = (-not [string]::IsNullOrWhiteSpace($shirVersion) -and ((([Version]$shirVersion) -lt ([Version]"$($upperVersion).0.0")) -or $shirVersion.StartsWith("$($upperVersion).")))
        }
        $result | Format-Table -AutoSize
        $results += [PSCustomObject]$result
    }
}
 
Write-Host "Expiring or expired Self-Hosted Integration Runtime includes: "
$results | Where-Object {$_.expiring_or_expired -eq $true} | Select-Object -Property subscription,resourceGroup,factory,integrationRuntime,integrationRuntimeVersion | Format-Table -AutoSize

관련 콘텐츠

• Azure Data Factory의 통합 런타임 개념을 검토합니다.
• Azure Portal에서 자체 호스팅 통합 런타임을 만드는 방법을 알아봅니다.