カスタム ストレージ

Capgoは、独自のストレージ ソリューションをサポートすることで、Capgoアプリ バンドルをアップデートするのに役立ちます。Capgoをホストするには、独自のインフラストラクチャまたは第三者ストレージ サービスを使用できます。この機能は、特定のセキュリティ要件、法的要件、または既存のストレージ インフラストラクチャを持つ組織にとって特に便利です。

概要

Capgoのカスタム ストレージは、CapgoにアップロードしたバンドルのURLを提供することで機能します。Capgo SDKは、Capgoのデフォルトのクラウド ストレージではなく、カスタム ストレージの場所からアップデートを直接ダウンロードします。

ヒント

カスタム ストレージは、以下の組織にとって適しています。

• 厳格なデータ居住地要件を持つ組織
• 既存のCDNまたはストレージインフラを持つチーム
• 追加のセキュリティ層が必要なアプリケーション
• 大きなバンドルサイズに対するコスト最適化

外部URLアップロード

Capgoに公開アクセス可能なURLにバンドルをアップロードし、そのURLをCapgoに提供することで、カスタムストレージを簡単に使用できます。

基本的な外部URLアップロード

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

Capgoのクラウドストレージにアップロードするのではなく、指定されたURLにバンドルを参照するようにCapgoに指示するコマンドです。

暗号化付き

安全な外部ストレージのために、バンドルを暗号化し、復号化キーを提供できます。

npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

S3統合

CapgoはAmazon S3とS3互換ストレージサービスに対応しています。CLIはS3にバンドルを自動的にアップロードし、CapgoをS3 URLで設定します。

S3アップロード設定

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-bucket-name your-bucket-name

__CAPGO_KEEP_0__ provides built-in support for Amazon S3 and S3-compatible storage services.

S3互換サービスまたはカスタムエンドポイントの場合:

npx @capgo/cli@latest bundle upload \
  --s3-region us-east-1 \
  --s3-apikey YOUR_ACCESS_KEY \
  --s3-apisecret YOUR_SECRET_KEY \
  --s3-endpoint https://s3.your-provider.com \
  --s3-bucket-name your-bucket-name \
  --s3-port 443 \
  --no-s3-ssl  # Only if your endpoint doesn't support SSL

S3の設定パラメータ

パラメータ	説明	必須
--s3-region	S3バケットのAWSリージョン	はい
--s3-apikey	S3アクセスキーID	はい
--s3-apisecret	__CAPGO_KEEP_0__	はい
--s3-bucket-name	__CAPGO_KEEP_1__	はい
--s3-endpoint	__CAPGO_KEEP_2__	いいえ
--s3-port	__CAPGO_KEEP_3__	いいえ
--no-s3-ssl	__CAPGO_KEEP_4__	いいえ

__CAPGO_KEEP_5__

カスタムストレージを使用する場合、特に暗号化を使用する場合、バンドルを適切に準備する必要があります。これには、zipファイルを作成し、必要に応じて暗号化することが含まれます。

Step 1: Zip Bundleを作成する

最初に、zipファイルを作成してアプリケーションバンドルを圧縮してください。

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

zipコマンドはzipファイルのチェックサムを返します。このチェックサムを使用してzipファイルを暗号化する必要がある場合があります。 --json オプションを使用して、チェックサムを含む構造化された出力を受け取ることができます。

Zipコマンドのオプション

npx @capgo/cli@latest bundle zip [appId] \
  --path ./dist \
  --bundle 1.2.3 \
  --name myapp-v1.2.3 \
  --json \
  --no-code-check \
  --key-v2 \
  --package-json ../../package.json,./package.json

オプション	説明
--path	capacitor.configのwebDirからデフォルトでフォルダをzipします
--bundle	バンドルバージョン番号をzipファイルの名前として使用
--name	カスタムのzipファイル名
--json	JSON形式で結果を出力（チェックサムを含む）
--no-code-check	notifyAppReady()の呼び出しとindexファイルのチェックをスキップ
--key-v2	暗号化v2を使用
--package-json	モノレポ用のpackage.jsonファイルのパス（カンマ区切り）

ステップ2：バンドルを暗号化（オプション）

アップロードする前に、zip バンドルを暗号化してください。

# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2

# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

The CHECKSUM パラメータは必須で、zip ファイルのチェックサムになります。zip コマンドの出力からチェックサムを取得できます ( --json オプションを使用して構造化された出力)。

デフォルトでは、暗号化コマンドはローカルプライベート署名キーを使用します。カスタムキーを指定するには --key オプションを使用します。 --key-data 暗号化コマンドはアップロードまたは復号化に必要な

を返します。 ivSessionKey 暗号化コマンドのオプション

__CAPGO_KEEP_0__

オプション	説明
zipPath	__CAPGO_KEEP_0__ (必須)
checksum	__CAPGO_KEEP_1__ (必須) - zip コマンドから取得
--key	__CAPGO_KEEP_2__ (省略可、ローカルキーを使用)
--key-data	__CAPGO_KEEP_3__ (省略可)
--json	JSON形式で出力

注意

暗号化コマンドは ivSessionKey を出力します。これはアップロード時に必要になります。 --iv-session-key option。

ワークフロー例

例 1:暗号化された外部 URL

1. アプリをビルドしてください：

   npm run build

2. zip バンドルを作成してください：

   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3

   このコマンドによって返されるチェックサムをご注意ください。

3. ファイルを暗号化:

   npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2

   注目する ivSessionKey 出力から

4. アップロードする: ホスティングサービスに暗号化したzipファイルをアップロードする。

5. 「Capgo」に登録する

   npx @capgo/cli@latest bundle upload \
     --external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_3

例2：S3への直接アップロード

1. アプリを構築:

   npm run build

2. 暗号化なしでS3にアップロード:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --channel Production

例3：S3に暗号化

1. ビルドしてzip:

   npm run build
   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

2. バンドルを暗号化:

   npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM

3. 暗号化を含むS3にアップロード:

   npx @capgo/cli@latest bundle upload \
     --s3-region us-west-2 \
     --s3-apikey YOUR_ACCESS_KEY \
     --s3-apisecret YOUR_SECRET_KEY \
     --s3-bucket-name your-app-bundles \
     --iv-session-key IV_SESSION_KEY_FROM_STEP_2 \
     --channel Production

セキュリティに関する考慮事項

カスタムストレージを使用する場合、以下のセキュリティベストプラクティスを考慮してください。

アクセス制御

• カスタムストレージのURLはアプリユーザーにアクセス可能ですが、一般に公開されないようにする
• 可能な場合は署名付きURLまたはトークンベースの認証を使用する
• ウェブベースのアプリケーション向けに適切なCORSヘッダーを実装する

暗号化

• 敏感なバンドルを常にCapgo暗号化ツールを使用して暗号化する
• 暗号化キーを安全に保存し、定期的に回転する
• モバイルおよびElectronアプリケーション向けにはすべてのバンドルURLにHTTPSを使用する (必須)

監視

• アクセスログを監視して異常なダウンロードパターンを検出する
• バンドルダウンロードに失敗したときにアラートを設定する
• ストレージパーミッションを定期的に検査する

トラブルシューティング

よくある問題

バンドルがダウンロードされない:

• URLがパブリックにアクセス可能であり、HTTPSを使用していることを確認してください (モバイルおよびElectronアプリ用に必須)
• ウェブアプリ用のCORSヘッダーを確認してください
• バンドルのフォーマットが正しいことを確認してください

暗号化エラー:

• 暗号化されたバンドルと一致していることを確認してください ivSessionKey 正しい鍵で暗号化されたバンドルが使用されていることを確認してください
• 新しいバンドル用に暗号化v2を使用していることを確認してください
• __CAPGO_KEEP_0__

__CAPGO_KEEP_0__

• S3接続のエラーが発生しています。確認してください。
• S3のクレデンシャルと権限を確認してください。
• バケットポリシーとCORS設定を確認してください。

指定されたリージョンが正しいことを確認してください。

「デバッグ コマンド」

npx @capgo/cli@latest app debug

コピー

npx @capgo/cli@latest bundle list

次のステップ

• 学習 チャンネル 異なるデプロイ環境を管理する
• 探索 更新の適用方法をカスタマイズする 設定
• CI/CD統合 カスタムストレージワークフローを自動化する ページを編集