Vega SDKをCIパイプラインに統合する方法
このページでは、Vega SDKを継続的インテグレーション（CI）パイプラインに統合する方法について、自動インストールプロセスや構成要件などを含めて説明します。
ビルドホストは、CIパイプラインの一部としてVegaアプリをビルドする仮想マシンや物理マシンです。Vega SDKでは、ビルドホスト上での自動SDKインストールを容易にするために、ユーザー入力を必要としない非インタラクティブで実行できるインストールコマンドが、インストール手順ページに用意されています。
前提条件
Vega SDKをCIパイプラインに統合する前に、ビルド環境が以下の要件を満たしていることを確認してください。ビルドホストに適切なプラットフォームを選択するよう特に注意してください。間違ったプラットフォームを選択すると、インストールエラーやランタイムエラーが発生する可能性があります。
システム要件
ホスト構成
- オペレーティングシステム
- Ubuntu 20.04、22.04、24.04
- x86_64
- Mac OS X
- arm64（Mシリーズ）またはx86_64（Intel）
- Ubuntu 20.04、22.04、24.04
インストールプロセス
Vega SDKをCI環境に実装する場合、インストールプロセスで特に注意が必要です。開発者ワークステーションではインタラクティブなインストールが一般的ですが、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 | すべてのプロンプトをスキップして自動的に実行します。CI/CDには必須です。 |
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
SHELL ["/bin/bash", "-c"]
ENV DEBIAN_FRONTEND=noninteractive
# cURLとユーティリティをインストールしてインストーラーを取得します。
RUN apt-get update && \
apt-get install -y curl tar jq ca-certificates --no-install-recommends && \
rm -rf /var/lib/apt/lists/*
# Vega SDKをインストールします。
ENV NONINTERACTIVE=true
ARG VEGA_SDK_VERSION=0.21.5245
ARG SKIP_VVD_INSTALL=true
ENV VEGA_SDK_VERSION=${VEGA_SDK_VERSION}
ENV SKIP_VVD_INSTALL=${SKIP_VVD_INSTALL}
RUN curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash
ENV PATH="/root/vega/bin:${PATH}"
# vegaコマンドが使用可能であることを確認します。
RUN vega -v
# React NativeアプリにはNode.jsとnpmが必要です。
RUN apt-get update && apt-get install -y nodejs npm --no-install-recommends && rm -rf /var/lib/apt/lists/*
# グローバルnpm設定パスを指定し、npmrc設定をその場所にバインドマウントします。
ENV NPM_CONFIG_GLOBALCONFIG="/etc/npmrc"
# nodeコマンドとnpmコマンドが使用可能であることを確認します。
RUN node -v && npm -v
ENTRYPOINT [ "/bin/bash", "-c" ]
Dockerイメージを構築するには、次のコマンドを実行します。SDKのインストールページで必要なSDKバージョンを見つけ、開発マシンではなく、CIビルドホストのプラットフォームを選択してください。
docker build . --tag vega-sdk \
--build-arg VEGA_SDK_VERSION=0.21.5245 \
--build-arg SKIP_VVD_INSTALL=true
ベストプラクティス
バージョン管理
- CI設定では、必ず
VEGA_SDK_VERSIONを使用して正確なSDKバージョンを指定します。 - 安定性と再現性のあるビルドのために、バージョン固定を使用します。
- リポジトリの変更ログにバージョン更新を記録します。
パフォーマンスの最適化
- デバイスエミュレーションが不要な場合は
SKIP_VVD_INSTALL=trueを設定します。これにより、インストールサイズが大幅に削減されます。 - ダウンロードしたアーティファクトにはキャッシュ戦略を使用します。
- 最終的なイメージサイズを小さく抑えるために、マルチステージのDockerビルドを検討します。
セキュリティ
- 常にHTTPSダウンロードURLを使用します。
- プライベートnpmレジストリに適切なアクセス制御を実装します。
- CI/CDパイプラインの設定を定期的に監査します。
トラブルシューティング
インストール失敗
- SDKリポジトリへのネットワーク接続を確認します。
- SDKのインストールに十分なディスク容量を確保します。
- 環境変数が正しく設定されていることを確認します。
- インストールページで、ビルドホストに適したプラットフォームを選択したことを確認します。
ビルドエラー
- SDKバージョンがアプリと互換性があることを確認します。
- ビルド環境に不足している依存関係がないか確認します。
- 特定のエラーメッセージについては、ビルドログを確認します。
- インストール時に正しいプラットフォームが選択されていることを確認します。
詳細については、SDKバージョンの管理を参照してください。
Last updated: 2026年3月16日
