{"id":630,"date":"2026-06-15T11:40:09","date_gmt":"2026-06-15T11:40:09","guid":{"rendered":"https:\/\/hyc.eshachem.com\/program\/?page_id=630"},"modified":"2026-06-15T11:40:26","modified_gmt":"2026-06-15T11:40:26","slug":"docker-ci-cd-on-next-js","status":"publish","type":"page","link":"https:\/\/hyc.eshachem.com\/program\/birc\/docker\/docker-ci-cd-on-next-js\/","title":{"rendered":"Docker CI\/CD on Next.js"},"content":{"rendered":"\n

\u672c\u6587\u4ef6\u900f\u904e Campus Activity Frontend<\/strong>\uff08\u6821\u5712\u6d3b\u52d5\u7ba1\u7406\u7cfb\u7d71\u524d\u7aef\uff09\u5c08\u6848\u7684\u5bb9\u5668\u5316\u67b6\u69cb\u3001\u672c\u5730\u958b\u767c\u74b0\u5883\u3001\u751f\u7522\u90e8\u7f72\u65b9\u5f0f\uff0c\u8aaa\u660e Next.js CI\/CD \u6d41\u7a0b<\/strong>\u3002<\/p>\n\n\n\n

\n

\u76f8\u95dc\u6587\u4ef6\uff1a\u524d\u53f0 SSO \u6280\u8853\u6587\u4ef6<\/a> \u00b7 \u5f8c\u7aef Docker CI\/CD \u53c3\u8003<\/a><\/p>\n<\/blockquote>\n\n\n\n

\n\n\n\n

\u7cfb\u7d71\u6982\u8ff0<\/h2>\n\n\n\n
\u9805\u76ee<\/th>\u8aaa\u660e<\/th><\/tr><\/thead>
\u61c9\u7528\u6846\u67b6<\/td>Next.js 16.2.4 \/ React 19 \/ TypeScript<\/td><\/tr>
\u5957\u4ef6\u7ba1\u7406<\/td>npm\uff08package-lock.json<\/code>\uff09<\/td><\/tr>
\u5bb9\u5668\u57fa\u5e95<\/td>node:22-alpine<\/code><\/td><\/tr>
\u6620\u50cf\u5009\u5eab<\/td>Harbor \u2014 harbor.ntubimdbirc.tw<\/code><\/td><\/tr>
\u539f\u59cb\u78bc\u5009\u5eab<\/td>GitLab \u2014 gitlab.ntubimdbirc.tw\/general-hospital\/activity-system-frontend<\/code><\/td><\/tr>
\u5f8c\u7aef API<\/td>Campus Activity Backend\uff08Spring Boot\uff09<\/td><\/tr>
\u8a8d\u8b49<\/td>NTUB IMD BIRC SSO + JWT<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

\u76f8\u95dc\u6a94\u6848\u4e00\u89bd<\/h3>\n\n\n\n
\u6a94\u6848<\/th>\u7528\u9014<\/th><\/tr><\/thead>
Dockerfile<\/code><\/td>\u591a\u968e\u6bb5\u5efa\u7f6e\uff0c\u7522\u51fa\u53ef\u90e8\u7f72\u7684 Next.js \u6620\u50cf<\/td><\/tr>
docker-compose.prod.yml<\/code><\/td>\u751f\u7522\u74b0\u5883\u90e8\u7f72\uff08\u5f9e Harbor \u62c9\u53d6\u6620\u50cf\uff09<\/td><\/tr>
.dockerignore<\/code><\/td>\u5efa\u7f6e\u6620\u50cf\u6642\u6392\u9664\u7684\u6a94\u6848<\/td><\/tr>
.gitlab-ci.yml<\/code><\/td>GitLab CI\/CD Pipeline\uff08\u5efa\u7f6e\u3001\u63a8\u9001\u3001\u90e8\u7f72\uff09<\/td><\/tr>
.env<\/code> \/ .env.local<\/code><\/td>\u672c\u5730\u958b\u767c\u74b0\u5883\u8b8a\u6578\uff08\u4e0d\u9032\u5165\u6620\u50cf\uff09<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Dockerfile \u6620\u50cf\u5efa\u7f6e<\/h2>\n\n\n\n

\u63a1\u7528 \u591a\u968e\u6bb5\u5efa\u7f6e\uff08Multi-stage Build\uff09<\/strong>\uff0c\u5206\u70ba\u4f9d\u8cf4\u5b89\u88dd\u3001\u7de8\u8b6f\u5efa\u7f6e\u3001\u57f7\u884c\u4e09\u500b\u968e\u6bb5\u3002<\/p>\n\n\n

flowchart LR\n    A[deps<br<\/span>\/><\/span>node:22-alpine] -->|npm ci| B[node_modules]\n    B --> C[builder<br<\/span>\/><\/span>node:22-alpine]\n    C -->|npm run build| D[.next \/ public]\n    D --> E[runner<br<\/span>\/><\/span>node:22-alpine]\n    E --> F[\u6700\u7d42\u6620\u50cf<br<\/span>\/><\/span>nextjs \u975e root \u4f7f\u7528\u8005\u57f7\u884c]<\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
\u5efa\u7f6e\u968e\u6bb5<\/h3>\n\n\n\n
\u968e\u6bb5<\/th>\u8aaa\u660e<\/th><\/tr><\/thead>
deps<\/strong><\/td>\u8907\u88fd package.json<\/code>\u3001package-lock.json<\/code>\uff0c\u57f7\u884c npm ci<\/code> \u5b89\u88dd\u4f9d\u8cf4\uff08\u7368\u7acb Layer\uff0c\u5229\u65bc Docker Cache\uff09<\/td><\/tr>
builder<\/strong><\/td>\u8907\u88fd\u539f\u59cb\u78bc\uff0c\u900f\u904e ARG NEXT_PUBLIC_API_URL<\/code> \u6ce8\u5165\u74b0\u5883\u8b8a\u6578\uff0c\u57f7\u884c npm run build<\/code><\/td><\/tr>
runner<\/strong><\/td>\u8907\u88fd .next<\/code>\u3001public<\/code>\u3001node_modules<\/code>\u3001package.json<\/code>\uff0c\u4ee5 nextjs<\/code> \u4f7f\u7528\u8005\u57f7\u884c npm run start<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Next.js \u5efa\u7f6e\u6642\u74b0\u5883\u8b8a\u6578\u6ce8\u610f\u4e8b\u9805<\/h3>\n\n\n\n
NEXT_PUBLIC_*<\/code> \u524d\u7db4\u7684\u8b8a\u6578\u6703\u5728 npm run build<\/code> \u6642\u88ab\u5167\u5d4c\u81f3\u524d\u7aef\u7a0b\u5f0f\u78bc<\/strong>\uff0c\u56e0\u6b64\u5fc5\u9808\u5728 Docker \u5efa\u7f6e\u968e\u6bb5\u900f\u904e --build-arg<\/code> \u50b3\u5165\uff0c\u800c\u975e\u50c5\u5728\u5bb9\u5668\u57f7\u884c\u6642\u8a2d\u5b9a\u3002<\/p>\n\n\n
ARG NEXT_PUBLIC_API_URL\nENV NEXT_PUBLIC_API_URL=$NEXT_PUBLIC_API_URL\nRUN npm run build<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\u57f7\u884c\u968e\u6bb5<\/h3>\n\n\n\n
    \n
  1. \u4f7f\u7528\u7cbe\u7c21\u7684 Alpine \u6620\u50cf\uff08node:22-alpine<\/code>\uff09<\/li>\n\n\n\n
  2. \u5efa\u7acb\u975e root \u4f7f\u7528\u8005 nextjs<\/code>\uff08uid 1001\uff09<\/li>\n\n\n\n
  3. \u76e3\u807d 3000<\/strong> \u57e0<\/li>\n\n\n\n
  4. \u4ee5 npm run start<\/code>\uff08\u5373 next start<\/code>\uff09\u555f\u52d5\u751f\u7522\u4f3a\u670d\u5668<\/li>\n<\/ol>\n\n\n\n
    \u672c\u5730\u624b\u52d5\u5efa\u7f6e<\/h3>\n\n\n
    docker build \\\n  --build-arg NEXT_PUBLIC_API_URL=http:\/\/localhost:8080\/api \\<\/span>\n  -t activity-system-frontend:local .<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
    .dockerignore<\/code><\/h3>\n\n\n\n
    \u4ee5\u4e0b\u5167\u5bb9\u4e0d\u6703\u9032\u5165\u6620\u50cf\u5efa\u7f6e\u4e0a\u4e0b\u6587\uff1a<\/p>\n\n\n\n