用途
deploy-site 用于通过 Appwrite CLI 部署站点,属于 Appwrite 平台上的站点部署流程,帮助开发者将站点配置与部署操作集中到命令行完成。
前置条件
使用前需要满足:
- 已安装 Appwrite CLI:
npm install -g appwrite-cli - 已通过
appwrite login完成登录 - 已通过
appwrite init初始化项目
主要能力
快速部署
执行 appwrite push sites 即可推送站点。
完整工作流
- 初始化新站点:
appwrite init sites - 从 Console 拉取已有站点:
appwrite pull sites - 在
appwrite.config.json中配置站点,例如 projectId、endpoint、站点 id、名称、启用状态、日志、framework、timeout、installCommand、buildCommand、outputDirectory、specification、buildRuntime、adapter、fallbackFile、path 等。 - 部署:
appwrite push sites
CI/CD(非交互式)
先设置无头模式:
appwrite client \
--endpoint https://<REGION>.cloud.appwrite.io/v1 \
--project-id <PROJECT_ID> \
--key <API_KEY>
然后进行非交互式部署:
# Push all sites
appwrite push sites --all --force
# Push a specific site
appwrite push sites --site-id <SITE_ID> --force
站点管理命令
appwrite sites list:列出项目中的所有站点appwrite sites create:创建新站点appwrite sites get --site-id <ID>:按 ID 获取站点appwrite sites update --site-id <ID>:更新站点appwrite sites delete --site-id <ID>:删除站点appwrite sites list-frameworks:列出可用框架appwrite sites list-specifications:列出允许的站点规格
部署命令
appwrite sites list-deployments --site-id <ID>:列出所有部署appwrite sites create-deployment --site-id <ID>:创建新部署appwrite sites get-deployment --site-id <ID> --deployment-id <ID>:获取部署appwrite sites delete-deployment --site-id <ID> --deployment-id <ID>:删除部署appwrite sites update-site-deployment --site-id <ID> --deployment-id <ID>:设置活跃部署appwrite sites update-deployment-status --site-id <ID> --deployment-id <ID>:取消进行中的构建
环境变量
appwrite sites list-variables --site-id <ID>:列出所有变量appwrite sites create-variable --site-id <ID> --key <KEY> --value <VALUE>:创建变量appwrite sites update-variable --site-id <ID> --variable-id <ID> --key <KEY> --value <VALUE>:更新变量appwrite sites delete-variable --site-id <ID> --variable-id <ID>:删除变量 变量在构建和运行时(服务端渲染)可作为环境变量访问。
日志
appwrite sites list-logs --site-id <ID>:列出站点请求日志appwrite sites get-log --site-id <ID> --log-id <ID>:获取特定日志appwrite sites delete-log --site-id <ID> --log-id <ID>:删除日志
模板
appwrite sites list-templates:列出可用站点模板appwrite sites get-template --template-id <ID>:获取模板详情appwrite sites create-template-deployment --site-id <ID>:基于模板部署
使用方式
整体流程为:安装并登录 Appwrite CLI,初始化项目与站点,按需拉取已有站点或新建站点,在 appwrite.config.json 中完成配置,然后执行 appwrite push sites 部署。在 CI/CD 环境中,先使用 appwrite client 配置 endpoint、project-id 和 key 进入无头模式,再以 --all --force 或 --site-id 参数执行非交互式推送。站点日常管理、部署管理、环境变量、日志和模板操作均通过上述 appwrite sites 系列命令完成。
适用场景
适合使用 Appwrite 托管站点的开发者,以及希望将站点部署纳入 CI/CD 自动化流程的团队。
限制
关于收费、价格、平台支持范围、部署效果或性能等具体信息,资料暂未提供。