Storage personalizzato
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Capgo supporta soluzioni di storage personalizzate per i bundle della tua app, consentendoti di ospitare gli aggiornamenti sulla tua infrastruttura o su servizi di storage di terze parti. Questo è particolarmente utile per le organizzazioni con requisiti di sicurezza specifici, esigenze di conformità o infrastrutture di storage esistenti.
Panoramica
Sezione intitolata “Panoramica”Lo storage personalizzato in Capgo funziona caricando il tuo bundle in una posizione esterna e fornendo a Capgo l'URL per accedervi. Il Capgo SDK scaricherà quindi gli aggiornamenti direttamente dalla tua posizione di storage personalizzata anziché dallo storage cloud predefinito di Capgo.
Upload tramite URL esterno
Sezione intitolata “Upload tramite URL esterno”Il modo più semplice per utilizzare lo storage personalizzato è caricare il bundle su un URL pubblicamente accessibile e fornire tale URL a Capgo.
Upload base tramite URL esterno
Sezione intitolata “Upload base tramite URL esterno”npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zipQuesto comando istruisce Capgo a fare riferimento al bundle all'URL specificato anziché caricarlo nello storage cloud di Capgo.
Con crittografia
Sezione intitolata “Con crittografia”Per uno storage esterno sicuro, puoi crittografare il bundle e fornire le chiavi di decrittazione:
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEYIntegrazione S3
Sezione intitolata “Integrazione S3”Capgo offre supporto integrato per Amazon S3 e servizi di storage compatibili con S3. CLI può caricare automaticamente il tuo bundle su S3 e configurare Capgo per utilizzare l'URL S3.
Opzioni di upload S3
Sezione intitolata “Opzioni di caricamento 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-nameConfigurazione S3 completa
Sezione intitolata “Configurazione S3 completa”Per servizi compatibili con S3 o endpoint personalizzati:
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 SSLParametri di configurazione S3
Sezione intitolata “Parametri di configurazione S3”| Parametro | Descrizione | Obbligatorio |
|---|---|---|
--s3-region | Regione AWS per il tuo bucket S3 | Sì |
--s3-apikey | ID chiave di accesso S3 | Sì |
--s3-apisecret | Chiave di accesso segreta S3 | Sì |
--s3-bucket-name | Nome del tuo bucket S3 | Sì |
--s3-endpoint | URL endpoint S3 personalizzato | No |
--s3-port | Porta per l'endpoint S3 | No |
--no-s3-ssl | Disabilita SSL per l'upload su S3 | No |
Preparazione e crittografia del bundle
Sezione intitolata “Preparazione e crittografia del bundle”Quando usi lo storage personalizzato, soprattutto con crittografia, devi preparare i bundle correttamente. Questo richiede di creare un file zip e, facoltativamente, di crittificarlo.
Passo 1: Crea un bundle Zip
Sezione intitolata “Passo 1: Creare un bundle zip”Innanzitutto, crea un file zip del bundle della tua app:
npx @capgo/cli@latest bundle zip com.example.app --path ./distIl comando zip restituirà il checksum del file zip. Puoi usare questo checksum per crittografare il file zip se necessario. Usa l'opzione --json per ottenere un output strutturato che includa il checksum.
Opzioni del comando Zip
Sezione intitolata “Opzioni del comando 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| Opzione | Descrizione |
|---|---|
--path | Percorso della cartella da comprimere (predefinito: webDir da capacitor.config) |
--bundle | Numero di versione del bundle per nominare lo zip |
--name | Nome personalizzato per il file zip |
--json | Output dei risultati in formato JSON (include checksum) |
--no-code-check | Ignora il controllo della chiamata notifyAppReady() e del file index |
--key-v2 | Usa la crittografia v2 |
--package-json | Percorsi dei file package.json per monorepo (separati da virgola) |
Passo 2: Crittografa il bundle (facoltativo)
Sezione intitolata “Passo 2: Crittografa il bundle (opzionale)”Per una maggiore sicurezza, crittografa il bundle zip prima dell'upload:
# 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"Il CHECKSUM Il parametro è obbligatorio e deve essere il checksum del tuo file zip. Puoi ottenere il checksum dall'output del comando zip (usa --json opzione per un output strutturato).
Di default, il comando encrypt utilizza la tua chiave di firma privata locale. Puoi specificare una chiave personalizzata usando le --key oppure --key-data opzioni.
Il comando encrypt restituirà il ivSessionKey necessario per l'upload o la decrittazione.
Opzioni del comando di crittografia
Sezione intitolata “Opzioni del comando di crittografia”| Opzione | Descrizione |
|---|---|
zipPath | Percorso del file zip da crittografare (obbligatorio) |
checksum | Checksum del file zip (obbligatorio) - ottienilo dal comando zip |
--key | Percorso personalizzato per la chiave di firma privata (opzionale, usa la chiave locale di default) |
--key-data | Dati della chiave di firma privata direttamente (facoltativo) |
--json | Output dei risultati in formato JSON |
Esempi di workflow completi
Sezione intitolata “Esempi di workflow completi”Esempio 1: URL esterno con crittografia
Sezione intitolata “Esempio 1: URL esterno con crittografia”-
Esegui il build della tua app:
Finestra del terminale npm run build -
Crea un bundle zip:
Finestra del terminale npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3Annota il checksum restituito da questo comando.
-
Crittografa il bundle:
Finestra del terminale npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2Annota il
ivSessionKeydall'output. -
Upload sul tuo storage: Carica il file zip crittografato sul tuo servizio di hosting.
-
Registra con Capgo:
Finestra del terminale 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
Esempio 2: Upload diretto su S3
Sezione intitolata “Esempio 2: Upload diretto su S3”-
Esegui il build della tua app:
Finestra del terminale npm run build -
Upload diretto su S3:
Finestra del terminale 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
Esempio 3: S3 con crittografia
Sezione intitolata “Esempio 3: S3 con crittografia”-
Build e zip:
Finestra del terminale npm run buildnpx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2 -
Crittografa il bundle:
Finestra del terminale npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM -
Upload su S3 con crittografia:
Finestra del terminale 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
Considerazioni sulla sicurezza
Sezione intitolata “Considerazioni sulla sicurezza”Quando si utilizza un archiviazione personalizzata, considera queste best practice di sicurezza:
Controllo degli accessi
Sezione intitolata “Controllo degli accessi”- Assicurati che gli URL di storage siano accessibili agli utenti della tua app ma non pubblicamente individuabili
- Usa URL firmati o autenticazione basata su token quando possibile
- Implementa le intestazioni CORS corrette per le app web
Crittografia
Sezione intitolata “Crittografia”- Crittografa sempre i bundle sensibili utilizzando gli strumenti di crittografia di Capgo
- Conserva le chiavi di crittografia in modo sicuro e ruotalle regolarmente
- Usa HTTPS per tutti gli URL dei bundle (obbligatorio per app mobile ed Electron)
Monitoraggio
Sezione intitolata “Monitoraggio”- Monitora i log di accesso per rilevare pattern di download insoliti
- Configura avvisi per i download di bundle non riusciti
- Esegui regolarmente un audit dei permessi di storage
Risoluzione problemi
Sezione intitolata “Troubleshooting”Problemi comuni
Sezione intitolata “Problemi comuni”Il bundle non viene scaricato:
- Verifica che l'URL sia accessibile pubblicamente e utilizzi HTTPS (obbligatorio per app mobile ed Electron)
- Controlla le intestazioni CORS per le app web
- Assicurati che il formato del bundle sia corretto
Errori di crittografia:
- Verifica il
ivSessionKeycorrisponde al bundle crittografato - Verifica che il bundle sia stato crittografato con la chiave corretta
- Assicurati di usare encryption v2 per i nuovi bundle
Errori di upload su S3:
- Verifica le credenziali e i permessi S3
- Controlla le policy del bucket e la configurazione CORS
- Assicurati che la regione specificata sia corretta
Comandi di debug
Sezione intitolata “Comandi di debug”Verifica lo stato del bundle:
npx @capgo/cli@latest app debugVerifica l'integrità del bundle:
npx @capgo/cli@latest bundle listProssimi passi
Sezione intitolata “Prossimi passi”- Scopri Canali per gestire diversi ambienti di deployment
- Esplora Comportamento degli aggiornamenti per personalizzare come vengono applicati gli update
- Configurazione Integrazione CI/CD per automatizzare il tuo workflow di storage personalizzato
Continua da Custom Storage
Sezione intitolata “Continua da Custom Storage”Se stai usando Storage personalizzato per pianificare sicurezza e compliance, collegalo a Crittografia per i dettagli di implementazione della crittografia, Conformità per i dettagli di implementazione in Compliance, Security Scanner di Capgo per il workflow del prodotto in Capgo Security Scanner, Sicurezza Capgo per il workflow del prodotto in Capgo Security, e Trust Center di Capgo per il workflow del prodotto in Capgo Trust Center.