MMicrosoft

Business Central op Docker

Business Central op Docker
0
Shares
0
0

Alweer een nieuwe blog over Business Central op Docker. Feit is dat ik dit dus niet dagelijks installeer op Docker en daarom dus steeds weer op zoek moet naar de laatste informatie. Zo is het me tot op de dag van vandaag niet gelukt om PowerShell 7 te gebruiken met BcContainerHelper. Tot overmaat van ramp had ik bedacht dat ik dit ook wel op een Windows Server 2025 in Azure kon laten draaien. Inmiddels ben ik weer terug naar PowerShell 5.1 gebruik makende van PowerShell ISE op Windows Server 2022. Een klein uitstapje dus, met grote gevolgen omdat ik veel tijd kwijt ben geraakt aan het oplossen van dingen die op dit moment nog niet lijken te werken. Voor de bedoeling van deze blog post om Business Central 2025 Wave 1 (versie 26) op Docker te laten draaien, maakt dat voorlopig niet uit.

Eerste template die ik gebruikte. 

# Begin variables
$containerName = $containerName
$dnsName = $dnsName # For example "docker.example.com"
$password = $password
$userName = $userName
$authenticationEmail = $authenticationEmail
$securePassword = ConvertTo-SecureString -String $password -AsPlainText -Force
$credential = New-Object pscredential $userName, $securePassword
$auth = 'UserPassword'
$artifactUrl = Get-BcArtifactUrl -type 'Sandbox' -country 'nl' -select 'Latest'
$aadTenant = $aadTenant
$aadAppId = $aadAppId
$aadAppIdUri = $aadAppIdUri
$licenseFile = $licenseFile
# End variables

# Begin installatie module BcContainerHelper
Install-Module BcContainerHelper -force
# End installatie module BcContainerHelper

# Begin deployment
New-BcContainer `
  -accept_eula `
  -containerName $containerName `
  -artifactUrl $artifactUrl `
  -auth "AAD" `
  -aadTenantId $aadTenant `
  -AuthenticationEMail $aadUser `
  -Credential $MyCredential `
  -useSSL=Y `
  -publicDnsName $dnsName `
  -assignPremiumPlan `
  -updateHosts `
  -dns "8.8.8.8" `
  -includeTestToolkit `
  -includeTestLibrariesOnly `
  -AadAppId  $aadAppId `
  -AadAppIdUri $aadAppIdUri `
  -installCertificateOnHost=Y `
  -multitenant `
  -WebClientPort 443 `
  -licenseFile $licenseFile `
  -alwaysPull
# End deployment

NB: de variabelen moeten nog ingevuld worden. Vanwege privacy, heb ik ze dezelfde naam gegeven.

Uiteraard kan ik natuurlijk voor het gemakkelijke gaan. We installer Docker, zetten deze om naar Windows Containers, zorgen ervoor dat Hyper-V en Containers als rol worden ondersteund op Windows Server 2022. Wat ik wil is dit te laten draaien met Azure AD Authentication. De meeste blogs die op internet zijn verschenen, beschrijven dit niet. Het meest makkelijke is natuurlijk om de Server Instance uit te rusten met NavUserPassword als authenticatie mechanisme.

De tweede template die ik gebruik is de daarom volgende. Ik heb overigens een blog post die je kunt vinden op deze site gebruikt. Is wel zo handig natuurlijk. Anders moest ik iedere keer de credentials van de AAD gebruiken invullen. Voor de rest geldt: Zoek de verschillen!

# Begin prerequisites
Set-ExecutionPolicy Unrestricted -Scope LocalMachine -Force
Install-PackageProvider -Name NuGet -force
Install-Module BcContainerHelper -Force
# End prerequisites

# Begin variables
$containerName = $containterName
$aadTenant = $aadTenant
$aadUser = $aadUser
$dnsName = $dnsName
$artifactUrl = Get-BcArtifactUrl -type 'Sandbox' -country 'nl' -select 'Latest'
$aadAppId = $aadAppId
$aadAppIdUri = $aadAppIdUri
$licenseFile = "C:\temp\4845780.bclicense"
$UserName = Read-Host "Enter Username"
$Password = Read-Host "Enter Password" -AsSecureString
$TEMP = "$env:TEMP"
$File = "$Temp\Password.txt"
$Password | ConvertTo-SecureString -AsPlainText -Force | ConvertFrom-SecureString | Out-File $File
$Password = Get-Content $File | ConvertTo-SecureString
$User = $UserName
$MyCredential=New-Object -TypeName System.Management.Automation.PSCredential `
 -ArgumentList $User, (Get-Content $File | ConvertTo-SecureString)
# End variables

# Begin deployment
New-BcContainer `
  -accept_eula `
  -containerName $containerName `
  -artifactUrl $artifactUrl `
  -auth "AAD" `
  -aadTenantId $aadTenant `
  -AuthenticationEMail $aadUser `
  -Credential $MyCredential `
  -useSSL=Y `
  -publicDnsName $dnsName `
  -assignPremiumPlan `
  -updateHosts `
  -dns "8.8.8.8" `
  -AadAppId  $aadAppId `
  -AadAppIdUri $aadAppIdUri `
  -useSSL=Y `
  -installCertificateOnHost=Y `
  -multitenant `
  -WebClientPort 443 `
  -licenseFile $licenseFile `
  -additionalParameters @("--publish 443:443")
# End deployment

# Begin import modules
Enter-BcContainer -containerName $containerName
Import-Module WebAdministration
Import-Module "C:\Program Files\Microsoft Dynamics NAV\260\Service\Microsoft.Dynamics.Nav.Management.psm1"
Import-Module "C:\Program Files\Microsoft Dynamics NAV\260\Service\NAVWebClientManagement.psm1"
# End import modules

# Begin list certificates in LocalMachine\My
$cert = Get-ChildItem -Path Cert:\LocalMachine\My |
    Where-Object { $_.Subject -like "*$dnsName*" } |
    Sort-Object NotAfter -Descending |
    Select-Object -First 1
$ServicesCertificateThumbprint = $cert.Thumbprint
# Begin list certificates in LocalMachine\My

# Begin configuring the parameters
Set-NAVServerConfiguration -ServerInstance BC -KeyName PublicWebBaseUrl -KeyValue "https://$dnsName/BC/"
Set-NAVServerConfiguration -ServerInstance BC -KeyName PublicSOAPBaseUrl -KeyValue "https://$dnsName:7047/BC/WS/"
Set-NAVServerConfiguration -ServerInstance BC -KeyName PublicODataBaseUrl -KeyValue "https://$dnsName:7048/BC/ODataV4/"
Set-NAVServerConfiguration -ServerInstance BC -KeyName PublicWinBaseUrl -KeyValue ""
Set-NAVServerConfiguration -ServerInstance BC -KeyName ServicesCertificateThumbprint -KeyValue $ServicesCertificateThumbprint
Restart-NAVServerInstance -ServerInstance BC -Force
Get-NAVServerConfiguration -ServerInstance BC
# End configuring the parameters

# Begin troubleshooting
Get-WebSite
Get-WebBinding
Remove-WebBinding -Name http -BindingInformation "*:443:"
Stop-Website -Name http
Start-Website -Name http
New-WebBinding -Name "NavWebApplicationContainer" -Protocol https -Port 443 -HostHeader "$dnsName"
Start-Website -Name "NavWebApplicationContainer"
netsh http add sslcert ipport=0.0.0.0:443 certhash=$ServicesCertificateThumbprint appid='{00112233-4455-6677-8899-AABBCCDDEEFF}'
# End troubleshooting

# Begin export / import SSL cert
$cert = Get-ChildItem -Path Cert:\LocalMachine\My | Where-Object { $_.Subject -like "*$dnsName*" }
$certPath = "C:\run\$dnsName.cer"
Export-Certificate -Cert $cert -FilePath $certPath
exit
docker cp bc-aad-nl:"C:\run\$dnsName.cer" "C:\temp\$dnsName.cer"
Import-Certificate -FilePath "C:\temp\$dnsName.nl.cer" -CertStoreLocation "Cert:\LocalMachine\Root"
# End export / import SSL cert

De deployment is met dit script gedaan en de connecties zijn ready to go. Nice

Business Central op Docker

Waarom werkt Business Central op Docker niet out of the box?

Dit komt omdat New-BcContainer voor interne doeleinden een aparte site opzet over port 8080, te weten http://$dnsName:8080/language.vsix. Echter, omdat we useSSL en installCertificateOnHost als parameter gebruiken, voegt New-BcContainer een binding toe over port 443 op elke IIS site. Maar omdat we geen meerdere zelfde wildcard bindings kunnen hebben op twee sites binnen IIS, ontstaat er een probleem dat de site NavWebApplicationContainer niet gestart wordt.

De oplossing is dan om de binding van de IIS site http weg te halen en een nieuwe binding toe te voegen via netsh. Dit doen we dus met bovenstaande script.

Maar het kan ook gemakkelijker.

Een ander optie is om een script mee te geven met een certificaat

We gebruiken hiervoor een SSL cert dat we in een folder plaatsen op de host. Dit kan een self signed certificaat zijn of een trusted cert. Als we een self signed SSL cert willen we gebruiken, dan kan dat via de volgende blog posting op deze site. Het PowerShell script wordt dan als volgt.

# Begin prerequisites
Set-ExecutionPolicy Unrestricted -Scope LocalMachine -Force
Install-PackageProvider -Name NuGet -force
Install-Module BcContainerHelper -Force
# End prerequisites

# Begin variables
$containerName = $containerName
$aadTenant = $aadTenant 
$dnsName = $dnsName
$artifactUrl = Get-BcArtifactUrl -type 'Sandbox' -country 'nl' -select 'Latest'
$aadAppId = $aadAppId
$aadAppIdUri = $aadAppIdUri
$licenseFile = $licenseFile
$UserName = Read-Host "Enter Username"
$Password = Read-Host "Enter Password" -AsSecureString
$TEMP = "$env:TEMP"
$File = "$Temp\Password.txt"
$Password | ConvertTo-SecureString -AsPlainText -Force | ConvertFrom-SecureString | Out-File $File
$Password = Get-Content $File | ConvertTo-SecureString
$MyCredential=New-Object -TypeName System.Management.Automation.PSCredential `
 -ArgumentList $UserName, (Get-Content $File | ConvertTo-SecureString)
# End variables

# Begin deployment
New-BCContainer -accept_eula `
                -isolation process `
                -containerName $containerName `
                -memoryLimit 8G `
                -artifactUrl $artifactUrl `
                -Credential $MyCredential `
                -updateHosts `
                -doNotExportObjectsToText `
                -auth AAD `
                -aadTenantId $aadTenant `
                -AadAppId  $aadAppId `
                -AadAppIdUri $aadAppIdUri `
                -AuthenticationEMail $userName `
                 -multitenant `
                -dns "8.8.8.8" `
                -additionalParameters $additionalParameters `
                -useSSL `
                -shortcuts Desktop `
                -assignPremiumPlan `
                -licenseFile $licenseFile `
                -myScripts @{"SetupCertificate.ps1" = $SetupCertificateScript}, "C:\temp\SSL Cert.p12"
# End deployment

# Begin enabling rewrite rules in web.config
Copy-FileFromBcContainer -containerName $containerName `
  -containerPath 'C:\inetpub\wwwroot\bc\web.config' `
  -localPath 'C:\Temp\web.config'

Copy-FileToBcContainer -containerName $containerName `
 -containerPath 'C:\inetpub\wwwroot\bc\web.config' `
 -localPath 'C:\Temp\web.config'
# Begin enabling rewrite rules in web.config

# Begin import modules
Enter-BcContainer -containerName $containerName
Import-Module "C:\Program Files\Microsoft Dynamics NAV\260\Service\Microsoft.Dynamics.Nav.Management.psm1"
Import-Module "C:\Program Files\Microsoft Dynamics NAV\260\Service\NAVWebClientManagement.psm1"
# End import modules

# Begin adjusting tenant properties
Dismount-NAVTenant -Tenant default -ServerInstance BC -Force
Mount-NavTenant -ServerInstance BC -Tenant default -DatabaseName default -DatabaseServer localhost\SQLEXPRESS `
-AadTenantId $dnsName -AlternateId $dnsName -NasServicesEnabled -OverwriteTenantIdInDatabase
# End adjusting tenant properties

Meer informatie hoe je de rewrite rule aanzet binnen de web.config file om host names voor tenants te accepteren, lees je hier.

0 Shares:
Share 0

Marco Mels is geboren in Hoogvliet, opgegroeid in Spijkenisse en tot slot heeft hij zijn studententijd doorgebracht in Rotterdam. Na een aantal jaren is Marco Mels verhuisd naar Maarssen om uiteindelijk in Riethoven te belanden. Daar woont Marco Mels nog steeds met zijn vriendin Marga en zijn twee kinderen Kevin en Nessa.

Geef een reactie

Uw e-mailadres wordt niet gepubliceerd. Vereiste velden zijn gemarkeerd met *

— Previous article

Missie statement

You May Also Like