Docker 컨테이너에 IronWord 설정하기

Docker를 사용하는 이유는 무엇일까요?

Docker를 사용하면 IronWord 가볍고 독립적인 컨테이너로 패키징하고 실행할 수 있습니다. 이를 통해 개발, 테스트 및 프로덕션 환경 전반에 걸쳐 일관된 동작을 보장할 수 있으며, 특히 Word 문서를 프로그램 방식으로 생성하거나 조작할 때 매우 유용합니다.

IronWord .NET 5-9, .NET Standard (2.x, 3.x) 및 .NET Framework 4.6.2 이상을 지원하며, 이러한 모든 버전은 Linux 및 Windows의 Docker 환경에서 원활하게 작동합니다.

권장 Linux Docker 배포판

IronWord 원활하게 사용하려면 다음 64비트 Linux 배포판을 권장합니다.

• 우분투 22.04+ (잼미)
• 우분투 20.04 (포컬)
• 데비안 11+ (불스아이)
• CentOS7+

Microsoft의 공식 Docker 이미지 와 .NET 런타임 및 SDK를 사용하여 설정 및 종속성 관리를 간소화하세요.

IronWord NuGet 패키지

IronWord NuGet 패키지를 통해 모든 .NET 프로젝트에 쉽게 추가할 수 있습니다. NuGet 패키지 관리자 콘솔에서 다음 명령을 실행하기만 하면 라이브러리가 자동으로 추가됩니다.

Install-Package IronWord

Ubuntu Dockerfile 예제

mcr.microsoft.com/dotnet/runtime:8.0-jammy AS base에서 가져옴
WORKDIR /앱

mcr.microsoft.com/dotnet/sdk:8.0-jammy AS 빌드에서
WORKDIR /src
["Example/Example.csproj", "Example/"]을 복사하세요.
`dotnet restore "Example/Example.csproj"` 명령을 실행하세요.

복사 . .
WORKDIR "/src/Example"
`dotnet build "Example.csproj" -c Release -o /app/build` 명령을 실행하세요.

빌드부터 게시까지
`dotnet publish "Example.csproj" -c Release -o /app/publish` 명령을 실행하세요.

베이스 AS 최종
WORKDIR /앱
COPY --from=publish /app/publish .
진입점 ["dotnet", "Example.dll"]

mcr.microsoft.com/dotnet/runtime:6.0-focal AS base에서
WORKDIR /앱

mcr.microsoft.com/dotnet/sdk:6.0-focal AS 빌드에서
WORKDIR /src
["Example/Example.csproj", "Example/"]을 복사하세요.
`dotnet restore "Example/Example.csproj"` 명령을 실행하세요.

복사 . .
WORKDIR "/src/Example"
`dotnet build "Example.csproj" -c Release -o /app/build` 명령을 실행하세요.

빌드부터 게시까지
`dotnet publish "Example.csproj" -c Release -o /app/publish` 명령을 실행하세요.

베이스 AS 최종
WORKDIR /앱
COPY --from=publish /app/publish .
진입점 ["dotnet", "Example.dll"]

데비안 Docker파일 예제

mcr.microsoft.com/dotnet/aspnet:7.0-bullseye-slim AS base에서
WORKDIR /앱

mcr.microsoft.com/dotnet/sdk:7.0-bullseye-slim AS 빌드에서
WORKDIR /src
["Example/Example.csproj", "Example/"]을 복사하세요.
`dotnet restore "Example/Example.csproj"` 명령을 실행하세요.

복사 . .
WORKDIR "/src/Example"
`dotnet build "Example.csproj" -c Release -o /app/build` 명령을 실행하세요.

빌드부터 게시까지
`dotnet publish "Example.csproj" -c Release -o /app/publish` 명령을 실행하세요.

베이스 AS 최종
WORKDIR /앱
COPY --from=publish /app/publish .
진입점 ["dotnet", "Example.dll"]

CentOS 7

IronWord 호환성을 위해 mcr.microsoft.com/dotnet/runtime:6.0-centos7과 같은 CentOS 기반 .NET 런타임을 사용하십시오.

# 빌드 단계
mcr.microsoft.com/dotnet/sdk:6.0 AS 빌드에서
WORKDIR /앱

./Example/Example.csproj ./Example/ 파일을 복사하세요.
RUN dotnet restore "./Example/Example.csproj"

복사 ./예시 ./예시/
WORKDIR /앱/Example
RUN dotnet publish -c Release -o /out

# 런타임 단계 - CentOS 7
mcr.microsoft.com/dotnet/runtime:6.0-centos7에서 런타임으로
WORKDIR /앱

yum install -y liberation-fonts && yum clean all 명령어를 실행하세요.

COPY --from=build /out ./

진입점 ["dotnet", "Example.dll"]

참고 사항 및 문제 해결

IronWord .NET 5~9, .NET Standard (2.x, 3.x) 및 .NET Framework 4.6.2 이상을 완벽하게 지원합니다.

• 필요한 경우 Linux 컨테이너에 글꼴을 설치하십시오(예: fonts-liberation, ttf-mscorefonts-installer). 그래야 제대로 렌더링됩니다.