Instalar extensiones

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

Aprenda a instalar, asignar, deshabilitar y desinstalar extensiones, que agregan nuevas características y funcionalidades para Azure DevOps.

Para obtener más información sobre las extensiones, consulte la introducción al desarrollo y la publicación .

Requisitos previos

  • Solo los miembros del grupo Administradores de colecciones de proyectos o que tienen permisos de "Editar información de nivel de recopilación" pueden instalar extensiones. Los propietarios de la organización son automáticamente miembros de este grupo. Si no tiene permisos, puede solicitar extensiones en su lugar o buscar un administrador de colecciones de proyectos.

Nota

Para usar una suscripción de Azure existente para la facturación, debe tener al menos permisos de coadministrador para esa suscripción. Si no tiene permisos, un administrador de cuentas de Azure o administrador de servicios puede agregarle como coadministrador a la suscripción de Azure en el Azure Portal.

La colección de proyectos reutiliza la suscripción de Azure para futuras compras de Marketplace. ¿Dónde puedo encontrar más información sobre la facturación de Azure?

Instalar una extensión

Instale una extensión en su organización siguiendo estos pasos.

  1. Inicie sesión en su organización (https://dev.azure.com/{yourorganization}).

  2. Seleccione el icono de la bolsa de compras y, a continuación, seleccione Examinar Marketplace.

    Captura de pantalla que muestra el icono de contenedor de compras resaltado y la selección del botón Examinar Marketplace.

  3. Busque la extensión que desea instalar y seleccione Obtener gratis.

    Captura de pantalla que muestra el resaltado cuadrado rojo resaltado botón Obtener gratis.

  4. Seleccione su organización en el menú desplegable y, a continuación, seleccione Instalar para instalar la extensión.

    Selección de la organización para esta extensión

La extensión ya está instalada. Ahora puede ir a su organización para usar la extensión. Además, informe a su equipo sobre esta extensión, para que puedan empezar a usar sus funcionalidades.

Extensión instalada

  1. Abra la página principal de Azure DevOps Server (https://{server}:DefaultCollection).

  2. Abra el menú de extensiones y elija Examinar Marketplace.

    Examinar Marketplace

  3. Busque la extensión que desea instalar. Use el cuadro de búsqueda para filtrar la lista de extensiones.

    Seleccionar una extensión

  4. Seleccione la extensión y elija Obtener o Obtener gratis. O bien, para algunas extensiones de terceros, elija Introducción para mostrar la información de precios y las instrucciones de instalación específicas de la extensión.

    Obtener la extensión

    Si no tiene permiso para instalar la extensión, puede solicitarle a un administrador que lo instale. La solicitud se almacena en Azure DevOps Server y está lista para prestar atención a un administrador.

  5. Seleccione la colección de proyectos en la que desea instalar esta extensión y elija Instalar.

    Seleccione colección de proyectos y elija Instalar.

  6. Una vez completada la instalación, vaya a la colección de proyectos o vuelva a Marketplace para buscar otras extensiones.

    Instalación finalizada

  1. En la página principal de Azure DevOps Server (https://{server}:8080/tfs/), vaya a la colección de proyectos donde desea instalar la extensión.

  2. Abra el menú de extensiones y elija Examinar Marketplace.

    Captura de pantalla que muestra el botón Examinar Marketplace resaltado.

  3. Busque y seleccione la extensión que desea instalar.

    Captura de pantalla que muestra el ejemplo de extensión seleccionado.

  4. Seleccione la extensión y, a continuación, Instalar.

  5. Confirme la colección de proyectos en la que desea instalar esta extensión.

    Selección que muestra la colección Project.

  6. Termine de instalar la extensión.

  7. Asigne la extensión a los usuarios que necesitan acceso. De lo contrario, puede ir a la colección de proyectos para usar la extensión. Informe a su equipo sobre esta extensión, por lo que también pueden empezar a usar sus funcionalidades.

    Captura de pantalla que muestra la confirmación de la extensión instalada.

Instalación de extensiones cuando se desconecta

Cuando esté desconectado de Azure DevOps Server, puede instalar extensiones gratuitas y en versión preliminar. En primer lugar, descargue la extensión, cárguelo en Azure DevOps Server y, a continuación, instálelo en una colección de proyectos.

Descarga desde Marketplace

  1. Inicie sesión en Marketplace > Azure DevOps.

  2. Busque la extensión que desea instalar.

    Captura de pantalla que muestra la búsqueda de la extensión en Marketplace.

    Captura de pantalla que muestra la búsqueda de la extensión.

  3. Descargue y guarde la extensión.

    Captura de pantalla que muestra la extensión de descarga.

Carga de la extensión en Azure DevOps

  1. Busque las extensiones descargadas (https://{server}:8080/tfs/_gallery).

  2. Seleccione Administrar extensiones.

    Captura de pantalla que muestra la selección, el botón Administrar extensiones.

  3. Seleccione Cargar nueva extensión.

    Captura de pantalla que muestra la selección, botón Cargar nueva extensión.

    ¿Por qué no puedo cargar extensiones?

Sugerencia

El tamaño máximo de la carga es de 25 MB. Si no puede solucionar este requisito, notifique un problema en el Developer Community.

Instalación de la extensión en la colección de proyectos

  1. Seleccione e instale la extensión que cargó.

    Captura de pantalla que muestra la selección de extensión.

  2. Elija la colección de proyectos donde desea instalar la extensión.

    Captura de pantalla que muestra la selección del botón Continuar.

  3. Revise los permisos que obtiene la extensión cuando esté instalado. Termine de instalar la extensión.

    Captura de pantalla que muestra la revisión de los permisos concedidos a la extensión.

    Ahora puede ir a la colección de proyectos para usar la extensión. Informe a su equipo sobre esta extensión, por lo que también pueden empezar a usar sus funcionalidades.

Instalación de extensiones preinstaladas (de primera entidad) para TFS desconectado

Nota

Esta sección solo sirve para agregar extensiones preinstaladas (de primera entidad), si va a instalar extensiones que no están preinstaladas con TFS, consulte la sección Instalación de extensiones cuando se desconecta.

En el caso de las extensiones de primera entidad que vienen preinstaladas con TFS, este es un método alternativo de instalación que evita problemas de compatibilidad.

  1. Mantenga el puntero sobre el contenedor de compras y seleccione Administrar extensiones.

    Seleccione Administrar extensiones.

  2. Una vez en la página Extensiones, seleccione Examinar extensiones locales.

    En la página Extensiones, Examinar extensiones locales

  3. Desplácese hacia abajo hasta que vea la categoría "Plan and track", que incluye planes de entrega. Seleccione Planes de entrega.

    Elección de la extensión

  4. Se le redirigirá a una página de extensión local para Planes de entrega donde seleccione Instalar. La instalación funciona cuando está en línea y sin conexión.

    Galería de extensiones de planes de entrega

Varias extensiones están preinstaladas en la galería de extensiones locales. Los usuarios pueden instalar estas extensiones sin necesidad de una conexión externa a Marketplace o a Internet.

Sugerencia

Las extensiones que se instalaron anteriormente desde Marketplace aparecen automáticamente en la galería local para que se puedan instalar fácilmente en otras colecciones de proyectos.

  1. Abra el menú de extensiones y elija Administrar extensiones.

    En el menú extensiones, elija Administrar extensiones.

  2. En la página Extensiones, elija Examinar extensiones locales.

    Examinar extensiones locales

  3. Elija la extensión que desea instalar.

    Elegir una extensión local

  4. Seleccione la colección de proyectos donde desea instalar esta extensión y elija Instalar.

    Seleccione la colección de proyectos donde desea instalar esta extensión y elija Instalar.

  5. Una vez completada la instalación, vaya a la colección de proyectos o vuelva a Marketplace para buscar otras extensiones.

    Instalación realizada

Desinstalación o deshabilitación de una extensión

Nota

Los cargos continúan por una extensión de pago hasta que se reducen todos los usuarios a cero (0) para la extensión.

  1. Inicie sesión en su organización (https://dev.azure.com/{yourorganization}).

  2. Seleccione el icono de engranajeConfiguración de la organización.

    Abrir configuración de la organización

  3. Seleccione Extensiones y, a continuación, seleccione la extensión que desea desinstalar o deshabilitar.

    Seleccionar desinstalar o deshabilitar para la extensión

  4. Seleccione Desinstalar o seleccione los puntos suspensivos (...) y, a continuación, seleccione Deshabilitar.

    Deshabilitar o desinstalar la extensión


Para desinstalar extensiones en una colección, realice los pasos siguientes.

  1. Vaya al portal de administración de la galería local (http://{server}:8080/tfs/_gallery/manage).

  2. Para la extensión deseada, seleccione los puntos suspensivos (...) y, a continuación, seleccione Quitar.

    Quitar extensión

Habilitar o enumerar extensiones a través de la línea de comandos

Habilite una extensión con el comando az devops extension enable . Para empezar, consulte Introducción a la CLI de Azure DevOps.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parámetros: habilitación de la extensión

  • extension-name: nombre de la extensión que se va a habilitar.
  • publisher-name: el nombre del publicador de extensiones.
  • org: dirección URL de la organización de Azure DevOps. Configure la organización predeterminada con az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.

Ejemplo: habilitación de la extensión

El siguiente comando habilita la extensión Timetracker y muestra el resultado en formato de tabla.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Enumerar extensiones

Puede enumerar las extensiones instaladas en su organización con el comando az devops extension list . Para empezar, consulte Introducción a la CLI de Azure DevOps.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Parámetros opcionales: enumerar extensiones

  • include-built-in: incluye las extensiones integradas. Los valores aceptados son true (valor predeterminado) y false.
  • include-disabled: incluya las extensiones deshabilitadas. Los valores aceptados son true (valor predeterminado) y false.
  • org: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.

Ejemplo: enumerar extensiones

En el siguiente comando se enumeran las extensiones de la organización. Excluye las extensiones deshabilitadas y integradas y muestra los resultados en formato de tabla.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Enumerar información de extensión

Puede enumerar los detalles de una extensión con el comando az devops extension show . Para empezar, consulte Introducción a la CLI de Azure DevOps.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parámetros: enumerar la información de la extensión

  • extension-name: el nombre de la extensión.
  • publisher-name: el nombre del publicador de extensiones.
  • org: dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante git config. Ejemplo: --org https://dev.azure.com/MyOrganizationName/.

Ejemplo: enumerar información de extensión

El siguiente comando muestra información sobre la extensión Timetracker en formato de tabla.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Preguntas más frecuentes (P+F)

P: ¿Por qué no veo mi organización desde la página de instalación de Marketplace?

R: Si no ve su organización al comprar desde Marketplace de Azure DevOps, pruebe los pasos siguientes:

  1. Compruebe la identidad que usa para iniciar sesión en Visual Studio Marketplace. En la esquina superior derecha, seleccione el nombre de usuario para ver el perfil.
  2. A la izquierda, asegúrese de que la dirección de correo electrónico y el directorio sean correctos.
  3. Cierre todas las ventanas del explorador.
  4. Abra una sesión de exploración privada o de incógnito.
  5. Inicie sesión en Visual Studio Marketplace. Use la identidad de un usuario de la organización que desee.

Sugerencia

Azure DevOps puede pedirle que elija entre "cuenta profesional o educativa" o "cuenta personal". Si es así, usó una dirección de correo electrónico que es la misma para una cuenta Microsoft y una "cuenta profesional o educativa" que la organización administra en Azure Active Directory. Aunque estas identidades tienen la misma dirección de correo electrónico, siguen siendo identidades independientes con distintos perfiles, configuraciones de seguridad y permisos. Elija la identidad del usuario de la organización que desea seleccionar.

P: ¿Por qué no puedo instalar una extensión?

R: No se pueden instalar extensiones por uno de los siguientes motivos.

  • Debe ser miembro del grupo Administradores de la colección de proyectos o ser propietario de la organización. Si no tiene permisos, pero es miembro del proyecto, puede solicitar extensiones en su lugar.
  • Si recibe una comprobación de error "ya instalada o solicitada" con el administrador de la colección de proyectos y pídale que le asigne la extensión.

P: ¿Por qué los usuarios no pueden acceder a las características de extensión?

R: Los usuarios no pueden acceder a una extensión por uno de los siguientes motivos:

  • La mayoría de las extensiones requieren que los usuarios tengan al menos acceso básico, no parte interesada. Por ejemplo, puede instalar la extensión de búsqueda de código gratuita, pero cada usuario debe tener al menos acceso básico para buscar código. Para ayudar a su equipo a mejorar la calidad de la aplicación, puede instalar la extensión de comentarios de prueba &gratuita. Experimentará diferentes funcionalidades, en función del nivel de acceso y de si trabaja sin conexión o se conecta a Azure DevOps Services o a Azure DevOps Server locales. Para más información, consulte la descripción de la extensión en la pestaña Visual Studio Marketplace, Azure DevOps.

  • Si usa una organización y ha iniciado una evaluación gratuita de la extensión, es posible que la versión de prueba haya expirado. Para comprobar si la prueba ha expirado:

    1. En la barra de herramientas de la organización, seleccione Usuarios.
    2. Vaya al panel de extensión.
    3. Compruebe si hay un mensaje de expiración para buscar si la extensión ha expirado o cuándo ha expirado.
  • Si usa una organización y paga por esta extensión, asegúrese de asignar esta extensión a los usuarios.

    1. En la barra de herramientas de la organización, vaya a Usuarios.
    2. Vaya al panel de extensión.
    3. Compruebe si la extensión está asignada al usuario. Si no es así, asigne la extensión al usuario.

Para obtener más información, consulte Asignación de extensiones a los usuarios.

P: ¿Qué ha ocurrido con mi extensión de versión preliminar?

R: Es posible que la extensión se haya movido fuera de la versión preliminar. Después de un período de versión preliminar, una extensión más larga estará disponible con carácter general como extensión de pago. Se puede ofrecer un período de gracia antes de que tenga que comprar la extensión. Todas las extensiones de versión preliminar se convierten automáticamente en una evaluación gratuita antes de tener que comprar la extensión.

P: ¿Por qué no puedo instalar extensiones para Azure DevOps Server? (local)

R: No se pueden instalar extensiones por Azure DevOps Server por uno de los siguientes motivos:

  • Debe ser miembro del grupo Administradores de recopilación de proyectos o tener establecido el permiso Editar información de nivel de colección en Permitir en la colección de proyectos donde desea instalar extensiones. Si no tiene permisos, puede solicitar extensiones en su lugar.
  • Es posible que reciba un error que indica que ya instaló o solicitó la extensión. Si es así, consulte con un miembro del grupo Administradores de la colección de proyectos y pídales que asignen la extensión. Para obtener más información, consulte Solicitar un aumento en los niveles de permisos.

P: ¿Por qué no veo la colección de proyectos que quiero? (local)

R: Debe ser miembro de la colección de proyectos. Siga estos pasos para comprobar la identidad que usa para iniciar sesión en Marketplace.

  1. En la página principal del portal web de Azure DevOps Server (https://{server}:8080/tfs/), vaya a la esquina superior derecha de la página y seleccione el nombre de usuario para ver el perfil.

  2. En el lado izquierdo del perfil, asegúrese de que la dirección de correo electrónico y el directorio sean correctos.

  3. Cierre todas las ventanas del explorador.

  4. Abra una sesión de exploración privada o de incógnito.

  5. Inicie sesión en la página principal de Azure DevOps Server (https://{server}:8080/tfs/) con la identidad que es un usuario de la colección de proyectos donde desea instalar la extensión.

    Azure DevOps puede pedirle que elija entre una "organización profesional o educativa" o "cuenta personal". Este mensaje significa que usó una dirección de correo electrónico que es la misma para una cuenta Microsoft y una "cuenta profesional o educativa" administrada por su organización en Azure Active Directory. Aunque estas identidades tienen la misma dirección de correo electrónico, siguen siendo identidades independientes con distintos perfiles, configuraciones de seguridad y permisos. Elija la identidad que es el usuario de la colección de proyectos.

  6. En la colección de proyectos, vaya a Marketplace.

P: ¿Por qué no se muestra la extensión que quiero mostrar un botón de descarga? (local)

R: Algunas extensiones solo funcionan con Azure DevOps Services por uno de los siguientes motivos:

  • La extensión usa características de Azure DevOps que aún no se han publicado para Azure DevOps Server.
  • El manifiesto de extensión indica que la extensión solo está disponible para Azure DevOps Services (destinos = Microsoft.Visualstudio.Services.Cloud).
  • El manifiesto de extensión indica que la extensión es una integración (destinos = Microsoft.Visualstudio.Services.Integration).

P: ¿Por qué no puedo cargar extensiones en Azure DevOps Server? (local)

R: Debe ser miembro del grupo Administradores de Team Foundation. También debe tener permisos de información de nivel de instancia para el Azure DevOps Server donde desea cargar extensiones.

P: ¿Cómo obtener soporte técnico para suscripciones, facturación y Marketplace de Azure?

R: Según el soporte técnico que necesite, elija entre los siguientes artículos:

Pasos siguientes