Azure Stack HCI 上の Azure Arc 拡張機能管理

[アーティクル]
01/31/2024

適用対象: Azure Stack HCI バージョン 23H2 および 22H2

この記事では、Azure Stack HCI サーバーマシンに Azure Arc 拡張機能をインストール、アップグレード、管理する方法について説明します。

Azure Stack HCI でのカスタマーマネージド Azure Arc 拡張機能

Azure Stack HCI を使用すると、Azure Stack HCI システムに Azure Arc 拡張機能をインストール、アンインストール、更新できます。 Azure Arc を使用すると、Azure portalで監視やWindows Admin Centerなどのハイブリッドサービスを実行できます。

インストールして管理できる個々の拡張機能を次に示します。

Azure Stack HCI での Azure マネージド拡張機能

新しい Azure Stack HCI クラスターを Azure に正常に登録すると、Azure マネージド拡張機能がクラスターに自動的にインストールされます。これらの拡張機能は、システムの機能と品質に不可欠であり、アンインストールすることはできません。 [拡張機能] ページに移動し、[設定] メニューを選択すると、Azure portalでこれらの拡張機能の動作を管理できます。

これらの拡張機能なしで Azure に登録されている既存の Azure Stack HCI クラスターがある場合は、Azure portalの [概要] ページまたは [拡張機能] ページにバナーが表示されます。バナーの情報を使用して、これらの拡張機能のインストールをガイドできます。

Azure マネージド拡張機能を次に示します。

拡張機能のインストール

拡張機能は、スクリーンショットに示すように、Azure Stack HCI Arc 対応サーバーの [ 機能 ] タブからインストールできます。 [機能] タブを使用して、ほとんどの拡張機能をインストールできます。

Azure portalに拡張機能をインストールすると、クラスター対応の操作になります。拡張機能は、クラスターのすべてのサーバーにインストールされます。クラスターにサーバーを追加すると、クラスターにインストールされているすべての拡張機能が新しいサーバーに自動的に追加されます。

Azure CLI は、Windows、macOS、Linux 環境にインストールできます。また、Azure Cloud Shellで実行することもできます。詳細については、「Azure Cloud Shellのクイックスタート」を参照してください。

Azure Cloud Shellを起動し、Bash を使用して、次の手順に従って拡張機能をインストールします。

サブスクリプション、リソースグループ、クラスターからパラメーターを設定する

subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
resourceGroup="hcicluster-rg" # Replace with your resource group name

az account set --subscription "${subscription}"

clusters=($(az graph query -q "resources | where type == 'microsoft.azurestackhci/clusters'| where resourceGroup =~ '${resourceGroup}' | project name" | jq -r '.data[].name'))

リソースグループのすべてのクラスターにWindows Admin Center拡張機能をインストールするには、次のコマンドを実行します。

extensionName="AdminCenter"
extensionType="AdminCenter"
extensionPublisher="Microsoft.AdminCenter"
settingsConfig="{'port':'6516'}"
connectivityProps="{enabled:true}"

for cluster in ${clusters}; do
    echo "Enabling Connectivity for cluster $currentCluster"
    az stack-hci arc-setting update \
        --resource-group ${resourceGroup} \
        --cluster-name ${cluster} \
        --name "default" \
        --connectivity-properties ${connectivityProps}

    echo "Installing extension: ${extensionName} on cluster: ${cluster}"
    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}" \
        --settings "${settingsConfig}"
done

リソースグループのすべてのクラスターに Azure Monitor エージェント拡張機能をインストールするには、次のコマンドを実行します。

extensionName="AzureMonitorWindowsAgent"
extensionType="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"

for cluster in ${clusters}; do
    echo "Installing extension: ${extensionName} on cluster: ${cluster}"

    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}"
done

リソースグループのすべてのクラスターに Azure Site Recovery 拡張機能をインストールするには、次のコマンドを実行します。

asrSubscription="00000000-0000-0000-0000-000000000000" # Replace with your ASR subscription ID
asrResourceGroup="asr-rg" # Replace with your ASR resource group
asrVaultName="asr-vault" # Replace with your ASR vault name
asrLocation="East US" # Replace with your ASR Location
asrSiteId="00000000-0000-0000-0000-000000000000" # Replace with your ASR Site ID
asrSiteName="asr-site" # Replace with your Site Name
asrSitePolicyId="/subscriptions/${asrSubscription}/resourceGroups/${asrResourceGroup}/providers/Microsoft.RecoveryServices/vaults/${asrVaultName}/replicationPolicies/s-cluster-policy" # Replace with your Site Policy name

extensionName="ASRExtension"
extensionType="Windows"
extensionPublisher="Microsoft.SiteRecovery.Dra"
jsonFile="./tmp-asr.json" #Temp JSON file

echo "{\"SubscriptionId\": \"${asrSubscription}\", \"Environment\": \"AzureCloud\",\"ResourceGroup\": \"${asrResourceGroup}\",\"Location\": \"${asrLocation}\",\"SiteId\": \"${asrSiteId}\", \"SiteName\": \"${asrSiteName}\", \"PolicyId\": \"${asrSitePolicyId}\", \"PrivateEndpointStateForSiteRecovery\": \"None\" }" > ${jsonFile}

for cluster in ${clusters}; do
    echo "Installing extension: ${extensionName} on cluster: ${cluster}"

    az stack-hci extension create \
        --arc-setting-name "default" \
        --cluster-name "${cluster}" \
        --resource-group "${resourceGroup}" \
        --name "${extensionName}" \
        --auto-upgrade "true" \
        --publisher "${extensionPublisher}" \
        --type "${extensionType}" \
        --settings "${jsonFile}"
done

Azure PowerShellは、Azure Cloud Shellで実行できます。このドキュメントでは、Azure Cloud Shell で PowerShell を使用する方法について詳しく説明します。詳細については、「Azure Cloud Shellのクイックスタート」を参照してください。

Azure Cloud Shellを起動し、PowerShell を使用して、次の手順に従って拡張機能をインストールします。

サブスクリプション、リソースグループ、クラスターからパラメーターを設定します。

$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

Set-AzContext -Subscription "${subscription}"
$clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name

リソースグループのすべてのクラスターにWindows Admin Center拡張機能をインストールするには、次のコマンドを実行します。

$extensionName = "AdminCenter"
$extensionType = "AdminCenter"
$extensionPublisher = "Microsoft.AdminCenter"
$settingsConfig = @{"port" = 6516 }

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Enable connectivity for cluster ${clusterName}")
    Invoke-AzRestMethod `
        -Method PATCH `
        -SubscriptionId ${subscription} `
        -ResourceGroupName ${resourceGroup} `
        -ResourceProviderName "Microsoft.AzureStackHCI" `
        -ResourceType ("clusters/" + ${clusterName} + "/arcSettings") `
        -Name "default" `
        -ApiVersion "2023-02-01" `
        -Payload (@{"properties" = @{ "connectivityProperties" = @{ "enabled" = $true } } } | ConvertTo-Json -Depth 5)


    Write-Output ("Installing Extension '${extensionName}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}" `
        -ExtensionParameterSetting ${settingsConfig} `
        -NoWait
}

リソースグループのすべてのクラスターに Azure Monitor エージェント拡張機能をインストールするには、次のコマンドを実行します。

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}"
}

リソースグループのすべてのクラスターに Azure Site Recovery 拡張機能をインストールするには、JSON パラメーターファイルを作成し、次のコマンドを実行します。

$settings = @{
    SubscriptionId = "<Replace with your Subscription Id>"
    Environment = "<Replace with the cloud environment type. For example: AzureCloud>"
    ResourceGroup = "<Replace with your Site Recovery Vault resource group>"
    ResourceName = "<Replace with your Site Recovery Vault Name>"
    Location = "<Replace with your Site Recovery Azure Region>"
    SiteId = "<Replace with the ID of your recovery site>"
    SiteName = "<Replace with your recovery site name>"
    PolicyId = "<Replace with resource ID of your recovery site policy>"
    PrivateEndpointStateForSiteRecovery = "None"
}

$extensionName = "ASRExtension"
$extensionType = "Windows"
$extensionPublisher = "Microsoft.SiteRecovery.Dra"

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name

    Write-Output ("Installing Extension '${extensionType}/${extensionPublisher}' on cluster ${clusterName}")

    New-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default" `
        -Name "${extensionName}" `
        -ExtensionParameterPublisher "${extensionPublisher}" `
        -ExtensionParameterType "${extensionType}" `
        -ExtensionParameterSetting ${settings} `
        -NoWait
}

拡張機能の状態を確認する

各サーバーの拡張機能の状態を [拡張機能] ページからチェックするには、グリッドの状態列を表示します。

Azure Cloud Shell を起動し、Bash を使用して、次の手順に従って拡張機能の状態をチェックします。

サブスクリプション、リソースグループ、クラスター名、拡張機能名からパラメーターを設定する

subscription="00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name
extensionName="AzureMonitorWindowsAgent" # Replace with the extension name

az account set --subscription "${subscription}"

クラスター上のすべての拡張機能を一覧表示するには、次のコマンドを実行します。

az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
-o table

のような AzureMonitorWindowsAgent特定の拡張機能をフィルター処理するには、次のコマンドを実行します。

az stack-hci extension list \
--arc-setting-name "default" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}" \
--query "[?name=='${extensionName}'].{Name:name, ManagedBy:managedBy, ProvisionStatus:provisioningState, State:aggregateState, Type:extensionParameters.type}" \
-o table

Azure Cloud Shell を起動し、PowerShell を使用して、次の手順に従って拡張機能の状態をチェックします。

サブスクリプション、リソースグループ、クラスター名からパラメーターを設定する

$subscription = "00000000-0000-0000-0000-000000000000" # Replace with your subscription ID
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

Set-AzContext -Subscription "${subscription}"
$clusters = Get-AzResource -ResourceType "Microsoft.AzureStackHCI/clusters" -ResourceGroupName ${resourceGroup} | Select-Object -Property Name

クラスター上のすべての拡張機能を一覧表示するには、次のコマンドを実行します。

foreach ($cluster in $clusters) {
    $clusterName = ${cluster}.Name
    Get-AzStackHciExtension `
        -ClusterName "${clusterName}" `
        -ResourceGroupName "${resourceGroup}" `
        -ArcSettingName "default"|Format-Table -Property Name, ParameterType, ParameterPublisher, ParameterEnableAutomaticUpgrade, ProvisioningState
}

拡張機能のアップグレードのしくみ

拡張機能パブリッシャーチームによって発行されると、拡張機能のアップグレードプロセスによって、既存の拡張機能のバージョンが新しくサポートされている拡張機能のバージョンに置き換えられます。既定では、自動アップグレードを明示的にオプトアウトしない限り、Azure Stack HCI Arc 対応クラスターにデプロイされているすべての拡張機能に対して拡張機能の自動アップグレード機能が有効になります。

現在、拡張機能の自動アップグレードはWindows Admin Center拡張機能でのみサポートされていますが、今後さらに拡張機能が追加される予定です。

注意

既定では、拡張機能が拡張機能の自動アップグレードをサポートしていない場合でも、すべての拡張機能が自動アップグレードを有効にするように設定されます。ただし、拡張機能の発行元が拡張機能の自動アップグレードをサポートすることを選択するまで、この既定の設定は有効になりません。

拡張機能の自動アップグレードを有効にする

一部の拡張機能では、拡張機能管理を使用して自動アップグレードを有効にすることができます。

自動アップグレードを有効にするには、[ 拡張機能 ] ページに移動し、次の手順を実行します。

自動アップグレードを有効にする拡張機能を選択します。
上部のメニューから [自動アップグレードを有効にする] を選択します
意図の確認を求められたら、[ OK] を選択します。

特定の拡張機能 AzureMonitorWindowsAgent の自動アップグレードをインストールして有効にするには、次のコマンドを実行します。

clusterName="HCICluster" # Replace with your cluster name
resourceGroup="hcicluster-rg" # Replace with your resource group name

extensionName="AzureMonitorWindowsAgent"
extensionPublisher="Microsoft.Azure.Monitor"
extensionType="AzureMonitorWindowsAgent"

az stack-hci extension create \
    --name "${extensionName}" \
    --arc-setting-name "default" \
    --cluster-name "${clusterName}" \
    --resource-group "${resourceGroup}" \
    --publisher ${extensionPublisher} \
    --type ${extensionType} \
    --auto-upgrade "true"

特定の拡張機能 AzureMonitorWindowsAgent の自動アップグレードをインストールして有効にするには、次のコマンドを実行します。

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"
$extensionType = "AzureMonitorWindowsAgent"
$extensionPublisher = "Microsoft.Azure.Monitor"

New-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}" `
    -ExtensionParameterPublisher "${extensionPublisher}" `
    -ExtensionParameterType "${extensionType}" `
    -ExtensionParameterEnableAutomaticUpgrade

Azure portalを使用した拡張機能の手動アップグレード

拡張機能の手動アップグレードは、拡張機能の自動アップグレードと同様に機能します。 Azure Stack HCI Arc 対応クラスターでは、拡張機能を手動でアップグレードすると、選択したバージョンが保存されます。その後、Azure はクラスター内のすべてのサーバー上の拡張機能をそのバージョンにアップグレードしようとします。

一部のサーバーでは、拡張機能のアップグレードに失敗した場合、プラットフォームは次の Azure Stack HCI クラウド同期中に選択したバージョンへのアップグレードを試みます。

次のシナリオでは、手動ワークフローを使用します。

拡張機能の新しいバージョンを使用でき、手動でアップグレードする必要があります。
拡張機能の自動アップグレードオプションは無効になっており、Azure Stack HCI クラスターのさまざまなサーバー間でバージョンが一致しません。

拡張機能を手動でアップグレードするには、次の手順に従います。

[拡張機能] ページに移動します。
アップグレードする拡張機能を選択し、上部のメニューから [設定] を選択します。
最新バージョンを選択し、[ 保存] を選択します。

拡張機能の自動アップグレードを無効にする

Azure portalで特定の拡張機能の自動アップグレードを無効にすることができます。自動アップグレードを無効にするには、[ 拡張機能 ] ページに移動し、次の手順を実行します。

自動アップグレードを無効にする拡張機能を選択します。
上部のメニューから [ 自動アップグレードを無効にする] を選択 します。
意図の確認を求められたら、[ OK] を選択します。

拡張機能のアップグレード履歴を確認する

個々の Azure Arc 対応サーバーリソース、リソースグループ、サブスクリプションの [アクティビティログ] タブを表示して、個々のクラスターサーバーの拡張機能の自動アップグレードの履歴をチェックできます。詳細については、「拡張機能の自動アップグレード履歴を確認する」を参照してください。

可用性優先の更新

アップグレード中の Azure Stack HCI Arc 対応クラスターのグループの場合、Azure プラットフォームは自動拡張機能アップグレードモデルを使用してアップグレードを調整しました。

拡張機能の自動アップグレードのタイミング

サポートされている拡張機能の新しいバージョンが公開されると、Azure Arc 対応サーバーでのインストールと手動アップグレードが可能になります。アップグレードは Azure リージョンとサブスクリプション全体でバッチで発行されるため、一部のサーバーでは拡張機能のアップグレードが他のサーバーよりも前に行われる場合があります。詳細については、「拡張機能の自動アップグレードのタイミング」を参照してください。

拡張機能をすぐにアップグレードするには、「Azure portalを使用した拡張機能の手動アップグレード」を参照してください。

自動ロールバックと再試行

拡張機能のアップグレードに失敗した場合、Azure は自動ロールバックに関連付けられているアクションを実行し、拡張機能の修復を試みるために再試行します。

拡張機能のアップグレードで問題が引き続き発生する場合は、拡張機能の自動アップグレードを無効にすることができます。自動アップグレードを無効にすると、問題のトラブルシューティング中にシステムの再試行が防止されます。準備が整った時点で再び拡張機能の自動アップグレードを有効にできます。

複数の拡張機能を使用したアップグレード

1 台のマシンで複数の拡張機能のアップグレードを使用できる場合は、一緒にバッチ処理される可能性があります。ただし、各拡張機能のアップグレードはマシン上で個別に適用されます。詳細については、「複数の拡張機能を使用した拡張機能のアップグレード」を参照してください。

拡張機能をアンインストールする

必要に応じて、Azure portal内の Azure Stack HCI クラスターから一部の拡張機能をアンインストールできます。拡張機能をアンインストールするには、次の手順に従います。

[拡張機能] ページに移動します。
アンインストールする拡張機能を選択します。アンインストールボタンは、Azure マネージド拡張機能では使用できません。
上部のメニューから [ アンインストール ] を選択します。
意図を確認し、[ はい] を選択します。

などの AzureMonitorWindowsAgent 特定の拡張機能を削除するには、次のコマンドを実行します。

extensionName="AzureMonitorWindowsAgent" # Replace with the extension name
resourceGroup="hcicluster-rg" # Replace with your resource group name
clusterName="HCICluster" # Replace with your cluster name

az stack-hci extension delete \
--arc-setting-name "default" \
--name "${extensionName}" \
--cluster-name "${clusterName}" \
--resource-group "${resourceGroup}"

などの AzureMonitorWindowsAgent 特定の拡張機能を削除するには、次のコマンドを実行します。

$clusterName = "HCICluster" # Replace with your cluster name
$resourceGroup = "hcicluster-rg" # Replace with your resource group name

$extensionName = "AzureMonitorWindowsAgent"

Remove-AzStackHciExtension `
    -ClusterName "${clusterName}" `
    -ResourceGroupName "${resourceGroup}" `
    -ArcSettingName "default" `
    -Name "${extensionName}"

拡張機能のエラーのトラブルシューティング

拡張機能の状態: 失敗

推奨事項: 失敗した状態の拡張機能の場合は、[ 失敗 (詳細の表示)] リンクを選択します。エラーに関するすべての情報を表示し、トラブルシューティングのヒントを適用します。

次のステップ

Azure Arc 対応サーバーを使用した仮想マシン拡張機能の管理について説明します。

次の方法で共有

Azure Stack HCI 上の Azure Arc 拡張機能管理

Azure Stack HCI でのカスタマーマネージド Azure Arc 拡張機能

Azure Stack HCI での Azure マネージド拡張機能

拡張機能のインストール

拡張機能の状態を確認する

拡張機能のアップグレードのしくみ

拡張機能の自動アップグレードを有効にする

Azure portalを使用した拡張機能の手動アップグレード

拡張機能の自動アップグレードを無効にする

拡張機能のアップグレード履歴を確認する

可用性優先の更新

拡張機能の自動アップグレードのタイミング

自動ロールバックと再試行

複数の拡張機能を使用したアップグレード

拡張機能をアンインストールする

拡張機能のエラーのトラブルシューティング

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Stack HCI 上の Azure Arc 拡張機能管理

Azure Stack HCI でのカスタマー マネージド Azure Arc 拡張機能

Azure Stack HCI での Azure マネージド拡張機能

拡張機能のインストール

拡張機能の状態を確認する

拡張機能のアップグレードのしくみ

拡張機能の自動アップグレードを有効にする

Azure portalを使用した拡張機能の手動アップグレード

拡張機能の自動アップグレードを無効にする

拡張機能のアップグレード履歴を確認する

可用性優先の更新

拡張機能の自動アップグレードのタイミング

自動ロールバックと再試行

複数の拡張機能を使用したアップグレード

拡張機能をアンインストールする

拡張機能のエラーのトラブルシューティング

次のステップ

フィードバック

その他のリソース

Azure Stack HCI でのカスタマーマネージド Azure Arc 拡張機能