Şunlar için geçerlidir: Azure Yerel 2311.2 ve üzeri
Bu makalede, Azure Yerel'de Azure Arc uzantılarını yükleme, yükseltme ve yönetme işlemleri açıklanmaktadır.
Azure Yerel'de müşteri tarafından yönetilen Azure Arc uzantıları
Azure Yerel'inize Azure Arc uzantılarını yükleyebilir, kaldırabilir ve güncelleştirebilirsiniz. Azure Arc, Izleme ve Windows Yönetim Merkezi gibi karma hizmetleri Azure portalında çalıştırmanıza olanak tanır.
Yükleyip yönetebileceğiniz tek tek uzantılar aşağıdadır.
Azure Yerel'de Azure tarafından yönetilen uzantılar
Yeni Azure Local'ınızı Azure'a başarıyla kaydettikten sonra, Azure tarafından yönetilen uzantılar sisteminize otomatik olarak yüklenir. Bu uzantılar sisteminizin işlevselliği ve kalitesi için gereklidir ve kaldırılamaz. Azure portalında Uzantılar sayfasına gidip Ayarlar menüsünü seçerek bu uzantıların davranışını yönetebilirsiniz.
Bu uzantılar olmadan Azure'a kayıtlı bir Azure Yerel'iniz varsa, Azure portalının 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 Yerel Arc özellikli sunucularınızın Özellikler sekmesinden yükleyebilirsiniz. Çoğu uzantıyı yüklemek için yetenekler sekmesini kullanabilirsiniz.
Azure portalında bir uzantı yüklediğinizde, bu küme kullanan bir işlemdir. Uzantı, sistemin tüm düğümlerine yüklenir. Sisteminize daha fazla düğüm eklerseniz, sisteminizde yüklü olan tüm uzantılar otomatik olarak yeni sunuculara eklenir.
Azure CLI, Windows, macOS ve Linux ortamlarında yüklenebilir. Azure Cloud Shell'de de çalıştırılabilir. Daha fazla bilgi için bkz . Azure Cloud Shell için Hızlı Başlangıç.
Azure Cloud Shell'i başlatın ve bash kullanarak aşağıdaki adımları izleyerek bir uzantı yükleyin:
Aboneliğinizden, kaynak grubunuzdan ve kümelerden 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 sistemlere 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 sistemlere 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 sistemlere 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'de çalıştırılabilir. Bu belgede, Azure Cloud Shell'de PowerShell'in nasıl kullanılacağı ayrıntılı olarak açıklanmaktadır. Daha fazla bilgi için bkz . Azure Cloud Shell için Hızlı Başlangıç.
Azure Cloud Shell'i 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 sistemlere yüklemek için aşağıdaki komutu çalıştırın:
Azure Site Recovery uzantısını kaynak grubu altındaki tüm sistemlere 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ılavuzun 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'de de çalıştırılabilir. Daha fazla bilgi için bkz . Azure Cloud Shell için Hızlı Başlangıç.
Azure Cloud Shell'i 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}"
Bir sistemdeki 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'de çalıştırılabilir. Bu belgede, Azure Cloud Shell'de PowerShell'in nasıl kullanılacağı ayrıntılı olarak açıklanmaktadır. Daha fazla bilgi için bkz . Azure Cloud Shell için Hızlı Başlangıç.
Azure Cloud Shell'i başlatın ve aşağıdaki adımları izleyerek uzantının durumunu denetlemek için PowerShell'i kullanın:
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
Bir sistemdeki 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 uzantıyla değiştirir. Varsayılan olarak, otomatik uzantı yükseltme özelliği, otomatik yükseltmeleri açıkça geri çevirmediğiniz sürece Azure Yerel 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 desteklenir, ancak gelecekte daha fazla uzantı eklenecektir.
Not
Varsayılan olarak, tüm uzantılar otomatik yükseltmeleri etkinleştirecek şekilde ayarlanır, ancak bu ayar yalnızca yayımcı destekliyorsa çalışır. Otomatik yükseltmeleri etkinleştirmek için bir uzantı ayarlanmadıysa, yükseltme çözüm güncelleştirme işlemi sırasında gerçekleşir. Zaman içinde, el ile uzantı yükseltmeleri otomatik yükseltmelere geçiş yapacaktır.
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.
Üst menüden Otomatik yükseltmeyi etkinleştir'i seçin
Amacınızı onaylamanız istendiğinde Tamam'ı seçin.
Belirli bir uzantı AzureMonitorWindowsAgent için otomatik yükseltmeyi yüklemek ve etkinleştirmek 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"
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"
Belirli bir uzantı AzureMonitorWindowsAgent için otomatik yükseltmeyi yüklemek ve etkinleştirmek 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"
$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ükseltme, Otomatik uzantı yükseltmesi gibi çalışır. Azure Yerel Arc özellikli bir kümede, bir uzantıyı el ile yükselttiğiniz zaman, Azure seçtiğiniz sürümü kaydeder. Ardından Azure, kümedeki tüm düğümlerdeki uzantıyı bu sürüme yükseltmeyi dener.
Bazı sunucularda uzantı yükseltmesi başarısız olursa, platform bir sonraki Azure Yerel bulut eşitlemesi sırasında seçili sürüme yükseltmeyi dener.
Şu 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ışıdır ve Azure Yerel'in farklı düğümlerinde sürüm uyuşmazlığı vardır.
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ında 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ı uygulayın:
Otomatik yükseltmeyi devre dışı bırakmak istediğiniz uzantıyı seçin.
Üst 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 denetleyin
Tek tek düğümler için otomatik uzantı yükseltmelerinin geçmişini denetlemek için Azure Arc özellikli sunucu kaynaklarının, kaynak gruplarının ve aboneliklerin 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 Azure Yerel Arc özellikli kümelerden oluşan bir grup 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.
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ükseltmesini yeniden etkinleştirebilirsiniz.
Birden çok uzantılı yükseltmeler
Bir düğüm için birden çok uzantı yükseltmesi varsa, bunlar birlikte toplu işlenebilir. Ancak, her uzantı yükseltmesi düğüme ayrı ayrı uygulanır. Daha fazla bilgi için bkz . Birden çok uzantılı uzantı yükseltmeleri.
İsterseniz Azure portalında Azure Yerel'inizden 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 durumdaki 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.