Como criar sua imagem do Business Central no Docker (Guia completo + dicas práticas)

Se você já tentou configurar um ambiente de desenvolvimento para Dynamics 365 Business Central e sentiu que ficou preso em detalhes de versões, configurações ou dependências, você não está sozinho.

O uso de Docker + BCContainerHelper transformou a forma como fazemos desenvolvimento com Business Central: ambientes consistentes, rápidos de criar, isolados e facilmente replicáveis entre a equipe — sem o famoso “na minha máquina funciona”.

Neste artigo, vamos ver como criar uma imagem personalizada do Business Central no Docker, com todos os passos essenciais, boas práticas e dicas extras que a maioria dos guias rápidos deixam de lado.

O que você vai precisar antes de começar

Antes de colocar a mão na linha de comando, tenha isso pronto:

• Windows 10/11 Pro ou Enterprise (Docker em modo Windows).

• Docker Desktop instalado e configurado para Windows Containers.

• PowerShell rodando como Administrador.

• BcContainerHelper instalado (módulo PowerShell usado para criar/manipular containers).

Se você estiver no Windows Home, não poderá usar containers Windows diretamente — nesse caso a alternativa é usar máquina virtual no Azure com Windows Server + Docker.

Passo a passo: preparando o ambiente

• Instalar Docker e habilitar Hyper-V

  • Instale o Docker Desktop e certifique-se de que o modo Windows Containers está ativo. O Business Central roda em containers Windows, então essa etapa é essencial.

No PowerShell (como Administrador), habilite as features:

Install-Module BCContainerHelper -Force

Reinicie o computador após habilitar o Hyper-V.

• Instalar BCContainerHelper

  BcContainerHelper é o módulo PowerShell que faz toda a mágica acontecer entre PowerShell, Docker e Business Central.

No PowerShell (como Administrador):

Enable-WindowsOptionalFeature -Online -FeatureName $("Microsoft-Hyper-V", "Containers") -All

Se surgir erro de políticas, ajuste:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Force -Scope LocalMachine

Não esqueça de reiniciar novamente, se necessário.

Entendendo Artifacts e criando o container

Ao contrário de imagens Docker tradicionais, o Business Central não é baixado diretamente como “image” Docker — ele usa Artifacts, que são pacotes oficiais com o instalador do BC.

Parâmetros importantes:

• -type: Sandbox ou OnPrem

• -country: localização (ex: br, us, w1)

• -select: versão específica ou Latest

O artifact será baixado para a pasta de cache (bcartifacts.cache), o que acelera containers futuros.

Com o artifact definido, vamos criar um container completo.

Defina o nome do container, usuário e senha do ambiente — lembrando dos requisitos de senha (letras maiúsculas, minúsculas, número e símbolo).

Aqui está um exemplo:

$containerName = 'bctest'

$password = 'P@ssw0rd'

$securePassword = ConvertTo-SecureString -String $password -AsPlainText -Force

$credential = New-Object pscredential 'admin', $securePassword

$auth = 'UserPassword'

$artifactUrl = Get-BcArtifactUrl -type 'Sandbox' -country 'us' -select 'Latest'

New-BcContainer `

-accept_eula `

-containerName $containerName `

-credential $credential `

-auth $auth `

-artifactUrl $artifactUrl `

-imageName 'mybc' `

-isolation 'hyperv' `

-memoryLimit 4G `

-vsixFile (Get-LatestAlLanguageExtensionUrl) `

-updateHosts

Transformando o container em uma imagem reutilizável

Depois que você configurou o container (instalou extensões, configurou dados, etc.), é uma ótima ideia transformá-lo em uma imagem Docker personalizada. Isso facilita criar novos ambientes idênticos para a equipe.

No terminal, use:

docker commit bc-docker-sandbox bc/bc-custom:1.0

Agora você tem uma imagem customizada com tag 1.0. Use essa imagem para criar outros containers rapidamente:

docker run -d --name bc-sandbox-2 bc/bc-custom:1.0

Dicas práticas que valem ouro

• Cache de artifacts

  • Se você cria containers repetidamente, o artifact cache acelera bastante o processo de inicialização.

• Configurações padrões do BcContainerHelper

  • Você pode ajustar valores padrão (como isolamento, atualização de hosts etc.) no arquivo de configuração do BCContainerHelper, reduzindo repetição de parâmetros nos scripts.

• Use volumes quando precisar de persistência

  • Se for mapear código ou dados entre container e host, configurar volumes é essencial.

• Não deixe dados sensíveis na imagem

  • Senha e credenciais não devem ficar embutidas dentro de uma imagem pública ou compartilhada.

Usando sua imagem no pipeline CI/CD

Criar imagens consistentes é um passo natural para CI/CD em Business Central. Com Docker, você pode:

• Automatizar builds de extensões

• Rodar testes automatizados em ambiente isolado

• Ter pipelines reprodutíveis entre ambientes de Dev, QA e Release.

O BCContainerHelper se integra bem com ambientes como Azure DevOps ou GitHub Actions — transformando esse processo em código.

Conclusão

Se você quer um ambiente de desenvolvimento rápido, consistente e padronizado para Business Central, usar Docker com BCContainerHelper é praticamente obrigatório no seu arsenal.

Além de facilitar o trabalho individual, isso melhora a sincronia do time e reduz bugs relacionados ao ambiente.

Se este artigo te ajudou, compartilhe com a comunidade.