Configurer Azure SQL Edge

Azure SQL Edge prend en charge la configuration par le biais d'une deux options suivantes :

• Variables d'environnement
• Un fichier mssql.conf placé dans le dossier /var/opt/mssql

Configurer à l'aide des variables d’environnement

Azure SQL Edge expose plusieurs variables d’environnement qui peuvent être utilisées pour configurer le conteneur SQL Edge. Ces variables d’environnement correspondent à un sous-ensemble de celles disponibles pour SQL Server sur Linux. Pour plus d’informations sur les variables d’environnement SQL Server sur Linux, consultez Variables d’environnement.

Les nouvelles variables d’environnement suivantes ont été ajoutées à Azure SQL Edge.

La variable d’environnement SQL Server sur Linux suivante n’est pas prise en charge par Azure SQL Edge. Si elle est définie, cette variable d’environnement est ignorée lors de l’initialisation du conteneur.

Spécifier les variables d’environnement

Spécifiez les variables d’environnement pour SQL Edge lorsque vous déployez le service via le portail Azure. Vous pouvez les ajouter dans la section Variables d’environnement du déploiement de module ou dans le cadre des Options de création de conteneur.

Ajoutez les valeurs dans des Variables d’environnement.

Ajoutez des valeurs dans Options de création de conteneur.

Configurer à l’aide d’un fichier mssql.conf

Azure SQL Edge n’inclut pas l’utilitaire de configuration mssql-conf comme le fait SQL Server sur Linux. Vous devez configurer manuellement le fichier mssql.conf et le placer dans le lecteur de stockage persistant qui est mappé au dossier /var/opt/mssql/ dans le module SQL Edge. Lors du déploiement de SQL Edge via Azure IoT Hub, ce mappage est spécifié en tant qu’option Mounts dans les Options de création de conteneur.

{
  "Mounts": [
    {
      "Type": "volume",
      "Source": "sqlvolume",
      "Target": "/var/opt/mssql"
    }
  ]
}

Les nouvelles options MSSQL. conf suivantes ont été ajoutées pour Azure SQL Edge.

Les options mssql.conf suivantes ne s’appliquent pas à SQL Edge :

L’exemple suivant de fichier mssql.conf fonctionne pour SQL Edge. Pour plus d’informations sur le format d’un fichier , consultez mssql.conf Format mssql.conf.

[EULA]
accepteula = Y

[coredump]
captureminiandfull = true
coredumptype = full

[filelocation]
defaultbackupdir = /var/opt/mssql/backup/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/log/

[language]
lcid = 1033

[memory]
memorylimitmb = 6144

[sqlagent]
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[traceflag]
traceflag0 = 3604
traceflag1 = 3605
traceflag2 = 1204

Exécutez Azure SQL Edge en tant qu’utilisateur non racine

Par défaut, les conteneurs Azure SQL Edge s'exécutent avec un utilisateur/groupe non racine. En cas de déploiement via Azure IoT Hub (ou en utilisant docker run), à moins qu’un autre utilisateur/groupe ne soit spécifié, les conteneurs SQL Edge démarrent en tant qu’utilisateur MSSQL (non racine). Pour spécifier un autre utilisateur non racine pendant le déploiement, ajoutez la paire clé-valeur *"User": "<name|uid>[:<group|gid>]"* sous les options de création de conteneur. Dans l’exemple suivant, SQL Edge est configuré pour démarrer en tant qu’utilisateur *IoTAdmin*.

{
    ..
    ..
    ..
    "User": "IoTAdmin",
    "Env": [
        "MSSQL_AGENT_ENABLED=TRUE",
        "ClientTransportType=AMQP_TCP_Only",
        "MSSQL_PID=Premium"
    ]
}

Pour permettre à l’utilisateur non racine d’accéder aux fichiers de base de données qui se trouvent sur des volumes montés, vérifiez que l’utilisateur/le groupe sous lequel vous exécutez le conteneur dispose des autorisations de lecture et d’écriture sur le stockage de fichiers persistant. Dans l’exemple suivant, nous définissons l’utilisateur non racine avec le user_id de 10001 comme propriétaire des fichiers.

chown -R 10001:0 <database file dir>

Mise à niveau à partir de versions CTP antérieures

Les CTP précédentes d'Azure SQL Edge étaient configurées de manière à s'exécuter en tant qu'utilisateurs racine. Les options suivantes sont disponibles lors de la mise à niveau à partir de CTP antérieures.

• Continuer à utiliser l’utilisateur racine - Pour continuer à utiliser l’utilisateur racine, ajoutez la paire clé-valeur *"User": "0:0"* sous les options de création de conteneur.

• Utiliser l’utilisateur MSSQL par défaut - Pour utiliser l’utilisateur MSSQL par défaut, suivez ces étapes :

  • Ajoutez un utilisateur nommé mssql sur l’hôte Docker. Dans l’exemple ci-dessous, nous ajoutons un utilisateur MSSQL avec l’ID 10001. Cet utilisateur est également ajouté au groupe racine.

    sudo useradd -M -s /bin/bash -u 10001 -g 0 mssql
    

  • Modifier l'autorisation sur le répertoire/volume de montage dans lequel se trouve le fichier de base de données

    sudo chgrp -R 0 /var/lib/docker/volumes/kafka_sqldata/
    sudo chmod -R g=u /var/lib/docker/volumes/kafka_sqldata/
    

• Utiliser un autre compte d’utilisateur non racine - Pour utiliser un autre compte d’utilisateur non racine

  • Mettez à jour les options de création de conteneur pour spécifier l’ajout d’une paire clé-valeur *"User": "user_name | user_id* sous les options de création de conteneur. Remplacez user_name ou user_id par un user_name ou un user_id réel de votre hôte Docker.
  • Modifiez les autorisations sur le répertoire/volume de montage.

Rendre vos données persistantes

Vos changements de configuration et fichiers de base de données Azure SQL Edge sont conservés dans le conteneur même si vous redémarrez le conteneur avec docker stop et docker start. Toutefois, si vous supprimez le conteneur avec docker rm, tout ce qui se trouve dans le conteneur est supprimé, y compris Azure SQL Edge et vos bases de données. La section suivante explique comment utiliser des volumes de données pour conserver les fichiers de votre base de données même si les conteneurs associés sont supprimés.

Monter un répertoire hôte en tant que volume de données

La première option consiste à monter un répertoire sur votre hôte en tant que volume de données dans votre conteneur. Pour ce faire, utilisez la commande docker run avec l'indicateur -v <host directory>:/var/opt/mssql. Cela permet de restaurer les données entre les exécutions de conteneur.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -p 1433:1433 -v <host directory>/data:/var/opt/mssql/data -v <host directory>/log:/var/opt/mssql/log -v <host directory>/secrets:/var/opt/mssql/secrets -d mcr.microsoft.com/azure-sql-edge

Cette technique vous permet également de partager et d’afficher les fichiers sur l’ordinateur hôte en dehors de Docker.

Utiliser des conteneurs de volume de données

La deuxième option consiste à utiliser un conteneur de volume de données. Vous pouvez créer un conteneur de volume de données en spécifiant un nom de volume à la place d’un répertoire hôte avec le paramètre -v. L’exemple suivant crée un volume de données partagé nommé sqlvolume.

docker run -e 'ACCEPT_EULA=Y' -e 'MSSQL_SA_PASSWORD=<password>' -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" -p 1433:1433 -v sqlvolume:/var/opt/mssql -d mcr.microsoft.com/azure-sql-edge

Même si vous arrêtez et supprimez ce conteneur, le volume de données persiste. Vous pouvez l’afficher avec la commande docker volume ls.

docker volume ls

Si vous créez ensuite un autre conteneur avec le même nom de volume, le nouveau conteneur utilise les données Azure SQL Edge contenues dans le volume.

Pour supprimer un conteneur de volume de données, utilisez la commande docker volume rm.

Contenu connexe

• Se connecter à Azure SQL Edge
• Générer une solution IoT de bout en bout avec SQL Edge