Início
» ESCRITÓRIO MS
»
Como adicionar fontes personalizadas ao Collabora Online CODE Docker
Como adicionar fontes personalizadas ao Collabora Online CODE Docker
Para disponibilizar uma fonte personalizada no Collabora Online CODE (Collabora Online Development Edition) em execução no Docker, os arquivos de fonte devem estar disponíveis para o próprio contêiner do Collabora. Instalá-los apenas no host do Docker ou em um contêiner Nextcloud separado não os torna disponíveis para o servidor do escritório. Para uma única implantação do Compose, uma montagem de diretório somente leitura geralmente é a opção mais simples; uma imagem personalizada é mais fácil de reproduzir em uma frota gerenciada, enquanto a configuração remota de fontes pode centralizar a distribuição, desde que você consiga operá-la com segurança.
Os diretórios exatos de fontes podem variar de acordo com a imagem e a versão. A implementação atual do Helm upstream da Collabora monta fontes personalizadas em `/usr/local/fonts` /usr/share/fonts/custome `/usr /opt/cool/systemplate/usr/share/fonts/custom/local/fonts`. Essa é uma referência útil para esses dois locais, mas não garante que todos os Dockers independentes estarão presentes. Verifique os caminhos na imagem que você está executando antes de implantar o exemplo abaixo.
Qual método de instalação de fontes é o mais adequado para a sua implementação?
Escolha com base em quantas instâncias do CODE você mantém, como você implementa as atualizações e se você pode operar um servidor de fontes seguro.
Método
Melhor ajuste
Troca
montagem de ligação somente leitura
Um host Compose ou uma pequena instalação
É fácil atualizar sem precisar recompilar, mas cada host precisa dos mesmos arquivos e caminhos de contêiner compatíveis.
Imagem Docker personalizada
CI/CD, implantações repetíveis ou vários hosts gerenciados
As fontes são versionadas juntamente com a imagem, mas alterar uma fonte significa recompilar e reimplantar o repositório.
Configuração remota de fontes
Existem diversos casos que necessitam de um catálogo gerenciado centralmente.
A entrega centralizada adiciona uma dependência de serviço e de rede; o uso em produção exige HTTPS e medidas de segurança operacionais reforçadas.
Se você instalar o Collabora com seu gráfico Helm, primeiro verifique as deployment.customFontsconfigurações do gráfico: o gráfico original já oferece uma opção de montagem de fonte personalizada. Para uma configuração independente do Docker Compose, prossiga com uma montagem de diretórios (bind mount) se os caminhos das suas imagens coincidirem.
Antes de alterar o Docker, o que você deve verificar?
Formato da fonte: Use arquivos de fonte compatíveis com sua configuração do Collabora. A documentação oficial do projeto Collabora fontserver abrange arquivos TrueType ( .ttf) e OpenType ( )..otf
Licença: Confirme se a licença da fonte permite o uso no servidor e a distribuição para seus usuários. Não copie fontes de um sistema operacional de desktop, a menos que a licença permita esse uso.
Sobrenome: O nome exibido no menu de fontes vem dos metadados internos da fonte, que podem ser diferentes do nome do arquivo. Faça o teste usando o sobrenome, não apenas o nome do arquivo.
Todas as instâncias: Se um proxy encaminhar usuários para vários contêineres do Collabora, instale os mesmos arquivos de fonte em todas as instâncias. Caso contrário, o mesmo documento poderá ser renderizado de forma diferente dependendo do servidor que o abrir.
Caminhos exatos das imagens: Verifique os diretórios e a configuração de inicialização da imagem em execução. Não reutilize indiscriminadamente caminhos antigos, como /opt/loolcaminhos de um pacote não relacionado.
Crie um diretório principal ao ./fontslado do seu arquivo Compose e coloque nele os arquivos permitidos .ttf. .otfLimite esse diretório às fontes que você pretende disponibilizar por meio do Collabora.
A pasta de fontes do lado do host e o arquivo Compose antes de adicionar o diretório ao serviço Collabora.
Como adicionar fontes com o Docker Compose?
Adicione as duas entradas de volume somente leitura à volumeslista do serviço Collabora existente. Mantenha a imagem, as portas, as variáveis de ambiente e outras configurações atuais do serviço; este é um arquivo Compose adicional, não um arquivo de substituição.
O diretório de origem à esquerda está no host Docker. Os caminhos à direita estão dentro do contêiner. O :rosufixo torna os arquivos somente leitura para o contêiner. Esses caminhos de destino seguem o modelo Helm upstream atual da Collabora; para o CODE Docker independente, verifique primeiro a sua tag específica. Se algum dos locais estiver ausente ou se a sua versão usar diretórios diferentes, use os caminhos suportados por essa imagem em vez de forçar este exemplo.
O exemplo de mapeamento de volume envia o mesmo diretório de fontes do host para ambos os locais de fontes do Collabora upstream.
Aplique a alteração de composição durante um período de baixa atividade, pois recriar o serviço Collabora pode interromper as sessões de edição ativas. Se o seu serviço se chamar collabora, execute:
docker compose up -d collabora
Use o nome real do seu serviço Compose, caso seja diferente. Evite reiniciar toda a pilha, a menos que outros serviços também precisem de uma alteração de configuração.
Como você pode confirmar se o contêiner consegue ver os arquivos?
Primeiro, verifique se os diretórios montados contêm os arquivos de fonte. Substitua `< collaboranome_do_contêiner>` pelo nome do contêiner usado em sua configuração:
docker exec collabora ls /usr/share/fonts/custom
docker exec collabora ls /opt/cool/systemplate/usr/share/fonts/custom
Exemplo de comando de verificação: liste os dois caminhos montados no contêiner Collabora em execução.
A visualização dos arquivos confirma as montagens do Docker, mas não comprova que o editor carregou a fonte. Se a imagem incluir as ferramentas Fontconfig, você pode inspecionar os nomes de família detectados com fc-list, por exemplo:
docker exec collabora fc-list : family file
Filtre a saída para a família esperada, usando uma ferramenta disponível no seu contêiner. Se fc-listnão estiver instalada, não adicione pacotes a um contêiner em execução como solução permanente; verifique a configuração de fontes da imagem ou use uma imagem personalizada reproduzível. Se os arquivos estiverem visíveis, mas não forem detectados, verifique as permissões, o formato do arquivo, os metadados internos da família e os dois caminhos de montagem. Em seguida, consulte os logs da imagem e versão exatas que você implantou.
Como testar a fonte no Collabora Online?
Abra ou crie um documento de teste através da integração normal que inicia o seu editor do Collabora.
Abra o menu de famílias de fontes e procure o nome interno da família da fonte.
Selecione-o, digite um pequeno exemplo, salve, feche e abra novamente o documento.
Consulte o mesmo documento a partir de outro usuário ou navegador se sua implantação tiver várias instâncias do Collabora.
O exemplo abaixo ilustra o tipo de verificação esperado: uma família de fontes aparece em um menu do editor. Não se trata de uma captura de tela de uma implementação CODE em produção, e sua barra de ferramentas pode variar de acordo com a versão ou integração.
Um exemplo da etapa de verificação: confirme se a família de fontes desejada aparece no menu de fontes do editor.
Se a família de fontes aparecer, mas o texto for renderizado em uma fonte substituta, verifique se o estilo e a espessura selecionados existem (por exemplo, regular e negrito) e confirme se a fonte está presente no caminho do diretório do sistema, bem como no diretório geral de fontes. Uma entrada de menu por si só não comprova que todos os estilos ou todos os servidores possuem a fonte.
Quando vale a pena usar um serviço de imagens personalizadas ou fontes remotas?
Crie uma imagem personalizada para garantir a repetibilidade.
Um Dockerfile que copia arquivos de fontes aprovados para os caminhos usados pela sua imagem CODE escolhida facilita a reprodução das implantações: o resumo da imagem identifica tanto a versão do servidor quanto seu conjunto de fontes. O custo é uma nova compilação, verificação e implantação sempre que você atualizar uma fonte ou a imagem base. Verifique novamente os diretórios de destino após atualizações da imagem base e evite tratar uma instrução de cópia de fonte como universal para todas as versões do CODE.
Use a configuração remota de fontes para um catálogo compartilhado.
O projeto fontserver da Collabora descreve a configuração remota de fontes e um catálogo JSON. Seus mantenedores classificam esse repositório como destinado a desenvolvimento e testes, portanto, não considere o servidor de exemplo como um serviço pronto para produção. Para produção, utilize um endpoint HTTPS devidamente mantido, restrinja e valide as fontes que ele serve e leve em conta a disponibilidade da rede e o comportamento de atualização do cache. Essa escolha pode reduzir o gerenciamento de arquivos por host, mas adiciona um serviço cuja falha ou desvio de configuração pode afetar a disponibilidade das fontes.
Para um contêiner CODE gerenciado com Docker Compose, comece com uma montagem de ligação somente leitura: é simples reverter e não requer uma compilação personalizada. Para uma frota mantida por meio de CI/CD, prefira uma imagem personalizada quando desejar que cada implantação contenha um conjunto de fontes explícito e revisável. Considere a configuração remota de fontes somente quando a distribuição centralizada for um benefício operacional significativo e você puder fornecer um serviço HTTPS seguro e confiável. Em todos os casos, verifique os caminhos e teste a fonte em um documento real após a implantação; a lista de fontes do host, por si só, não confirma se o Collabora a carregou.