カスタムストレージ
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
Capgo はアプリの bundle 向けのカスタムストレージソリューションに対応しており、独自のインフラやサードパーティのストレージサービスでアップデートをホストできます。これは、特定のセキュリティ要件やコンプライアンス、既存のストレージインフラを持つ組織にとって特に有用です。
Capgo のカスタムストレージは、bundle を外部の場所にアップロードし、アクセス用の URL を Capgo に提供することで動作します。これにより、Capgo の SDK は、Capgo のデフォルトのクラウドストレージではなく、カスタムストレージの場所から直接アップデートをダウンロードします。
外部URLからのアップロード
「外部URLアップロード」セクションカスタムストレージを利用する最も簡単な方法は、bundleを公開URLにアップロードし、そのURLをCapgoに渡すことです。
基本的な外部URLアップロード
「基本的な外部URLアップロード」セクションnpx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zipこのコマンドにより、CapgoはbundleをCapgoのクラウドストレージにアップロードする代わりに、指定されたURLのbundleを参照します。
暗号化あり
「暗号化あり」というタイトルのセクション外部ストレージのセキュリティを高めるには、bundleを暗号化し、復号キーを指定できます。
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEYS3 連携
「S3 連携」というタイトルのセクションCapgo は、Amazon S3 および S3 互換ストレージサービスを標準でサポートしています。CLI は、bundle を S3 に自動アップロードし、Capgo が S3 URL を使用するように設定できます。
S3 アップロードオプション
「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-nameS3設定の完了
「S3設定の完了」という見出しのセクション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 SSLS3設定パラメータ
「S3設定パラメータ」という見出しのセクション| パラメータ | 説明 | 必須 |
|---|---|---|
--s3-region | S3バケットのAWSリージョン | はい |
--s3-apikey | S3 アクセスキー ID | はい |
--s3-apisecret | S3 シークレットアクセスキー | はい |
--s3-bucket-name | S3 バケット名 | はい |
--s3-endpoint | カスタム S3 エンドポイント URL | いいえ |
--s3-port | S3 エンドポイントのポート | いいえ |
--no-s3-ssl | S3 アップロードの SSL を無効化 | いいえ |
Bundleの準備と暗号化
「Bundleの準備と暗号化」というセクションカスタムストレージを使う場合、特に暗号化を併用する場合は、Bundleを適切に準備する必要があります。これにはzipファイルの作成と、必要に応じた暗号化が含まれます。
ステップ1: Zip Bundleの作成
「ステップ1: Zip Bundleの作成」というセクションまず、アプリのBundleをzipファイルにまとめます:
npx @capgo/cli@latest bundle zip com.example.app --path ./distzipコマンドを実行すると、zipファイルのチェックサムが返されます。必要に応じて、このチェックサムを使ってzipファイルを暗号化できます。チェックサムを含む構造化出力を取得するには、 --json オプションを使用してください。
zipコマンドのオプション
「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 | zipするフォルダのパス (デフォルトは capacitor.config の webDir) |
--bundle | zipファイル名に使用するBundleのバージョン番号 |
--name | zipファイルのカスタム名 |
--json | 結果をJSON形式で出力 (チェックサムを含む) |
--no-code-check | notifyAppReady() の呼び出しとindexファイルのチェックをスキップ |
--key-v2 | 暗号化 v2 を使用 |
--package-json | モノレポ用の package.json へのパス (カンマ区切り) |
ステップ 2: Bundleの暗号化 (オプション)
セクション「ステップ 2: Bundle の暗号化(任意)」セキュリティを強化するために、アップロード前に zip bundle を暗号化します:
# Using default local keynpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
# Using custom key filenpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2
# Using key data directlynpx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"この CHECKSUM パラメータは必須で、zip ファイルのチェックサムを指定します。チェックサムは zip コマンドの出力から取得できます( --json オプションを構造化出力に使用)。
デフォルトでは、encrypt コマンドはローカルの秘密鍵を使用します。 --key または --key-data オプションも指定可能です。
encrypt コマンドは、アップロードまたは復号に必要となる ivSessionKey キーを返します。
暗号化コマンドのオプション
セクション「暗号化コマンドのオプション」| オプション | 説明 |
|---|---|
zipPath | 暗号化する zip ファイルへのパス(必須) |
checksum | zip ファイルのチェックサム(必須)- zip コマンドから取得 |
--key | 秘密鍵の自定义パス(省略可、デフォルトではローカル鍵を使用) |
--key-data | 秘密鍵データを直接指定(省略可) |
--json | 結果を JSON 形式で出力 |
ワークフローの完全な例
「ワークフローの完全な例」というセクション例1: 暗号化付き外部URL
「例1:暗号化を伴う外部URL」というセクション-
アプリをビルド:
ターミナル npm run build -
zip bundleを作成します:
ターミナル npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3このコマンドが返すチェックサムを記録してください。
-
bundleを暗号化:
ターミナル npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2以下を控えてください:
ivSessionKey出力から。 -
ストレージにアップロード: 暗号化された zip ファイルをホスティングサービスにアップロードします。
-
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への直接アップロード
セクション「例2: S3への直接アップロード」-
アプリをビルド:
ターミナル npm run build -
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
セクション「例3: 暗号化付きS3」-
ビルドしてzip圧縮:
ターミナル npm run buildnpx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2 -
bundleを暗号化:
ターミナル npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM -
暗号化して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またはトークンベースの認証を使用してください
- Webベースのアプリには適切なCORSヘッダーを実装してください
暗号化
「暗号化」セクション- 機密性の高いbundleは常に Capgo の暗号化ツールを使用して暗号化してください
- 暗号化キーは安全に保管し、定期的にローテーションしてください
- すべてのbundle URLにHTTPSを使用してください(モバイルおよびElectronアプリでは必須)
モニタリング
「モニタリング」セクション- アクセスログを監視し、異常なダウンロードパターンを検知してください
- bundleのダウンロード失敗に対するアラートを設定してください
- ストレージの権限を定期的に監査してください
トラブルシューティング
「トラブルシューティング」セクションよくある問題
「よくある問題」セクションBundleがダウンロードできない場合:
- URLが公開されていてHTTPSを使用しているか確認してください(モバイルおよびElectronアプリでは必須)
- Webアプリの場合はCORSヘッダーを確認してください
- Bundleのフォーマットが正しいか確認してください
暗号化エラー:
- 次を確認してください:
ivSessionKey暗号化されたBundleと一致しているか - Bundleが正しいキーで暗号化されているか確認してください
- 新しいbundleにはencryption v2を使用してください
S3のアップロード失敗:
- S3の認証情報と権限を確認してください
- バケットポリシーとCORS設定を確認してください
- 指定したリージョンが正しいか確認してください
デバッグ用コマンド
「デバッグコマンド」セクションbundleのステータスを確認:
npx @capgo/cli@latest app debugbundleの整合性を確認:
npx @capgo/cli@latest bundle list次のステップ
「次のステップ」セクション- 詳しく知る チャンネル 異なるデプロイ環境を管理するには
- 詳しく見る アップデートの動作 アップデートの適用方法をカスタマイズするために
- セットアップ CI/CD 連携 カスタムストレージのワークフローを自動化するために
Custom Storageからの続き
セクション「Custom Storageから続ける」使用している場合 カスタムストレージ セキュリティとコンプライアンスを計画するには、これを以下と連携させてください 暗号化 暗号化の実装詳細について コンプライアンス コンプライアンスの実装詳細について Capgo セキュリティスキャナー Capgo Security Scanner のプロダクトワークフローについて Capgo のセキュリティ Capgo Security のプロダクトワークフロー向け、および Capgo トラストセンター Capgo Trust Center のプロダクトワークフロー向け。