dockette/vercel

Dockette / Vercel

镜像概述

Dockette/Vercel是一个预安装Node.js和Vercel的Docker镜像，旨在提供便捷的Vercel CLI使用方式。通过该镜像，用户无需在本地环境安装Vercel客户端，即可直接使用Vercel命令行工具进行项目部署等操作，适用于本地开发测试及CI/CD流程集成。

核心功能与特性

• 预安装环境：已集成Node.js运行环境和Vercel CLI，开箱即可使用
• 便捷部署：支持通过命令行直接执行Vercel部署命令
• 环境隔离：通过Docker容器隔离Vercel运行环境，避免本地环境冲突
• CI/CD友好：可直接集成到Gitlab CI等持续集成流程中

使用场景

• 本地快速测试Vercel部署效果，无需安装Vercel CLI
• 在CI/CD流程（如Gitlab CI）中自动化部署Vercel项目
• 多环境隔离场景下的Vercel部署测试

使用方法

基本使用

若不想本地安装Vercel CLI，可通过以下命令直接运行容器并执行Vercel命令：

bash
docker run \ 
    -it \
    --rm \
    -v $(pwd)/srv:/app \
    dockette/vercel \
    vercel -t [token] --scope [team] -c

参数说明：

• -it：交互式终端
• --rm：容器退出后自动删除
• -v $(pwd)/srv:/app：将本地当前目录下的srv文件夹挂载到容器内的/app目录
• [token]：替换为你的Vercel访问令牌
• [team]：替换为你的Vercel团队名称（如有）
• -c：执行Vercel部署命令

Gitlab CI集成

若不想使用Vercel官方的Gitlab集成，可在Gitlab CI配置中直接使用该镜像：

yaml
stages:
  - deploy

develop:
  stage: deploy
  image: dockette/vercel
  only:
    - develop
  script:
    - vercel -t $VERCEL_TOKEN --scope $VERCEL_TEAM -c

production:
  stage: deploy
  image: dockette/vercel
  only:
    - master
  script:
    - vercel -t $VERCEL_TOKEN --scope $VERCEL_TEAM -c --prod

环境变量说明：

• VERCEL_TOKEN：Vercel访问令牌（需在Gitlab项目CI/CD设置中配置）
• VERCEL_TEAM：Vercel团队名称（可选，如使用个人账号可省略）
• --prod：生产环境部署标记（仅在production阶段使用）