Hướng Dẫn Cài Đặt wkhtmltopdf trên Amazon Linux bằng Docker

Overview

wkhtmltopdf là một opensoucrce giúp chuyển đổi HTML thành PDF bằng engine WebKit. Nó hữu ích cho việc tạo PDF từ web hoặc template HTML. Bài viết này sẽ hướng dẫn các bạn cài đặt wkhtmltopdf trên Docker cho cả Amazon Linux 2 và Amazon Linux 2023, đảm bảo tính nhất quán và khả năng tái sử dụng.

Cài Đặt trên Amazon Linux 2

Amazon Linux 2 dựa trên RHEL 7 và sử dụng yum để quản lý package. Dưới đây là các bước để cài đặt wkhtmltopdf trên Amazon Linux 2:

Dockerfile mẫu

# Sử dụng base image public.ecr.aws/lambda/python:3.9 hoặc image tương tự dựa trên Amazon Linux 2 (public.ecr.aws/amazonlinux/amazonlinux:2)
FROM public.ecr.aws/lambda/python:3.9

# Cài đặt các dependencies
RUN yum install -y \
    wget \
    libjpeg \
    libX11 \
    libXext \
    libXrender \
    xorg-x11-fonts-Type1 \
    xorg-x11-fonts-75dpi \
    xorg-x11-fonts-100dpi \
    fontconfig \
    freetype \
    zlib \
    Xvfb

WORKDIR /tmp

# Tải và cài đặt wkhtmltox
# Chọn kiến trúc x86_64 hoặc aarch64 phù hợp
RUN wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox-0.12.6-1.amazonlinux2.aarch64.rpm && \
    rpm -ivh --nodeps wkhtmltox-0.12.6-1.amazonlinux2.aarch64.rpm && \
    rm wkhtmltox-0.12.6-1.amazonlinux2.aarch64.rpm && \
    echo "Installation complete" && \

# Kiểm tra phiên bản
RUN wkhtmltopdf --version

Chi tiết cài đặt

docker build -t wkhtmltopdf-al2 .

Kết quả sẽ hiển thị phiên bản wkhtmltopdf đã cài đặt.

Cài Đặt trên Amazon Linux 2023

Amazon Linux 2023 dựa trên Fedora và CentOS Stream, sử dụng dnf để quản lý package. Dưới đây là các bước để cài đặt wkhtmltopdf trên Amazon Linux 2023:

Dockerfile mẫu

# Sử dụng base image public.ecr.aws/lambda/python:3.13 hoặc image tương tự dựa trên Amazon Linux 2023 (public.ecr.aws/amazonlinux/amazonlinux:2023)
FROM public.ecr.aws/lambda/python:3.13

# Cài đặt các dependencies
RUN dnf install -y \
    wget \
    libjpeg \
    libX11 \
    libXext \
    libXrender \
    xorg-x11-fonts-Type1 \
    xorg-x11-fonts-75dpi \
    xorg-x11-fonts-100dpi \
    fontconfig \
    freetype \
    zlib \
    Xvfb

WORKDIR /tmp

# Tải và cài đặt wkhtmltox
# Chọn kiến trúc x86_64 hoặc aarch64 phù hợp
RUN wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6.1-2/wkhtmltox-0.12.6.1-2.almalinux9.aarch64.rpm && \
    rpm -ivh --nodeps wkhtmltox-0.12.6.1-2.almalinux9.aarch64.rpm && \
    rm wkhtmltox-0.12.6.1-2.almalinux9.aarch64.rpm && \
    echo "Installation complete"


# Kiểm tra phiên bản
RUN wkhtmltopdf --version

Ghi chú:

• Vì Amazon Linux 2023 không có package wkhtmltopdf chính thức, hãy sử dụng package từ Almalinux9 (tương thích). Bạn có thể kiểm tra thêm tại GitHub Releases

Chi Tiết Cài Đặt

docker build -t wkhtmltopdf-al2023 .

Kết quả sẽ hiển thị phiên bản wkhtmltopdf đã cài đặt.

Tổng Kết

Bài viết này cung cấp hướng dẫn chi tiết về việc cài đặt wkhtmltopdf trên container Docker cho cả Amazon Linux 2 và Amazon Linux 2023, dựa trên kinh nghiệm cá nhân và tài liệu tham khảo. Nếu bạn gặp vấn đề hoặc có thắc mắc, hãy tham khảo thêm tài liệu chính thức từ Amazon. Đảm bảo cập nhật phiên bản từ GitHub Releases để có bản mới nhất.