Conexión de máquinas híbridas a Azure desde Azure PortalConnect hybrid machines to Azure from the Azure portal

Con el fin de implementar en su entorno servidores habilitados para Azure Arc para una máquina Windows o Linux, o un número reducido de ellas, debe realizar una serie de pasos manualmente.You can enable Azure Arc enabled servers for one or a small number of Windows or Linux machines in your environment by performing a set of steps manually. O bien, puede usar un método automatizado mediante la ejecución de un script de plantilla que le proporcionaremos.Or you can use an automated method by running a template script that we provide. Este script automatiza la descarga e instalación de ambos agentes.This script automates the download and installation of both agents.

Este método requiere que tenga permisos de administrador en la máquina para instalar y configurar el agente.This method requires that you have administrator permissions on the machine to install and configure the agent. En Linux, mediante la cuenta raíz, y en Windows, usted es miembro del grupo local de administradores.On Linux, by using the root account, and on Windows, you are member of the Local Administrators group.

Antes de comenzar, asegúrese de revisar los requisitos previos y compruebe que su suscripción y sus recursos los cumplen.Before you get started, be sure to review the prerequisites and verify that your subscription and resources meet the requirements. Para obtener información sobre las regiones admitidas y otras consideraciones relacionadas, consulte Regiones admitidas de Azure.For information about supported regions and other related considerations, see supported Azure regions.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Generación del script de instalación desde Azure PortalGenerate the installation script from the Azure portal

El script para automatizar la descarga y la instalación, y para establecer la conexión con Azure Arc, está disponible en Azure Portal.The script to automate the download and installation, and to establish the connection with Azure Arc, is available from the Azure portal. Para completar el proceso, haga lo siguiente:To complete the process, do the following:

  1. En el explorador, vaya a Azure Portal.From your browser, go to the Azure portal.

  2. En la página Servidores: Azure Arc, seleccione Agregar en la parte superior izquierda.On the Servers - Azure Arc page, select Add at the upper left.

  3. En la página Seleccionar un método, seleccione el icono Agregar servidores mediante un script interactivo y, después, seleccione Generar script.On the Select a method page, select the Add servers using interactive script tile, and then select Generate script.

  4. En la página Generar script, seleccione la suscripción y el grupo de recursos en el que desea que se administre la máquina en Azure.On the Generate script page, select the subscription and resource group where you want the machine to be managed within Azure. Seleccione la ubicación de Azure en la que se almacenarán los metadatos de la máquina.Select an Azure location where the machine metadata will be stored. Esta ubicación puede ser la misma u otra diferente que la del grupo de recursos.This location can be the same or different, as the resource group's location.

  5. En la página Requisitos previos, revise la información y, luego, seleccione Siguiente: Detalles del recurso.On the Prerequisites page, review the information and then select Next: Resource details.

  6. En la página Detalles del recurso, proporcione lo siguiente:On the Resource details page, provide the following:

    1. En la lista desplegable Grupo de recursos, seleccione el grupo de recursos desde el que se administrará la máquina.In the Resource group drop-down list, select the resource group the machine will be managed from.
    2. En la lista desplegable Región, seleccione la región de Azure en la que se almacenarán los metadatos de los servidores.In the Region drop-down list, select the Azure region to store the servers metadata.
    3. En la lista desplegable Sistema operativo, seleccione el sistema operativo en el que se ejecutará el script.In the Operating system drop-down list, select the operating system that the script be configured to run on.
    4. Si la máquina se comunica mediante un servidor proxy para conectarse a Internet, especifique la dirección IP del servidor proxy o el nombre y el número de puerto que usará la máquina para comunicarse con el servidor proxy.If the machine is communicating through a proxy server to connect to the internet, specify the proxy server IP address or the name and port number that the machine will use to communicate with the proxy server. Escriba el valor con el formato http://<proxyURL>:<proxyport>.Enter the value in the format http://<proxyURL>:<proxyport>.
    5. Seleccione Siguiente: Etiquetas.Select Next: Tags.
  7. En la página Etiquetas, revise las etiquetas de ubicación física predeterminadas sugeridas y escriba un valor, o bien especifique una o varias etiquetas personalizadas para que cumplan sus estándares.On the Tags page, review the default Physical location tags suggested and enter a value, or specify one or more Custom tags to support your standards.

  8. Seleccione Siguiente: Descargar y ejecutar el script.Select Next: Download and run script.

  9. En la pestaña Descargar y ejecutar el script, revise la información del resumen y seleccione Descargar.On the Download and run script page, review the summary information, and then select Download. Si todavía necesita realizar cambios, seleccione Anterior.If you still need to make changes, select Previous.

Instalación y validación del agente en WindowsInstall and validate the agent on Windows

Instalación manualInstall manually

Para instalar manualmente el agente de Connected Machine, puede ejecutar el paquete de Windows Installer llamado AzureConnectedMachineAgent.msi.You can install the Connected Machine agent manually by running the Windows Installer package AzureConnectedMachineAgent.msi. Puede descargar la versión más reciente del paquete de Windows Installer con el agente del centro de descarga de Microsoft.You can download the latest version of the Windows agent Windows Installer package from the Microsoft Download Center.

Nota

  • Para instalar o desinstalar el agente, debe tener permisos de administrador.To install or uninstall the agent, you must have Administrator permissions.
  • Primero debe descargar y copiar el paquete del instalador en una carpeta en el servidor de destino o desde una carpeta de red compartida.You must first download and copy the Installer package to a folder on the target server, or from a shared network folder. Si ejecuta el paquete del instalador sin opciones, se inicia un asistente para instalación que puede seguir para realizar la instalación del agente de forma interactiva.If you run the Installer package without any options, it starts a setup wizard that you can follow to install the agent interactively.

Si la máquina necesita comunicarse mediante un servidor proxy con el servicio, después de instalar el agente, debe ejecutar un comando que se describe en los pasos siguientes.If the machine needs to communicate through a proxy server to the service, after you install the agent you need to run a command that's described in the steps below. Este comando permite establecer la variable de entorno del sistema del servidor proxy https_proxy.This command sets the proxy server system environment variable https_proxy.

Si no está familiarizado con las opciones de la línea de comandos para los paquetes de Windows Installer, consulte Opciones de la línea de comandos estándar de msiexec y Opciones de la línea de comandos de msiexec.If you are unfamiliar with the command-line options for Windows Installer packages, review Msiexec standard command-line options and Msiexec command-line options.

Por ejemplo, ejecute el programa de instalación con el parámetro /? para revisar la opción de ayuda y referencia rápida.For example, run the installation program with the /? parameter to review the help and quick reference option.

msiexec.exe /i AzureConnectedMachineAgent.msi /?
  1. Para instalar el agente de forma silenciosa y crear un archivo de registro de instalación en la carpeta C:\Support\Logs, ejecute el comando siguiente.To install the agent silently and create a setup log file in the C:\Support\Logs folder that exist, run the following command.

    msiexec.exe /i AzureConnectedMachineAgent.msi /qn /l*v "C:\Support\Logs\Azcmagentsetup.log"
    

    Si el agente no se inicia una vez completada la instalación, compruebe los registros para obtener información detallada del error.If the agent fails to start after setup is finished, check the logs for detailed error information. El directorio de registro es %ProgramData%\AzureConnectedMachineAgent\log.The log directory is %ProgramData%\AzureConnectedMachineAgent\log.

  2. Si la máquina necesita comunicarse a través de un servidor proxy, para establecer la variable de entorno del servidor proxy, ejecute el siguiente comando:If the machine needs to communicate through a proxy server, to set the proxy server environment variable, run the following command:

    [Environment]::SetEnvironmentVariable("https_proxy", "http://{proxy-url}:{proxy-port}", "Machine")
    $env:https_proxy = [System.Environment]::GetEnvironmentVariable("https_proxy","Machine")
    # For the changes to take effect, the agent service needs to be restarted after the proxy environment variable is set.
    Restart-Service -Name himds
    

    Nota

    El agente no admite la configuración de la autenticación de proxy en esta versión preliminar.The agent does not support setting proxy authentication in this preview.

  3. Después de instalar el agente, debe configurarlo para que se comunique con el servicio Azure Arc mediante la ejecución del siguiente comando:After installing the agent, you need to configure it to communicate with the Azure Arc service by running the following command:

    "%ProgramFiles%\AzureConnectedMachineAgent\azcmagent.exe" connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID"
    

Instalación con el método con scriptInstall with the scripted method

  1. Inicie sesión en el servidor.Log in to the server.

  2. Abra un símbolo del sistema de PowerShell con privilegios elevados.Open an elevated PowerShell command prompt.

    Nota

    El script solo admite la ejecución desde una versión de 64 bits de Windows PowerShell.The script only supports running from a 64-bit version of Windows PowerShell.

  3. Cambie a la carpeta o recurso compartido en el que copió el script y ejecútelo en el servidor mediante el script ./OnboardingScript.ps1.Change to the folder or share that you copied the script to, and execute it on the server by running the ./OnboardingScript.ps1 script.

Si el agente no se inicia una vez completada la instalación, compruebe los registros para obtener información detallada del error.If the agent fails to start after setup is finished, check the logs for detailed error information. El directorio de registro es %ProgramData%\AzureConnectedMachineAgent\log.The log directory is %ProgramData%\AzureConnectedMachineAgent\log.

Instalación y validación del agente en LinuxInstall and validate the agent on Linux

El agente de Connected Machine de Linux se proporciona en el formato de paquete preferido para la distribución (.RPM o .DEB) que se hospeda en el repositorio de paquetes de Microsoft.The Connected Machine agent for Linux is provided in the preferred package format for the distribution (.RPM or .DEB) that's hosted in the Microsoft package repository. Este conjunto de scripts de shell Install_linux_azcmagent.sh realiza las acciones siguientes:The shell script bundle Install_linux_azcmagent.sh performs the following actions:

  • Configura la máquina host para descargar el paquete del agente de packages.microsoft.com.Configures the host machine to download the agent package from packages.microsoft.com.

  • Instala el paquete del proveedor de recursos híbridos.Installs the Hybrid Resource Provider package.

Opcionalmente, puede configurar el agente con la información del proxy incluyendo el parámetro --proxy "{proxy-url}:{proxy-port}".Optionally, you can configure the agent with your proxy information by including the --proxy "{proxy-url}:{proxy-port}" parameter.

El script también contiene la lógica para identificar las distribuciones admitidas y no admitidas, y comprueba los permisos necesarios para realizar la instalación.The script also contains logic to identify the supported and unsupported distributions, and it verifies the permissions that are required to perform the installation.

En el siguiente ejemplo se descarga el agente y se instala:The following example downloads the agent and installs it:

# Download the installation package.
wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh

# Install the connected machine agent.
bash ~/Install_linux_azcmagent.sh
  1. Para descargar e instalar el agente, incluyendo el parámetro --proxy para configurar el agente para que se comunique mediante el servidor proxy, ejecute los siguientes comandos:To download and install the agent, including the --proxy parameter for configuring the agent to communicate through your proxy server, run the following commands:

    # Download the installation package.
    wget https://aka.ms/azcmagent -O ~/Install_linux_azcmagent.sh
    
    # Install the connected machine agent.
    bash ~/Install_linux_azcmagent.sh --proxy "{proxy-url}:{proxy-port}"
    
  2. Después de instalar el agente, debe configurarlo para que se comunique con el servicio Azure Arc mediante la ejecución del siguiente comando:After installing the agent, you need to configure it to communicate with the Azure Arc service by running the following command:

    azcmagent connect --resource-group "resourceGroupName" --tenant-id "tenantID" --location "regionName" --subscription-id "subscriptionID" --cloud "cloudName"
    if [ $? = 0 ]; then echo "\033[33mTo view your onboarded server(s), navigate to https://portal.azure.com/#blade/HubsExtension/BrowseResource/resourceType/Microsoft.HybridCompute%2Fmachines\033[m"; fi
    

Instalación con el método con scriptInstall with the scripted method

  1. Inicie sesión en el servidor con una cuenta que tenga acceso raíz.Log in to the server with an account that has root access.

  2. Cambie a la carpeta o recurso compartido en el que copió el script y ejecútelo en el servidor mediante el script ./OnboardingScript.sh.Change to the folder or share that you copied the script to, and execute it on the server by running the ./OnboardingScript.sh script.

Si el agente no se inicia una vez completada la instalación, compruebe los registros para obtener información detallada del error.If the agent fails to start after setup is finished, check the logs for detailed error information. El directorio de registro es var/opt/azcmagent/log.The log directory is var/opt/azcmagent/log.

Comprobación de la conexión con Azure ArcVerify the connection with Azure Arc

Después de instalar el agente y configurarlo para que se conecte a los servidores habilitados para Azure Arc, vaya a Azure Portal para comprobar que el servidor se ha conectado correctamente.After you install the agent and configure it to connect to Azure Arc enabled servers, go to the Azure portal to verify that the server has successfully connected. Vea las máquinas en Azure Portal.View your machines in the Azure portal.

Una conexión de servidor correcta

Pasos siguientesNext steps