Partekatu honen bidez:

Uso de etiquetas para tomar una instantánea de los archivos en Azure Repos

  • Artikulua

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

Visual Studio 2019 | Visual Studio 2022

Las etiquetas de Control de versiones de Team Foundation (TFVC) proporcionan una manera de tomar una instantánea de los archivos. Más adelante, podrá volver a hacer referencia a esa instantánea. Mediante el uso de la etiqueta, puede ver, compilar o incluso revertir un gran conjunto de archivos al estado en el que se encontraban al aplicar la etiqueta.

Prerrequisitos

  • Para aplicar una etiqueta, el permiso Etiqueta debe estar establecido en Permitir.
  • Para buscar, mostrar o ver etiquetas, el permiso Leer debe estar establecido en Permitir.
  • Para modificar o eliminar una etiqueta, debe ser propietario de la etiqueta o tener el permiso Administrar etiquetas establecido en Permitir.

Uso de etiquetas

En muchos proyectos de software, cuando el código ha alcanzado un nivel razonable de calidad y estabilidad, el equipo crea y publica una nueva versión del producto. El equipo debe marcar la versión actual de cada archivo. Incluso a medida que los archivos siguen cambiando, el equipo todavía puede obtener y compilar la nueva versión de cada archivo de su proyecto.

En teoría, podría registrar el identificador de cada conjunto de cambios para cada archivo manualmente. Pero este tipo de proceso no es práctico. TFVC facilita el trabajo. Aplique una etiqueta a la carpeta, rama o proyecto que contiene los archivos. Puede asignar un nombre a la etiqueta que siga la convención de nomenclatura que prefiera. Algunos ejemplos de nombres de etiqueta son: "Sprint 5", "M1", "Beta2" y "Release Candidate 0".

Después de aplicar la etiqueta, puede usarla para calificar operaciones como compilar, bifurcar, combinar, comparar y obtener versiones específicas de archivos y carpetas.

A veces después de aplicar una etiqueta, decide que necesita cambiarla. TFVC proporciona una manera de aplicar una etiqueta a archivos adicionales, quitar una etiqueta de determinados archivos y modificar a qué versión de un archivo específico se aplica una etiqueta.

Sugerencia

La aplicación de una etiqueta proporciona muchas de las mismas ventajas que crear una rama, pero normalmente con un costo y una complejidad más bajos. El inconveniente es que, para las bases de datos grandes, las operaciones como la combinación pueden tardar mucho más tiempo de lo habitual cuando se ejecutan en una etiqueta.

Aplicación de una etiqueta

Nota

Cuando se usa Visual Studio para aplicar una etiqueta que ya existe, la operación quita la etiqueta de todas las versiones de archivo y, a continuación, aplica la etiqueta. En la línea de comandos, sin embargo, la operación label es aditiva. Vea Comando Label (Control de versiones de Team Foundation).

  1. En Visual Studio, en el menú Ver, seleccione Otras ventanas>Explorador de control de código fuente.

  2. En el Explorador de control de código fuente, haga clic con el botón derecho en la colección, proyecto, rama, carpeta o archivo al que desea aplicar una etiqueta y, a continuación, seleccione Avanzadas>Aplicar etiqueta. Aparecerá el cuadro de diálogo Nueva etiqueta.

  3. En el cuadro Nombre, escriba un nombre para la etiqueta.

  4. (Opcional) En el cuadro Comentario, escriba un comentario.

  5. En la lista de versiones , la versión más reciente está seleccionada de forma predeterminada. Esta opción es la que se usa más normalmente. Si necesita la etiqueta para tener como destino una versión específica, seleccione una de las siguientes opciones:

    • Conjunto de cambios: especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, seleccione los puntos suspensivos (…) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Búsqueda y visualización de conjuntos de cambios.

    • Fecha: Especifique una fecha en el cuadro Fecha o seleccione una fecha del calendario en el menú desplegable.

    • etiqueta: especifique una etiqueta existente en la que basar la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o seleccione los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta. Para obtener más información, vea Búsqueda, edición y eliminación de etiquetas.

    • Versión del área de trabajo: cree la etiqueta para la versión en el área de trabajo.

  6. Cuando esté satisfecho con la configuración, siga uno de los pasos siguientes:

    • Para aplicar la etiqueta, seleccione Crear.

    • Para aplicar la etiqueta y modificarla después de aplicarla, seleccione Crear y editar. Esta acción aplica la etiqueta y, después, muestra la ventana Etiqueta. Para obtener más información sobre el uso de la ventana Etiqueta para editar una etiqueta, consulte Usar la ventana Etiqueta para trabajar con etiquetas.

Nota

Cuando se aplica una etiqueta que usa un nombre que ya existe, el sistema le advierte y pregunta si desea continuar. Si selecciona Aceptar para continuar, TFVC quita esa etiqueta de los elementos que no están en la ruta de acceso a la que está aplicando la etiqueta.

Cambiar el nombre de una etiqueta

No se puede modificar el nombre de una etiqueta existente. Pero puede aplicar fácilmente una nueva etiqueta a exactamente los mismos archivos y las mismas versiones a las que se aplica otra etiqueta.

  1. En el Explorador de control de código fuente, haga clic con el botón derecho en el nodo de colección de proyectos (el nodo raíz) y seleccione Avanzadas>Aplicar etiqueta. Aparecerá el cuadro de diálogo Nueva etiqueta.

  2. En el cuadro Nombre, escriba un nombre para la etiqueta.

  3. (Opcional) En el cuadro Comentario, escriba un comentario.

  4. En la lista Versión, seleccione Etiqueta. Aparecerá el cuadro Etiqueta.

  5. Realice uno de los pasos siguientes:

    • Escriba el nombre de la etiqueta existente.

    • Si no está seguro del nombre de la etiqueta existente, seleccione el botón Examinar con los puntos suspensivos (…) que se encuentra junto al cuadro Etiqueta. Aparece el cuadro de diálogo Buscar etiqueta. Use las opciones del cuadro de diálogo Buscar etiqueta para filtrar la lista de etiquetas y buscar la etiqueta existente a la que desea aplicar la nueva etiqueta. Para obtener más información, vea Buscar, Editar y Quitar Etiquetas.

  6. Seleccione Crear.

  7. (Opcional) Después de crear la nueva etiqueta, puede quitar la etiqueta anterior. Para obtener más información, vea Búsqueda, edición y eliminación de etiquetas.

Enumerar, buscar, ver, editar y quitar etiquetas

Hay dos maneras de enumerar y buscar etiquetas: el cuadro de diálogo Buscar etiqueta y la pestaña Etiqueta en la ventana Historial. Después de encontrar la etiqueta que le interesa, puede ver, editar o quitarla. También puede trabajar con los archivos a los que se aplica la etiqueta.

Buscar y trabajar con etiquetas mediante el cuadro de diálogo Buscar etiqueta

  1. En el Explorador de control de código fuente, en la barra de menús, seleccione Archivo>Control de código fuente>Buscar>Buscar etiqueta. Aparece el cuadro de diálogo Buscar etiqueta.

  2. (Opcional) Para refinar la búsqueda, realice uno o varios de los pasos siguientes:

    • En el cuadro de texto Nombre, escriba el nombre de la etiqueta.

    • En la lista Proyecto, seleccione el proyecto que contiene la etiqueta que desea encontrar.

    • En el cuadro de texto Propietario, escriba el nombre o alias del propietario de la etiqueta.

  3. Seleccione Buscar. La lista Resultados muestra etiquetas que coinciden con los criterios de búsqueda especificados.

  4. (Opcional) Realice uno de los pasos siguientes:

    • Para ver o editar una etiqueta, selecciónela y seleccione Editar. Aparecerá la ventana Etiqueta. Para obtener más información, vea Uso de la ventana Etiqueta para trabajar con etiquetas.

    • Para eliminar una etiqueta, selecciónela y seleccione Eliminar.

    • Seleccione Cerrar.

Enumerar y trabajar con etiquetas que se aplican a un elemento específico

A veces, es posible que no esté seguro del nombre de una etiqueta, pero sabe que la etiqueta se aplicó a un elemento determinado bajo el control de versiones. En el procedimiento siguiente se explica cómo buscar y trabajar con una etiqueta en esta situación.

  1. En el Explorador de control de código fuente, haga clic con el botón derecho en un elemento al que se aplicó la etiqueta y, a continuación, seleccione Ver historial. Aparecerá la ventana Historial.

  2. Seleccione la pestaña etiquetas para mostrar la lista de etiquetas que se aplican a este elemento.

  3. (Opcional) Realice uno de los pasos siguientes:

    • Para ver o editar una etiqueta, haga clic con el botón derecho en la etiqueta y seleccione Editar etiqueta. Aparecerá la ventana Etiqueta. Para obtener información sobre cómo usar esta ventana, vea Usar la ventana Etiqueta para trabajar con etiquetas.

    • Para eliminar una etiqueta, haga clic con el botón derecho en la etiqueta y seleccione Eliminar etiqueta.

    • Haga clic con el botón derecho en la etiqueta y seleccione otra acción, como Obtener esta versión o Comparar.

Para obtener más información sobre cómo usar la pestaña de etiquetas en la ventana Historial, consulte Obtener el historial de un elemento.

Descarga de versiones etiquetadas de archivos en el área de trabajo

Etiquetar un conjunto de archivos es como tomar una instantánea de cómo existían en un momento dado. Semanas o meses después de haber tomado esta instantánea, es posible que tenga que ver o trabajar con los archivos tal como existían en esa instantánea. En el procedimiento siguiente se explica cómo descargar las versiones etiquetadas de un conjunto de archivos en el área de trabajo.

  1. En el Explorador de control de código fuente, haga clic con el botón derecho en la colección de proyectos, el proyecto, la rama o la carpeta que contiene los elementos que desea descargar y, a continuación, seleccione Advanced>Obtener versión específica. Aparecerá el cuadro de diálogo Obtener.

  2. En la lista Tipo, seleccione Etiqueta y, después, escriba el nombre de la etiqueta en el cuadro Etiqueta o seleccione puntos suspensivos (…) para abrir el cuadro de diálogo Buscar etiqueta. Para obtener más información sobre cómo usar este cuadro de diálogo, vea Buscar, editar y quitar etiquetas.

  3. Seleccione las demás opciones adecuadas en el cuadro de diálogo Obtener.

  4. Seleccione Consiga.

Usar la ventana Etiqueta para trabajar con etiquetas

Una vez abierta la ventana Etiqueta mediante uno de los procedimientos anteriores, ya está a punto para empezar a trabajar con la etiqueta. En la parte superior de la ventana, un cuadro muestra el comentario, que puede editar.

Puede usar la ventana de etiqueta para realizar las siguientes tareas:

  • Agregar un elemento a la etiqueta
  • Quitar un elemento de la etiqueta
  • Cambiar la versión de un archivo
  • Realizar otras acciones en un elemento

Agregar un elemento a la etiqueta

  1. En la ventana Etiqueta, seleccione Agregar elemento. Aparece el cuadro de diálogo Elegir versión de elemento.

  2. En el cuadro de diálogo Elegir versión del elemento, vaya hasta el elemento que quiera agregar y selecciónelo.

    Sugerencia

    Puede seleccionar y mantener pulsada la tecla Ctrl o la tecla Mayús y, a continuación, seleccionar varios elementos.

  3. (Opcional) Si necesita la etiqueta para tener como destino una versión específica, en la lista Versión, seleccione una versión:

    • Última versión: aplique la etiqueta a la última versión que esté en el control de versiones.

    • Conjunto de cambios: especifique el número de un conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, seleccione los puntos suspensivos (…) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Búsqueda y visualización de conjuntos de cambios.

    • Fecha: especifique una fecha en la caja Fecha o seleccione una fecha del calendario en el menú desplegable.

    • etiqueta: especifique una etiqueta existente en la que basar la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o seleccione los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta. Para obtener más información, vea Buscar, Editar y Quitar Etiquetas.

    • Versión del área de trabajo: cree la etiqueta para la versión en el área de trabajo.

  4. Seleccione Aceptar.

  5. Seleccione Archivo>Guardar.

Quitar un elemento de la etiqueta

  1. En la ventana Etiqueta, busque la colección, el proyecto, la rama, la carpeta o el archivo que desea quitar de esta etiqueta.

  2. Haga clic con el botón derecho en el elemento y seleccione Quitar de la etiqueta. La etiqueta se quita del elemento. Si el elemento es una colección de proyectos, proyecto, rama o carpeta, la etiqueta también se quita de todos los elementos que contiene.

  3. Seleccione Archivo>Guardar.

Cambiar la versión de un archivo

  1. En la ventana Etiqueta, busque el archivo que desea modificar.

  2. Haga clic con el botón derecho en el archivo y seleccione Cambiar versión etiquetada. Aparece el cuadro de diálogo Cambiar versión etiquetada.

  3. Seleccione uno de los siguientes valores:

    • Última versión: aplique la etiqueta a la última versión que esté en el control de versiones.

    • Conjunto de cambios: especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, seleccione las elipses (...) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Búsqueda y visualización de conjuntos de cambios.

    • Fecha: Especifique una fecha en el cuadro de Fecha o seleccione una fecha del calendario en el menú desplegable.

    • etiqueta: especifique una etiqueta existente en la que basar la nueva etiqueta. Seleccione el nombre de la etiqueta en el cuadro Etiqueta o el botón de puntos suspensivos (…) para abrir el cuadro de diálogo Buscar etiqueta. Para obtener más información, vea Buscar, Editar y Quitar Etiquetas.

    • Versión del área de trabajo: cree la etiqueta para la versión en el área de trabajo.

  4. Seleccione Archivo>Guardar.

Realizar otras acciones en un elemento etiquetado

Al hacer clic con el botón derecho en un elemento de la ventana Etiqueta, también puede seleccionar uno de los siguientes comandos:

Trabajar desde el símbolo del sistema

  • Use el comando labels para enumerar etiquetas. Para obtener más información, vea comando Labels.

  • Use el comando label para aplicar o quitar una etiqueta. Para obtener más información, vea Comando Label (Control de versiones de Team Foundation).

    Sugerencia

    Al usar el comando label para aplicar una etiqueta, puede especificar un ámbito distinto del proyecto.

Pasos siguientes