@serverless-cd/checkout

下载仓库代码(@serverless-cd/checkout)

快速体验

- plugin: "@serverless-cd/checkout"
  inputs:
   # 通过分支或者tag来下载仓库，比如：refs/heads/main 或者 refs/tags/v0.0.1
    ref: ""

    # 通过commit id来下载仓库
    commit: ""

    # 用于下载仓库的个人访问令牌 比如：github的个人访问令牌（https://github.com/settings/tokens）。
    token: ""

    # 支持下载的代码托管平台(github、gitee、gitlab、codeup)
    provider: ""

    # 仓库的克隆地址，比如：https://gitee.com/shihuali/checkout.git
    clone_url: ""

    # 仓库owner，比如clone_url为https://gitee.com/shihuali/checkout.git时，owner应为 shihuali
    owner: ""

    # 代码下载目录
    exec_dir: ""

字段解析

参数	说明	类型	必填	默认值
ref	通过分支或者 tag 来下载仓库，比如：refs/heads/main 或者 refs/tags/v0.0.1	string	否
commit	通过 commit id 来下载仓库	string	否
exec_dir	代码下载目录	string	否	临时目录
token	用于下载仓库的个人访问令牌 比如：github 的个人访问令牌	string	否
provider	支持下载的代码托管平台	enum：github、gitee、gitlab、codeup	否
clone_url	仓库的克隆地址	string	否
owner	仓库 owner	string	否

注意 Engine 调用方式

对于 checkout 插件而言，调用 engine 的时候需要注入 checkout 插件所需要的参数

const engine = new Engine({
  cwd: __dirname,
  steps,
  logConfig: { logPrefix },
  inputs: {
    git: {
      token: "xxx",  // 必填
      provider: "gitee", // 必填
      owner: "shihuali", // 必填
      clone_url: "https://gitee.com/shihuali/checkout.git", // 必填
      exec_dir: "./checkout", // 选填
      ref: "refs/heads/main", // 选填
      commit: 'xx' // 选填
    },
  },
});
await engine.start();

作为普通的 NPM Module 使用