1. IronWord
  2. Commencer
  3. Utiliser avec des conteneurs Docker

Configuration d'IronWord dans des conteneurs Docker

Kye Stuart
Kye Stuart
Mis à jour:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronWord est entièrement pris en charge dans des conteneurs Docker pour les environnements Linux et Windows, ce qui le rend idéal pour le déploiement sur Azure, AWS ou tout autre. Hôte prêt pour le réseau.

Pourquoi utiliser Docker ?

Docker vous permet d'empaqueter et d'exécuter IronWord sous forme de conteneur léger et autonome. Cela garantit un comportement cohérent tout au long des phases de développement, de test et de production, ce qui est particulièrement précieux lors de la génération ou de la manipulation de documents Word par programmation.

IronWord prend en charge .NET 5-9, .NET Standard (2.x, 3.x) et .NET Framework 4.6.2+, qui fonctionnent tous de manière transparente dans Docker sous Linux et Windows.

Distributions Linux Docker recommandées

Pour un fonctionnement optimal d'IronWord, nous recommandons les distributions Linux 64 bits suivantes :

  • Ubuntu 22.04+ (Jammy)
  • Ubuntu 20.04 (Focal)
  • Debian 11+ (Bullseye)
  • CentOS7+

Utilisez les images Docker officielles de Microsoft avec le runtime et le SDK .NET pour simplifier la configuration et la gestion des dépendances

Package NuGet IronWord

IronWord s'ajoute facilement à tout projet .NET via son package NuGet. Il suffit d'exécuter la commande suivante dans la console du gestionnaire de packages NuGet, et la bibliothèque sera ajoutée automatiquement :

Install-Package IronWord

Exemples de Dockerfile Ubuntu

Ubuntu 22 bits + .NET 8

FROM mcr.microsoft.com/dotnet/runtime:8.0-jammy AS base
RÉPERTOIRE DE TRAVAIL /app

DEPUIS mcr.microsoft.com/dotnet/sdk:8.0-jammy AS build
RÉPERTOIRE DE TRAVAIL /src
COPIER ["Example/Example.csproj", "Example/"]
Exécutez dotnet restore "Example/Example.csproj"

COPIE . .
WORKDIR "/src/Example"
Exécuter dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
Exécuter dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
RÉPERTOIRE DE TRAVAIL /app
COPIER --from=publish /app/publish .
POINT D'ENTRÉE ["dotnet", "Example.dll"]

Ubuntu 20.04 + .NET 6 (LTS)

FROM mcr.microsoft.com/dotnet/runtime:6.0-focal AS base
RÉPERTOIRE DE TRAVAIL /app

DEPUIS mcr.microsoft.com/dotnet/sdk:6.0-focal AS build
RÉPERTOIRE DE TRAVAIL /src
COPIER ["Example/Example.csproj", "Example/"]
Exécutez dotnet restore "Example/Example.csproj"

COPIE . .
WORKDIR "/src/Example"
Exécuter dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
Exécuter dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
RÉPERTOIRE DE TRAVAIL /app
COPIER --from=publish /app/publish .
POINT D'ENTRÉE ["dotnet", "Example.dll"]

Exemple de Dockerfile Debian

Debian11 + .NET7

FROM mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim AS base
RÉPERTOIRE DE TRAVAIL /app

À PARTIR DE mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim AS build
RÉPERTOIRE DE TRAVAIL /src
COPIER ["Example/Example.csproj", "Example/"]
Exécutez dotnet restore "Example/Example.csproj"

COPIE . .
WORKDIR "/src/Example"
Exécuter dotnet build "Example.csproj" -c Release -o /app/build

FROM build AS publish
Exécuter dotnet publish "Example.csproj" -c Release -o /app/publish

FROM base AS final
RÉPERTOIRE DE TRAVAIL /app
COPIER --from=publish /app/publish .
POINT D'ENTRÉE ["dotnet", "Example.dll"]

CentOS 7

Utilisez des runtimes .NET basés sur CentOS comme mcr.microsoft.com/dotnet/runtime:6.0-centos7 pour la compatibilité avec IronWord.

# Étape de construction
DEPUIS mcr.microsoft.com/dotnet/sdk:6.0 AS build
RÉPERTOIRE DE TRAVAIL /app

COPIER ./Example/Example.csproj ./Example/
RUN dotnet restore "./Example/Example.csproj"

COPIER ./Exemple ./Exemple/
RÉPERTOIRE DE TRAVAIL /app/Exemple
Exécutez dotnet publish -c Release -o /out

# Phase d'exécution - CentOS 7
DEPUIS mcr.microsoft.com/dotnet/runtime:6.0-centos7 EN TANT QU'EXÉCUTION
RÉPERTOIRE DE TRAVAIL /app

Exécutez la commande : `yum install -y liberation-fonts && yum clean all`

COPIER --from=build /out ./

POINT D'ENTRÉE ["dotnet", "Example.dll"]

Notes et dépannage

  • IronWord prend entièrement en charge .NET5–9, .NET Standard (2.x, 3.x) et .NET Framework 4.6.2+.
  • Installez les polices si nécessaire (par exemple, fonts-liberation, ttf-mscorefonts-installer) sur les conteneurs Linux pour un rendu correct.

Questions Fréquemment Posées

Qu'est-ce qu'IronWord et pourquoi l'utiliser dans un conteneur Docker ?

IronWord est une bibliothèque pour travailler avec des documents Word dans des applications .NET. L'utiliser dans un conteneur Docker permet un comportement cohérent à travers les environnements de développement, de test et de production sous Linux et Windows.

Quelles distributions Linux sont recommandées pour exécuter IronWord dans Docker ?

IronWord fonctionne sans problème sur des distributions Linux 64 bits telles qu'Ubuntu 22.04+ (Jammy), Ubuntu 20.04 (Focal), Debian 11+ (Bullseye), et CentOS 7+.

Comment ajouter IronWord à un projet .NET en utilisant NuGet ?

IronWord peut être ajouté à un projet .NET en exécutant la commande d'installation dans la console du gestionnaire de packages NuGet, ce qui inclut automatiquement la bibliothèque dans votre projet.

Quel est l'avantage d'utiliser les images Docker officielles de Microsoft pour IronWord ?

L'utilisation des images Docker officielles de Microsoft avec le runtime et le SDK .NET simplifie l'installation et la gestion des dépendances, assurant une intégration transparente avec IronWord.

Quels sont quelques exemples de Dockerfiles pour configurer IronWord sur Ubuntu ?

La page fournit des exemples de Dockerfiles pour Ubuntu 22 avec .NET 8 et Ubuntu 20.04 avec .NET 6, détaillant les étapes de la configuration de l'image de base à l'exécution de l'application.

Comment puis-je configurer IronWord sur Debian en utilisant Docker ?

Un exemple de Dockerfile pour Debian 11 avec .NET 7 est fourni, qui comprend les étapes pour construire et déployer l'application IronWord dans un conteneur Docker.

Est-il nécessaire d'installer des polices supplémentaires pour IronWord sur les conteneurs Linux ?

Oui, l'installation de polices telles que fonts-liberation ou ttf-mscorefonts-installer peut être nécessaire sur les conteneurs Linux pour un rendu correct des documents lorsque l'on utilise IronWord.

IronWord prend-il en charge toutes les versions de .NET ?

IronWord prend en charge .NET 5-9, .NET Standard (2.x, 3.x), et .NET Framework 4.6.2+, ce qui le rend polyvalent pour différentes versions d'applications .NET.

Quelles sont les étapes pour déployer une application IronWord sur CentOS 7 ?

La page décrit un Dockerfile pour CentOS 7, qui inclut l'utilisation d'un runtime .NET 6, l'installation des polices nécessaires, et la configuration de l'environnement pour exécuter des applications IronWord.

Pourquoi choisir Docker pour déployer des applications IronWord ?

Docker garantit que les applications IronWord bénéficient d'un environnement léger et autonome, offrant des performances cohérentes à travers les différentes étapes du développement et du déploiement des applications.

Kye Stuart
Kye Stuart
  Discutez maintenant avec l'équipe d'ingénierie
Rédacteur technique

Kye Stuart fusionne la passion du codage et l'habileté rédactionnelle chez Iron Software. Éduqué au Yoobee College en déploiement de logiciels, ils transforment maintenant des concepts technologiques complexes en contenu éducatif clair. Kye valorise l'apprentissage tout au long de la vie et relève de nouveaux dé...

Lire la suite
Prêt à commencer?
Nuget Téléchargements 32,629 | Version : 2026.2 vient de sortir