Installer Salt Minion sur des machines virtuelles (VM) Linux ou Windows à l’aide de l’extension de machine virtuelle

2024-10-15

Prérequis

Un compte Microsoft Azure avec une (ou plusieurs) machines virtuelles (VM) Windows ou Linux
Salt Master (local ou dans un cloud) qui peut accepter des connexions à partir de minions Salt hébergés sur Azure
L’extension de machine virtuelle Salt Minion nécessite que la machine virtuelle cible soit connectée à Internet afin d’extraire des packages Salt

Plateformes prises en charge

Machine virtuelle Azure exécutant l’un des systèmes d’exploitation pris en charge suivants :

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 Professionnel (x86_64)
Microsoft Windows Server 2012 R2, 2016, 2019, 2022 Datacenter (x86_64)

Si vous souhaitez qu’une autre distribution soit prise en charge (en supposant que Salt prend en charge ), un problème peut être déposé sur GitLab.

Versions de Salt Minion prises en charge

3006 et plus (onedir)

Détails de l’extension

Nom de l’éditeur : turtletraction.oss
Nom de l’extension Linux : salt-minion.linux
Nom de l’extension Windows : salt-minion.windows

Paramètres Salt Minion

master_address - Adresse Salt Master à laquelle se connecter (localhost par défaut)
minion_id - Minion ID (nom d’hôte par défaut)
salt_version - Version Salt Minion à installer, par exemple 3006.1 (latest par défaut)

Installer Salt Minion à l’aide du portail Azure

Sélectionnez l’une de vos machines virtuelles.
Dans le menu de gauche, cliquez sur Extensions + applications.
Cliquez sur + Ajouter.
Dans la galerie, tapez Salt Minion dans la barre de recherche.
Sélectionnez la vignette Salt Minion, puis cliquez sur Suivant.
Entrez les paramètres de configuration dans le formulaire fourni (voir paramètres Salt Minion).
Cliquez sur Vérifier + créer.

Installer Salt Minion à l’aide d’Azure CLI

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"}'

Pour le désinstaller :

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

Installer Salt Minion à l’aide du modèle Azure ARM

{
    "$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')]"
                }
            }
        }
    ]
}

Installer Salt Minion à l’aide de Terraform

En supposant que vous avez défini une ressource de machine virtuelle dans TerraForm nommée vm_ubuntu, utilisez un élément similaire à celui-ci pour installer l’extension sur celle-ci :

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
}

Soutien

Pour obtenir de l’aide ou du support commercial avec Salt, vous pouvez visiter le créateur de l’extension, TurtleTraction
Le code source de cette extension est disponible sur GitLab
Pour les problèmes liés à Azure, vous pouvez déposer un incident de support Azure. Accédez au site de support Azure, puis sélectionnez Obtenir le support