Vega SDKをCIパイプラインに統合する方法

​

前提条件

​

システム要件

​

ホスト構成

• オペレーティングシステム
  • Ubuntu 20.04、22.04、または24.04
    • x86_64
  • Mac OS X
    • arm64（Mシリーズ）またはx86_64（Intel）

​

インストールプロセス

​

基本インストール

1. インストールコマンドを編集して、自動インストールを中断する可能性のあるインストーラープロンプトを無効にします。
   export NONINTERACTIVE=true
   
2. 必要なインストールフラグを構成します。
   # VVDのインストールをスキップします。
   export SKIP_VVD_INSTALL=true
   
   # 特定のSDKバージョンをインストールします。
   export VEGA_SDK_VERSION=0.23.9106
   
   # インストーラースクリプトをダウンロードして実行します。
   curl -fsSL https://sdk-installer.vega.labcollab.net/get_vvm.sh | bash
   

​

環境変数の構成

​

Dockerの統合

​

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.23.9106
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 build . --tag vega-sdk \
  --build-arg VEGA_SDK_VERSION=0.23.9106 \
  --build-arg SKIP_VVD_INSTALL=true

​

ベストプラクティス

​

バージョン管理

• CI設定では、必ずVEGA_SDK_VERSIONを使用して正確なSDKバージョンを指定します。
• 安定性と再現性のあるビルドのために、バージョン固定を使用します。
• リポジトリの変更ログにバージョン更新を記録します。

​

パフォーマンスの最適化

• デバイスエミュレーションが不要な場合はSKIP_VVD_INSTALL=trueを設定してください。これにより、インストールサイズが大幅に削減されます。
• ダウンロードしたアーティファクトにはキャッシュ戦略を使用してください。
• 最終的なイメージサイズを小さく抑えるために、マルチステージのDockerビルドを検討してください。

​

セキュリティ

• 常にHTTPSダウンロードURLを使用してください。
• プライベートnpmレジストリに適切なアクセス制御を実装します。
• CI/CDパイプラインの設定を定期的に監査してください。

​

トラブルシューティング

​

インストール失敗

• SDKリポジトリへのネットワーク接続を確認します。
• SDKのインストールに十分なディスク容量を確保してください。
• 環境変数が正しく設定されていることを確認します。
• インストールページで、ビルドホストに適したプラットフォームを選択したことを確認します。

​

ビルドエラー

• アプリとのSDKバージョンの互換性を確認してください。
• ビルド環境に不足している依存関係がないか確認してください。
• 特定のエラーメッセージについては、ビルドログを確認してください。
• インストール時に正しいプラットフォームが選択されていることを確認します。