Automatyczna aktualizacja i powiadomienie o wygaśnięciu samodzielnego środowiska uruchomieniowego Integration Runtime

DOTYCZY: Azure Data Factory Azure Synapse Analytics

W tym artykule opisano sposób automatycznego zaktualizowania własnego środowiska Integration Runtime do najnowszej wersji oraz sposobu, w jaki Azure Data Factory (ADF) zarządza wersjami własnego środowiska Integration Runtime.

Jak sprawdzić wersję samodzielnie hostowanego środowiska Integration Runtime

Możesz sprawdzić wersję w kliencie własnego środowiska Integration Runtime lub w portalu usługi ADF:

Automatyczna aktualizacja lokalnego środowiska uruchomieniowego integracji

Ogólnie rzecz biorąc, podczas instalowania własnego środowiska Integration Runtime na komputerze lokalnym lub maszynie wirtualnej Azure masz dwie opcje zarządzania wersją własnego środowiska Integration Runtime: autoaktualizacją lub konserwacją ręczną. Zazwyczaj usługa ADF zwalnia jedną nową wersję własnego środowiska Integration Runtime co miesiąc, która obejmuje nowe funkcje wydane, naprawione błędy i ulepszenia. Dlatego zalecamy użytkownikom aktualizację do najnowszej wersji.

Najwygodniejszym sposobem jest włączenie automatycznej aktualizacji podczas tworzenia lub edytowania własnego środowiska Integration Runtime. Własne środowisko Integration Runtime jest automatycznie aktualizowane do nowszej wersji. Możesz również zaplanować aktualizację w najbardziej odpowiednim przedziale czasu, tak jak chcesz.

Możesz sprawdzić datę ostatniej aktualizacji w kliencie własnego środowiska Integration Runtime.

Możesz użyć tego polecenia programu PowerShell, aby pobrać wersję autoaktualizacji.

Automatyczna aktualizacja wersji vs najnowsza wersja

Aby zapewnić stabilność własnego środowiska Integration Runtime, co miesiąc publikujemy nową wersję i wypychamy automatyczną aktualizację co trzy miesiące przy użyciu stabilnej wersji z poprzednich trzech miesięcy. Dlatego może się okazać, że wersja automatycznieaktualizowana jest poprzednią wersją rzeczywistej najnowszej wersji. Jeśli chcesz uzyskać najnowszą wersję, możesz przejść do centrum pobierania i zrobić to ręcznie. Ponadto automatyczna aktualizacja nowej wersji jest zarządzana wewnętrznie. Nie można go zmienić.

Strona automatycznej aktualizacji samodzielnie hostowanego środowiska Integration Runtime w portalu ADF wyświetla nowszą wersję, jeśli obecna wersja jest przestarzała. Gdy lokalne środowisko Integration Runtime działa w trybie online, ta wersja jest wersją automatycznej aktualizacji i automatycznie aktualizuje środowisko w zaplanowanym czasie. Jeśli jednak własne środowisko Integration Runtime jest w trybie offline, strona zawiera tylko najnowszą wersję.

Portal nie oferuje wyboru daty. Oznacza to, że można wybrać tylko godzinę, podczas gdy data jest określana przez system zaplecza. Zazwyczaj data zostanie ustawiona na kilka dni po odebraniu przez własne środowisko Integration Runtime powiadomienia o automatycznej aktualizacji, co daje klientom wystarczający czas na dokonanie wyboru.

Jeśli masz wiele węzłów i z niektórych powodów niektóre z nich nie zostały pomyślnie automatycznie zaktualizowane. Następnie te węzły są przywracane do wersji, która była taka sama we wszystkich węzłach przed automatycznym aktualizacją.

Powiadomienie o wygaśnięciu samodzielnie hostowanego Integration Runtime

Jeśli chcesz ręcznie kontrolować wersję własnego środowiska Integration Runtime, możesz wyłączyć ustawienie autoaktualizacji i zainstalować je ręcznie. Każda wersja samodzielnie hostowanego środowiska Integration Runtime wygasa w ciągu jednego roku. Wygasający komunikat jest wyświetlany w portalu usługi ADF i w kliencie zainstalowanym lokalnie środowiska uruchomieniowego integracji 90 dni przed wygaśnięciem.

Po otrzymaniu powiadomienia o wygaśnięciu możesz użyć następującego polecenia programu PowerShell, aby znaleźć wszystkie wygasłe i wygasające lokalne środowiska uruchomieniowe integracji w swoim środowisku. Następnie można je odpowiednio uaktualnić.

$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

Powiązana zawartość

• Zapoznaj się z pojęciami integration runtime w Azure Data Factory.
• Dowiedz się, jak tworzeć własne środowisko Integration Runtime w portalu Azure.