Marketplace Cibest

Marketplace Cibest es una extensión pública de VS Code para descubrir, revisar e instalar extensiones internas publicadas como archivos VSIX en Artifactory, sin depender de la publicación de extensiones en el marketplace de VS Code.

Para qué sirve

• Tener un catálogo privado de extensiones dentro de VS Code.
• Ver rápidamente qué extensiones hay disponibles para tu plataforma.
• Instalar o actualizar una extensión sin salir del editor.
• Revisar el README y el CHANGELOG de cada paquete antes de instalar.
• Detectar actualizaciones al iniciar VS Code si esa opción está activa.

Uso rápido

1. Configura marketplaceCibest.sourceBaseUrl con la raíz de Artifactory.
2. Registra en marketplaceCibest.sourceRepositories los repositorios a consultar.
3. Abre el comando Marketplace Cibest: Open Settings si quieres validar o ajustar la configuración desde VS Code.
4. Abre el comando Marketplace Cibest: Open Private Extension Catalog.
5. Revisa la extensión que necesitas y valida si hay versión nueva o si ya la tienes instalada.
6. Instala, actualiza o desinstala desde el mismo catálogo.
7. Si quieres confirmar cambios antes de instalar, abre el README o el CHANGELOG del paquete.

Flujo de uso diario

Instalar una extensión privada

1. Abre el catálogo.
2. Busca la extensión en la lista.
3. Revisa la versión disponible para tu runtime.
4. Pulsa Install latest o Install version.
5. Si VS Code lo pide, usa Reload Window para activar el cambio.

Actualizar una extensión que ya tienes

1. Abre el catálogo.
2. Identifica las extensiones marcadas con update disponible.
3. Revisa cambios desde Changelog si lo necesitas.
4. Pulsa Update to latest.
5. Recarga la ventana si VS Code lo solicita.

Instalar desde un VSIX descargado manualmente

1. Descarga el archivo .vsix desde Artifactory.
2. Ejecuta Marketplace Cibest: Install Downloaded VSIX.
3. Selecciona el archivo.
4. Confirma la recarga de la ventana si aparece.

Qué vas a ver en la extensión

• Un ícono propio en el Activity Bar.
• Una vista Extensions con acceso al catálogo privado.
• Una vista Copilot reservada para futuras capacidades del proyecto.
• Un panel donde puedes ver versiones, detalle, changelog y acciones de instalación.

Comandos disponibles

• Marketplace Cibest: Open Settings
• Marketplace Cibest: Open Private Extension Catalog
• Marketplace Cibest: Refresh Private Extension Catalog
• Marketplace Cibest: Open Artifactory for Current Platform
• Marketplace Cibest: Open Artifactory for Windows
• Marketplace Cibest: Open Artifactory for Linux
• Marketplace Cibest: Open Artifactory for macOS
• Marketplace Cibest: Install Downloaded VSIX

Configuración

La configuración mínima recomendada es esta:

{
	"marketplaceCibest.sourceBaseUrl": "https://artifactory.apps.company.com/artifactory/",
	"marketplaceCibest.sourceRepositories": [
		"company_extension_1_vscode"
	],
	"marketplaceCibest.requestTimeoutMs": 15000,
	"marketplaceCibest.catalogCacheTtlMinutes": 15,
	"marketplaceCibest.enableStartupUpdateCheck": true
}

Qué significa cada ajuste

• marketplaceCibest.sourceBaseUrl: raíz de Artifactory.
• marketplaceCibest.sourceRepositories: lista de repositorios dentro de Artifactory. La extensión arma automáticamente las rutas <base>/<repo>/windows, <base>/<repo>/linux y <base>/<repo>/macos.
• marketplaceCibest.requestTimeoutMs: tiempo máximo de espera para consultar Artifactory.
• marketplaceCibest.catalogCacheTtlMinutes: tiempo que se reutiliza el catálogo antes de volver a consultar.
• marketplaceCibest.enableStartupUpdateCheck: avisa al abrir VS Code si encuentra nuevas versiones.

Recomendaciones de uso

• Usa rutas raw de Artifactory (artifactory/...) cuando sea posible.
• Si tienes rutas legacy ui/native/..., la extensión intenta convertirlas internamente.
• Si acabas de instalar o desinstalar una extensión, acepta Reload Window para evitar estados viejos.
• Si el catálogo tarda, prueba primero con Refresh Private Extension Catalog.

Troubleshooting

El catálogo aparece vacío

• Revisa Output > Marketplace Cibest.
• Verifica que marketplaceCibest.sourceBaseUrl apunte a la raíz correcta.
• Verifica que marketplaceCibest.sourceRepositories tenga los repositorios correctos (por ejemplo company_extension_1_vscode).
• La configuración recomendada usa rutas raw artifactory/....

Artifactory responde pero no lista .vsix

• Verifica que exista y sea navegable la ruta raw artifactory/<repo>/<platform>/ para windows, linux y macos.

La instalación no se refleja de inmediato

• VS Code puede requerir Reload Window después de instalar o desinstalar una extensión.

En pocas palabras

Marketplace Cibest busca que el flujo sea simple: abrir, revisar, instalar y seguir trabajando. Si la fuente en Artifactory está bien configurada, casi todo el uso diario pasa por el catálogo, sin descargar archivos manualmente ni salir de VS Code.