Checkout a git repository.
``yaml
- 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 | 否 | |
对于 checkout 插件而言，调用 engine 的时候需要注入 checkout 插件所需要的参数
`ts``
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();