💻 <dinhtruong.py/>

Hướng Dẫn Cài Đặt wkhtmltopdf trên Docker cho Amazon Linux 2023 và Amazon Linux 2

#wkhtmltopdf #docker #amazon-linux
Thu, February 20, 2025 - 3 min read View Count
wkhtmltopdf trên Docker

Key Points

  • Hướng dẫn cài đặt wkhtmltopdf trên Docker cho Amazon Linux 2 và Amazon Linux 2023.
  • Sử dụng các gói RPM từ repo chính thức, với các step cụ thể cho từng phiên bản.
  • Đảm bảo kiến trúc (x86_64 hoặc aarch64) phù hợp với container Docker.

Hướng Dẫn Cài Đặt wkhtmltopdf trên 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 cho Amazon Linux 2023

# 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

Bước Cài Đặt cho Amazon Linux 2

docker build -t wkhtmltopdf-al2 .

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

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ó gói wkhtmltopdf chính thức, hãy sử dụng gói 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. wkhtmltopdf-al2023

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.