Article publié le 5 novembre 2019 par Jean-Charles OUAIRY
Introduction
Dans cet article, nous aborderons les étapes relatives à la configuration d’un conteneur Docker Microsoft Dynamics Business Central 2019 Wave 2 # MSDyn365BC.
Installer un conteneur docker
Suivre les explications du lien : https://docs.docker.com/docker-for-windows/install/
Aller sur le site https://www.docker.com :
Créer votre compte
Télécharger docker for desktop.
Une fois l’installation faite, lors de l’initialisation, faire un clic droit sur l’icône : cliquer sur « Switch to Windows Containers »
Ouvrir PowerShell ISE
L’exécuter en tant qu’administrateur
Set Execution Policy
Cette commande n’est à lancer qu’une seule fois et permet à PowerShell d’exécuter tous les scripts.
Si le script n’est pas signé, une autorisation d’exécution sera demandée.
Set-ExecutionPolicy Unrestricted -Force
La commande Set-ExecutionPolicy RemoteSigned -Force n’autorisera pas les scripts non signés.
Plus d’informations :
https://forsenergy.com/fr-fr/windowspowershellhelp/html/24d903a7-780b-42fa-96b5-cc9596da0073.htm
Install Nav Container Helper
Cette instruction installe les commandes nécessaires pour la gestion des conteneurs BC.
Elle est à utiliser à chaque téléchargement de nouveau conteneur (on a alors la dernière version).
Install-Module -Name navcontainerhelper -Force
La commande de création d’un conteneur pour Business Central 2019
Script de téléchargement de la version
Il faut copier le texte dans powershell
Quelques paramètres :
memoryLimit | Taille de la mémoire dévolue au conteneur. Dans l’exemple c’est 3GB mais il faut remplacer le 3 par 10 pour passer à 10 GB. |
$licenseFile | Indique le chemin sur la machine locale où se trouve la licence. |
admin | Nom d’utilisateur du conteneur. |
P@ssword1 | Mot de passe du conteneur. |
$containerName | Nom du conteneur. |
$imageName | Le nom de l’image Business Central à utiliser. |
Pour créer un conteneur basé sur une version On-Prem pour Business Central 2019 Wave 2, utiliser un des liens suivants vers les images :
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-w1
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-w1-ltsc2016
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-w1-ltsc2019
Pour créer un conteneur basé sur une version Cloud bac à sable Business Central 2019 Wave, utiliser un des liens suivants vers les images :
mcr.microsoft.com/businesscentral/sandbox:15.0.36560.36626-w1
mcr.microsoft.com/businesscentral/sandbox:15.0.36560.36626-w1-ltsc2016
mcr.microsoft.com/businesscentral/sandbox:15.0.36560.36626-w1-ltsc2019
Tous ces liens sont pour la W1 (Worldwide Version)
Comment les interpréter ?
mcr.microsoft.com/businesscentral | Racine pour toutes les images Business Central. |
on-prem ou Sandbox | Spécifie quelle image souhaitée OnPrem ou Sandbox. |
15.0.36560.36626 | Version du produit. |
W1 | Localisation à installer. |
ltsc2016 or ltsc2019 | Système opératoire du conteneur à utiliser Windows Server 2016 ou 2019. |
Donc pour configurer une version OnPrem pour la France l’instruction sera l’une des suivantes :
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-fr
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-fr-ltsc2016
mcr.microsoft.com/businesscentral/onprem:15.0.36560.0-fr-ltsc2019
Comment trouver les versions ?
Dans notre cas, nous utilisons la version du produit 15.0.36560.0 mais comment la trouver ?
Pour Business Central On-Prem vous trouverez les versions ici
Pour Business Central Sandbox vous c’est par ici
La commande suivante permet de télécharger la dernière version sandbox FR :
mcr.microsoft.com/businesscentral/sandbox:fr
Que se passe-t-il lors de l’exécution de cette commande ?
Selon votre débit internet Internet et l’utilisation de conteneurs existants cela peut prendre entre 10 minutes et une heure pour compléter le processus de setup d’un conteneur.
La fin du traitement donne le résultat suivant :
Que contient la page de résultat ?
Container IP Address.
Container Hostname.
Web Client URL.
Files.
Des raccourcis seront créés sur votre bureau.
Vous pouvez utiliser ces informations pour travailler via le client web, et également développer via VS Code et créer vos propres extensions.
Sauvegardez ces détails pour l’avenir.
Comment créer un nouvel utilisateur dans un conteneur ?
Ouvrir PowerShell ISE et l’exécuter en tant qu’administrateur. L’utilisateur aura un ensemble d’autorisations SUPER
$Credentials = get-credential -Message "Set new user"
New-NavContainerNavUser -containerName "Nomducontainer" -Credential $Credentials
Comment supprimer un conteneur docker ?
Ouvrir PowerShell ISE et l’exécuter en tant qu’administrateur.
Remove-NavContainer -containerName "Nomducontainer"
Exemple :
Remove-NavContainer -containerName 'BC15FR'
Comment remplacer une licence dans un conteneur docker ?
Pour importer une licence dans un conteneur existant, il faut utiliser la fonction
Import-NavContainerLicense
Exemple :
Import-NavContainerLicense -containerName 'BC15FR' -licenseFile 'C:\Licences\AC_FR.flf'
Comment télécharger le code standard ?
La commande -includeAL permet de télécharger les objets AL de la base du conteneur, ce qui peut être utile pour débugger le standard.
Pour récupérer les fichiers AL, il faut ensuite lancer le script ci-joint (à recopier dans PowerShell) :
Plus d’informations en suivant le lien suivant :
https://demiliani.com/2019/10/25/dynamics-365-business-central-debugging-the-base-application/
Récapitulatif des liens
Rubriques d'aide relatives aux applets de commande Windows PowerShell