Adicionando o IronPDF a um contêiner Docker existente
O IronPDF for .NET Standard agora oferece suporte completo ao Docker, incluindo o Azure Docker Containers para Linux e Windows.
Deseja implantar o IronPDF como um contêiner Docker separado? Saiba mais sobre o guia de tutoriais do IronPDFEngine .
Por que usar o Docker no Azure?
Além da excelente escalabilidade empresarial, os contêineres Docker no Azure desfrutam de mais permissões do que os aplicativos Web comuns. Isso permite a renderização de fontes SVG, pois o acesso do sistema aos gráficos GDI+ está habilitado.
Introdução ao IronPDF e Linux
Se você é iniciante no uso do Docker com .NET, recomendamos este excelente artigo sobre como configurar a depuração e a integração do Docker com projetos do Visual Studio .
Recomendamos também a leitura do nosso Guia de Configuração e Compatibilidade do IronPDF para Linux.
Distribuições Linux recomendadas para Docker
Recomendamos os sistemas operacionais Linux de 64 bits mais recentes listados abaixo para uma "configuração fácil" do IronPDF.
- Ubuntu 22
- Ubuntu 20
- Ubuntu 18
- Debian 11
- Debian 10
- CentOS 8
- Amazon AWS Linux 2 Leia o Guia de Configuração do AWS Lambda do IronPDF
Recomendamos o uso das imagens oficiais do Docker da Microsoft for .NET . Outras distribuições Linux são parcialmente suportadas, mas podem exigir configuração manual. Consulte nosso guia " Configuração manual do Linux ".
Instalação do IronPDF no Docker para Linux
Use pacotes NuGet otimizados para Linux.
Recomendamos o uso do pacote NuGet IronPdf.Linux em vez do pacote IronPdf padrão para economizar espaço em disco e evitar o download de arquivos ao iniciar sua instância do Docker. Não se preocupe, ainda funciona ao desenvolver no Windows ou macOS - apenas está otimizado para Linux.
Install-Package IronPdf.Linux
Outra solução é simplesmente adicionar o IronPdf.Native.Chrome.Linux ao pacote NuGet padrão do IronPdf .
Install-Package IronPdf.Native.Chrome.Linux
Evite a instalação automática de dependências
Muitos usuários relatam melhores resultados com Linux e Docker quando LinuxAndDockerDependenciesAutoConfig está definido como falso. Isso ocorre porque os pré-requisitos já estão instalados pelos gerenciadores de pacotes do tipo apt-get em seus arquivos Docker.
// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;// Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;' Disable automatic configuration of Linux and Docker dependencies
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = FalseDesativar aceleração por GPU
Os contêineres Docker do Linux geralmente não têm acesso a uma GPU. A aceleração por GPU está desativada por padrão. Se você habilitou o ChromeGpuModes.Enabled, recomendamos fortemente que o desabilite para implantações do Docker:
// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;// Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;' Disable GPU acceleration for Docker environments
IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.DisabledArquivos Docker do Ubuntu Linux
Ubuntu 22 com .NET 8
Ubuntu 22 com .NET 7
Ubuntu 20 com .NET 6
Ubuntu 20 com .NET 5
Ubuntu 20 com .NET 3.1 LTS
Ubuntu 18 com .NET 3.1 LTS
Arquivos Docker do Debian Linux
Debian 12 com .NET 8
Debian 11 com .NET 7
Debian 11 com .NET 6
Debian 11 com .NET 5
Debian 11 com .NET 3.1 LTS
Debian 10 com .NET 5
Debian 10 com .NET 3.1 LTS
Arquivos Docker do Alpine Linux
A execução do IronPDF no Alpine Linux não é suportada. Gostaríamos muito, mas não podemos. Sinceramente, gostamos da Alpine e esperamos que este projeto continue e cresça. Em 2023, o Alpine ainda utilizava bibliotecas de linguagem C "musl" desatualizadas, que ainda não permitiam aos desenvolvedores do Chromium oferecer suporte completo a este sistema operacional.
Utilizando Alpine Docker com IronPdfEngine no .NET 6
O IronPDF fornece uma imagem contêiner que inclui todas as funcionalidades do IronPDF. Isso permite que projetos em execução no Alpine acessem as funcionalidades do IronPD conectando-se ao contêiner IronPdfEngine.
Passo 1: Baixe e execute a imagem Docker do IronPDF Engine.
Execute os seguintes comandos no seu terminal para baixar e executar a imagem Docker do IronPDF Engine:
# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine# Pull the IronPDF Engine Docker Image
docker pull ironsoftwareofficial/ironpdfengine# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine# Run the IronPDF Engine Docker container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengineEtapa 2: Configurar o aplicativo Console
Crie um novo aplicativo de console direcionado ao .NET 6. Instale o pacote NuGet IronPdf.Slim usando o Gerenciador de Pacotes NuGet.
Arquivo Docker do Windows
Os contêineres Docker do Windows estão se tornando cada vez mais populares no Azure, pois oferecem níveis mais altos de desempenho e escalabilidade, além de concederem aos desenvolvedores mais permissões para configurar instâncias.
O IronPDF, na verdade, apresentará uma renderização de texto mais atraente dentro de um contêiner Docker (Windows ou Linux) no Azure devido aos níveis mais altos de acesso à biblioteca gráfica e à placa gráfica virtual.
O artigo " Ferramentas de contêiner do Visual Studio para Docker " é um excelente guia para iniciantes.
Este é um exemplo de Dockerfile para contêiner Windows com .NET Core 3.1.
Windows Server 2019 .NET 6.0
Os contêineres Windows pré-configurados incluem todas as dependências necessárias para executar o IronPDF.
Visite o repositório do Docker para explorar imagens pré-configuradas adicionais para executar o IronPDF.
Perguntas frequentes
Como posso integrar uma biblioteca .NET para geração de PDFs em um contêiner Docker?
Você pode integrar o IronPDF, uma biblioteca .NET para geração de PDFs, em um contêiner Docker usando as imagens Docker oficiais da Microsoft e o pacote NuGet IronPDF.Linux para Linux, ou contêineres Docker pré-configurados para ambientes Windows.
Quais são os benefícios de usar contêineres Docker para manipulação de PDFs no Azure?
Utilizar contêineres Docker para manipulação de PDFs no Azure proporciona maior escalabilidade empresarial e mais permissões do que os WebApps tradicionais. Essa configuração é ideal para habilitar recursos avançados, como a renderização de fontes SVG por meio do acesso gráfico GDI+.
Quais distribuições Linux são mais adequadas para executar uma biblioteca .NET PDF em um ambiente Docker?
As distribuições Linux mais adequadas para executar o IronPDF no Docker incluem Ubuntu 18/20/22, Debian 10/11, CentOS 8 e Amazon AWS Linux 2, pois oferecem configuração simples e compatibilidade.
Como posso otimizar o desempenho de uma biblioteca PDF .NET em contêineres Docker Linux?
Para otimizar o desempenho, use o pacote IronPdf.Linux, desative a instalação automática de dependências e desative a aceleração por GPU configurando o IronPdf.Installation.ChromeGpuMode para IronPdf.Engines.Chrome.ChromeGpuModes.Disabled .
O IronPDF pode ser executado no Alpine Linux dentro de um contêiner Docker?
O IronPDF não oferece suporte nativo ao Alpine Linux devido à incompatibilidade com as bibliotecas 'musl'. Para usar o IronPDF no Alpine Linux, considere executá-lo por meio de um contêiner Docker do IronPDFEngine.
Qual a finalidade de usar contêineres Docker pré-configurados para uma biblioteca .NET?
Os contêineres Docker pré-configurados fornecem todas as dependências necessárias para executar o IronPDF de forma eficiente, garantindo alto desempenho e escalabilidade, o que é particularmente benéfico ao implantar em plataformas como o Azure.
Como posso configurar uma biblioteca PDF .NET para aplicações .NET no Docker?
Você pode configurar o IronPDF para aplicações .NET no Docker, integrando-o com contêineres Docker Linux e Windows, possibilitando funcionalidades robustas de PDF em uma arquitetura de microsserviços.
Quais são os passos de configuração recomendados para implantar uma biblioteca .NET no Docker?
As etapas recomendadas incluem o uso de um pacote otimizado para Linux, como o IronPDF.Linux, a desativação da instalação automática de dependências e a pré-inicialização do IronPDF para evitar atrasos durante a execução em ambientes Docker.
Como faço para configurar uma biblioteca PDF .NET em um contêiner Docker do Windows Server 2019 executando o .NET 6.0?
Configure uma biblioteca .NET PDF em um contêiner Docker do Windows Server 2019 usando um Dockerfile pré-configurado que inclui todas as dependências e configurações necessárias para executar o IronPDF com .NET 6.0.
Por que desativar a aceleração por GPU em uma configuração Docker para uma biblioteca .NET?
Desativar a aceleração por GPU para o IronPDF no Docker pode levar a uma implantação e desempenho mais suaves, evitando possíveis problemas gráficos em ambientes com recursos de GPU limitados.
Ainda está rolando a tela?
Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.
Comece GRATUITAMENTE
Comece GRATUITAMENTE
Agende uma demonstração ao vivo gratuita
Não é necessário cartão de crédito nem criação de conta.
