Amazon Developer

Console

as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
AWS
ドキュメント
Support
Contact Us
My Cases

Console

as

開発
設計と開発
公開
リファレンス
サポート

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

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

このページでは、Vega SDKを継続的インテグレーション（CI）パイプラインに統合する方法について、自動インストールプロセスや構成要件などを含めて説明します。

ビルドホストは、継続的インテグレーション（CI）パイプラインの一部としてVegaアプリをビルドする仮想マシンや物理マシンです。Vega SDKでは、ビルドホスト上での自動SDKインストールを容易にするために、ユーザー入力を必要としない非インタラクティブで実行できるインストールコマンドが、インストール手順ページに用意されています。インストールページでは、ビルドホストに適したオペレーティングシステムとアーキテクチャを選択する必要があります。たとえば、ビルドホストがUbuntu 22.04を実行している場合、[Operating System] ドロップダウンから [Linux (x86_64)] を選択します。生成されたコマンドは、ビルドホストで実行できます。

さらに、Amazonのプライベートnpmレジストリを使用してVega npmパッケージをダウンロードするように、ビルドホストのnpmクライアントを構成する必要があります。

一貫性のある高品質なソフトウェアリリースを維持するには、ビルドとデプロイのプロセスを自動化することが不可欠です。Vega SDKをCIパイプラインに統合することで、開発ワークフローを大幅に効率化できます。このガイドでは、プロセス、要件、重要な考慮事項について説明します。

前提条件

Vega SDKをCIパイプラインに統合する前に、ビルド環境が以下の要件を満たしていることを確認してください。ビルドホストに適切なプラットフォームを選択するよう特に注意してください。間違ったプラットフォームを選択すると、インストールエラーやランタイムエラーが発生する可能性があります。

システム要件

ホスト構成

  • オペレーティングシステム
    • Ubuntu 20.04以降
      • x86_64
    • Mac OS X
      • arm64またはx86_64

ユーザー要件

Vega OSの0.20.3106より前のバージョン

* ビルドホスト/CI環境の非rootユーザーアカウント
    * すべてのインストール方法で必須です
    * CI/CDを直接インストールする場合は、ビルドプロセスを非rootで実行します

Vega OSの0.20.3106以降のバージョン

* 非rootユーザーアカウントの要件はなくなりました
* CI環境では「NONINTERACTIVE=true」に設定します

インストールプロセス

Vega SDKをCI環境に実装する場合、インストールプロセスで特に注意が必要です。開発者ワークステーションではインタラクティブなインストールが一般的ですが、CI環境では完全に自動化されたアプローチが必要です。以下のセクションでは、これらの手順について説明します。

基本インストール

  1. インストールページから、ビルドホストに適切なOSとアーキテクチャを選択します
  2. 提供されているインストールコマンドを非インタラクティブモードで使用します

非rootユーザーの要件

注： 0.20.3106より前のバージョンのSDKでは、インストーラースクリプトを非rootのユーザーが実行する必要があります。

環境変数の構成

次の環境変数を使用してインストーラースクリプトを制御します。

変数名 有効な値 デフォルト 説明  
DELETE_DOWNLOADS true false "true" ダウンロードしたSDK/シミュレーターファイルの削除を制御する
DOWNLOAD_DIR 有効なパス $HOME/Downloads SDK/シミュレーターのダウンロード場所  
DIRECTED_ID 文字列 - 匿名化されたカスタマーID  
INSECURE_DOWNLOADS true false "false" 安全ではないcurlダウンロードを有効にする
INSTALL_ROOT_DIR 有効なパス $HOME/kepler/sdk SDKインストールのベースディレクトリ  
LOG_ENABLED true false "true" ファイルロギングを有効にする
LOG_FILE 有効なパス $HOME/.kepler/logs/kepler-YYYY-MM-DD.log ログファイルの場所  
NONINTERACTIVE true false "false" 非インタラクティブなインストールを有効にする
OPT_IN true false "false" 使用状況メトリクスの収集を有効にする
VERBOSE true false - 詳細な出力を有効にします
OVERWRITE_PREVIOUS true false 場合によって異なる 既存のインストールの上書きを制御する
SDK_URL URL なし 必須。 SDKのダウンロードURL  
SIM_URL URL なし オプション： シミュレーターのダウンロードURL  
VERSION 文字列 なし SDKのバージョン番号  

インストールディレクトリの構成

*# デフォルトのインストールパス：$HOME/kepler/sdk/$VERSION*
*# カスタムインストールの例：*
curl -fsSL <スクリプトURL> | INSTALL_ROOT_DIR=/opt/kepler /bin/bash --version <バージョン> --sdk-url <SDKのURL>

重要な考慮事項

環境変数：

インストール後、SDKツールを見つけることができるように環境を構成する必要があります。

KEPLER_SDK_PATHの設定

export KEPLER_SDK_PATH="/path/to/kepler/sdk/version"

システムパスへの追加

export PATH="/path/to/kepler/sdk/version/bin:$PATH"

例

SDKが/home/user/kepler/sdk/0.20.3106にインストールされている場合、以下のように設定します。

export KEPLER_SDK_PATH="/home/user/kepler/sdk/0.20.3106"
export PATH="/home/user/kepler/sdk/0.20.3106/bin:$PATH"

検証： 次のコマンドを実行して、正しく設定されていることを確認します。

クリップボードにコピーしました。

kepler -v

VVDイメージのインストール（任意）

バージョン0.20.3106以降では、SDKインストールの実効サイズを削減するため、Vega仮想デバイス（VVD）イメージのインストールは任意になりました。

  • --sim-urlフラグを削除すると、VVDイメージのダウンロードとインストールがスキップされます
  • これにより、CI環境でのインストールフットプリントを大幅に削減できます。

VS Codeプラグインに関する注意事項

CI環境では、VS Codeプラグインのインストールエラーは無視しても問題ありません。

テレメトリ構成

# OPT_IN環境変数を使用してテレメトリを有効にする
curl -fssL <スクリプトURL> | OPT_IN=true /bin/bash --version <バージョン> --sdk-url <URL>

Dockerの統合

Dockerは、Vega SDKを使用してアプリケーションを構築するための一貫性のある分離環境を提供します。次の例は、必要なすべての依存関係と構成を含むビルド環境を作成する方法を示しています。このアプローチは、コンテナベースのビルドをサポートするさまざまなCIソリューションに適用できます。

Dockerfileの例

クリップボードにコピーしました。

FROM ubuntu:22.04

SHELL ["/bin/bash", "-c"]

# インストーラーを取得するにはcURLが必要です。
RUN apt-get update && \
    apt-get install curl ca-certificates --no-install-recommends -y && \
    rm -rf /var/lib/apt/lists/*

# Vega SDKのインストール
ARG INSTALLER_SCRIPT
ARG SDK_VERSION
ARG SDK_URL
ARG SDK_ROOT=/kepler
ARG SIM_URL
RUN test -n "$INSTALLER_SCRIPT" || (echo "INSTALLER_SCRIPT not set" && false)
RUN test -n "$SDK_VERSION" || (echo "SDK_VERSION not set" && false)
RUN test -n "$SDK_URL" || (echo "SDK_URL not set" && false)
RUN curl ${INSTALLER_SCRIPT} | NONINTERACTIVE=true INSTALL_ROOT_DIR=${SDK_ROOT} bash -s -- \
    --sdk-url=${SDK_URL} \
    --sim-url=${SIM_URL} \
    --version=${SDK_VERSION}
## 必要な環境変数のセットアップ
## このスクリプトでは$SDK_ROOT/sdk/$SDK_VERSIONにインストールされます
## $SDK_ROOTが設定されていない場合は、デフォルトで/keplerに設定されます
ENV KEPLER_SDK_PATH="$SDK_ROOT/$SDK_VERSION"
ENV PATH="$KEPLER_SDK_PATH/bin:$PATH"
## keplerコマンドが使用可能であることを確認します
RUN kepler -v

# React Nativeアプリを構築する場合は、NodeJSとNPMが必要です
RUN curl -sL https://deb.nodesource.com/setup_lts.x | bash -
RUN apt-get update && apt-get install -y nodejs
RUN npm install -g npm

## グローバルなnpm構成パスを/etc/npmrcに設定します
## npmrc設定をこの場所にバインドマウントします
ENV NPM_CONFIG_GLOBALCONFIG="/etc/npmrc"
## nodeコマンドとnpmコマンドが使用可能であることを確認します
RUN node -v && npm -v

ENTRYPOINT [ "/bin/bash", "-c" ]

Dockerビルドの例

docker build . --tag ksdk \
--build-arg INSTALLER_SCRIPT=<url_to_installer_script> \
--build-arg SDK_URL=<url_to_sdk> \
--build-arg SIM_URL=<url_to_simulator> \
--build-arg SDK_VERSION=0.20.3106 \
--build-arg SDK_ROOT=/tmp/kepler

Last updated: 2025年9月30日

フォローする

サポート対象デバイス

amazon_developer_logo

© 2010-2025, Amazon.com, Inc. or its affiliates. All Rights Reserved. 無断複写·転載を禁じます。

利用規約

Amazon開発者ブログ

お問い合わせ