Instalación de Salt Minion en máquinas virtuales Linux o Windows mediante la extensión de máquina virtual

2025-04-13

Requisitos previos

Una cuenta de Microsoft Azure con una (o varias) máquinas virtuales Windows o Linux
Un Salt Master (ya sea local o en una nube) que puede aceptar conexiones de Salt Minions hospedados en Azure
La extensión de máquina virtual de Salt Minion requiere que la máquina virtual de destino esté conectada a Internet para capturar los paquetes de Salt

Plataformas compatibles

Una máquina virtual de Azure que ejecuta cualquiera de los siguientes sistemas operativos compatibles:

Ubuntu 20.04, 22.04 (x86_64)
Debian 10, 11 (x86_64)
Oracle Linux 7, 8, 9 (x86_64)
RHEL 7, 8, 9 (x86_64)
Microsoft Windows 10, 11 Pro (x86_64)
Microsoft Windows Server 2012 R2, 2016, 2019, 2022 Datacenter (x86_64)

Si desea que se admita otra distribución (suponiendo que Salt la admita), se puede presentar una incidencia en GitLab.

Versiones admitidas de Salt Minion

3006 y superiores (onedir)

Detalles de la extensión

Nombre del publicador: turtletraction.oss
Nombre de la extensión de Linux: salt-minion.linux
Nombre de la extensión de Windows: salt-minion.windows

Configuración de Salt Minion

master_address: Dirección del Salt Master a la que conectarse (localhost de forma predeterminada)
minion_id: Id. de Minion (nombre de host de forma predeterminada)
salt_version: Versión de Salt Minion que se va a instalar, por ejemplo 3006.1 (latest de forma predeterminada)

Instalación de Salt Minion desde Azure Portal

Seleccione una de sus máquinas virtuales.
En el menú izquierdo, haga clic en Extensiones y aplicaciones.
Haga clic en + Agregar.
En la galería, escriba Salt Minion en la barra de búsqueda.
Seleccione el icono de Salt Minion y haga clic en Siguiente.
Escriba los parámetros de configuración en el formulario proporcionado (consulte Configuración de Salt Minion).
Haga clic en Revisar y crear.

Instalación de Salt Minion mediante la CLI de Azure

az vm extension set --resource-group my-group --vm-name vm-ubuntu22 --name salt-minion.linux --publisher turtletraction.oss --settings '{"master_address": "10.x.x.x"}'
az vm extension set --resource-group my-group --vm-name vm-windows11 --name salt-minion.windows --publisher turtletraction.oss --settings '{"master_address": "10.x.x.x"}'

Para desinstalarlo:

az vm extension delete --resource-group my-group --vm-name vm-ubuntu22 --name salt-minion.linux
az vm extension delete --resource-group my-group --vm-name vm-windows11 --name salt-minion.windows

Instalación de Salt Minion mediante la plantilla ARM de Azure

{
    "$schema": "http://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "vmName": {
            "type": "string"
        },
        "master_address": {
            "type": "string"
        },
        "salt_version": {
            "type": "string"
        },
        "minion_id": {
            "type": "string"
        }
    },
    "resources": [
        {
            "name": "[concat(parameters('vmName'),'/salt-minion.linux')]",
            "type": "Microsoft.Compute/virtualMachines/extensions",
            "location": "[resourceGroup().location]",
            "apiVersion": "2015-06-15",
            "properties": {
                "publisher": "turtletraction.oss",
                "type": "salt-minion.linux",
                "typeHandlerVersion": "1.0",
                "autoUpgradeMinorVersion": true,
                "settings": {
                    "master_address": "[parameters('master_address')]",
                    "salt_version": "[parameters('salt_version')]",
                    "minion_id": "[parameters('minion_id')]"
                }
            }
        }
    ]
}

Instalación de Salt Minion con Terraform

Suponiendo que haya definido un recurso de máquina virtual en TerraForm denominado vm_ubuntu, use algo parecido a esto para instalar la extensión en él:

resource "azurerm_virtual_machine_extension" "vmext_ubuntu" {
  name                 = "vmext_ubuntu"
  virtual_machine_id   = azurerm_linux_virtual_machine.vm_ubuntu.id
  publisher            = "turtletraction.oss"
  type                 = "salt-minion.linux"
  type_handler_version = "1.0"

  settings = <<SETTINGS
{
  "salt_version": "3006.1",
  "master_address": "x.x.x.x",
  "minion_id": "ubuntu22"
}
SETTINGS
}

Soporte técnico

Para obtener soporte técnico o asistencia comercial de Salt, puede visitar al creador de la extensión, TurtleTraction
El código fuente de esta extensión está disponible en GitLab
En el caso de los problemas relacionados con Azure, puede presentar un incidente de soporte técnico de Azure. Vaya al sitio de Soporte técnico de Azure y seleccione Obtener soporte