Compartir vía


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

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 una etiqueta, puede ver, compilar o incluso revertir un amplio conjunto de archivos al estado en el que estaban cuando se aplicó la etiqueta.

Requisitos previos

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

Usar etiquetas

En muchos proyectos de software, cuando el código ha alcanzado un nivel razonable de calidad y estabilidad, el equipo compila y lanza 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 id. 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 contenga los archivos. Puede dar un nombre a la etiqueta que cumpla cualquier convención de nomenclatura que prefiera. Algunos ejemplos de nombres de etiqueta incluyen los siguientes: "Sprint 5", "M1", "Beta2" y "Versión candidata para lanzamiento 0".

Después de aplicar la etiqueta, puede utilizarla para calificar operaciones como compilar, crear una rama, combinar, comparar y obtener versiones concretas de archivos y carpetas.

A veces, después de aplicar una etiqueta, decide que tiene que cambiarla. TFVC ofrece una forma automática para aplicar una etiqueta a archivos adicionales, quitar una etiqueta de determinados archivos y modificar la versión de un archivo en particular al que se aplica la etiqueta.

Sugerencia

Al aplicar una etiqueta, se proporcionan muchas de las ventajas que se obtienen al crear una bifurcación, pero normalmente con un costo y complejidad menores. 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.

Aplicar una etiqueta

Nota:

Cuando usa Visual Studio para aplicar una etiqueta que ya existe, la operación quita la etiqueta de todas las versiones del archivo para aplicarla después. 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 secundario en la colección, proyecto, rama, carpeta o archivo al que quiere aplicar una etiqueta y, después, seleccione Avanzado>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 Versión, la opción Última versión aparece seleccionada de forma predeterminada. Esta opción es la que se usa con más frecuencia. Si necesita la etiqueta para tener como destino una versión específica, seleccione una de las opciones siguientes:

    • 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 en el calendario del menú desplegable.

    • Etiqueta: especifique una etiqueta existente en la que basar la etiqueta nueva. 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é de acuerdo con la configuración, siga uno de los pasos siguientes:

    • Para aplicar la etiqueta, seleccione Crear.

    • Para aplicar la etiqueta y modificarla una vez aplicada, seleccione Crear y editar. Esta acción aplica la etiqueta y, después, muestra la ventana Etiqueta. Para obtener más información sobre cómo utilizar la ventana Etiqueta a fin de editar una etiqueta, vea Uso de la ventana Etiqueta para trabajar con etiquetas.

Nota:

Al aplicar una etiqueta que usa un nombre que ya existe, el sistema le advierte y pregunta si quiere 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.

Cambio de nombre de una etiqueta

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

  1. En el Explorador de control de código fuente, haga clic con el botón secundario en el nodo de colección de proyectos (el nodo raíz) y, después, seleccione Avanzado>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 siguientes pasos:

    • 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. Utilice las opciones del cuadro de diálogo Buscar etiqueta para filtrar la lista de etiquetas y buscar la etiqueta existente a la que quiere aplicar la nueva etiqueta. Para obtener más información, vea Búsqueda, edición y eliminación de etiquetas.

  6. Seleccione Crear.

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

Enumeración, búsqueda, visualización, edición y eliminación de etiquetas

Hay dos maneras para mostrar 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 verla, editarla 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) Refine su búsqueda realizando uno o varios de estos pasos:

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

    • En la lista Proyecto, seleccione el proyecto que contiene la etiqueta que quiere buscar.

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

  3. Seleccione Buscar. En la lista Resultados se muestran etiquetas que coinciden con el criterio de búsqueda especificado.

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

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

A veces, podría dudar del nombre de una etiqueta, pero sabe que la etiqueta se aplicó a un elemento determinado en 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 secundario en un elemento al que se aplicó la etiqueta y, después, 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) Elija uno de los siguientes pasos:

    • Para ver o editar una etiqueta, haga clic con el botón secundario en la etiqueta y, después, seleccione Editar etiqueta. Aparecerá la ventana Etiqueta. Para obtener información sobre cómo utilizar esta ventana, vea Uso de la ventana Etiqueta para trabajar con etiquetas.

    • Para eliminar una etiqueta, haga clic con el botón secundario en la etiqueta y, después, seleccione Eliminar etiqueta.

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

Para obtener más información sobre cómo usar la pestaña Etiqueta en la ventana Historial, vea Obtención del historial de un elemento.

Descargar versiones con etiquetas de archivos al área de trabajo

Etiquetar un conjunto de archivos es como obtener una captura de cómo eran en determinado punto del tiempo. Semanas o meses después de haber obtenido esa captura, es posible que necesite ver los archivos, o trabajar con ellos, tal y como existían en esa captura. En el siguiente procedimiento se explica cómo descargar las versiones con etiquetas de un conjunto de archivos al área de trabajo.

  1. En el Explorador de control de código fuente, haga clic con el botón secundario en la colección de proyectos, el proyecto, la rama o la carpeta que contiene los elementos que quiere descargar y, después, seleccione Avanzado>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 utilizar este cuadro de diálogo, vea Búsqueda, edición y eliminación de etiquetas.

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

  4. Selecciona Obtener.

Uso de 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 se puede editar.

Puede utilizar la ventana Etiqueta para realizar las tareas siguientes:

  • 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. Aparecerá el cuadro de diálogo Elegir versión del 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 mantener presionadas las teclas Ctrl o Mayús y, después, seleccionar varios elementos.

  3. (Opcional) Si necesita que la etiqueta tenga como destino una versión concreta, 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 el cuadro Fecha o seleccione una fecha en el calendario del menú desplegable.

    • Etiqueta: especifique una etiqueta existente en la que basar la etiqueta nueva. 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.

  4. Seleccione Aceptar.

  5. Seleccione Archivo>Guardar.

Quitar un elemento de la etiqueta

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

  2. Haga clic con el botón secundario 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 se quitará también 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 secundario 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 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 en el calendario del menú desplegable.

    • Etiqueta: especifique una etiqueta existente en la que basar la etiqueta nueva. 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 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.

  4. Seleccione Archivo>Guardar.

Realizar otras acciones en un elemento con etiquetas

Al hacer clic con el botón secundario 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 mostrar una lista de 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

    Cuando utilice el comando label para aplicar una etiqueta, puede especificar un ámbito distinto al del proyecto.

Pasos siguientes