O documento descreve como ajustar as configurações de localização (locale) em containers Docker para suportar corretamente a acentuação portuguesa. Ele lista sintomas de quando o ajuste é necessário e passos para verificar e realizar o ajuste, incluindo instalar pacotes, gerar e configurar o locale pt_BR.UTF-8 e reiniciar o container.

1. Como ajustar a acentuação portuguesa
em containers do Docker?
Sintomas:
 A acentuação portuguesa e os caracteres especiais
não são exibidos corretamente
 A criação de databases relacionais com a correta
interpretação da acentuação portuguesa ou de outros
caracteres especiais não é possível exibindo uma
mensagem de erro
 A inserção de documentos com caracteres especiais
em databases não relacionais não retornam operação
bem sucedida
Como verificar se o ajuste é necessário?
1. No docker acesse o container que está rodando
2. Com o “vi” crie um arquivo e insira acentuação
portuguesa. Grave o arquivo e abra-o novamente
verificando que a acentuação está sendo exibida
corretamente.
3. Execute o comando: locale
4. Verifique se as variáveis: LANG, LANGUAGE, LC_ALL
possuem valores.
Se os passos 2 e 4 não tiveram sucesso, o ajuste é
necessário.

2. Como ajustar?
Considerando que você já está “logado” no container,
execute os seguintes passos:
 apt-get –qq update
 apt-get install locales
 locale-gen pt_BR.UTF-8
 dpkg-reconfigure locales (escolher: pt_BR.ETF-8)
 echo 'export LANG="pt_BR.UTF-8"' >>
$HOME/.bashrc
 echo 'export LANGUAGE="pt_BR.UTF-8"' >>
$HOME/.bashrc
 echo 'export LC_ALL="pt_BR.UTF-8"' >>
$HOME/.bashrc
 update-locale LC_ALL=pt_BR.UTF-8
LANG=pt_BR.UTF-8 LANGUAGE=pt_BR.UTF-8
Faça um novo “logon” no container
 Repita o teste do item 2 acima
 execute o comando: locale
 Verifique se as variáveis: LANG, LANGUAGE, LC_ALL
estão com o valor: pt_BR.ETF-8
Se sim, o ajuste foi feito corretamente
Palavras chave:
Docker, Container, Locale, Linux, SQL, NoSQL,
pt_BR.ETF-8, acentuação
Marcos Aurelio Barranco – 05/12/2016