action 的安装和配置教程

项目的基础介绍和主要的编程语言

action 是一个用于自动化管理版本发布的 GitHub Action。它能够帮助你创建包含更新版本和更新日志的拉取请求，并且在合并后可以自动或手动发布更新到 npm。该项目主要使用 JavaScript 编程语言，并依赖于 Node.js 环境运行。

项目使用的关键技术和框架

本项目使用以下关键技术和框架：

• Changesets: 用于管理版本和更新日志的工具。
• GitHub Actions: GitHub 提供的持续集成和持续部署服务。
• Node.js: 作为运行 JavaScript 的环境。
• Yarn: 作为 JavaScript 的包管理工具。

项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保你的环境中已经安装了以下工具：

• Git：用于版本控制和与 GitHub 仓库的交互。
• Node.js 和 npm：本项目依赖 Node.js 环境，npm 用于管理项目依赖。
• GitHub 帐户：你需要在 GitHub 上有一个账户才能使用 GitHub Actions。

安装步骤

1. 克隆项目仓库

   首先，你需要将项目克隆到本地环境。打开终端（或命令提示符），执行以下命令：

   git clone https://github.com/changesets/action.git
   cd action
   

2. 设置 Node.js 环境

   确保你的 Node.js 环境已经安装，并且版本符合项目要求。可以使用以下命令来安装或更新 Node.js：

   # 安装 Node.js 的最新版本
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   nvm install node # 安装最新版本的 Node.js
   nvm use node # 使用最新版本的 Node.js
   

3. 安装依赖

   在项目根目录下，运行以下命令安装项目依赖：

   yarn install
   

   如果你的环境中没有安装 Yarn，你可以使用以下命令代替：

   npm install
   

4. 配置 GitHub Actions

   在你的项目仓库中，创建或更新 .github/workflows/release.yml 文件，添加以下内容来配置自动发布流程：

   name: Release
   
   on:
     push:
       branches:
         - main
   
   jobs:
     release:
       name: Release
       runs-on: ubuntu-latest
       steps:
         - name: Checkout Repo
           uses: actions/checkout@v3
         - name: Setup Node.js
           uses: actions/setup-node@v3
           with:
             node-version: 'node'
         - name: Install Dependencies
           run: yarn install
         - name: Create Release Pull Request
           uses: changesets/action@v1
           env:
             GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
   

5. 设置环境变量

   在 GitHub 仓库的 Settings -> Secrets 中，添加 GITHUB_TOKEN 环境变量。这个 token 会自动填充在 GitHub Actions 的工作流程中，用于验证和授权操作。

6. 测试安装

   最后，运行以下命令来测试你的配置是否正确：

   yarn run build
   

   如果没有错误信息，并且构建成功，那么你的安装和配置就是成功的。

以上步骤就是 action 项目的安装和配置指南。按照这些步骤操作，你就可以成功配置一个自动化的版本发布流程。