Azure Arc Resource Bridge implementeren met behulp van de opdrachtregel

  • Artikel
  • 7 minuten om te lezen

Van toepassing op: Azure Stack HCI, versie 21H2

Als u het inrichten van virtuele machines (VM's) wilt inschakelen via de Azure Portal in Azure Stack HCI, moet u Azure Arc Resource Bridge implementeren.

U kunt Azure Arc Resource Bridge implementeren in het Azure Stack HCI-cluster met behulp van Windows Admin Center of opdrachtregel.

In dit artikel wordt beschreven hoe u de opdrachtregel gebruikt om Azure Arc Resource Bridge te implementeren, waaronder:

Zie Azure Arc Resource Bridge implementeren met behulp van Windows Admin Center als u Azure Arc Resource Bridge wilt implementeren met behulp van Windows Admin Center.

Zie VM-inrichting via Azure Portal op Azure Stack HCI (preview) voor meer informatie over vm-inrichting via de Azure Portal.

Voordat u begint

Voordat u begint met de implementatie van Azure Arc Resource Bridge, moet u uw fysieke en hostnetwerkinfrastructuur plannen en configureren. Raadpleeg de volgende secties:

PowerShell-modules installeren en extensies bijwerken

Als u wilt voorbereiden op het installeren van Azure Arc Resource Bridge op een Azure Stack HCI-cluster en een VM-clusterextensie wilt maken, voert u deze stappen uit via RdP (Remote Desktop Protocol) of consolesessie. Externe PowerShell wordt niet ondersteund.

  1. Installeer de vereiste PowerShell-modules door de volgende cmdlet uit te voeren als beheerder op alle servers van het Azure Stack HCI-cluster:

    Install-PackageProvider -Name NuGet -Force 
Install-Module -Name PowershellGet -Force -Confirm:$false -SkipPublisherCheck

    Start alle geopende PowerShell-vensters opnieuw op.

    Install-Module -Name Moc -Repository PSGallery -AcceptLicense -Force
Initialize-MocNode
Install-Module -Name ArcHci -Force -Confirm:$false -SkipPublisherCheck -AcceptLicense

  2. Start PowerShell opnieuw en geef vervolgens invoer op voor het volgende in het PowerShell-venster op een server van het cluster. Raadpleeg de volgende tabel voor een beschrijving van deze parameters.

    $vswitchName="<Switch-Name>"
$controlPlaneIP="<IP-address>"
$csv_path="<input-from-admin>"
$vlanID="<vLAN-ID>" (Optional)
$VMIP="<static IP address for Resource Bridge VM>" (required only for static IP configurations)   
$DNSServers="<comma separated list of DNS servers>" (required only for static IP configurations)
$IPAddressPrefix="<subnet mask for the IP address>" (required only for static IP configurations)
$Gateway="<IPv4 address of the default gateway>" (required only for static IP configurations)
$cloudServiceIP="<IP-address>" (required only for static IP configurations)

    Hierbij

    Parameter Beschrijving
    vswitchName Moet overeenkomen met de naam van de switch op de host. Het netwerk dat wordt geleverd door deze vmswitch, moet statische IP-adressen kunnen opgeven voor controlPlaneIP.
    controlPlaneIP Het IP-adres dat wordt gebruikt voor de load balancer in de Arc-resourcebrug. Het IP-adres moet zich in hetzelfde subnet bevinden als het DHCP-bereik en moet worden uitgesloten van het DHCP-bereik om IP-adresconflicten te voorkomen.
    csv_path Een CSV-volumepad dat toegankelijk is vanaf alle servers van het cluster. Dit wordt gebruikt voor het opslaan van installatiekopieën van het besturingssysteem die worden gebruikt voor de Azure Arc Resource Bridge. Het slaat ook tijdelijke configuratiebestanden op tijdens de installatie en configuratiebestanden van de cloudagent na de installatie. Bijvoorbeeld: C:\ClusterStorage\contosoVol.
    vlanID (Optioneel) vLAN-id.
    VMIP (Alleen vereist voor statische IP-configuraties) IP-adres voor de Arc-resourcebrug. Als u deze parameter niet opgeeft, krijgt de Arc Resource Bridge een IP-adres van DHCP.
    DNSServers (Alleen vereist voor statische IP-configuraties) Door komma's gescheiden lijst met DNS-servers. Bijvoorbeeld: "192.168.250.250","192.168.250.255".
    IPAddressPrefix (Alleen vereist voor statische IP-configuraties) Het voorvoegselLength geeft het subnetmasker voor het IP-adres op. Bijvoorbeeld: "192.168.0.0/16".
    Gateway (Alleen vereist voor statische IP-configuraties) IPv4-adres van de standaardgateway.
    cloudServiceIP (Alleen vereist voor statische IP-configuraties) Het IP-adres van de cloudagent die wordt uitgevoerd onder de resourcebrug. Dit is vereist als aan de clusterservers statisch IP-adressen zijn toegewezen. Het IP-adres moet worden verkregen van het onderliggende netwerk (fysiek netwerk).

  3. Configuratie voorbereiden voor Azure Arc Resource Bridge. Deze stap varieert afhankelijk van of Azure Kubernetes Service (AKS) in Azure Stack HCI is geïnstalleerd of niet.

    • Als AKS in Azure Stack HCI is geïnstalleerd. Sla deze stap over en ga verder met stap 4 om de vereiste extensies bij te werken.

    • Als AKS in Azure Stack HCI niet is geïnstalleerd. Voer de volgende cmdlets uit om een IP-adres op te geven voor uw Azure Arc Resource Bridge-VM:

      $vnet=New-MocNetworkSetting -Name hcirb-vnet -vswitchName $vswitchName -vipPoolStart $controlPlaneIP -vipPoolEnd $controlPlaneIP  

Set-MocConfig -workingDir $csv_path\ResourceBridge  -vnet $vnet -imageDir $csv_path\imageStore -skipHostLimitChecks -cloudConfigLocation $csv_path\cloudStore -catalog aks-hci-stable-catalogs-ext -ring stable -CloudServiceIP $cloudServiceIP 

Install-Moc

    Tip

    Zie beperkingen en bekende problemen als Azure Kubernetes Service ook is ingeschakeld voor uitvoering op dit cluster.

  4. Werk de vereiste extensies bij.

    • Verwijder de oude extensies:

      az extension remove --name arcappliance
az extension remove --name connectedk8s
az extension remove --name k8s-configuration
az extension remove --name k8s-extension
az extension remove --name customlocation
az extension remove --name azurestackhci

    • Installeer de nieuwe extensies:

      az extension add --upgrade --name arcappliance
az extension add --upgrade --name connectedk8s
az extension add --upgrade --name k8s-configuration
az extension add --upgrade --name k8s-extension
az extension add --upgrade --name customlocation
az extension add --upgrade --name azurestackhci

Een aangepaste locatie maken door Azure Arc Resource Bridge te installeren

Als u een aangepaste locatie wilt maken, installeert u Azure Arc Resource Bridge door een PowerShell-venster met verhoogde bevoegdheid te starten en de volgende stappen uit te voeren:

  1. Voer de volgende cmdlets uit. Raadpleeg de volgende tabel voor een beschrijving van de parameters.

    $resource_group="<pre-created resource group in Azure>"
$subscription="subscription ID in Azure"
$Location="<Azure Region - Available regions include 'eastus', 'eastus2euap' and 'westeurope'>"
$customloc_name="<name of the custom location, such as HCICluster -cl>"

    Hierbij

    Parameter Beschrijving
    resource_group Naam van de vooraf gemaakte resourcegroep in Azure.
    abonnement Abonnements-id in Azure.
    Locatie Naam van de Azure-regio. Geef een van de volgende beschikbare regio's op: eastus, eastus2euap of westeurope.
    customloc_name Naam van de aangepaste locatie, zoals HCICluster -cl.

    Tip

    Voer Get-AzureStackHCI deze opdracht uit om deze details te vinden.

  2. Meld u aan bij uw Azure-abonnement en haal de extensie en providers op voor Azure Arc Resource Bridge:

    az login --use-device-code
az account set --subscription $subscription
az provider register --namespace Microsoft.KubernetesConfiguration
az provider register --namespace Microsoft.ExtendedLocation
az provider register --namespace Microsoft.ResourceConnector
az provider register --namespace Microsoft.AzureStackHCI

  3. Voer de volgende cmdlets uit op basis van uw netwerkconfiguraties:

    $resource_name= ((Get-AzureStackHci).AzureResourceName) + "-arcbridge"
mkdir $csv_path\ResourceBridge
New-ArcHciConfigFiles -subscriptionID $subscription -location $location -resourceGroup $resource_group -resourceName $resource_name -workDirectory $csv_path\ResourceBridge -controlPlaneIP $controlPlaneIP  -k8snodeippoolstart $VMIP -k8snodeippoolend $VMIP -gateway $Gateway -dnsservers $DNSServers -ipaddressprefix $IPAddressPrefix [-vLanID=$vlanID]
az arcappliance validate hci --config-file $csv_path\ResourceBridge\hci-appliance.yaml

    az arcappliance prepare hci --config-file $csv_path\ResourceBridge\hci-appliance.yaml

    az arcappliance deploy hci --config-file  $csv_path\ResourceBridge\hci-appliance.yaml --outfile $env:USERPROFILE\.kube\config

    az arcappliance create hci --config-file $csv_path\ResourceBridge\hci-appliance.yaml --kubeconfig $env:USERPROFILE\.kube\config

  4. Controleer of het Arc-apparaat wordt uitgevoerd. Voer de volgende cmdlets uit totdat de inrichtingsstatus van het apparaat is voltooid en de status wordt uitgevoerd. Deze bewerking kan maximaal vijf minuten duren.

    az arcappliance show --resource-group $resource_group --name $resource_name

  5. Voeg de vereiste extensies voor VM-beheermogelijkheden toe die moeten worden ingeschakeld via de zojuist geïmplementeerde Arc Resource Bridge:

    $hciClusterId= (Get-AzureStackHci).AzureResourceUri
az k8s-extension create --cluster-type appliances --cluster-name $resource_name --resource-group $resource_group --name hci-vmoperator --extension-type Microsoft.AZStackHCI.Operator --scope cluster --release-namespace helm-operator2 --configuration-settings Microsoft.CustomLocation.ServiceAccount=hci-vmoperator --configuration-protected-settings-file $csv_path\ResourceBridge\hci-config.json --configuration-settings HCIClusterID=$hciClusterId --auto-upgrade true

  6. Controleer of de extensies zijn geïnstalleerd. Blijf de volgende cmdlet uitvoeren totdat de inrichtingsstatus van de extensie is voltooid. Deze bewerking kan maximaal vijf minuten duren.

    az k8s-extension show --cluster-type appliances --cluster-name $resource_name --resource-group $resource_group --name hci-vmoperator

  7. Maak een aangepaste locatie voor het Azure Stack HCI-cluster, waarbij customloc_name de naam is van de aangepaste locatie, zoals 'HCICluster -cl':

    az customlocation create --resource-group $resource_group --name $customloc_name --cluster-extension-ids "/subscriptions/$subscription/resourceGroups/$resource_group/providers/Microsoft.ResourceConnector/appliances/$resource_name/providers/Microsoft.KubernetesConfiguration/extensions/hci-vmoperator" --namespace hci-vmoperator --host-resource-id "/subscriptions/$subscription/resourceGroups/$resource_group/providers/Microsoft.ResourceConnector/appliances/$resource_name" --location $Location

U kunt nu naar de resourcegroep in Azure navigeren en de aangepaste locatie en Azure Arc Resource Bridge bekijken die u hebt gemaakt voor het Azure Stack HCI-cluster.

Nu de aangepaste locatie beschikbaar is, kunt u virtuele netwerken en galerie-installatiekopieën maken of toevoegen voor de aangepaste locatie die is gekoppeld aan het Azure Stack HCI-cluster.

  1. Maak of voeg een netwerkswitch toe voor VM's. Zorg ervoor dat u een externe vmswitch hebt geïmplementeerd op alle hosts van het Azure Stack HCI-cluster. Geef de naam van de vmswitch op die wordt gebruikt voor netwerkinterfaces tijdens het inrichten van vm's. De parameter vnetName moet de naam zijn van het virtuele netwerk van de hosts van het cluster, bijvoorbeeld : 'myvnet'.

    $vnetName=<name of the vnet>
az azurestackhci virtualnetwork create --subscription $subscription --resource-group $resource_group --extended-location name="/subscriptions/$subscription/resourceGroups/$resource_group/providers/Microsoft.ExtendedLocation/customLocations/$customloc_name" type="CustomLocation" --location $Location --network-type "Transparent" --name $vnetName

  2. Maak een installatiekopieën van een besturingssysteemgalerie die wordt gebruikt voor het maken van VM's door de volgende cmdlets uit te voeren, waarbij de parameters worden opgegeven die in de volgende tabel worden beschreven.

    Zorg ervoor dat u een Windows- of Linux-VHDX-installatiekopie lokaal op de host hebt gekopieerd. De VHDX-installatiekopie moet gen-2-type zijn en beveiligd opstarten is ingeschakeld. Het moet zich op een gedeeld clustervolume bevinden dat beschikbaar is voor alle servers in het cluster. Azure Stack HCI met Arc ondersteunt Windows- en Linux-besturingssystemen.

    $galleryImageName=<gallery image name>
$galleryImageSourcePath=<path to the source gallery image>
$osType="<Windows/Linux>"
az azurestackhci galleryimage create --subscription $subscription --resource-group $resource_group --extended-location name="/subscriptions/$subscription/resourceGroups/$resource_group/providers/Microsoft.ExtendedLocation/customLocations/$customloc_name" type="CustomLocation" --location $Location --image-path $galleryImageSourcePath --name $galleryImageName --os-type $osType

    Hierbij

    Parameter Beschrijving
    galleryImageName Naam van de galerie-installatiekopieën; Bijvoorbeeld 'win-os'. Houd er rekening mee dat Azure alle namen weigert die het trefwoord 'Windows' bevatten.
    galleryImageSourcePath Pad naar de brongalerie-installatiekopieën VHDX; Bijvoorbeeld 'C:\OSImages\winos.vhdx'.
    osType Het type besturingssysteem. Dit kan 'Windows' of 'Linux' zijn; Bijvoorbeeld 'Windows'.

Volgende stappen