1. IronPDF
2. 操作指南
3. 拉取並運行 IronPdfEngine

如何拉取和運行 IronPdfEngine

拉取和運行 IronPdfEngine 映像涉及從 Dockerhub、AWS ECR Public Gallery 或 AWS Marketplace 獲取預構建的容器映像，然後在 Docker 環境中執行它。

拉取：這是指從指定的註冊表中檢索 IronPdfEngine 容器映像。 (Dockerhub、AWS ECR Public Gallery 或 AWS Marketplace) 到您的本地系統。docker pull 命令通常用於此目的。

運行：一旦拉取了映像，您可以使用 docker run 命令基於該映像啟動容器實例。這將在 Docker 容器內啟動 IronPdfEngine 應用程序，使您能夠利用其功能。

安裝與 NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

或

下載 DLL

下載DLL

手動安裝到您的項目中

安裝與 NuGet

Install-Package IronPdf

nuget.org/packages/IronPdf/

或

下載 DLL

下載DLL

手動安裝到您的項目中

立即開始在您的專案中使用IronPDF，並享受免費試用。

第一步：

免費開始

使用 Nuget 安裝

查看 IronPDF 上 Nuget 快速安裝和部署。已被下載超過800萬次，它正用C#改變PDF。

nuget.org/packages/IronPdf/

Install-Package IronPdf

下載DLL

請考慮安裝 IronPDF DLL 直接下載並手動安裝到您的專案或GAC表單： IronPdf.zip

手動安裝到您的項目中

下載DLL

在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. 在您的應用程式中設定 IronPDF 引擎的地址 (myconsoleapp) 到 "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. 前往 IronPdfEngine 在 AWS 市場. 點擊“繼續訂閱”。

2. 接受條款。

4. 繼續配置。

5. 拉取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 市場獲取 IronPdfEngine

設置

1. 前往 IronPDF Docker 容器在 Azure Marketplace1. 點擊「立即獲取」和「繼續」。

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 是什麼？" 文章。