Azure Stack HCI'de Azure Arc uzantısı yönetimi

Şunlar için geçerlidir: Azure Stack HCI, sürüm 23H2 ve 22H2

Bu makalede, Azure Stack HCI sunucu makinelerinde Azure Arc uzantılarını yükleme, yükseltme ve yönetme işlemleri açıklanır.

Azure Stack HCI'de müşteri tarafından yönetilen Azure Arc uzantıları

Azure Stack HCI ile Azure Stack HCI sistemlerinize Azure Arc uzantılarını yükleyebilir, kaldırabilir ve güncelleştirebilirsiniz. Azure Arc, Azure portal izleme ve Windows Admin Center gibi karma hizmetleri çalıştırmanıza olanak tanır.

Yükleyip yönetebileceğiniz tek tek uzantılar aşağıdadır.

• Azure İzleme Aracısı
• Azure Site Recovery
• Windows Yönetim Merkezi

Azure Stack HCI'de Azure tarafından yönetilen uzantılar

Yeni Azure Stack HCI kümenizi Azure'a başarıyla kaydettikten sonra Azure tarafından yönetilen uzantılar kümenize otomatik olarak yüklenir. Bu uzantılar, sisteminizin işlevselliği ve kalitesi için gereklidir ve kaldırılamaz. Uzantılar sayfasına gidip Ayarlar menüsünü seçerek bu uzantıların davranışını Azure portal yönetebilirsiniz.

Bu uzantılar olmadan Azure'a kayıtlı bir Azure Stack HCI kümeniz varsa, Azure portal Genel Bakış veya Uzantılar sayfasında bir başlık gösterilir. Bu uzantıları yükleme konusunda size yol göstermek için başlıktaki bilgileri kullanabilirsiniz.

Azure tarafından yönetilen uzantılar şunlardır:

• Telemetri ve tanılama
• Uzaktan Destek Arc uzantısı

Uzantı yükleme

Azure portalı

Uzantıları, ekran görüntüsünde gösterildiği gibi Azure Stack HCI Arc özellikli sunucularınızın Özellikler sekmesinden yükleyebilirsiniz. Çoğu uzantıyı yüklemek için yetenekler sekmesini kullanabilirsiniz.

Azure portal bir uzantı yüklediğinizde, bu küme algılayan bir işlemdir. Uzantı, kümenin tüm sunucularına yüklenir. Kümenize daha fazla sunucu eklerseniz, kümenizde yüklü olan tüm uzantılar yeni sunuculara otomatik olarak eklenir.

Azure CLI

Azure CLI, Windows, macOS ve Linux ortamlarında yüklenebilir. Azure Cloud Shell'da da çalıştırılabilir. Daha fazla bilgi için bkz. Azure Cloud Shell için hızlı başlangıç.

Azure Cloud Shell başlatın ve bash kullanarak şu adımları izleyerek bir uzantı yükleyin:

1. Aboneliğinizden, kaynak grubunuzdan ve kümelerinizden parametreleri ayarlama

   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'))
   

2. Windows Admin Center uzantısını kaynak grubu altındaki tüm kümelere yüklemek için aşağıdaki komutu çalıştırın:

   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
   

3. Azure İzleyici Aracısı uzantısını kaynak grubu altındaki tüm kümelere yüklemek için aşağıdaki komutu çalıştırın:

   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
   

4. Azure Site Recovery uzantısını kaynak grubu altındaki tüm kümelere yüklemek için aşağıdaki komutu çalıştırın:

   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 PowerShell Azure Cloud Shell'da çalıştırılabilir. Bu belgede, Azure Cloud Shell'de PowerShell'in nasıl kullanılacağı ayrıntılı olarak anlatılmaktadır. Daha fazla bilgi için bkz. Azure Cloud Shell için hızlı başlangıç.

Azure Cloud Shell başlatın ve powershell kullanarak aşağıdaki adımları izleyerek bir uzantı yükleyin:

1. Aboneliğinizden, kaynak grubunuzdan ve kümelerinizden parametreleri ayarlayın:

   $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
   

2. Windows Admin Center uzantısını kaynak grubu altındaki tüm kümelere yüklemek için aşağıdaki komutu çalıştırın:

   $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
   }
   

3. Azure İzleyici Aracısı uzantısını kaynak grubu altındaki tüm kümelere yüklemek için aşağıdaki komutu çalıştırın:

   $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}"
   }
   

4. Azure Site Recovery uzantısını kaynak grubu altındaki tüm kümelere yüklemek için bir JSON parametre dosyası oluşturun ve aşağıdaki komutu çalıştırın:

   $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
   }
   

Uzantı durumunu denetleme

Azure portalı

Kılavuzdaki durum sütununu görüntüleyerek Uzantılar sayfasından her sunucudaki bir uzantının durumunu de kontrol edebilirsiniz.

Azure CLI

Azure CLI, Windows, macOS ve Linux ortamlarında yüklenebilir. Azure Cloud Shell'da da çalıştırılabilir. Daha fazla bilgi için bkz. Azure Cloud Shell için hızlı başlangıç.

Azure Cloud Shell'ı başlatın ve bash kullanarak aşağıdaki adımları izleyerek bir uzantının durumunu denetleyin:

1. Aboneliğinizden, kaynak grubunuzdan, küme adınızdan ve uzantı adınızdan parametreleri ayarlama

   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}"
   

2. Kümedeki tüm uzantıları listelemek için aşağıdaki komutu çalıştırın:

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

3. gibi AzureMonitorWindowsAgentbelirli bir uzantıyı filtrelemek için aşağıdaki komutu çalıştırın:

   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 PowerShell

Azure PowerShell Azure Cloud Shell'da çalıştırılabilir. Bu belgede, Azure Cloud Shell'de PowerShell'in nasıl kullanılacağı ayrıntılı olarak anlatılmaktadır. Daha fazla bilgi için bkz. Azure Cloud Shell için hızlı başlangıç.

Azure Cloud Shell başlatın ve powershell kullanarak aşağıdaki adımları izleyerek bir uzantının durumunu denetleyin:

1. Aboneliğinizden, kaynak grubunuzdan ve küme adınızdan parametreleri ayarlama

   $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
   

2. Kümedeki tüm uzantıları listelemek için aşağıdaki komutu çalıştırın:

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

Uzantı yükseltme nasıl çalışır?

Uzantı yayımcısı ekibi tarafından yayımlandığında, uzantı yükseltme işlemi mevcut uzantı sürümünü yeni desteklenen bir sürümle değiştirir. Varsayılan olarak otomatik uzantı yükseltme özelliği, otomatik yükseltmeleri açıkça geri çevirmediğiniz sürece Azure Stack HCI Arc özellikli kümelerde dağıtılan tüm uzantılar için etkinleştirilir.

Şu anda otomatik uzantı yükseltmeleri yalnızca Windows Admin Center uzantısında desteklenmektedir, ancak gelecekte daha fazla uzantı eklenecektir.

Not

Varsayılan olarak, bir uzantı otomatik uzantı yükseltmesini desteklemese bile tüm uzantılar otomatik yükseltmeleri etkinleştirecek şekilde ayarlanır. Ancak, uzantı yayımcısı otomatik uzantı yükseltmesini desteklemeyi seçene kadar bu varsayılan ayarın hiçbir etkisi olmaz.

Otomatik uzantı yükseltmesini etkinleştirme

Azure portalı

Bazı uzantılar için, uzantı yönetimi aracılığıyla otomatik yükseltmeleri etkinleştirebilirsiniz.

Otomatik yükseltmeyi etkinleştirmek için Uzantılar sayfasına gidin ve şu adımları uygulayın:

1. Otomatik yükseltmeyi etkinleştirmek istediğiniz uzantıyı seçin.

2. Üstteki menüden Otomatik yükseltmeyi etkinleştir'i seçin

   

3. Amacınızı onaylamanız istendiğinde Tamam'ı seçin.

   

Azure CLI

Aşağıdaki komutu çalıştırmak gibi AzureMonitorWindowsAgent belirli bir uzantı için otomatik yükseltmeyi yüklemek ve etkinleştirmek için:

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"

Azure PowerShell

Aşağıdaki komutu çalıştırmak gibi AzureMonitorWindowsAgent belirli bir uzantı için otomatik yükseltmeyi yüklemek ve etkinleştirmek için:

$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 aracılığıyla el ile uzantı yükseltme

El ile uzantı yükseltmesi , Otomatik uzantı yükseltmesi gibi çalışır. Azure Stack HCI Arc özellikli bir kümede, bir uzantıyı el ile yükselttiğiniz zaman, Azure seçtiğiniz sürümü kaydeder. Azure daha sonra kümedeki tüm sunuculardaki uzantıyı bu sürüme yükseltmeyi dener.

Bazı sunucularda, uzantı yükseltmesi başarısız olursa platform bir sonraki Azure Stack HCI bulut eşitlemesi sırasında seçilen sürüme yükseltmeyi dener.

Bu senaryolarda el ile iş akışını kullanın:

• Uzantının yeni bir sürümü kullanılabilir ve el ile yükseltmek istiyorsunuz.

• Uzantının otomatik yükseltme seçeneği devre dışı bırakıldı ve Azure Stack HCI kümesinin farklı sunucularında sürüm uyuşmazlığı var.

Bir uzantıyı el ile yükseltmek için şu adımları izleyin:

1. Uzantılar sayfasına gidin.

2. Yükseltmek istediğiniz uzantıyı seçin ve üstteki menüden Ayarlar'ı seçin.

   

3. En son sürümü seçin ve Kaydet'i seçin.

Otomatik uzantı yükseltmeyi devre dışı bırakma

Azure portal belirli uzantılar için otomatik yükseltmeleri devre dışı bırakabilirsiniz. Otomatik yükseltmeleri devre dışı bırakmak için Uzantılar sayfasına gidin ve şu adımları gerçekleştirin:

1. Otomatik yükseltmeyi devre dışı bırakmak istediğiniz uzantıyı seçin.

2. Üstteki menüden Otomatik yükseltmeyi devre dışı bırak'ı seçin.

   

3. Amacınızı onaylamanız istendiğinde Tamam'ı seçin.

   

Uzantı yükseltme geçmişini denetleme

Tek tek küme sunucuları için otomatik uzantı yükseltmelerinin geçmişini denetlemek için Tek tek Azure Arc özellikli sunucu kaynakları, kaynak grupları ve aboneliklerde Etkinlik Günlüğü sekmesini görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Otomatik uzantı yükseltme geçmişini denetleme.

Kullanılabilirlik öncelikli güncelleştirmeler

Yükseltmeden geçen bir grup Azure Stack HCI Arc özellikli küme için Azure platformu, yükseltmeleri yönetmek için Otomatik uzantı yükseltme modelini kullandı.

Otomatik uzantı yükseltmelerinin zamanlaması

Desteklenen bir uzantının yeni bir sürümü yayımlandığında, Azure Arc özellikli sunucularda yükleme ve el ile yükseltme için kullanılabilir hale gelir. Yükseltmeler Azure bölgeleri ve abonelikleri genelinde toplu olarak verilir, bu nedenle bazı sunucularda diğerlerinden önce bir uzantı yükseltmesi olduğunu görebilirsiniz. Daha fazla bilgi için bkz . Otomatik uzantı yükseltmelerinin zamanlaması.

Bir uzantıyı hemen yükseltmek için bkz. Azure portal aracılığıyla el ile uzantı yükseltme.

Otomatik geri alma ve yeniden denemeler

Uzantı yükseltmesi başarısız olursa, Azure Otomatik geri alma ile ilişkili eylemleri gerçekleştirir ve uzantıyı onarma girişiminde yeniden dener.

Uzantı yükseltmesi ile ilgili sorun devam ederse , otomatik uzantı yükseltmeyi devre dışı bırakabilirsiniz. Otomatik yükseltmeyi devre dışı bırakırsanız, siz sorunu giderirken sistem yeniden denemelerini engeller. Hazır olduğunuzda otomatik uzantı yükseltmeyi yeniden etkinleştirebilirsiniz .

Birden çok uzantılı yükseltmeler

Bir makine için birden çok uzantı yükseltmesi varsa, bunlar birlikte toplu hale getirilebilir. Ancak, her uzantı yükseltmesi makineye tek tek uygulanır. Daha fazla bilgi için bkz . Birden çok uzantılı uzantı yükseltmeleri.

Uzantıyı kaldırma

Azure portalı

İsterseniz Azure portal Azure Stack HCI kümelerinizden bazı uzantıları kaldırabilirsiniz. Uzantıyı kaldırmak için şu adımları kullanın:

1. Uzantılar sayfasına gidin.

2. Kaldırmak istediğiniz uzantıyı seçin. Kaldırma düğmesi Azure tarafından yönetilen uzantılar için kullanılamaz.

   

3. Üstteki menüden Kaldır'ı seçin.

4. Amacı onaylayın ve Evet'i seçin.

   

Azure CLI

Gibi AzureMonitorWindowsAgent belirli bir uzantıyı kaldırmak için aşağıdaki komutu çalıştırın:

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}"

Azure PowerShell

Gibi AzureMonitorWindowsAgent belirli bir uzantıyı kaldırmak için aşağıdaki komutu çalıştırın:

$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}"

Uzantı hatalarını giderme

Uzantı Durumu: Başarısız

Öneri: Başarısız duruma sahip bir uzantı için Başarısız (Ayrıntıları görüntüle) bağlantısını seçin. Hata hakkındaki tüm bilgileri görüntüleyin ve sorun giderme ipuçlarını uygulayın.

Sonraki adım

Azure Arc özellikli sunucularla sanal makine uzantısı yönetimi hakkında bilgi edinin.