1. IronPDF
2. 操作指南
3. 拉取并运行IronPdfEngine

如何拉动和运行铁PdfEngine

从Dockerhub、AWS ECR Public Gallery或AWS Marketplace获取预构建的容器映像，并在Docker环境中执行该映像，即可拉取并运行IronPdfEngine映像。

拉取：这是指从指定的注册表中检索IronPdfEngine容器映像。(Dockerhub、AWS ECR 公共图库或 AWS Marketplace)到您的本地系统。 通常使用 docker pull 命令来实现这一目的。

运行：一旦镜像被拉取，您就使用 docker run 命令来启动基于该镜像的容器实例。 这将在Docker容器中启动IronPdfEngine应用程序，使您能够利用其功能。

开始使用IronPDF

立即在您的项目中开始使用IronPDF，并享受免费试用。

第一步：

免费开始

在 Dockerhub 中获取 IronPdfEngine

先决条件

• 必须安装 Docker。

设置

1. 访问 https://hub.docker.com/r/ironsoftwareofficial/ironpdfengine

2. 拉取 ironsoftwareofficial/ironpdfengine 镜像

  docker pull ironsoftwareofficial/ironpdfengine

或调出特定版本(推荐)

  docker pull ironsoftwareofficial/ironpdfengine:2023.12.6

3. 运行 ironsoftwareofficial/ironpdfengine 容器。

   此命令将创建一个容器并在后台运行，端口为33350。

  docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

浏览" "部分，了解如何配置 IronPdf 客户端以使用 IronPdfEngine。更新代码以使用 IronPdfEngine."

IronPdfEngine 在 Docker compose 中

关键是要建立一个Docker网络，使IronPdfEngine和您的应用程序能够相互看到。 将 'depends_on' 设置为确保 IronPdfEngine 在您的应用程序启动前已经运行。

设置

1. 首先创建一个 docker-compose.yml 文件。使用以下模板设置您的 Docker Compose 文件：

version: "3.6"
services:
  myironpdfengine:
    container_name: ironpdfengine
    image: ironsoftwareofficial/ironpdfengine:latest
    ports:
      - "33350:33350"
    networks:
      - ironpdf-network
  myconsoleapp:
    container_name: myconsoleapp
    build:
      # enter YOUR project directory path here
      context: ./MyConsoleApp/
      # enter YOUR dockerfile name here, relative to project directory
      dockerfile: Dockerfile
    networks:
      - ironpdf-network
    depends_on:
      myironpdfengine:
        condition: service_started
networks:
  ironpdf-network: 
    driver: "bridge"

2. 在您的应用程序中设置IronPdfEngine的地址(我的控制台应用程序)到 "myironpdfengine:33350"

3. 运行 docker compose

docker compose up --detach --force-recreate --remove-orphans --timestamps

在 AWS ECR 公共图库中获取 IronPdfEngine

先决条件

• 必须安装 Docker。

设置

1. 前往 https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

2. 拉取 v1m9w8y1/ironpdfengine 镜像

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine

或调出特定版本(推荐)

docker pull https://gallery.ecr.aws/v1m9w8y1/ironpdfengine:2023.12.6

3. 运行 ironpdfengine 容器。

   此命令将创建一个容器，并在后台运行，端口号为33350。

docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

浏览" "部分，了解如何配置 IronPdf 客户端以使用 IronPdfEngine。更新代码以使用 IronPdfEngine."

在 AWS Marketplace 获取 IronPdfEngine

先决条件

• 必须安装 Docker。
• AWS CLI 必须安装并登录。

设置

1. 去AWS 市场上的 IronPdfEngine. 点击“继续订阅”。

2. 接受条款。

   

3. 继续前往 Confiuguration。

   
4. 拉取ironpdfengine镜像。 此步骤将向您展示一个命令，用来拉取ironpdfengine镜像。
   

   例如

aws ecr get-login-password \
    --region us-east-1 
 docker login \
    --username AWS \
    --password-stdin 000000000000.dkr.ecr.us-east-1.amazonaws.com
CONTAINER_IMAGES="000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15"    
for i in $(echo $CONTAINER_IMAGES 
 sed "s/,/ /g"); do docker pull $i; done

6. 运行 ironpdfengine 容器。 此命令将创建一个容器，并在后台运行，端口号为33350。

docker run -d -p 33350:33350 000000000000.dkr.ecr.us-east-1.amazonaws.com/iron-software/ironpdfengine:2024.1.15

从 Azure Marketplace 获取 IronPdfEngine

设置

1. 去Azure 市场上的 IronPDF Docker 容器. 点击“立即获取”和“继续”。

2. 完成“基础信息”、“集群详情”和“应用详情”以创建 Kubernetes 服务。

3. 部署完成后，在左侧侧边栏中，转到 Kubernetes 资源 -> 运行命令。 运行以下命令

kubectl get services

使用 EXTERNAL-IP 和 PORT 信息(S)您可以对 IronPDFEngine 连接进行相应配置。

:path=/static-assets/pdf/content-code-examples/how-to/pull-run-ironpdfengine-azure-marketplace.cs

using IronPdf;
using IronPdf.GrpcLayer;

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";

IronPdfConnectionConfiguration configuration = new IronPdfConnectionConfiguration();
configuration.ConnectionType = IronPdfConnectionType.RemoteServer;
configuration.Host = "http://48.216.143.233";
configuration.Port = 80;
IronPdf.Installation.ConnectToIronPdfHost(configuration);

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");
pdf.SaveAs("output.pdf");

Imports IronPdf
Imports IronPdf.GrpcLayer

IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01"

Dim configuration As New IronPdfConnectionConfiguration()
configuration.ConnectionType = IronPdfConnectionType.RemoteServer
configuration.Host = "http://48.216.143.233"
configuration.Port = 80
IronPdf.Installation.ConnectToIronPdfHost(configuration)

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")
pdf.SaveAs("output.pdf")

更新代码以使用 IronPdfEngine

这涉及修改代码以确保 IronPdf 指向 IronPdfEngine 暴露的正确端口。这个操作对于每种编程语言略有不同。 请参考以下文章以获取具体使用指南：

• IronPDF for .NET
• IronPDF for Java
• IronPDF for Node.js

• IronPDF for Python

  此外，您可以将此容器部署在任何地方。 不要忘记暴露端口33350，并使其对IronPdf客户端可访问。 要了解更多关于IronPdfEngine及其限制的信息，请访问“什么是 IronPdfEngine？"一文。