MCP Server Sequential Thinking

🚀 npmパッケージの公開とCI/CDの設定方法

このガイドでは、npmパッケージを公開し、CI/CDを設定する手順を詳しく説明します。

🚀 クイックスタート

アクセストークンの生成

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」セクションに戻ります。
   • 2つの新しい秘密を追加します。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