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. Agrega en marketplaceCibest.sourceUrls cada URL donde se publican los .vsix que quieres ver. También puedes usar el botón + de la vista Extensions para agregar una URL directamente desde el Activity Bar; el campo solicita Enter the Installation source URL to add.
2. Usa una URL por sistema operativo cuando la aplicación publique un paquete por plataforma.
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.

La vista Extensions muestra un badge con la cantidad de actualizaciones pendientes. Cada extensión conserva su logo, nombre, descripción y publisher; cuando tiene una actualización, muestra la etiqueta Update al final de la línea del publisher.

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: Add Artifactory URL
• 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

Los cuatro comandos Open Artifactory abren las URL que declaraste en marketplaceCibest.sourceUrls. La plataforma se deduce de la propia URL, igual que se hace al clasificar los artefactos, así que una URL que termine en /windows/ se ofrece para Windows. Si hay varias URL para la misma plataforma, se te pregunta cuál abrir.

Configuración

La configuración mínima recomendada es esta:

{
	"marketplaceCibest.sourceUrls": [
		"https://artifactory.apps.company.com/artifactory/sample-extension_vscode/windows/",
		"https://artifactory.apps.company.com/artifactory/sample-extension_vscode/linux/",
		"https://artifactory.apps.company.com/artifactory/sample-extension_vscode/macos/",
		"https://otro-artifactory.company.com/artifactory/app-other/"
	],
	"marketplaceCibest.maxVersionsPerSource": 5,
	"marketplaceCibest.requestTimeoutMs": 15000,
	"marketplaceCibest.catalogCacheTtlMinutes": 15,
	"marketplaceCibest.enableStartupUpdateCheck": true,
	"marketplaceCibest.showPreReleaseVersions": false
}

No necesitas escribir este JSON a mano. Como sourceUrls es una lista de textos, la interfaz de configuración de VS Code la dibuja con sus propios controles: abre Marketplace Cibest: Open Settings y tendrás Add Item para agregar una URL, y un lápiz y una equis en cada fila para editarla o eliminarla.

Qué significa cada ajuste

• marketplaceCibest.sourceUrls: URL donde se buscan los .vsix. Cada URL se consulta tal como la escribes: no hay una raíz común ni una convención de carpetas, así que pueden convivir paquetes publicados con distribuciones distintas y en servidores distintos.

  Los .vsix encontrados se agrupan por la identidad que declara su manifiesto (publisher.name), que es también de donde sale el nombre con el que se muestran. Por eso las tres URL de una misma aplicación —Windows, Linux y macOS— terminan en una sola tarjeta sin que tengas que declarar nada más.

  Si dos URL exponen el mismo archivo, por ejemplo un espejo, la versión se lista una sola vez y se usa la URL que aparezca primero en la lista.

• marketplaceCibest.maxVersionsPerSource: cuántos de los artefactos más recientes se inspeccionan en cada URL. Por defecto 5, con un máximo de 10 que no se puede subir. Conocer la versión de un artefacto obliga a descargar el paquete completo, así que este valor es el que acota lo que tarda y lo que transfiere una actualización del catálogo. Los artefactos más antiguos siguen publicados en Artifactory, simplemente no se listan.

• 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.

• marketplaceCibest.showPreReleaseVersions: incluye las versiones de prelanzamiento al elegir qué instalar y al buscar actualizaciones. En false (valor por defecto) el catálogo sigue listándolas en su propio grupo, pero no se ofrecen como actualización.

Versiones estables y de prelanzamiento

El catálogo separa los artefactos en dos grupos dentro de la pestaña Versions: Release versions y Pre-release versions. Un artefacto se considera de prelanzamiento cuando:

1. la versión del manifiesto trae un identificador semver de prelanzamiento (1.4.0-rc.1, 1.4.0-beta.2), o
2. el nombre del archivo trae ese marcador justo después de la versión (sample-extension-win32-x64-2.0.0-rc.1.vsix).

Los marcadores reconocidos son alpha, beta, rc, pre, next, dev y snapshot. Las variantes de build -latest y -fixed no son prelanzamientos, y una versión 0.x.y tampoco.

Con la configuración por defecto, quien tiene instalada una versión estable nunca recibe un prelanzamiento como actualización; quien ya tiene instalado un prelanzamiento sí sigue recibiendo actualizaciones dentro de ese canal. Cualquier versión listada se puede instalar de forma explícita desde su fila.

Qué se descarga y cuándo

Para saber qué versión es un .vsix hay que abrirlo y leer su manifiesto, así que la extensión descarga cada paquete que va a listar. Esas descargas son temporales: se borran en cuanto se ha leído lo necesario, y lo mismo ocurre al abrir un README o un CHANGELOG, y al instalar. La carpeta de descargas también se vacía al iniciar VS Code, por si alguna operación quedó a medias.

Por eso existe marketplaceCibest.maxVersionsPerSource: el recorte se aplica al listado del repositorio antes de descargar nada, de modo que un repositorio con muchas versiones publicadas no obligue a traerlas todas.

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

• Si el catálogo dice No hay URL configuradas, aún no has declarado nada: usa el botón Abrir configuración que aparece ahí mismo. Si dice No hay extensiones disponibles, la configuración existe pero las URL no devolvieron artefactos.
• Revisa Output > Marketplace Cibest.
• Verifica que marketplaceCibest.sourceUrls tenga al menos una URL. Con la lista vacía el catálogo no consulta nada.
• Verifica que cada URL sea absoluta (http:// o https://). Las rutas relativas y otros protocolos se descartan.
• La configuración recomendada usa rutas raw artifactory/....

Artifactory responde pero no lista .vsix

• Abre en el navegador cada URL de urls y verifica que sea navegable y que liste archivos .vsix.

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.