Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Obtenga información sobre cómo abrir una wiki y aprovisionar un repositorio de Git para la wiki.
Cada proyecto de equipo puede tener una wiki. Use la wiki para compartir información con su equipo para comprender el proyecto y contribuir a él.
Cada wiki de proyecto de equipo cuenta con la tecnología de un repositorio de Git en el back-end. Al crear un proyecto de equipo, no se crea un repositorio de Git wiki de forma predeterminada. Aprovisione un repositorio de Git para almacenar los archivos Markdown de wiki o publique los archivos de Markdown existentes desde un repositorio git en una wiki.
Cada wiki de proyecto de equipo cuenta con la tecnología de un repositorio de Git en el back-end. Al crear un proyecto de equipo, no se crea un repositorio de Git wiki de forma predeterminada. Aprovisione un repositorio de Git para almacenar los archivos Markdown de wiki.
Requisitos previos
Debe tener un proyecto de equipo. Si aún no tiene un proyecto de equipo, cree uno en Azure DevOps.
Debe tener al menos acceso básico para crear y modificar una wiki.
Debe tener el permiso Crear repositorio para publicar código como wiki. De forma predeterminada, este permiso se establece para los miembros del grupo Project administradores de .
Cualquier persona que sea miembro del grupo de seguridad Colaboradores puede agregar o editar páginas wiki. Cualquier persona con acceso al proyecto de equipo, incluidas las partes interesadas,puede ver la wiki.
Debe tener un proyecto de equipo. Si aún no tiene un proyecto de equipo, cree uno local.
Debe tener el permiso Crear repositorio para publicar código como wiki. De forma predeterminada, este permiso se establece para los miembros del grupo Project administradores de .
Cualquier persona que sea miembro del grupo de seguridad Colaboradores puede agregar o editar páginas wiki. Cualquier persona con acceso al proyecto de equipo, incluidas las partes interesadas,puede ver la wiki.
Si necesita cambiar el proyecto de equipo, elija Azure DevOps examinar todos los proyectos de equipo y equipos.
Puede ver y abrir una página wiki definida para un proyecto mediante el az devops wiki show comando . Para empezar, consulte Introducción a la CLI Azure DevOps.
az devops wiki show --wiki
[--open]
[--project]
[--subscription]
Parámetros
--wiki:obligatorio. Nombre o identificador de la wiki.
--open: opcional. Abra la página wiki en el explorador web.
--project -p: opcional. Nombre o identificador del proyecto.
--subscription:opcional. Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
Abra una wiki denominada "myprojectwiki".
az devops wiki show --wiki myprojectwiki --open
Visualización de una página wiki
Para obtener el contenido de una página a través de la CLI Azure DevOps, escriba el az devops wiki show comando .
az devops wiki page show --path
--wiki
[--include-content]
[--open]
[--project]
[--subscription]
[--version]
Parámetros
--path: obligatorio. Ruta de acceso de la página wiki.
--wiki:obligatorio. Nombre o identificador de la wiki.
--include-content:opcional. Incluir contenido de la página.
--open: opcional. Abra la página wiki en el explorador web.
--project -p: opcional. Nombre o identificador del proyecto.
--version -v: opcional. Versión (ETag) de la página wiki.
Ejemplo
Obtenga el contenido de la página wiki con la ruta de acceso "mi wiki" en una wiki denominada "myprojectwiki".
az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
Aprovisione un nuevo repositorio de Git que almacena todas las páginas wiki y los artefactos relacionados. En la página de aterrizaje wiki, seleccione Crear Project Wiki. (Incluso si usa TFVC para el control de código fuente, puede crear una wiki con un repositorio de Git).
Si no tiene acceso para crear un repositorio de Git wiki o si no tiene acceso a ninguna de las wikis existentes, aparece el mensaje siguiente.
El administrador puede aprovisionar el repositorio de Git wiki o puede solicitarle que eleve los permisos. Las partes interesadas no pueden crear una wiki, ya que no tienen permisos para trabajar en Repos o code.
El repositorio de Git wiki se conoce como TeamProjectName.wiki. Por ejemplo, si el proyecto de equipo es "foobar", el repositorio wiki se etiqueta como "foobar.wiki".
Nota
Si desea aprovisionar más wikis, debe publicar código como wiki. Puede configurar varios repositorios wiki dentro de un solo proyecto.
¿Cómo puedo ir al repositorio de Git?
TeamProjectName.wiki no aparece en el menú desplegable de repositorios de Repos o Code. Tampoco está en la lista proporcionada desde las páginas repositorios de Project Configuración oProject Configuración control de versiones.
Sin embargo, puede acceder a él desde la siguiente dirección URL:
Si desea aprovisionar más de una wiki, debe publicar código como wiki. Puede configurar varios repositorios wiki dentro de un solo proyecto.
az devops wiki create [--mapped-path]
[--name]
[--org]
[--project]
[--repository]
[--type {codewiki, projectwiki}]
[--version]
Parámetros
mapped-path: (obligatorio para el tipo codewiki). Ruta de acceso asignada de la nueva wiki. Por ejemplo, puede especificar "/" para publicar desde la raíz del repositorio.
name: (obligatorio para el tipo codewiki). Nombre de la nueva wiki. Si no especifica un nombre para el tipo projectwiki, la nueva wiki se denominará TeamProjectName.wiki.
org: 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: --org https://dev.azure.com/MyOrganizationName/.
project:nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID . Obligatorio si no está configurado como predeterminado o se selecciona mediante git config .
repository: (obligatorio para el tipo codewiki). Nombre o identificador del repositorio desde el que se publica la wiki.
type: tipo de wiki que se creará. Los valores aceptados son projectwiki (valor predeterminado) y codewiki.
version: (obligatorio para el tipo codewiki). Nombre de la rama del repositorio desde la que se va a publicar el wiki de código.
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 comando siguiente crea una wiki denominada "Fabrikam Fiber" y muestra la salida en formato de tabla.
az devops wiki create --name "Fabrikam Fiber" --output table
ID Name Type
------------------------------------ ------------------- -----------
7edcc35b-89be-465e-855e-377ba8660af7 Fabrikam Fiber.wiki projectWiki
Azure DevOps comandos de la CLI no se admiten para Azure DevOps Server 2019 y versiones anteriores.
de equipo y equipos.
