Almacenamiento personalizado
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Capgo admite soluciones de almacenamiento personalizadas para tus bundles de la app, lo que te permite alojar tus actualizaciones en tu propia infraestructura o en servicios de almacenamiento de terceros. Esto resulta especialmente útil para organizaciones con requisitos de seguridad específicos, necesidades de cumplimiento o infraestructura de almacenamiento existente.
El almacenamiento personalizado en Capgo funciona subiendo tu bundle a una ubicación externa y proporcionando a Capgo la URL para acceder a él. El Capgo SDK descargará las actualizaciones directamente desde tu ubicación de almacenamiento personalizada en lugar del almacenamiento en la nube predeterminado de Capgo.
Subida desde URL externa
Sección titulada “Subida desde URL externa”La forma más sencilla de usar almacenamiento personalizado es subir tu bundle a cualquier URL de acceso público y pasar esa URL a Capgo.
Subida básica desde URL externa
Sección titulada “Subida básica desde URL externa”npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zipEste comando indica a Capgo que use el bundle de la URL especificada en lugar de subirlo al almacenamiento en la nube de Capgo.
Con cifrado
Sección titulada “Con cifrado”Para un almacenamiento externo seguro, puedes cifrar tu bundle y proporcionar las claves de descifrado:
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEYIntegración con S3
Sección titulada “Integración con S3”Capgo ofrece soporte integrado para Amazon S3 y servicios de almacenamiento compatibles con S3. El CLI puede subir automáticamente tu bundle a S3 y configurar Capgo para que use la URL de S3.
Opciones de subida a S3
Sección titulada “Opciones de subida a 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-nameConfiguración completa de S3
Sección titulada “Configuración completa de S3”Para servicios compatibles con S3 o endpoints personalizados:
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 SSLParámetros de configuración de S3
Sección titulada “Parámetros de configuración de S3”| Parámetro | Descripción | Obligatorio |
|---|---|---|
--s3-region | Región de AWS para tu bucket de S3 | Sí |
--s3-apikey | ID de clave de acceso S3 | Sí |
--s3-apisecret | Clave de acceso secreta S3 | Sí |
--s3-bucket-name | Nombre de tu bucket S3 | Sí |
--s3-endpoint | URL del endpoint S3 personalizado | No |
--s3-port | Puerto para el endpoint S3 | No |
--no-s3-ssl | Desactivar SSL para la subida a S3 | No |
Preparación y cifrado del bundle
Sección titulada “Preparación y cifrado del bundle”Al usar un storage personalizado, especialmente con cifrado, debes preparar tus bundles correctamente. Esto implica crear un archivo zip y, opcionalmente, cifrarlo.
Paso 1: Crear un bundle zip
Sección titulada “Paso 1: Crear un bundle zip”Primero, crea un archivo zip con el bundle de tu app:
npx @capgo/cli@latest bundle zip com.example.app --path ./distEl comando zip devolverá el checksum del archivo zip. Puedes usar este checksum para cifrar el zip si es necesario. Usa la --json opción para obtener una salida estructurada que incluya el checksum.
Opciones del comando zip
Sección titulada “Opciones 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| Opción | Descripción |
|---|---|
--path | Ruta de la carpeta a comprimir (por defecto, webDir de capacitor.config) |
--bundle | Número de versión del bundle para nombrar el archivo zip |
--name | Nombre personalizado para el archivo zip |
--json | Resultados en formato JSON (incluye checksum) |
--no-code-check | Omitir la comprobación de notifyAppReady() y del archivo index |
--key-v2 | Usar cifrado v2 |
--package-json | Rutas a los archivos package.json para monorepos (separadas por comas) |
Paso 2: Cifrar el bundle (opcional)
Sección titulada “Paso 2: Cifrar el bundle (opcional)”Para mejorar la seguridad, cifra tu bundle zip antes de subirlo:
# 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"El CHECKSUM El parámetro es obligatorio y debe ser el checksum de tu archivo zip. Puedes obtener el checksum desde la salida del comando zip (usa --json opción para una salida estructurada).
Por defecto, el comando encrypt usará tu clave privada de firma local. Puedes especificar una clave personalizada usando el --key o --key-data opciones.
El comando encrypt devolverá el ivSessionKey necesarios para la subida o el descifrado.
Opciones del comando de cifrado
Sección titulada “Opciones del comando de cifrado”| Opción | Descripción |
|---|---|
zipPath | Ruta al archivo zip a cifrar (obligatorio) |
checksum | Checksum del archivo zip (obligatorio): obtenlo del comando zip |
--key | Ruta personalizada para la clave de firma privada (opcional, usa la clave local por defecto) |
--key-data | Datos de la clave de firma privada directamente (opcional) |
--json | Mostrar resultados en formato JSON |
Ejemplos de flujo de trabajo completo
Sección titulada “Ejemplos de flujo de trabajo completo”Ejemplo 1: URL externa con cifrado
Sección titulada “Ejemplo 1: URL externa con cifrado”-
Haz el build de tu app:
Ventana de terminal npm run build -
Crea un bundle zip:
Ventana de terminal npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3Anota el checksum que devuelve este comando.
-
Cifra el bundle:
Ventana de terminal npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2Anota el
ivSessionKeyde la salida. -
Sube el archivo a tu storage: Sube el archivo zip cifrado a tu servicio de hosting.
-
Regístrate con Capgo:
Ventana de terminal 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
Ejemplo 2: Subida directa a S3
Sección titulada “Ejemplo 2: Subida directa a S3”-
Haz el build de tu app:
Ventana de terminal npm run build -
Subir directamente a S3:
Ventana de terminal 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
Ejemplo 3: S3 con cifrado
Sección titulada “Ejemplo 3: S3 con cifrado”-
Build y zip:
Ventana de terminal npm run buildnpx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2 -
Cifra el bundle:
Ventana de terminal npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM -
Subir a S3 con cifrado:
Ventana de terminal 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
Consideraciones de seguridad
Sección titulada “Consideraciones de seguridad”Al usar almacenamiento personalizado, considera estas buenas prácticas de seguridad:
Control de acceso
Sección titulada “Control de acceso”- Asegúrate de que las URLs de tu almacenamiento sean accesibles para tus usuarios, pero no se puedan descubrir públicamente.
- Usa URLs firmadas o autenticación por token cuando sea posible
- Implementa los headers CORS adecuados para apps web
Cifrado
Sección titulada “Cifrado”- Encripta siempre los bundles sensibles con las herramientas de cifrado de Capgo
- Almacena las claves de cifrado de forma segura y rotalas periódicamente
- Usa HTTPS para todas las URLs de bundles (obligatorio para apps móviles y de Electron)
Monitoreo
Sección titulada “Monitoreo”- Monitorea los logs de acceso para detectar patrones de descarga inusuales
- Configura alertas para fallos en la descarga de bundles
- Audita regularmente los permisos de tu almacenamiento
Solución de problemas
Sección titulada “Solución de problemas”Problemas comunes
Sección titulada “Problemas comunes”El bundle no se descarga:
- Verifica que la URL sea pública y use HTTPS (requerido para apps móviles y Electron)
- Revisa los headers de CORS para web apps
- Asegúrate de que el formato del bundle sea correcto
Errores de cifrado:
- Verifica el
ivSessionKeycoincide con el bundle cifrado - Comprueba que el bundle se cifró con la clave correcta
- Asegúrate de usar encryption v2 para nuevos bundles
Errores al subir a S3:
- Verifica tus credenciales y permisos de S3
- Revisa las políticas del bucket y la configuración CORS
- Asegúrate de que la región especificada sea correcta
Comandos de debug
Sección titulada “Comandos de depuración”Comprueba el estado del bundle:
npx @capgo/cli@latest app debugVerifica la integridad del bundle:
npx @capgo/cli@latest bundle listPróximos pasos
Sección titulada “Próximos pasos”- Aprende sobre Canales para gestionar distintos entornos de despliegue
- Explorar Comportamiento de actualización para personalizar cómo se aplican las actualizaciones
- Configura Integración CI/CD para automatizar tu workflow de almacenamiento personalizado
Continuar desde Custom Storage
Sección titulada “Continuar desde Custom Storage”Si estás usando Almacenamiento personalizado para planificar la seguridad y el cumplimiento, conéctalo con Cifrado para los detalles de implementación en Cifrado, Cumplimiento para los detalles de implementación en Cumplimiento, Escáner de seguridad de Capgo para el flujo de trabajo del producto en Capgo Security Scanner, Seguridad de Capgo para el flujo de trabajo del producto en Capgo Security, y Centro de confianza de Capgo para el flujo de trabajo del producto en Capgo Trust Center.