Ş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 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.
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, 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:
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'))
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
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
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 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:
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
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:
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
}
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, 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:
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}"
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
gibi AzureMonitorWindowsAgentbelirli bir uzantıyı filtrelemek için aşağıdaki komutu çalıştırın:
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:
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
Kümedeki tüm uzantıları listelemek için aşağıdaki komutu çalıştırın:
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.
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:
Otomatik yükseltmeyi etkinleştirmek istediğiniz uzantıyı seçin.
Üstteki menüden Otomatik yükseltmeyi etkinleştir'i seçin
Amacınızı onaylamanız istendiğinde Tamam'ı seçin.
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"
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:
Uzantılar sayfasına gidin.
Yükseltmek istediğiniz uzantıyı seçin ve üstteki menüden Ayarlar'ı seçin.
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:
Otomatik yükseltmeyi devre dışı bırakmak istediğiniz uzantıyı seçin.
Üstteki menüden Otomatik yükseltmeyi devre dışı bırak'ı seçin.
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 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.
İsterseniz Azure portal Azure Stack HCI kümelerinizden bazı uzantıları kaldırabilirsiniz. Uzantıyı kaldırmak için şu adımları kullanın:
Uzantılar sayfasına gidin.
Kaldırmak istediğiniz uzantıyı seçin. Kaldırma düğmesi Azure tarafından yönetilen uzantılar için kullanılamaz.
Üstteki menüden Kaldır'ı seçin.
Amacı onaylayın ve Evet'i seçin.
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}"
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.
