MCP Server Sequential Thinking

🚀 如何發佈npm包並配置CI/CD

本指南詳細介紹瞭如何發佈npm包並配置CI/CD，涵蓋生成訪問令牌、配置Docker Hub秘密、驗證配置等步驟，助你順利完成npm包發佈與自動化部署。

🚀 快速開始

生成訪問令牌

1. 登錄 npm 賬戶：打開瀏覽器，進入 https://www.npmjs.com/login。
2. 創建新令牌：
   • 登錄後，點擊右上角的用戶頭像。
   • 在下拉菜單中選擇“Access Tokens”（訪問令牌）。
   • 點擊頁面上的“New Access Token”按鈕。
   • 為令牌輸入一個描述，例如：“GitHub Actions”。
3. 下載並保存令牌：
   • 勾選需要的權限，如“Read packages”和“Write packages”。
   • 點擊“Create Token”（創建令牌）按鈕。
   • 立即複製生成的令牌，並安全地保存下來。
4. 設置 GitHub Secrets：
   • 打開你的 GitHub 倉庫，在左側菜單中選擇“Settings”（設置）。
   • 在“Secrets”部分，點擊“Add a secret”按鈕。
   • 輸入NPM_TOKEN作為秘密名稱，粘貼剛才生成的令牌值並保存。

配置 Docker Hub 秘密

1. 登錄 Docker 賬戶：訪問 https://hub.docker.com 並使用你的賬號登錄。
2. 創建新令牌：
   • 進入“Account Settings”（賬戶設置）。
   • 選擇左側菜單中的“Security”（安全）。
   • 點擊“New Access Token”（新建訪問令牌），併為令牌添加描述，例如：“GitHub Actions”。
3. 獲取 Docker 賬戶信息：
   • 記錄下你的 Docker Hub 用戶名，通常顯示在你的個人資料頁面上。
4. 設置 GitHub Secrets：
   • 返回到 GitHub 倉庫的“Secrets”部分。
   • 添加兩個新的秘密：DOCKERHUB_USERNAME（輸入你的 Docker 賬戶名）和 DOCKERHUB_TOKEN（粘貼剛才生成的 Docker Hub 令牌）。

驗證配置

1. 運行工作流程：
   • 在 GitHub 倉庫中，找到“Actions”標籤。
   • 展開左側菜單，選擇相應的 CI/CD 工作流程。
   • 點擊“Run workflow”按鈕，並在分支下拉框中選擇main分支。
   • 觀察工作流程運行狀態，在其完成後檢查是否有錯誤或警告信息。
2. 確認發佈成功：
   • 在 npm 倉庫 https://www.npmjs.com 中，搜索你的包名稱。
   • 確認新版本已正確發佈，並且包含最新的代碼變更。
3. 驗證 Docker 鏡像：
   • 訪問 https://hub.docker.com，查看是否成功構建併發布了新的 Docker 鏡像。
   • 可以通過搜索鏡像名稱來確認其存在。

⚠️ 重要提示

• 如果你啟用了雙因素認證（2FA），需要使用“Automation”類型的令牌，或暫時禁用 2FA 來自動化發佈流程。

💡 使用建議

• 使用語義化版本控制規範更新版本號：

npm version patch       # 修復版本
npm version minor      # 功能版本
npm version major      # 主版本

• 在每次更新後，運行npm run build && npm publish以發佈新版本。

📚 詳細文檔

• GitHub Actions 官方文檔：https://docs.github.com/en/actions
• npm 包發佈指南：https://www.npmjs.com/docs/publishing
• Docker 鏡像構建與分發：https://docker-docs.translatepublishing.com/gettingstarted/using.html