Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013
Importante
No se admite la creación de un proyecto desde el portal web Team Foundation Server (TFS 2015) y versiones anteriores. Use Team Explorer para crear un proyecto.
En este artículo se describe cómo usar Azure DevOps para crear un proyecto y establecer un repositorio para el código fuente. Puede administrar y estructurar cada proyecto para satisfacer sus necesidades empresariales. Cada proyecto que cree proporciona límites para aislar los datos de otros proyectos. Para más información sobre los proyectos y cuándo crear uno, consulte Acerca de los proyectos y el escalado de la organización.
Importante
A fin de ver el contenido disponible para la plataforma, asegúrese de seleccionar la versión correcta de este artículo en el selector de versiones que se encuentra sobre la tabla de contenidos. La compatibilidad con las características difiere en función de si se trabaja desde Azure DevOps Services o una versión local de Azure DevOps Server.
Vea ¿Qué plataforma o versión estoy usando? para obtener información sobre la versión local que utiliza.
Si no desea crear un proyecto en Azure DevOps, puede crear Azure DevOps Projects.
Nota
Si no desea administrar un servidor local, puede registrarse para Azure DevOps Services crear un proyecto.
Debe ser miembro del grupo administradores de Project colección o tener el permiso Crear nuevos proyectos establecido en Permitir. Si es el propietario de la organización, se le agregará automáticamente al grupo administradores Project recopilación. Si no es miembro, ahora se agregará. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.
Un proyecto se crea dentro de una colección de proyectos. Si aún no ha creado una colección de proyectos, haga esto ahora. Para obtener más información, vea Crear una colección de proyectos.
Debe ser miembro del grupo administradores de Project colección o tener el permiso Crear nuevos proyectos establecido en Permitir. Si no es miembro, ahora se agregará. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.
Un proyecto se crea dentro de una colección de proyectos. Si aún no ha creado una colección de proyectos, haga esto ahora. Para obtener más información, vea Crear una colección de proyectos.
Debe ser miembro del grupo administradores de Project colección o tener el permiso Crear nuevos proyectos establecido en Permitir. Si no es miembro, ahora se agregará. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.
Pregunte al administrador sobre los siguientes recursos y obtenga permisos adicionales según sea necesario:
¿A qué colección de proyectos debe conectarse al crear el proyecto? Si instaló TFS mediante el Asistente para configuración básica del servidor, solo tiene una colección de proyectos denominada DefaultCollection. A menos que admita cientos de proyectos, debe crear todos los proyectos dentro de una única colección de proyectos. Si necesita crear recopilaciones adicionales, vea Administrar colecciones de proyectos.
¿Ha configurado SQL Server Analysis Services y SQL Server Reporting Services para la implementación? Si es así, pida al administrador que le agregue como miembro del grupo Administradores de contenido de Team Foundation. Debe ser miembro de este grupo en el servidor que hospeda SQL Server Reporting Services. Sin estos permisos, no se puede crear un proyecto. Para obtener más información, vea Conceder permisos para vero crear SQL Server informes .
¿Ha configurado una SharePoint web para la implementación? Puede configurar un portal SharePoint al crear el proyecto. Para ello, póngase en contacto con el administrador SharePoint para concederle permisos de control total en el servidor que hospeda SharePoint Products. De lo contrario, puede omitir este paso y configurar un portal más adelante.
Importante
Para crear un proyecto público o hacer público un proyecto privado, consulte Crear un proyecto público en su organización o Cambiar la visibilidad del proyecto, pública o privada. Debe habilitarse una configuración de directiva adicional para trabajar con proyectos públicos.
Crear un proyecto
Importante
Al crear un proyecto desde el portal web, se omiten varios archivos de plantilla de proceso. En concreto, no se admiten los archivos que crearían Administrador de informes sitio web. Puede agregar informes más adelante siguiendo las instrucciones proporcionadas en Agregar informes a un proyecto de Teams.
Seleccione Azure DevOps para abrir la página Proyectos.
Elija la organización y, a continuación, seleccione Nuevo proyecto.
Escriba la información en el formulario proporcionado. Proporcione un nombre para el proyecto. El nombre del proyecto no puede contener caracteres especiales, como , no puede comenzar con un carácter de subrayado, no puede comenzar ni terminar con un punto y debe tener / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] 64 o menos caracteres. Escriba una descripción opcional. Elija la visibilidad, el tipo de control de código fuente inicial y el proceso del elemento de trabajo. Para obtener más información, vea Elegir el control de versiones adecuado para el proyecto y Elegir un proceso.
Seleccione la visibilidad de pública o privada. Al elegir la visibilidad pública, cualquier persona de Internet puede ver el proyecto. Con visibilidad privada, solo las personas a las que se da acceso pueden ver el proyecto. Para obtener más información sobre los proyectos públicos, consulte Creación de un proyecto público en la organización. Si la opción Público no está disponible, debe cambiar la directiva.
Seleccione Crear. Aparece la página principal.
Seleccione una de las siguientes opciones para continuar:
Repos:clone o importe un repositorio, o bien inicialice un archivo LÉAME para la página de resumen del proyecto. Consulte Clone an existing Git repo (Clonar un repositorio de Git existente).
Elija la pestaña Página actual para obtener información sobre cómo crear un proyecto.
Seleccione Azure DevOps para abrir la página Proyectos.
Elija la organización y, a continuación, seleccione Crear proyecto.
Escriba la información en el formulario proporcionado. Proporcione un nombre para el proyecto. El nombre del proyecto no puede contener caracteres especiales, como , no puede comenzar con un carácter de subrayado, no puede comenzar ni terminar con un punto y debe tener / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ] 64 o menos caracteres. Escriba una descripción opcional. Elija la visibilidad, el tipo de control de código fuente inicial y el proceso del elemento de trabajo. Para obtener más información, vea Elegir el control de versiones adecuado para el proyecto y Elegir un proceso.
Seleccione la visibilidad del proyecto de pública o privada. Al elegir la visibilidad pública, cualquier persona de Internet puede ver el proyecto. Con visibilidad privada, solo las personas a las que se da acceso pueden ver el proyecto. Para obtener más información sobre los proyectos públicos, consulte Creación de un proyecto público en la organización. Si la opción Público no está disponible, debe cambiar la directiva.
Seleccione Crear. Aparece la página principal.
Seleccione una de las siguientes opciones para continuar:
Repos:clone o importe un repositorio, o bien inicialice un archivo LÉAME para la página de resumen del proyecto. Consulte Clone an existing Git repo (Clonar un repositorio de Git existente).
Elija la pestaña Vista previa de la página para obtener instrucciones.
Seleccione Azure DevOps para abrir la página Proyectos. A continuación, seleccione Crear proyecto.
En Crear un nuevo proyecto, proporcione un nombre para el proyecto y, opcionalmente, una descripción. Expanda Avanzadas para seleccionar el tipo de control de código fuente inicial y el proceso de elemento de trabajo.
Repos clonar o importar un repositorio, o bien inicializar un archivo LÉAME para la página de resumen del proyecto. Consulte Clone an existing Git repo (Clonar un repositorio de Git existente).
Seleccione Azure DevOps para abrir la página Proyectos. A continuación, seleccione Nuevo proyecto.
Complete el formulario proporcionado. Proporcione un nombre para el nuevo proyecto, tipo de control de código fuente inicial, proceso de elemento de trabajo.
La creación de un proyecto desde el portal web es compatible con TFS 2015.2 y versiones posteriores. Para versiones anteriores, use Team Explorer para crear un proyecto.
Importante
Al crear un proyecto desde el portal web, se omiten varios archivos de plantilla de proceso. En concreto, no se admiten los archivos que crearían Administrador de informes sitio web y SharePoint portal de proyectos. Todavía puede configurar Informes y SharePointmanualmente después de la creación del proyecto.
Si tiene TFS 2015.2 o una versión posterior, seleccione el botón de engranaje para abrir la página Proyectos. A continuación, elija Nuevo proyecto.
De lo contrario, para TFS 2015 o TFS 2015.1, abra la página de información general de administración eligiendo configuración. A continuación, seleccione Configuración del servidor y elija Nuevo proyecto.
Seleccione la página de administración de recopilación de la colección en la que desea crear el proyecto en el panel izquierdo. Seleccione Crear un proyecto.
Escriba la información en el formulario proporcionado. Proporcione un nombre para el nuevo proyecto, una breve descripción y seleccione su tipo de control de código fuente inicial y el proceso de seguimiento de elementos de trabajo.
Para Azure DevOps Server 2020, puede usar el siguiente comando para establecer la instancia del servidor, la colección y el proyecto predeterminados. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Parámetros
name: Necesario. Nombre del proyecto que se creará.
description:opcional. Breve descripción del proyecto. Incluya la descripción entre comillas.
open: opcional. Una vez que el comando crea un proyecto, se abre en el explorador web predeterminado.
org: opcional. Azure DevOps url de la organización. Obligatorio si no está configurado como predeterminado o se selecciona mediante git config . Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Ejemplo: https://dev.azure.com/MyOrganizationName/.
process: opcional. Modelo de proceso que se va a usar, como Agile,Basic,Scrum,CMMIu otro modelo de proceso personalizado. Agile es el valor predeterminado. Para más información, consulte Acerca de la personalización de procesos y los procesos heredados.
control de código fuente:opcional. Tipo de repositorio de control de código fuente que se creará para el proyecto: git (valor predeterminado) o tfvc. Si no es así, nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".
El siguiente comando crea un proyecto denominado MyFirstProject en la organización fabrikam. El proyecto tiene el proceso agile y el control de código fuente de Git. Para otras opciones de formato de salida, vea Formatos de salida CLI de Azure comandos.
az devops project create --name MyFirstProject --description "Test project 1" --org https://dev.azure.com/fabrikam/ --process Agile --source-control git --output table
ID Name Visibility Process Source Control
------------------------------------ --------------- ------------ --------- ----------------
be87c31a-fbb3-4377-b207-57a8caf65e31 MyFirstProject1 Private Agile Git
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
No se puede crear un proyecto desde Team Explorer para TFS-2018 y versiones posteriores, incluidos Azure DevOps Services.
Puede crear un proyecto desde Visual Studio o Team Explorer después de conectarse a un entorno Azure DevOps Server.
Abra la misma versión de Visual Studio que la versión de TFS a la que se va a conectar. Si no ve el panel de Team Explorer, seleccione VerTeam Explorer en el menú.
Descargue e instale Visual Studio Community obtener una copia gratuita de la versión más reciente.
Conectar a la colección de servidores y proyectos donde desea crear el proyecto.
Conectar desde un cliente que está en el mismo nivel de versión que TFS. Es decir, debe conectarse a TFS 2015 desde una versión de Visual Studio 2015.
Sugerencia
Si ejecuta Team Explorer desde un servidor que hospeda SharePoint Products y SQL Server Reporting Services, es posible que tenga que ejecutar Visual Studio como administrador.
Si es la primera vez que se conecta a TFS, deberá agregar TFS a la lista de servidores reconocidos.
Abra el Asistente para Project nuevo.
Asigne el nombre al proyecto. No especifique más de 64 caracteres.
Elegir una plantilla de procesos. Para obtener una comparación de las plantillas de proceso predeterminadas, vea Elegir un proceso.
Elija el control de versiones, ya sea repositorios distribuidos de Git o TFVC, un repositorio centralizado.
A menos que la colección de proyectos admita SharePoint portal de proyectos, ha terminado.
Si el botón Siguiente está activo, puede configurar el portal del proyecto.
Si tiene un problema, recibirá un mensaje de error y un vínculo al registro de creación del proyecto. Consulte Solución de problemas de creación de un proyecto para ver errores y excepciones específicos.
Cuando haya terminado, puede ver el proyecto en Team Explorer. También puede elegir el vínculo Acceso web para conectarse al proyecto desde el portal web.
Nota
Para TFS 2018 y versiones posteriores, use el portal web. No se admite la creación de un proyecto desde Visual Studio/Team Explorer para TFS 2018 y versiones posteriores, incluidos Azure DevOps Server 2019 y Azure DevOps Services.
TFS 2018 y versiones posteriores ya no admiten la integración nativa con SharePoint productos. Si planea actualizar a TFS 2018, lea Acerca de la integración SharePoint para obtener información sobre las opciones disponibles.
Conectar a un proyecto, colección o servidor desde el explorador web.
Para ver los proyectos definidos para una organización, seleccione Azure DevOps Azure DevOps para abrir la página Proyectos.
Elija la organización para ver la lista de proyectos. En la página se enumeran los dos o tres últimos proyectos a los que se conectó en la pantalla superior. Seleccione cualquier proyecto para conectarse a ese proyecto.
O bien, elija Configuración de la organización y, a continuación, seleccione Proyectos para enumerar todos los proyectos.
Elija la pestaña Página actual para obtener información sobre cómo conectarse a proyectos.
Conectar a un proyecto, colección o servidor desde el explorador web.
Para ver los proyectos definidos para una organización, seleccione Azure DevOps Azure DevOps para abrir la página Proyectos.
Elija la organización para ver la lista de proyectos. En la página se enumeran los dos o tres últimos proyectos a los que se conectó en la pantalla superior. Seleccione cualquier proyecto para conectarse a ese proyecto.
O bien, elija Configuración de la organización y, a continuación, seleccione Proyectos para enumerar todos los proyectos.
Elija la pestaña Vista previa de la página para obtener información.
Para ver los proyectos definidos para una colección, seleccione Azure DevOps Azure DevOps para abrir la página Proyectos.
Elija la colección para ver la lista de proyectos. En la página se enumeran los dos o tres últimos proyectos a los que se conectó en la pantalla superior. Elija cualquier proyecto para conectarse a ese proyecto.
O bien, seleccione Configuración de administración y, a continuación, elija Proyectos para enumerar todos los proyectos.
org: opcional. Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona a través de git config . Ejemplo: https://dev.azure.com/MyOrganizationName/.
skip:opcional. Número de resultados que se omitirán.
top:opcional. Número máximo de resultados que se muestran.
Nota
Para Azure DevOps Server 2020, puede usar el siguiente comando para establecer la instancia del servidor, la colección y el proyecto predeterminados. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Ejemplo
El siguiente comando enumera los proyectos definidos en la organización fabrikam. Para otras opciones de formato de salida, vea Formatos de salida CLI de Azure comandos.
az devops project list --org https://dev.azure.com/fabrikam/ --output table
ID Name Visibility
------------------------------------ ------------------ ------------
647c53b6-01aa-462a-adb7-da81d5620167 Agile 11 Private
c5dd744a-574b-4308-925f-386415dc6efc CMMI Private
d4195a58-96a9-4753-bbf9-4c0a4ef178e0 Demo 11 Private
80bb92c7-49b2-43db-9843-3baf8f64b85d Design Agile Private
5444a5d2-6bd9-4ad1-a25d-eea59855c2a9 Fabrikam Fiber Private
36946972-3a77-4bb4-875e-2f66a0f4652c Fabrikam Test Private
29bb9642-45f2-42bf-b391-f8701999c5fc My Basic Project Private
7aafdbeb-8de1-4e84-978f-d0ee4595b90e MyFirstProject Private
aba0ed07-3174-4793-9f2c-d2c5fa6b44d7 MyPublicProject Public
36ca09d1-9de0-4e3e-8277-e10b5cb96f7c Scrum 2.0 Private
Mostrar información del proyecto y abrir en el portal web
Puede enumerar la información del proyecto y, opcionalmente, abrir el proyecto en el portal web mediante el comando az devops project show.
az devops project show --project
[--open]
[--org]
Parámetros
project: requerido. Nombre o identificador del proyecto. Ejemplo: --project "Fabrikam Fiber".
open: opcional. Abra el proyecto en el explorador web predeterminado.
org: opcional. Azure DevOps url de la organización. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL . Obligatorio si no está configurado como predeterminado o se selecciona mediante git config . Ejemplo: https://dev.azure.com/MyOrganizationName/.
Nota
Para Azure DevOps Server 2020, puede usar el siguiente comando para establecer la instancia del servidor, la colección y el proyecto predeterminados. az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
Ejemplo
El siguiente comando muestra información de MyFirstProject en la organización fabrikam y la abre en el portal web. Para otras opciones de formato de salida, vea Formatos de salida CLI de Azure comandos.
az devops project show --project MyFirstProject --open --org https://dev.azure.com/fabrikam/ --output table
ID Name Visibility Process Source Control
------------------------------------ -------------- ------------ ----------------- ----------------
40751c1d-236b-418d-9df4-d5cc7c0e7bd6 MyFirstProject Private Scrum - Inherited Git
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
Desde Team Explorer, puede ver una lista de proyectos conectándose a una organización o servidor. Para obtener más información, vea Conectar a un proyecto.
Visual Studio 2019
Visual Studio 2017
Visual Studio 2015
Adición de un repositorio al proyecto
Desde el contexto de administración del portal web, puede agregar repositorios adicionales a un proyecto. Agregue repositorios git (distribuidos) o TFVC (centralizados). Puede crear muchos repositorios de Git, pero solo un único repositorio TFVC para un proyecto. Es posible que se requieran pasos adicionales para abordar los permisos. Para más información, consulte Uso de repositorios de Git y TFVC en el mismo proyecto.
Seleccione Nuevo repositorio.
Asigne un nombre al repositorio y seleccione Crear.
Nota
Se admite la capacidad de trabajar desde repositorios de Git y TFVC desde el mismo proyecto cuando se conecta a TFS 2015.1 y versiones posteriores.