Använd VMware PowerCLI för att skala onboarding VMware vSphere virtuella Linux-datorer till Azure-bågenUse VMware PowerCLI to scale onboarding VMware vSphere Linux virtual machines to Azure Arc

Den här artikeln innehåller rikt linjer för att använda det tillhandahållna VMware PowerCLI -skriptet så att du kan utföra en automatiserad skalad distribution av den anslutna dator agenten i Azure Arc i flera virtuella VMware vSphere virtuella datorer och därmed registrera dessa virtuella datorer som en Azure Arc-aktiverad server.This article provides guidance for using the provided VMware PowerCLI script so you can perform an automated scaled deployment of the Azure Arc connected machine agent in multiple VMware vSphere virtual machines and as a result, onboarding these VMs as an Azure Arc enabled servers.

Den här guiden förutsätter att du redan har en att publicera virtuella VMware-datorer och att använda PowerCLI PowerShell-modulen för att automatisera onboarding-processen för de virtuella datorerna till Azure-bågen.This guide assumes you already have an exiting inventory of VMware virtual machines and will use the PowerCLI PowerShell module to automate the onboarding process of the VMs to Azure Arc.

FörutsättningarPrerequisites

  1. Klona Azure Arc rivstart med-lagringsplatsen.Clone the Azure Arc Jumpstart repository.

    git clone https://github.com/microsoft/azure_arc.git
    
  2. Installera eller uppdatera Azure CLI till version 2,7 och senare.Install or update Azure CLI to version 2.7 and above. Använd följande kommando för att kontrol lera den aktuella installerade versionen.Use the following command to check your current installed version.

    az --version
    
  3. Installera VMware PowerCLI.Install VMware PowerCLI.

    Anteckning

    Den här guiden har testats med den senaste versionen av PowerCLI från och med publikationen (12.0.0), men tidigare versioner förväntas fungera också.This guide was tested with the latest version of PowerCLI as of publication (12.0.0), but earlier versions are expected to work as well.

    • PowerShell-versioner som stöds: VMware PowerCLI 12.0.0 är kompatibel med följande PowerShell-versioner:Supported PowerShell versions: VMware PowerCLI 12.0.0 is compatible with the following PowerShell versions:
      • Windows PowerShell 5.1Windows PowerShell 5.1

      • PowerShell 7PowerShell 7

      • Detaljerade Installationsinstruktioner finns här , men det enklaste sättet är att använda VMware.PowerCLI modulen från PowerShell-galleriet med hjälp av följande kommando.Detailed installation instructions can be found here but the easiest way is to use the VMware.PowerCLI module from the PowerShell gallery using the following command.

        Install-Module -Name VMware.PowerCLI
        
  4. För att kunna läsa VM-inventeringen från vCenter och anropa ett skript på den virtuella datorns OS-nivå behövs följande behörigheter:To be able to read the VM inventory from vCenter as well as invoke a script on the VM OS level, the following permissions are needed:

  5. Skapa ett huvud namn för Azure-tjänsten.Create an Azure service principal.

    För att ansluta den VMware vSphere virtuella datorn till Azure-bågen krävs ett Azure-tjänstens huvud namn som tilldelats rollen deltagare.To connect the VMware vSphere virtual machine to Azure Arc, an Azure service principal assigned with the Contributor role is required. Om du vill skapa den loggar du in på ditt Azure-konto och kör följande kommando.To create it, sign in to your Azure account and run the following command. Du kan också köra det här kommandot i Azure Cloud Shell.You can also run this command in Azure Cloud Shell.

    az login
    az ad sp create-for-rbac -n "<Unique SP Name>" --role contributor
    

    Exempel:For example:

    az ad sp create-for-rbac -n "http://AzureArcServers" --role contributor
    

    Utdata bör se ut så här:Output should look like this:

    {
      "appId": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "displayName": "AzureArcServers",
      "name": "http://AzureArcServers",
      "password": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "tenant": "XXXXXXXXXXXXXXXXXXXXXXXXXXXX"
    }
    

    Anteckning

    Vi rekommenderar starkt att du omfångerar tjänstens huvud namn till en Azure-prenumeration och en unik resurs grupp.We highly recommend that you scope the service principal to a specific Azure subscription and resource group.

Automation-flödeAutomation flow

Automation-flödet för det här scenariot innehåller följande steg:The automation flow for this scenario includes these steps:

  1. Redigera vars.ps1 PowerCLI-skriptet.Edit the vars.ps1 PowerCLI script.

  2. Vid körning av scale-deploy.ps1 PowerShell-skriptet:Upon execution of the scale-deploy.ps1 PowerShell script:

    • Skriptet genererar automatiskt ett vars.sh Shell-skript med användarens Azure-miljövariabler.The script will auto-generate a vars.sh shell script with the user's Azure environment variables.

    • Skript körningen initierar autentisering mot vCenter och genomsöker den aktuella VM-mappen där virtuella Azure Arc Candidate-datorer finns och kopierar både de automatiskt genererade vars.sh och install_azure_arc_agent.sh gränssnitts skripten till virtuella Linux-operativsystem som finns i /vmware/scaled-deploy/powercli/linux till varje virtuell dator i den VM-mappen.The script execution will initiate authentication against vCenter and will scan the targeted VM folder where Azure Arc candidate VMs are located and will copy both the auto-generated vars.sh and the install_azure_arc_agent.sh shell scripts to VM Linux OS located in /vmware/scaled-deploy/powercli/linux to each VM in that VM folder.

  3. install_azure_arc_agent.shShell-skriptet körs på den virtuella datorn gäst operativ system och kommer att installera den Azure Arc Connected Machine-agenten för att publicera den virtuella datorn till Azure-bågen.The install_azure_arc_agent.sh shell script will run on the VM guest OS and will install the Azure Arc connected machine agent in order to onboard the VM to Azure Arc.

FördistributionPredeployment

För att demonstrera före och efter i det här scenariot visar skärm bilderna nedan en dedikerad, Tom Azure-resurs grupp, en vCenter VM-mapp med kandidat-VM: ar och /var/opt/ katalogen som visar att ingen agent är installerad.To demonstrate the before and after for this scenario, the below screenshots shows a dedicated, empty Azure resource group, a vCenter VM folder with candidate VMs and the /var/opt/ directory showing no agent is installed.

Skärm bild av en tom resurs grupp i Azure.

En skärm bild av en vanilj VMware vSphere virtuell dator utan en Azure Arc-agent.

En annan skärm bild av en vanilj VMware vSphere virtuell dator utan en Azure Arc-agent.

DistributionDeployment

Innan du kör PowerCLI-skriptet måste du ange de miljövariabler som ska användas av install_azure_arc_agent.sh skriptet.Before running the PowerCLI script, you must set the environment variables which will be used by the install_azure_arc_agent.sh script. Dessa variabler baseras på Azure-tjänstens huvud namn som du precis har skapat, din Azure-prenumeration och klient organisation och dina VMware vSphere autentiseringsuppgifter och data.These variables are based on the Azure service principal you've just created, your Azure subscription and tenant, and your VMware vSphere credentials and data.

  • Hämta ditt Azure-prenumerations-ID och klient-ID med az account list kommandotRetrieve your Azure subscription ID and tenant ID using the az account list command

  • Använd Azure-tjänstens huvud namn-ID och lösen ord som skapats i avsnittet krav:Use the Azure service principal ID and password created in the prerequisites section:

    En skärm bild av export av miljövariabler.

  • azure_arc_servers_jumpstart\vmware\scaled-deploy\powercli\linuxÖppna en PowerShell-session i mappen som administratör och kör scale-deploy.ps1 skriptet.From the azure_arc_servers_jumpstart\vmware\scaled-deploy\powercli\linux folder, open a PowerShell session as an administrator and run the scale-deploy.ps1 script.

    En skärm bild av "scale_deploy.ps1".

    En andra skärm bild av "scale_deploy.ps1".

    En tredje skärm bild av "scale_deploy.ps1".

  • När den virtuella datorn har slutförts kommer den Azure Arc-anslutna dator agenten att installeras samt Azure-gruppgruppen med nya Azure Arc-aktiverade servrar.Upon completion, the VM will have the Azure Arc connected machine agent installed as well as the Azure resource group populated with the new Azure Arc enabled servers.

    En skärm bild av en dator med en Azure Arc-agent installerad.

    En skärm bild av nya Azure Arc-aktiverade servrar i en Azure-resurs grupp.

    En annan skärm bild av nya Azure Arc-aktiverade servrar i en Azure-resurs grupp.