将Vega SDK集成到CI管道中

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

本页面介绍如何将Vega SDK集成到持续集成 (CI) 管道中，包括自动安装过程和配置要求。

构建主机是指CI管道中用于构建Vega应用的计算机（虚拟机或物理机）。Vega SDK可在安装说明页面上提供安装命令，该命令能以非交互式的方式运行，无需用户输入，便于在构建主机上自动安装SDK。

先决条件

在将Vega SDK集成到CI管道中之前，请确保您的构建环境满足以下要求。请特别注意为构建主机选择正确的平台，因为选择错误的平台可能会导致安装或运行时错误。

系统要求

主机配置

操作系统
- Ubuntu 20.04或以上
  - x86_64
- Mac OS X
  - arm64（M系列）或x86_64 (Intel)

安装过程

在CI环境中安装Vega SDK时，需要特别注意。与经常进行交互式安装的开发者工作站不同，CI环境需要使用全自动的方法。以下部分将指导您完成此过程。

基本安装

编辑安装命令以禁用可能中断自动安装的安装程序提示。
```
export NONINTERACTIVE=true
```

配置所需的安装标记。

# 跳过VVD安装。
export SKIP_VVD_INSTALL=true

# 安装特定的SDK版本。
export VEGA_SDK_VERSION=0.21.5245

# 下载并运行安装程序脚本。
curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash

有关其他配置选项，请参阅以下部分。

环境变量配置

使用以下环境变量控制安装程序脚本。

变量	默认值	描述
`NONINTERACTIVE`	FALSE	跳过所有提示并自动运行。
`VEGA_SDK_VERSION`	（最新）	安装特定的SDK版本（例如，0.21.5245）
`SKIP_SDK_INSTALL`	FALSE	完全跳过SDK安装。
`SKIP_VVD_INSTALL`	FALSE	在SDK设置期间跳过VVD安装。

Docker集成

Docker为使用Vega SDK构建应用提供了统一且隔离的环境。以下示例演示如何创建包含所有必要依赖项和配置的构建环境。这种方法适用于各种支持基于容器进行构建的CI解决方案。

示例Dockerfile

已复制到剪贴板。

FROM --platform=linux/amd64 ubuntu:22.04

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y \
    curl tar jq ca-certificates \
    && rm -rf /var/lib/apt/lists/*

ENV NONINTERACTIVE=true

# SDK配置
ARG VEGA_SDK_VERSION=0.21.5245
ARG SKIP_SDK_INSTALL=false

ENV VEGA_SDK_VERSION=${VEGA_SDK_VERSION}
ENV SKIP_SDK_INSTALL=${SKIP_SDK_INSTALL}

RUN curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash

ENV PATH="/root/vega/bin:${PATH}"

RUN vega -v

CMD ["/bin/bash"]

有关更多信息，请参阅管理您的SDK版本。

Last updated: 2026年1月6日