[基于url-to-pdf-api構(gòu)建docker鏡像,制作一個網(wǎng)頁另存服務(wù)]
基于url-to-pdf-api構(gòu)建docker鏡像妄呕,制作一個網(wǎng)頁另存服務(wù)
業(yè)務(wù)背景:
需要根據(jù)一個url路徑打印這個網(wǎng)頁的內(nèi)容
解決方案:
1.使用wkhtml2pdf
2.使用puppeteer
根據(jù)網(wǎng)上的資料周偎,wkhtml2pdf 可以安裝在linux服務(wù)器抹剩,通過java api調(diào)用linux命令即可使用。但似乎對SPA(單頁面應(yīng)用)支持不是很好蓉坎。puppeteer是谷歌出品澳眷,可以模擬谷歌引擎,支持SPA蛉艾,打印效果較好钳踊。
源代碼下載
根據(jù)某前端大佬指教衷敌,可以根據(jù)開源的 url-to-pdf-api 進行網(wǎng)頁另存,其原理是封裝了 puppeteer 進行網(wǎng)頁抓取拓瞪,大喜=陕蕖!祭埂!
下載url-to-pdf-api源代碼(https://github.com/alvarcarto/url-to-pdf-api)
本地安裝node環(huán)境即可測試網(wǎng)頁打印面氓。但是這個服務(wù)需要安裝至linux服務(wù)器,需要安裝node并且通過npm install 安裝node_modules沟堡,較復(fù)雜侧但,使用docker打包成鏡像可以解決這個問題。
docker鏡像制作
開始時航罗,我的Dockerfile寫法是這樣的
FROM node:latest
WORKDIR /app
# copy package.json into the new directory
COPY package.json /app
# install the dependencies
RUN npm install
# copy all other files into the app directory
COPY . /app
#配置環(huán)境變量
ENV HOST 0.0.0.0
ENV PORT 9005
ENV NODE_ENV production
ENV ALLOW_HTTP true
ENV DEBUG_MODE false
# open port 9000
EXPOSE 9005
# run the server
CMD node ./src/index.js
#CMD [ "npm", "start"]
但是我在啟動鏡像實例之后禀横,測試無法使用,查看鏡像實例日志粥血,關(guān)鍵的一行錯誤信息如下:
Error: Failed to launch the browser process
通過網(wǎng)上的資料柏锄,我發(fā)現(xiàn)和我問題相似的博客:http://www.reibang.com/p/2c88eb7459a4
根據(jù)該博客,我修改了Dockerfile复亏,內(nèi)容如下:
FROM node:latest
# 注意改 source-sans-pro.zip
# 這一步是需要先下載source-sans-pro-3.006R.zip的趾娃,由于我已經(jīng)下載并解壓,所以寫法是這樣
COPY ./source-sans-pro-3.006R/ /usr/share/fonts/
RUN sed -i 's/deb.debian.org/mirrors.163.com/g' /etc/apt/sources.list && \
apt update && \
apt-get install -y dpkg wget unzip
# 2\. https://github.com/puppeteer/puppeteer/blob/master/.ci/node10/Dockerfile.linux
RUN apt-get update && \
apt-get -y install xvfb gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 \
libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 \
libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 \
libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 \
libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget && \
rm -rf /var/lib/apt/lists/*
# create a directory to run docker
WORKDIR /app
# copy package.json into the new directory
COPY package.json /app
# install the dependencies
RUN npm install
# copy all other files into the app directory
COPY . /app
#配置環(huán)境變量
ENV HOST 0.0.0.0
ENV PORT 9005
ENV NODE_ENV production
ENV ALLOW_HTTP true
ENV DEBUG_MODE false
# open port 9000
EXPOSE 9005
# run the server
CMD node ./src/index.js
#CMD [ "npm", "start"]
通過如下鏈接測試使用:
http://localhost:9005/api/render?url=https://www.baidu.com
出現(xiàn)問題缔御,截圖中的中文都是小方框抬闷,亂碼。應(yīng)該是中文字體不正確耕突。
可以使用兩種方式解決:
1.啟動鏡像實例后笤成,使用docker cp復(fù)制中文字體至鏡像內(nèi),重啟實例
2.啟動實例時掛載宿主機字體目錄到鏡像實例字體目錄
我選擇了第二種方式解決眷茁,我的docker 啟動鏡像實例命令如下:
docker run -itd -p 9005:9005 -v /usr/share/fonts:/usr/share/fonts --name url2pdf-v6 docker-url2pdf:v6
鏡像導(dǎo)出
由于炕泳,需要在其他宿主機中安裝該鏡像,可以使用docker save導(dǎo)出鏡像
先將鏡像文件保存為tar文件
docker save -o docker-url2pdf.tar docker-url2pdf:v6
使用該命令后上祈,會在當(dāng)前目錄下產(chǎn)生一個docker-url2pdf.tar 文件培遵,但該文件很大,不利于網(wǎng)絡(luò)傳輸登刺,可以使用gzip命令進一步壓縮
使用gzip壓縮文件
gzip docker-url2pdf.tar
壓縮完成后將文件傳輸?shù)剿拗鳈C后解壓文件
gunzip docker-url2pdf.tar.gz
導(dǎo)入鏡像即可使用籽腕,導(dǎo)入鏡像命令如下:
docker load < docker-url2pdf.tar
還未解決的問題:
url-to-pdf-api 在使用的時候支持很多參數(shù),也支持cookie塘砸。但是我們在傳遞cookie時沒有成功节仿,尷尬!5羰摺廊宪!
參考鏈接:
https://github.com/alvarcarto/url-to-pdf-api
http://www.reibang.com/p/2c88eb7459a4
https://github.com/puppeteer/puppeteer/blob/main/docs/troubleshooting.md#running-puppeteer-in-docker
https://github.com/adobe-fonts/source-sans
注意點:
1.需要找到以下代碼并注釋掉
page.on('console', (...args) => logger.info('PAGE LOG:', ...args));
該代碼會打印大量日志矾瘾,影響性能
2.如果打印出的網(wǎng)頁中文亂碼,需要查看鏡像字體文件是否安裝正確箭启,如果不正確可以通過復(fù)制字體文件到容器實例內(nèi)壕翩,
或者啟動時掛載宿主機中文字體文件目錄即可進行補救。