移行ガイド

C#でGotenbergからIronPDFに移行する方法

公開日:2026年1月25日

GotenbergからIronPDFへの移行は、あなたの.NET PDFワークフローをHTTP API呼び出しによるDockerベースのマイクロサービス・アーキテクチャからプロセス内のネイティブC#ライブラリに変換します。このガイドでは、.NETのプロフェッショナルな開発者向けに、インフラストラクチャのオーバーヘッド、ネットワーク遅延、コンテナ管理の複雑さを解消する、包括的でステップバイステップの移行パスを提供します。

なぜGotenbergからIronPDFに移行するのか

ゴテンベルク・アーキテクチャ問題

Gotenbergは、PDF生成のためのDockerベースのマイクロサービスアーキテクチャです。強力で柔軟な反面、C#アプリケーションには大きな複雑さをもたらします：

1.インフラストラクチャのオーバーヘッド: Docker、コンテナオーケストレーション (Kubernetes/Docker Compose)、サービス検出、負荷分散が必要です。デプロイメントが複雑になるたびに

2.ネットワークレイテンシ： PDF操作ごとに別のサービスへのHTTP呼び出しが必要となり、リクエストごとに10～100ミリ秒以上の遅延が発生します。このレイテンシは、大量のデータを扱うシナリオでは急速に増大します。

3.コールドスタートの問題:コンテナーの起動により、最初のリクエストに 2 ～ 5 秒かかる場合があります。ポッドの再起動、スケールアップのイベント、デプロイのたびにコールドスタートが発生します。

4.運用の複雑さ:コンテナの健全性、スケーリング、ログ記録、監視をメインアプリケーションとは別の問題として管理する必要があります。

5.マルチパートフォームデータ:すべてのリクエストで、multipart/form-data ペイロードを構築する必要があります。これは冗長で、エラーが発生しやすく、保守が面倒です。

6.障害ポイント:ネットワークタイムアウト、サービスの利用不可、コンテナのクラッシュはすべて、処理する責任があなたにあります。

7.バージョン管理:Gotenbergイメージはアプリケーションとは別に更新されます。 APIの変更は、予期せず統合を壊す可能性があります。

GotenbergとIronPDFの比較

アスペクト	Gotenberg	IronPDF
デプロイメント	Dockerコンテナ＋オーケストレーション	単一のNuGetパッケージ
アーキテクチャ	マイクロサービス（REST API）	インプロセスライブラリ
リクエストあたりの待ち時間	10-100ms以上（ネットワーク・ラウンドトリップ）	<1msのオーバーヘッド
コールドスタート	2～5秒（コンテナinit）	1～2秒（最初のレンダリングのみ）
インフラ	Docker、Kubernetes、ロードバランサー	不要
障害モード	ネットワーク、コンテナ、サービス障害	.NET 標準の例外
APIスタイル	REST multipart/form-data	C#ネイティブメソッドコール
スケーリング	水平方向（コンテナを増やす）	垂直方向（進行中）
デバッグ	分散トレースが必要	標準デバッガ
バージョン管理	コンテナ画像タグ	NuGetパッケージのバージョン

2025年と2026年まで.NET 10とC# 14の導入を計画しているチームにとって、IronPDFは最新の.NETパターンとネイティブに統合する、インフラ依存ゼロの将来性のある基盤を提供します。

マイグレーションの複雑さの評価

機能別の見積もり作業

フィーチャー	移行の複雑さ	ノート
HTMLからPDFへ	低レベル	メソッドの直接置換
URLからPDFへ	低レベル	メソッドの直接置換
カスタム用紙サイズ	低レベル	プロパティベースの設定
マージン	低レベル	単位変換（インチ → mm）
PDFマージ	低レベル	静的メソッド呼び出し
ヘッダー/フッター	中規模	さまざまなプレースホルダ構文
待ち時間	低レベル	文字列からミリ秒へ
PDF/A変換	低レベル	パラメータの代わりにメソッド呼び出し

パラダイムシフト

このGotenberg移行における基本的な変化は、マルチパートフォームデータを使用した HTTP API 呼び出しからネイティブ C# メソッド呼び出しへの変更です。

Gotenberg：  Docker コンテナへの HTTP POST multipart/form-data
IronPDF：    C#オブジェクトの直接メソッド呼び出し

始める前に

前提条件

.NETバージョン: IronPDFは.NET Framework 4.6.2以降および.NET Core 3.1以降 / .NET 5/6/7/8/9以降をサポートしています。 2.ライセンスキー: ironpdf.comからIronPDFライセンスキーを取得します。 3.インフラストラクチャの削除を計画する:移行後の廃止に向けてGotenbergコンテナを文書化する

すべてのGotenbergの使用法を特定する

# Find direct HTTP calls to Gotenberg
grep -r "gotenberg\|/forms/chromium\|/forms/libreoffice\|/forms/pdfengines" --include="*.cs" .

# Find GotenbergSharpApiClient usage
grep -r "GotenbergSharpClient\|Gotenberg.Sharp\|ChromiumRequest" --include="*.cs" .

# Find Docker/KubernetesGotenbergconfiguration
grep -r "gotenberg/gotenberg\|gotenberg:" --include="*.yml" --include="*.yaml" .

# Find direct HTTP calls to Gotenberg
grep -r "gotenberg\|/forms/chromium\|/forms/libreoffice\|/forms/pdfengines" --include="*.cs" .

# Find GotenbergSharpApiClient usage
grep -r "GotenbergSharpClient\|Gotenberg.Sharp\|ChromiumRequest" --include="*.cs" .

# Find Docker/KubernetesGotenbergconfiguration
grep -r "gotenberg/gotenberg\|gotenberg:" --include="*.yml" --include="*.yaml" .

SHELL

NuGetパッケージの変更

# RemoveGotenbergclient (if using)
dotnet remove package Gotenberg.Sharp.API.Client

# Install IronPDF
dotnet add package IronPdf

# RemoveGotenbergclient (if using)
dotnet remove package Gotenberg.Sharp.API.Client

# Install IronPDF
dotnet add package IronPdf

SHELL

クイックスタートマイグレーション

ステップ 1: ライセンス構成の更新

ビフォア(Gotenberg):。

Gotenbergはライセンス不要ですが、コンテナURLのあるDockerインフラストラクチャが必要です。

private readonly string _gotenbergUrl = "http://localhost:3000";

private readonly string _gotenbergUrl = "http://localhost:3000";

$vbLabelText $csharpLabel

翻訳後（IronPDF）：。

// Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

// Set once at application startup
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

$vbLabelText $csharpLabel

ステップ 2: 名前空間インポートを更新する

// Before (Gotenberg)
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;

// Before (Gotenberg)
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

// After (IronPDF)
using IronPdf;
using IronPdf.Rendering;

$vbLabelText $csharpLabel

完全な API リファレンス

GotenbergエンドポイントからIronPDFへのマッピング

御殿場ルート	IronPDF 同等物	ノート
`POST /forms/chromium/convert/html`。	`ChromePdfRenderer.RenderHtmlAsPdf()`のようになります。	HTML文字列をPDFに。
`POST /forms/chromium/convert/url`	`ChromePdfRenderer.RenderUrlAsPdf()`のようにします。	URLからPDFへ
`POST /forms/pdfengines/merge`	`PdfDocument.Merge()`を使用してください。	複数のPDFをマージする。
`POST /forms/pdfengines/convert`。	`pdf.SaveAs()`を設定します。	PDF/A変換
`GET /health`	該当なし	外部サービス不要

フォームパラメータと RenderingOptions のマッピング

Gotenberg パラメータ	IronPDF プロパティ	変換に関する注意事項
`paperWidth</code> (インチ)\|<code>RenderingOptions.PaperSize`	列挙型またはカスタムサイズを使用
`paperHeight</code> (インチ)\|<code>RenderingOptions.PaperSize`	列挙型またはカスタムサイズを使用
`マージントップ` (インチ)	`RenderingOptions.MarginTop`。	mmは25.4倍
`マージンボトム` (インチ)	`RenderingOptions.MarginBottom`。	mmは25.4倍
`printBackground`	`RenderingOptions.PrintHtmlBackgrounds`を使用してください。	ブーリアン
`風景`	`RenderingOptions.PaperOrientation`	`ランドスケープ`列挙
`waitDelay`	`RenderingOptions.RenderDelay`となります。	ミリ秒への変換

コード移行の例

例1: 基本的なHTMLからPDFへ

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergExample
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Hello from Gotenberg</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("output.pdf", pdfBytes);
        Console.WriteLine("PDF generated successfully");
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergExample
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Hello from Gotenberg</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("output.pdf", pdfBytes);
        Console.WriteLine("PDF generated successfully");
    }
}

$vbLabelText $csharpLabel

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var html = "<html><body><h1>Hello from IronPDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully");
    }
}

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfExample
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var html = "<html><body><h1>Hello from IronPDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
        Console.WriteLine("PDF generated successfully");
    }
}

$vbLabelText $csharpLabel

この違いは大きい：Gotenbergでは、HttpClientの構築、MultipartFormDataContentの構築、実行中のDockerコンテナへの非同期HTTP POSTの作成、バイト配列レスポンスの処理が必要です。 IronPDFはこれをChromePdfRendererメソッド呼び出しで3行に減らしました。ネットワークオーバーヘッドもコンテナ依存も非同期の複雑さもありません。その他のレンダリングオプションについては、HTML to PDF documentationを参照してください。

例2: URLからPDFへの変換

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergUrlToPdf
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/url";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        content.Add(new StringContent("https://example.com"), "url");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("webpage.pdf", pdfBytes);
        Console.WriteLine("PDF from URL generated successfully");
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergUrlToPdf
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/url";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        content.Add(new StringContent("https://example.com"), "url");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("webpage.pdf", pdfBytes);
        Console.WriteLine("PDF from URL generated successfully");
    }
}

$vbLabelText $csharpLabel

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfUrlToPdf
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");

        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL generated successfully");
    }
}

// NuGet: Install-Package IronPdf
using System;
using IronPdf;

class IronPdfUrlToPdf
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://example.com");

        pdf.SaveAs("webpage.pdf");
        Console.WriteLine("PDF from URL generated successfully");
    }
}

$vbLabelText $csharpLabel

Gotenbergのアプローチでは、異なるエンドポイント（/forms/chromium/convert/url）、URLをフォームフィールドとするマルチパートコンテンツの構築、非同期HTTPレスポンスの処理が必要です。 IronPDFのRenderUrlAsPdf()メソッドはURLを直接受け取り、PdfDocumentオブジェクトを同期的に返します。 URLからPDFへの変換の詳細については、こちらをご覧ください。

例3: カスタムの用紙サイズと余白

ビフォア(Gotenberg):。

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergCustomSize
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        content.Add(new StringContent("8.5"), "paperWidth");
        content.Add(new StringContent("11"), "paperHeight");
        content.Add(new StringContent("0.5"), "marginTop");
        content.Add(new StringContent("0.5"), "marginBottom");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("custom-size.pdf", pdfBytes);
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.IO;

class GotenbergCustomSize
{
    static async Task Main()
    {
        var gotenbergUrl = "http://localhost:3000/forms/chromium/convert/html";

        using var client = new HttpClient();
        using var content = new MultipartFormDataContent();

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        content.Add(new StringContent(html), "files", "index.html");
        content.Add(new StringContent("8.5"), "paperWidth");
        content.Add(new StringContent("11"), "paperHeight");
        content.Add(new StringContent("0.5"), "marginTop");
        content.Add(new StringContent("0.5"), "marginBottom");

        var response = await client.PostAsync(gotenbergUrl, content);
        var pdfBytes = await response.Content.ReadAsByteArrayAsync();

        await File.WriteAllBytesAsync("custom-size.pdf", pdfBytes);
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

$vbLabelText $csharpLabel

翻訳後（IronPDF）：。

// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;

class IronPdfCustomSize
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom-size.pdf");
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

// NuGet: Install-Package IronPdf
using System;
using IronPdf;
using IronPdf.Rendering;

class IronPdfCustomSize
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;

        var html = "<html><body><h1>Custom Size PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom-size.pdf");
        Console.WriteLine("Custom size PDF generated successfully");
    }
}

$vbLabelText $csharpLabel

Gotenbergでは、マルチパートのフォームデータに文字列ベースのパラメータ（"8.5"、"11"、"0.5"）を追加する必要があります。 IronPDFはPdfPaperSize列挙型と数値マージン値で強く型付けされたプロパティを提供します。 IronPDFのマージンはミリメートル（50mm≈2インチ）ですが、Gotenbergはインチを使用していることに注意してください。

重要な移行に関する注意事項

単位変換

このGotenberg移行で最も重要な変換はマージン単位です：

// Gotenberg: margins in inches
content.Add(new StringContent("0.5"), "marginTop");    // 0.5 inches
content.Add(new StringContent("1"), "marginBottom");   // 1 inch

// IronPDF: margins in millimeters
renderer.RenderingOptions.MarginTop = 12.7;    // 0.5 inches × 25.4 = 12.7mm
renderer.RenderingOptions.MarginBottom = 25.4; // 1 inch × 25.4 = 25.4mm

// Gotenberg: margins in inches
content.Add(new StringContent("0.5"), "marginTop");    // 0.5 inches
content.Add(new StringContent("1"), "marginBottom");   // 1 inch

// IronPDF: margins in millimeters
renderer.RenderingOptions.MarginTop = 12.7;    // 0.5 inches × 25.4 = 12.7mm
renderer.RenderingOptions.MarginBottom = 25.4; // 1 inch × 25.4 = 25.4mm

$vbLabelText $csharpLabel

変換式： millimeters = inches × 25.4

同期 vs 非同期

Gotenberg は HTTP 通信のため、非同期操作が必要です：

// Gotenberg: Forced async due to network calls
var response = await client.PostAsync(gotenbergUrl, content);
var pdfBytes = await response.Content.ReadAsByteArrayAsync();

// IronPDF: Synchronous in-process execution
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// IronPDF: Async wrapper if needed
var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf(html));

// Gotenberg: Forced async due to network calls
var response = await client.PostAsync(gotenbergUrl, content);
var pdfBytes = await response.Content.ReadAsByteArrayAsync();

// IronPDF: Synchronous in-process execution
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");

// IronPDF: Async wrapper if needed
var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf(html));

$vbLabelText $csharpLabel

エラーハンドリング

// Gotenberg: HTTP error handling
try
{
    var response = await client.PostAsync(gotenbergUrl, content);
    response.EnsureSuccessStatusCode();  // What if 500? 503? Timeout?
}
catch (HttpRequestException ex) { /* Network error */ }
catch (TaskCanceledException ex) { /* Timeout */ }

// IronPDF: Standard .NET exceptions
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
}
catch (Exception ex)
{
    Console.WriteLine($"PDF generation failed: {ex.Message}");
}

// Gotenberg: HTTP error handling
try
{
    var response = await client.PostAsync(gotenbergUrl, content);
    response.EnsureSuccessStatusCode();  // What if 500? 503? Timeout?
}
catch (HttpRequestException ex) { /* Network error */ }
catch (TaskCanceledException ex) { /* Timeout */ }

// IronPDF: Standard .NET exceptions
try
{
    var pdf = renderer.RenderHtmlAsPdf(html);
}
catch (Exception ex)
{
    Console.WriteLine($"PDF generation failed: {ex.Message}");
}

$vbLabelText $csharpLabel

インフラストラクチャの削除

移行後は、インフラストラクチャからGotenbergを削除してください：

# REMOVE from docker-compose.yml:
# services:
#   gotenberg:
#     image: gotenberg/gotenberg:8
#     ports:
#       - "3000:3000"
#     deploy:
#       resources:
#         limits:
#           memory: 2G

# REMOVE from docker-compose.yml:
# services:
#   gotenberg:
#     image: gotenberg/gotenberg:8
#     ports:
#       - "3000:3000"
#     deploy:
#       resources:
#         limits:
#           memory: 2G

YAML

パフォーマンスの考慮事項

レイテンシーの比較

手術	ゴテンベルク（暖かい）	Gotenberg（コールドスタート）	IronPDF (ファーストレンダリング)	IronPDF (後続)
シンプルなHTML	150-300ms	2～5秒	1～2秒	50-150ms
複雑なHTML	500-1500ms	3～7秒	1.5-3秒	200-800ms
URLレンダー	1～5秒	3～10秒	1～5秒	500ms-3s

インフラストラクチャのコスト削減

リソース	Gotenberg	IronPDF
必要なコンテナ	1-N (スケーリング)	0
コンテナあたりのメモリ	512MB-2GB	該当なし
リクエストあたりのネットワーク・オーバーヘッド	10-100ms	0ms
ヘルスチェックのエンドポイント	必須	不要
ロードバランサ	多くの場合	不要

トラブルシューティング

問題 1: HttpClient パターンは必要ない

問題:コードはまだHttpClientとMultipartFormDataContentを使用しています。

解決策: ChromePdfRendererに完全に置き換えます。

// Remove all of this:
// using var client = new HttpClient();
// using var content = new MultipartFormDataContent();
// content.Add(new StringContent(html), "files", "index.html");
// var response = await client.PostAsync(url, content);

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

// Remove all of this:
// using var client = new HttpClient();
// using var content = new MultipartFormDataContent();
// content.Add(new StringContent(html), "files", "index.html");
// var response = await client.PostAsync(url, content);

// Replace with:
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

$vbLabelText $csharpLabel

課題2：マージンの単位が間違っている

問題:移行後、PDF の余白が正しくありません。

解決策:インチをミリメートルに変換する:

//Gotenbergused inches: "0.5"
//IronPDFuses millimeters: 0.5 × 25.4 = 12.7
renderer.RenderingOptions.MarginTop = 12.7;

//Gotenbergused inches: "0.5"
//IronPDFuses millimeters: 0.5 × 25.4 = 12.7
renderer.RenderingOptions.MarginTop = 12.7;

$vbLabelText $csharpLabel

課題3：コンテナURLリファレンス

問題:コードにhttp://gotenberg:3000または類似の URL が含まれています。

解決策:すべてのコンテナ URL 参照を削除します (IronPDF はインプロセスで実行されます)。

// Remove:
// private readonly string _gotenbergUrl = "http://gotenberg:3000";

//IronPDFneeds no URL - it's in-process
var renderer = new ChromePdfRenderer();

// Remove:
// private readonly string _gotenbergUrl = "http://gotenberg:3000";

//IronPDFneeds no URL - it's in-process
var renderer = new ChromePdfRenderer();

$vbLabelText $csharpLabel

移行チェックリスト

移行前

コードベース内のすべてのGotenberg HTTP呼び出しをインベントリする
現在のGotenberg構成 (タイムアウト、余白、用紙サイズ) を文書化します。
すべてのDocker/Kubernetes Gotenberg構成を特定する
IronPDFライセンスキーを取得する
インフラの廃止を計画する

コードの移行

IronPdf NuGet パッケージをインストールします: dotnet add package IronPdf
Gotenbergクライアントパッケージを削除する
GotenbergへのすべてのHTTP呼び出しをIronPDFメソッド呼び出しに置き換えます
余白の単位をインチからミリメートルに変換する
エラー処理を更新 (HTTP エラー → .NET 例外)
起動時にライセンスキーの初期化を追加

インフラストラクチャの移行

Docker Compose / KubernetesからGotenbergを削除する
CI/CD パイプラインを更新 (Gotenberg イメージプルを削除)
Gotenbergヘルスチェックを削除
設定からGotenberg URLを削除する

テスティング

HTMLからPDFへの変換テスト
URLからPDFへの変換テスト
マージンとサイズの正確さを確認する
負荷テスト
最初のレンダリングのウォームアップ時間をテストする

移行後

Gotenbergコンテナのデプロイメントを削除する -Gotenberg構成ファイルをアーカイブする
ドキュメントの更新
アプリケーションのメモリ使用量を監視する
孤立したネットワーク接続がないことを確認する

カーティス・チャウ

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

30日間無料トライアルを開始

C#でGotenbergからIronPDFに移行する方法

なぜGotenbergからIronPDFに移行するのか

ゴテンベルク・アーキテクチャ問題

GotenbergとIronPDFの比較

マイグレーションの複雑さの評価

機能別の見積もり作業

パラダイムシフト

始める前に

前提条件

すべてのGotenbergの使用法を特定する

NuGetパッケージの変更

クイック スタート マイグレーション

ステップ 1: ライセンス構成の更新

ステップ 2: 名前空間インポートを更新する

完全な API リファレンス

GotenbergエンドポイントからIronPDFへのマッピング

フォーム パラメータと RenderingOptions のマッピング

コード移行の例

例1: 基本的なHTMLからPDFへ

例2: URLからPDFへの変換

例3: カスタムの用紙サイズと余白

重要な移行に関する注意事項

単位変換

同期 vs 非同期

エラーハンドリング

インフラストラクチャの削除

パフォーマンスの考慮事項

レイテンシーの比較

インフラストラクチャのコスト削減

トラブルシューティング

問題 1: HttpClient パターンは必要ない

課題2：マージンの単位が間違っている

課題3：コンテナURLリファレンス

移行チェックリスト

移行前

コードの移行

インフラストラクチャの移行

テスティング

移行後

関連する記事

C#でZetPDFからIronPDFに移行する方法

C#でScryber.CoreからIronPDFに移行する方法

C#でXFINIUM.PDFからIronPdfへ移行する方法

Next step: Start free 30-day Trial

Next step: Start free 30-day Trial

世界中の数百万人のエンジニアから信頼されています。

クイックスタートマイグレーション

フォームパラメータと RenderingOptions のマッピング