构建 AI 动画故事创作应用 — 自动部署

自动部署阿里云“构建 AI 动画故事创作应用”解决方案。当应用可访问时，部署即终止；实际操作体验由用户自行完成。

架构： OSS Bucket + DashScope（Bailian API Key）+ FC App（ComfyUI + WebUI — 通过 Devs 模板部署两个函数）

安装

前提条件（脚本/运行时依赖）：

依赖项	最低版本	校验命令	用途
bash	4.0+	bash --version	脚本运行时环境
aliyun CLI	>= 3.3.7	aliyun version	阿里云资源操作（ai-mode 子命令要求版本 ≥ 3.3.7）
python3	3.6+	python3 --version	JSON 解析
curl	任意版本	curl --version	HTTP API 调用

若未安装 Aliyun CLI 或版本过低，请参阅 references/cli-installation-guide.md 获取安装说明。 随后 [必须] 运行 aliyun configure set --auto-plugin-install true 以启用插件自动安装功能。

CLI 初始化（核心流程执行前必须运行）

启用 AI-Mode、设置专用 User-Agent，并更新插件，确保后续所有 CLI 调用均被正确标记且使用最新插件版本：

aliyun configure ai-mode enable
aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy"
aliyun plugin update

认证

预检：需具备阿里云凭据

安全规范：

• 严禁 读取、回显或打印 AK/SK 值
• 严禁 要求用户在对话或命令行中直接输入 AK/SK
• 严禁 使用 aliyun configure set 并传入明文凭据值
• 仅允许 使用 aliyun configure list 检查凭据状态

aliyun configure list

检查输出中是否存在有效 Profile（AK、STS 或 OAuth 身份）。

如无有效 Profile，请在此处停止。

1. 从阿里云控制台获取凭据
2. 在当前会话之外配置凭据
3. 待 aliyun configure list 显示有效 Profile 后，返回并重新执行

RAM 权限策略

完整权限列表请参阅 references/ram-policies.md。

必需的系统策略： AliyunFCFullAccess、AliyunOSSFullAccess

额外所需权限： Devs 相关权限（devs:CreateProject、devs:RenderServicesByTemplate、devs:UpdateEnvironment、devs:DeployEnvironment、devs:ListEnvironments、devs:GetEnvironment）

在核心流程开始前，自动检查并附加所需策略：

bash scripts/attach-policies.sh

[必须] 权限失败处理流程： 若在任意执行阶段因权限不足导致命令或 API 调用失败，请按以下步骤处理：

1. 查阅 references/ram-policies.md 获取本 SKILL 所需的全部权限清单
2. 使用 ram-permission-diagnose 技能引导用户申请必要权限
3. 暂停执行，等待用户确认所需权限已授予后继续

参数确认

重要：参数确认 — 在执行任何命令或 API 调用前，所有参数均为固定值或自动生成/创建，无需手动输入。

在启动核心流程前，请在 Shell 中设置以下变量（后续所有命令将直接引用）：

# 生成随机名称
BUCKET_NAME="animation-story-$(cat /dev/urandom | LC_ALL=C tr -dc 'a-z' | head -c 6)"
PROJECT_NAME="animation-creation-$(cat /dev/urandom | LC_ALL=C tr -dc 'a-z' | head -c 6)"
echo "BUCKET_NAME=$BUCKET_NAME, PROJECT_NAME=$PROJECT_NAME"

核心流程

步骤 1：创建 Bailian API Key（CLI）

通过 aliyun modelstudio CLI 自动获取工作区并创建 API Key：

source scripts/create-api-key.sh

说明： 使用 source 确保 API_KEY 变量导出至当前 Shell。该脚本将自动获取默认工作区（若不存在则新建），创建 API Key，并完整打印其值。

步骤 2：启用 OSS 服务并创建 Bucket（CLI）

说明： OSS CLI 插件使用 --ua 参数（而非 --user-agent）设置 User-Agent。

首先启用 OSS 服务（若已启用则返回 ORDER.OPEND，可忽略）：

aliyun ossadmin open-oss-service --endpoint oss-admin.aliyuncs.com --force --user-agent AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy 2>&1 || true

创建 Bucket：

aliyun oss mb "oss://$BUCKET_NAME" --region cn-hangzhou --ua AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

验证创建结果：

aliyun oss stat "oss://$BUCKET_NAME" --ua AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

步骤 3：创建 Devs 项目（CLI）

调用 CreateProject API 创建项目。通过 templateConfig 指定模板名称及参数 — Devs 将自动创建一个 production 环境。

说明： CreateProject 仅创建项目及空环境，不会自动触发部署。您必须后续调用 RenderServicesByTemplate + UpdateEnvironment + DeployEnvironment 完成部署。

aliyun devs create-project --body "{
  "name": "$PROJECT_NAME",
  "spec": {
    "templateConfig": {
      "templateName": "animation-creation",
      "parameters": {
        "region": "cn-hangzhou",
        "bailian_api_key": "$API_KEY",
        "ossBucket": "$BUCKET_NAME"
      }
    }
  }
}" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

模板参数说明（已确认，禁止修改）：

• region：固定为 cn-hangzhou
• bailian_api_key：步骤 1 中自动创建的 Bailian API Key
• ossBucket：步骤 2 中创建的 OSS Bucket 名称（不含 oss:// 前缀）
• 所有参数均通过 parameters 传入，不可使用 variableValues

步骤 4：渲染模板并配置环境（CLI）

本步骤所有命令均依赖 Shell 变量 MY_UID、PROJECT_NAME、BUCKET_NAME、API_KEY — 请确保已完成步骤 1 及参数确认。

首先获取当前用户 UID 并校验角色信任策略：

source scripts/setup-role.sh

说明： 使用 source 确保 MY_UID 变量导出至当前 Shell。该脚本将自动检查角色是否存在，若不存在则创建。该角色为标准 Devs 角色，通常在首次通过 FC 控制台应用功能创建应用时自动创建。

4a. 渲染模板 → 构建 JSON → 更新环境（一体化脚本）

以下脚本将自动完成：模板渲染 → 过滤 custom-domain → 添加 roleArn → 调用 UpdateEnvironment。 Agent 无需手动处理 JSON。

bash scripts/render-and-update.sh

关键说明（已内置至脚本，无需手动干预）：

• custom-domain 服务将被自动过滤（否则引发 “Unknown service type” 错误）
• roleArn 将被自动添加
• 使用 --body 传递数据（--spec 无法正确传递深度嵌套的 JSON）

4b. 触发部署

内置限流保护： 脚本最多重试 3 次，每次间隔 60 秒；遇到 404 错误立即终止。请直接运行该脚本，切勿手动调用 deploy-environment。

bash scripts/deploy-environment.sh

步骤 5：轮询部署状态

部署为异步过程 — 需持续轮询直至完成（通常耗时 5–15 分钟）。请直接运行以下脚本：

bash scripts/poll-deploy-status.sh

步骤 6：创建自定义域名

为何需要自定义域名？ FC 触发器 URL（*.fcapp.run）强制返回 Content-Disposition: attachment 响应头，导致浏览器下载 HTML 文件而非渲染页面。必须使用自定义域名（*.devsapp.net）才能使应用正常工作。

必须使用 FC 2.0 API（aliyun fc-open）创建辅助函数： FC 3.0 不支持函数名中包含 $ 字符。fc-open 插件将通过 --auto-plugin-install true 配置自动安装。

请直接运行以下完整脚本（仅需确保已设置 MY_UID 和 PROJECT_NAME 变量）：

bash scripts/create-custom-domain.sh

步骤 7：获取访问 URL（至此停止）

访问 URL 将在步骤 6 脚本末尾自动打印，格式如下：

http://${PROJECT_NAME}-web.fcv3.${MY_UID}.cn-hangzhou.fc.devsapp.net/

至此停止。将步骤 6 输出的访问 URL 提供给用户，由其自行体验应用。请勿代替用户操作应用。

⚠️ 安全提醒 — 展示访问 URL 时必须告知用户： 该 URL 可通过公网直接访问，请勿随意分享给不信任的人。未经授权的访问可能导致：

• 云资源被消耗： 每次访问均会消耗函数计算资源和百炼 API 调用额度，可能产生额外费用。
• 隐私信息泄露： 生成的动画故事、上传的图片等内容可能包含个人或敏感信息。

清理

如需清理已部署资源，请按以下顺序删除（需预先设置 PROJECT_NAME、MY_UID、BUCKET_NAME、API_KEY_ID 变量）：

# 1. 删除 FC 自定义域名
aliyun fc delete-custom-domain --domain-name "${PROJECT_NAME}-web.fcv3.${MY_UID}.cn-hangzhou.fc.devsapp.net" --region cn-hangzhou --user-agent AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

# 2. 删除 Devs 项目（同时删除关联的 FC 函数；--force true 跳过环境资源校验）
aliyun devs delete-project --name "$PROJECT_NAME" --force true --user-agent AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

# 3. 删除 OSS Bucket（先递归删除所有对象，再删除 Bucket）
aliyun oss rm "oss://$BUCKET_NAME" -r -f --region cn-hangzhou --ua AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy
aliyun oss rm "oss://$BUCKET_NAME" -b -f --region cn-hangzhou --ua AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

# 4. 删除 Bailian API Key（API_KEY_ID 在 create-api-key.sh 执行过程中输出）
aliyun modelstudio delete-api-key --api-key-id "$API_KEY_ID" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-tech-solution-animation-creation-auto-deploy

流程收尾

流程执行完毕（或执行完清理操作）后，禁用 AI-Mode：

aliyun configure ai-mode disable

无法通过 CLI/SDK 完成的操作汇总

完整 CLI 命令参考请参阅 references/related-commands.md。

关键限制： 函数计算（FC）首次开通无 CLI/API 支持，用户须在控制台手动开通。

可自动开通： OSS 服务（通过 aliyun ossadmin open-oss-service，已集成于步骤 2）；Bailian 工作区（通过 aliyun modelstudio create-workspace，已集成于步骤 1）。

最佳实践

1. 地域固定为 cn-hangzhou（FC 与 OSS 位于同一地域）
2. DashScope API Key 通过 Devs 模板参数传入，禁止硬编码
3. OSS Bucket 名称包含随机后缀，避免命名冲突
4. 部署完成后记录访问 URL 及已创建的资源

参考链接