Azure-beli virtuálisgép-bővítmények engedélyezése az Azure CLI használatával

Cikk
10/24/2023

Ez a cikk bemutatja, hogyan helyezheti üzembe, frissítheti, frissítheti és távolíthatja el az Azure Arc-kompatibilis kiszolgálók által támogatott virtuálisgép-bővítményeket linuxos vagy windowsos hibrid gépekre az Azure CLI használatával.

Megjegyzés:

Az Azure Arc-kompatibilis kiszolgálók nem támogatják a virtuálisgép-bővítmények üzembe helyezését és kezelését az Azure-beli virtuális gépeken. Azure-beli virtuális gépek esetén tekintse meg a következő virtuálisgép-bővítmény áttekintési cikkét .

Előfeltételek

Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
- Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
- Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
- Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Az Azure CLI-bővítmény telepítése

A Csatlakozás edMachine parancsok nem az Azure CLI részeként lesznek szállítva. Mielőtt az Azure CLI használatával csatlakozik az Azure-hoz, és felügyelné a virtuálisgép-bővítményeket az Azure Arc-kompatibilis kiszolgálók által felügyelt hibrid kiszolgálón, be kell töltenie a Csatlakozás edMachine bővítményt. Ezek a felügyeleti műveletek elvégezhetők a munkaállomásról, nem kell őket futtatnia az Azure Arc-kompatibilis kiszolgálón.

A lekéréshez futtassa a következő parancsot:

az extension add --name connectedmachine

Bővítmény engedélyezése

Ha engedélyezni szeretne egy virtuálisgép-bővítményt az Azure Arc-kompatibilis kiszolgálón, használja a create az connectedmachine bővítményt a --machine-name, --extension-name, --location, --type, settingsés --publisher paraméterekkel.

Az alábbi példa engedélyezi a Log Analytics virtuálisgép-bővítményt egy Azure Arc-kompatibilis kiszolgálón:

az connectedmachine extension create --machine-name "myMachineName" --name "OmsAgentForLinux or MicrosoftMonitoringAgent" --location "regionName" --settings '{\"workspaceId\":\"myWorkspaceId\"}' --protected-settings '{\"workspaceKey\":\"myWorkspaceKey\"}' --resource-group "myResourceGroup" --type-handler-version "1.13" --type "OmsAgentForLinux or MicrosoftMonitoringAgent" --publisher "Microsoft.EnterpriseCloud.Monitoring"

Az alábbi példa engedélyezi az egyéni szkriptbővítményt egy Azure Arc-kompatibilis kiszolgálón:

az connectedmachine extension create --machine-name "myMachineName" --name "CustomScriptExtension" --location "regionName" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"

Az alábbi példa engedélyezi a Key Vault virtuálisgép-bővítményt egy Azure Arc-kompatibilis kiszolgálón:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.KeyVault" --type "KeyVaultForLinux or KeyVaultForWindows" --name "KeyVaultForLinux or KeyVaultForWindows" --settings '{"secretsManagementSettings": { "pollingIntervalInS": "60", "observedCertificates": ["observedCert1"] }, "authenticationSettings": { "msiEndpoint": "http://localhost:40342/metadata/identity" }}'

Az alábbi példa engedélyezi a Microsoft Antimalware bővítményt egy Azure Arc-kompatibilis Windows-kiszolgálón:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Microsoft.Azure.Security" --type "IaaSAntimalware" --name "IaaSAntimalware" --settings '"{\"AntimalwareEnabled\": \"true\"}"'

Az alábbi példa engedélyezi a Datadog bővítményt egy Azure Arc-kompatibilis Windows-kiszolgálón:

az connectedmachine extension create --resource-group "resourceGroupName" --machine-name "myMachineName" --location "regionName" --publisher "Datadog.Agent" --type "DatadogWindowsAgent" --settings '{"site": "us3.datadoghq.com"}' --protected-settings '{"api_key": "YourDatadogAPIKey" }'

Telepített bővítmények listázása

Az Azure Arc-kompatibilis kiszolgálón található virtuálisgép-bővítmények listájának lekéréséhez használja az az connectedmachine bővítménylistát a --machine-name paraméterekkel együtt --resource-group .

Példa:

az connectedmachine extension list --machine-name "myMachineName" --resource-group "myResourceGroup"

Alapértelmezés szerint az Azure CLI-parancsok kimenete JSON-ban (JavaScript Object Notation) van. Ha az alapértelmezett kimenetet listára vagy táblára szeretné módosítani, használja például az az config set core.output=table parancsot. Bármelyik parancshoz hozzáadhat --output egy egyszeri módosítást kimeneti formátumban.

Az alábbi példa a parancs részleges JSON-kimenetét az connectedmachine extension -list mutatja be:

[
  {
    "autoUpgradingMinorVersion": "false",
    "forceUpdateTag": null,
    "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroupName/providers/Microsoft.HybridCompute/machines/SVR01/extensions/DependencyAgentWindows",
    "location": "regionName",
    "name": "DependencyAgentWindows",
    "namePropertiesInstanceViewName": "DependencyAgentWindows",

Bővítménykonfiguráció frissítése

Egyes virtuálisgép-bővítmények konfigurációs beállításokat igényelnek az Arc-kompatibilis kiszolgálóra való telepítéshez, például az egyéni szkriptbővítményhez és a Log Analytics-ügynök virtuálisgép-bővítményéhez. A bővítmény konfigurációjának frissítéséhez használja az az connectedmachine bővítményfrissítést.

Az alábbi példa bemutatja, hogyan konfigurálhatja az egyéni szkriptbővítményt:

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.HybridCompute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Bővítmények frissítése

A támogatott virtuálisgép-bővítmények új verziójának kiadásakor frissítheti azt a legújabb kiadásra. Egy virtuálisgép-bővítmény frissítéséhez használja az az connectedmachine upgrade-extensiont a --machine-name, --resource-groupés --extension-targets paraméterekkel.

--extension-targets A paraméterhez meg kell adnia a bővítményt és a legújabb elérhető verziót. Ha meg szeretné tudni, hogy mi a legújabb elérhető verzió, ezeket az információkat az Azure Portal kijelölt Arc-kompatibilis kiszolgáló Bővítmények lapján, vagy az az vm extension image list futtatásával szerezheti be. Egyetlen frissítési kérelemben több bővítményt is megadhat, ha a közzétevő és a típus (időszak szerint elválasztva) meghatározott bővítmények vesszővel tagolt listáját és az egyes bővítmények célverzióját adja meg, ahogyan az az alábbi példában is látható.

Az újabb verziójú Windows Log Analytics-ügynökbővítmény frissítéséhez futtassa a következő parancsot:

az connectedmachine upgrade-extension --machine-name "myMachineName" --resource-group "myResourceGroup" --extension-targets '{\"Microsoft.EnterpriseCloud.Monitoring.MicrosoftMonitoringAgent\":{\"targetVersion\":\"1.0.18053.0\"}}'

A telepített virtuálisgép-bővítmények verzióját bármikor áttekintheti az az connectedmachine bővítménylista futtatásával. A typeHandlerVersion tulajdonság értéke a bővítmény verzióját jelöli.

Bővítmények eltávolítása

Ha el szeretne távolítani egy telepített virtuálisgép-bővítményt az Azure Arc-kompatibilis kiszolgálón, használja az az connectedmachine kiterjesztés törlését a --extension-name, --machine-nameés --resource-group paraméterekkel.

Ha például el szeretné távolítani a Linuxhoz készült Log Analytics virtuálisgép-bővítményt, futtassa a következő parancsot:

az connectedmachine extension delete --machine-name "myMachineName" --name "OmsAgentForLinux" --resource-group "myResourceGroup"

Következő lépések

Virtuálisgép-bővítményeket az Azure PowerShell használatával, az Azure Portalról vagy az Azure Resource Manager-sablonokból helyezhet üzembe, kezelhet és távolíthat el.
A hibaelhárítási információk a virtuálisgép-bővítmények hibaelhárítási útmutatójában találhatók.
A parancsokkal kapcsolatos további információkért tekintse át az Azure CLI virtuálisgép-bővítmény áttekintési cikkét.

Share via