Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions es.json
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,7 @@
"es/deploy/ghes",
"es/deploy/gitlab",
"es/deploy/bitbucket",
"es/deploy/azure-repos",
"es/deploy/rollbacks"
]
},
Expand Down
27 changes: 23 additions & 4 deletions es/autopilot.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,10 @@ Para cambiar en qué trabaja Autopilot y cuándo se ejecuta, [chatea con Autopil
## Requisitos previos
</div>

- Un proyecto de Mintlify conectado a un repositorio de GitHub o GitLab. Autopilot admite gitlab.com e instancias de [GitLab autoalojado](/es/deploy/gitlab-self-hosted).
- Un proyecto de Mintlify conectado a un repositorio de GitHub, GitLab o Azure Repos. Autopilot admite gitlab.com e instancias de [GitLab autoalojado](/es/deploy/gitlab-self-hosted).
- Para GitHub: la [GitHub App de Mintlify](/es/deploy/github) instalada en tu repositorio de documentación y en cualquier repositorio de código fuente que quieras que use Autopilot.
- Para GitLab: tu repositorio de documentación y cualquier repositorio de código fuente que quieras que use Autopilot conectados en la sección **GitLab OAuth** de tu [configuración de Git](https://app.mintlify.com/settings/project/git-settings). En GitLab, Autopilot abre merge requests en lugar de pull requests.
- Para Azure Repos: tu repositorio de documentación y cualquier repositorio de código fuente que quieras que use Autopilot conectados en tu [configuración de Git](https://app.mintlify.com/settings/project/git-settings). Consulta [Azure Repos](/es/deploy/azure-repos).

<div id="enable-autopilot">
## Habilitar Autopilot
Expand Down Expand Up @@ -77,6 +78,22 @@ Tu proyecto de documentación siempre se incluye como contexto obligatorio para

La lista **Additional projects** solo muestra los proyectos de GitLab conectados mediante GitLab OAuth. Para añadir un proyecto que no aparece en la lista, haz clic en **Add GitLab projects** al final de la lista para abrir tu configuración de Git y conectarlo.

<div id="azure-repos-repositories">
### Repositorios de Azure Repos
</div>

Si tu repositorio de documentación está en [Azure Repos](/es/deploy/azure-repos), la sección **Integrations** muestra una fila **Azure Repos** en lugar de una fila **GitHub**.

Para elegir los repositorios que Autopilot usa como contexto:

1. Haz clic en **Configure** en la fila **Azure Repos**.
2. En **Additional repositories**, selecciona los repositorios de código fuente que quieres que use Autopilot.
3. Haz clic en **Save**.

Tu repositorio de documentación siempre se incluye como contexto obligatorio para Autopilot, por lo que no puedes quitarlo.

La lista **Additional repositories** solo muestra los repositorios de Azure Repos conectados a tu organización de Mintlify. Para añadir un repositorio que no aparece en la lista, haz clic en **Add Azure DevOps repositories** al final de la lista para abrir tu configuración de Git y conectarlo.

<div id="slack-and-other-integrations">
### Slack y otras integraciones
</div>
Expand All @@ -95,7 +112,7 @@ Autopilot también puede ejecutarse cuando ocurre un evento en una integración

Autopilot normalmente confirma sus cambios en una nueva rama y abre una pull request. Nunca hace push directamente a tu rama de despliegue ni a la rama predeterminada del repositorio.

Autopilot crea sus commits a través de la API de GitHub, por lo que GitHub los firma y los muestra como **Verified**. Los commits de Autopilot funcionan con las reglas de protección de ramas que requieren commits firmados.
En GitHub, Autopilot crea sus commits a través de la API de GitHub, por lo que GitHub los firma y los muestra como **Verified**. Los commits de Autopilot funcionan con las reglas de protección de ramas que requieren commits firmados.

De forma predeterminada, las pull requests apuntan a tu rama de despliegue. Si tu equipo fusiona los cambios en una rama distinta de la que despliega tu sitio, díselo a Autopilot en un chat y apuntará a esa rama en su lugar.

Expand All @@ -113,6 +130,8 @@ Si tu equipo ya escribe la documentación del lanzamiento en su propia rama, Aut

De forma predeterminada, Autopilot asigna cada pull request al compañero de equipo que identifica como responsable del código que cambió, solicita su revisión y le notifica sobre la pull request. Para solicitar revisiones a más personas, cambiar quién revisa los cambios o cambiar cómo Autopilot notifica a alguien, díselo a Autopilot en un chat.

Autopilot no asigna las pull requests de Azure Repos ni solicita revisiones en ellas.

Si [conectas Slack](#slack-and-other-integrations) y Autopilot puede asociar al revisor con una cuenta de Slack, le envía un mensaje directo en Slack. De lo contrario, le envía un correo electrónico.

Cuando Autopilot abre la primera pull request de un lanzamiento de funcionalidad, envía un correo electrónico a los responsables del lanzamiento en el que indica si la pull request es un borrador, qué ocurre a continuación y los canales, proyectos, especificaciones y pull requests de código relacionados que está siguiendo.
Expand Down Expand Up @@ -141,9 +160,9 @@ Cuando Autopilot toma un comentario o un comentario de revisión en línea, reac

Autopilot solo responde a comentarios de personas que son propietarias del repositorio, pertenecen a la organización de GitHub propietaria del repositorio, son colaboradoras en él o tienen acceso de escritura a él. Ignora los comentarios de bots y los comentarios dirigidos a otra persona, como una pregunta que @menciona a un compañero de equipo.

Autopilot no responde a comentarios en merge requests de GitLab. Para pedir cambios en una merge request, envía un mensaje en su sugerencia en la página de Autopilot.
Autopilot no responde a comentarios en merge requests de GitLab ni en pull requests de Azure Repos. Para pedir cambios, envía un mensaje en la sugerencia en la página de Autopilot.

Si una pull request tiene conflictos de fusión o tus reglas de protección de ramas bloquean la fusión, resuélvelo en GitHub.
Si una pull request tiene conflictos de fusión o tus reglas de protección de ramas bloquean la fusión, resuélvelo en tu proveedor de Git.

<div id="chat-with-autopilot">
## Chatear con Autopilot
Expand Down
156 changes: 156 additions & 0 deletions es/deploy/azure-repos.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@
---
title: "Azure Repos"
description: "Conecta un repositorio de Azure Repos a Mintlify con Microsoft Entra ID para despliegues automáticos, vistas previas de pull requests, publicación desde el editor web y Autopilot."
keywords: ["Azure DevOps", "Microsoft Entra ID", "service hooks", "despliegues automatizados"]
---

<Info>
Azure Repos requiere un [plan Enterprise](https://mintlify.com/pricing?ref=azure-repos).
</Info>

Mintlify se conecta a Azure Repos mediante Microsoft Entra ID. Inicias sesión con tu cuenta de Microsoft para que Mintlify pueda verificar a qué organizaciones, proyectos y repositorios tienes acceso. Después, Mintlify usa la app de Mintlify en tu tenant de Entra para leer tu repositorio, crear service hooks, desplegar cada cambio enviado a tu rama de despliegue y crear despliegues de vista previa para las pull requests.

Mintlify admite organizaciones de Azure DevOps Services en `dev.azure.com` conectadas a Microsoft Entra ID, incluidas las organizaciones que todavía usan URL `*.visualstudio.com`. Mintlify no admite Azure DevOps Server.

<div id="requirements">
## Requisitos
</div>

- Una organización de Azure DevOps conectada a Microsoft Entra ID.
- Un administrador de Entra que conceda consentimiento a la app de Mintlify en tu tenant.
- La app de Mintlify añadida a tu organización de Azure DevOps con acceso **Basic** y al proyecto que contiene tu repositorio.
- La app de Mintlify en el grupo **Project Administrators** del proyecto. Azure DevOps solo permite a los administradores de proyecto crear service hooks.
- Una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar.
- Acceso de administrador a tu organización de Mintlify.
- Un archivo `docs.json` en tu repositorio.

<div id="set-up-a-new-azure-repos-connection">
## Configurar una nueva conexión con Azure Repos
</div>

Cuando abres [Git Settings](https://app.mintlify.com/settings/project/git-settings) por primera vez, un asistente de configuración te guía para conectar tu repositorio.

<Steps>
<Step title="Selecciona Azure Repos como tu proveedor">
1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), haz clic en **Connect to Azure Repos**.
2. Haz clic en **Continue**.
</Step>
<Step title="Mueve el contenido alojado en Mintlify">
Si actualmente alojas tu contenido en un repositorio gestionado por Mintlify, descárgalo como archivo zip. Extrae el contenido del zip y envía los archivos a tu repositorio de Azure Repos.

Si tu contenido ya está en Azure Repos, haz clic en **Continue setup**.
</Step>
<Step title="Conecta Microsoft">
1. Haz clic en **Connect Microsoft**.
2. Inicia sesión con una cuenta de Microsoft que sea administradora del proyecto o que tenga **Manage permissions** en el repositorio que quieres conectar.

Después de iniciar sesión, Microsoft te redirige a tu configuración de Git de Mintlify.
</Step>
<Step title="Selecciona el repositorio">
Selecciona los siguientes valores. Cada lista muestra los recursos a los que tiene acceso tu cuenta de Microsoft.

- **Organization**: la organización de Azure DevOps. Por ejemplo, en `https://dev.azure.com/acme/docs-project/_git/docs`, `acme` es la organización.
- **Project**: el proyecto que contiene el repositorio, como `docs-project`.
- **Repository**: el nombre del repositorio, como `docs`.
- **Deploy branch**: la rama que publica en tu sitio de documentación de producción, como `main`.
</Step>
<Step title="Configura un directorio de contenido (opcional)">
1. Si tu archivo `docs.json` está en un subdirectorio, activa **docs.json is in a subdirectory**.
2. Introduce la ruta al directorio que contiene tu archivo `docs.json`. Por ejemplo, si tu `docs.json` está en el directorio `apps/docs/`, introduce `apps/docs`.
</Step>
<Step title="Conecta el repositorio">
1. Haz clic en **Connect**.
2. Confirma el cambio.

Mintlify verifica que tu cuenta de Microsoft puede administrar el repositorio y que la rama de despliegue existe. Después, Mintlify registra los service hooks que mantienen sincronizados tu sitio y el editor web, e inicia tu primer despliegue.
</Step>
</Steps>

Para confirmar los service hooks, abre tu proyecto de Azure DevOps y ve a **Project settings** > **Service hooks**. Mintlify crea tres suscripciones **Web Hooks** para el repositorio: **Code pushed**, **Pull request created** y **Pull request updated**.

<div id="switch-an-existing-deployment-to-azure-repos">
## Cambiar un despliegue existente a Azure Repos
</div>

1. En la página [Git Settings](https://app.mintlify.com/settings/project/git-settings), selecciona **Azure Repos** como proveedor de Git.
2. Si no has conectado una cuenta de Microsoft, haz clic en **Connect Microsoft** e inicia sesión.
3. Selecciona la organización, el proyecto, el repositorio y la rama de despliegue, e introduce un directorio de contenido si es necesario.
4. Haz clic en **Switch to Azure Repos**.

<div id="change-the-connected-microsoft-account">
## Cambiar la cuenta de Microsoft conectada
</div>

Toda tu organización de Mintlify comparte la cuenta de Microsoft de Git Settings, y solo los administradores pueden cambiarla. Mintlify actualiza las credenciales de Microsoft automáticamente, por lo que no necesitas rotar tokens.

Para usar otra cuenta, abre la sección **Microsoft connection** en la página [Git Settings](https://app.mintlify.com/settings/project/git-settings) y haz clic en **Change account**. La nueva cuenta debe ser administradora del proyecto o tener **Manage permissions** en el repositorio.

<div id="edit-in-the-web-editor">
## Editar en el editor web
</div>

Puedes editar el contenido de Azure Repos en el [editor web](/es/editor). Cuando publicas, Mintlify envía una rama a Azure Repos y abre una pull request contra tu rama de despliegue.

- Las ramas que envías a Azure Repos se sincronizan con el editor.
- Los cambios en las pull requests de Azure Repos se sincronizan con la rama correspondiente del editor.
- Cuando eliminas una rama en Azure Repos, Mintlify la quita del editor.
- Si tu rama de despliegue tiene directivas de rama bloqueantes, como revisores obligatorios, publica mediante una pull request.

<div id="preview-deployments">
## Despliegues de vista previa
</div>

Cuando abres una pull request contra tu rama de despliegue, Mintlify compila un [despliegue de vista previa](/es/deploy/preview-deployments) y lo enlaza desde un estado **Mintlify preview ready** en la pull request. Mintlify vuelve a compilar la vista previa cuando envías cambios a la rama de la pull request y la elimina cuando completas o abandonas la pull request o eliminas la rama.

<div id="use-autopilot">
## Usar Autopilot
</div>

[Autopilot](/es/autopilot) funciona con Azure Repos. Se ejecuta cuando se fusiona código en los repositorios conectados y abre pull requests en tu repositorio de Azure Repos. Acepta o cierra sus pull requests en la página de Autopilot, o fusiónalas en Azure Repos.

Para darle más contexto a Autopilot, conecta tus repositorios de código fuente en Git Settings y luego selecciónalos en la fila **Azure Repos** de la página de Autopilot. Consulta [Repositorios de Azure Repos](/es/autopilot#azure-repos-repositories).

En Azure Repos, Autopilot no asigna pull requests, no solicita revisiones ni responde a comentarios en las pull requests. Para pedir cambios, envía un mensaje en la sugerencia en la página de Autopilot.

<div id="use-the-agent-in-slack">
## Usar el agente en Slack
</div>

El [agente en Slack](/es/agent/slack) funciona con Azure Repos. Cuando le pides que actualice tu contenido, abre una pull request en tu repositorio de Azure Repos.

<div id="troubleshooting">
## Solución de problemas
</div>

<AccordionGroup>
<Accordion title="Mintlify no pudo iniciar sesión en tu tenant de Microsoft Entra">
Pide a un administrador de Entra de tu tenant que conceda consentimiento a la app de Mintlify y, después, vuelve a conectar el repositorio.
</Accordion>
<Accordion title="La organización no está conectada a Microsoft Entra ID">
Mintlify solo admite organizaciones de Azure DevOps respaldadas por Microsoft Entra ID. Conecta tu organización a tu tenant de Entra en Azure DevOps, en **Organization settings** > **Microsoft Entra**, y vuelve a intentarlo.
</Accordion>
<Accordion title="Añade la app de Mintlify a la organización o al proyecto">
La app de Mintlify no puede leer el repositorio. Añade la app de Mintlify a tu organización de Azure DevOps con acceso **Basic** y añádela al proyecto que contiene el repositorio.
</Accordion>
<Accordion title="Añade la app de Mintlify al grupo Project Administrators">
Mintlify necesita crear service hooks para desplegar tus cambios automáticamente. Añade la app de Mintlify al grupo **Project Administrators** del proyecto y, después, vuelve a conectar el repositorio.
</Accordion>
<Accordion title="Tu cuenta de Microsoft no puede acceder al repositorio">
La cuenta de Microsoft conectada en Git Settings no puede leer el repositorio. Haz clic en **Change account** e inicia sesión con una cuenta que tenga acceso. Los usuarios con acceso **Stakeholder** no pueden leer repositorios en proyectos privados.
</Accordion>
<Accordion title="Solo un administrador del proyecto puede conectar el repositorio">
La cuenta de Microsoft conectada en Git Settings puede leer el repositorio, pero no administrarlo. Haz clic en **Change account** e inicia sesión con una cuenta que esté en el grupo **Project Administrators** del proyecto o que tenga **Manage permissions** en el repositorio.
</Accordion>
<Accordion title="No se encontró la rama de despliegue">
Comprueba que la rama existe en el repositorio y que el nombre coincide exactamente.
</Accordion>
<Accordion title="Los envíos no activan un despliegue">
En Azure DevOps, ve a **Project settings** > **Service hooks** y abre las suscripciones de Mintlify para revisar su historial de entregas. Confirma que enviaste los cambios a la rama de despliegue configurada en Mintlify.

Si una suscripción está deshabilitada o falta, haz clic en **Save** en [Git Settings](https://app.mintlify.com/settings/project/git-settings). Mintlify reemplaza cualquier suscripción que no esté en buen estado.
</Accordion>
</AccordionGroup>

<Note>
Mintlify no elimina los service hooks cuando cambias a otro proveedor de Git. Elimínalos en **Project settings** > **Service hooks**.
</Note>
1 change: 1 addition & 0 deletions fr.json
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,7 @@
"fr/deploy/ghes",
"fr/deploy/gitlab",
"fr/deploy/bitbucket",
"fr/deploy/azure-repos",
"fr/deploy/rollbacks"
]
},
Expand Down
Loading
Loading