GitHub Deployments integra tus repositorios de GitHub directamente con tu sitio de WordPress.com, ofreciéndote un flujo de trabajo automatizado y controlado por versiones para desplegar plugins, temas o cambios completos en el sitio. Esta guía cubre el proceso de configuración y cómo gestionar tus repositorios conectados.
Esta función está disponible en sitios con los planes Business y Commerce de WordPress.com. Si tienes un plan Business, asegúrate de activarlo. Para los sitios con los planes gratuito, Personal y Premium, mejora tu plan para acceder a esta función.
Antes de poder desplegar un repositorio de GitHub en tu sitio de WordPress.com, primero tendrás que configurar la conexión entre los dos siguiendo estos pasos:
- Visita tu página Sitios: https://wordpress.com/sites/
- Haz clic en el nombre de tu sitio para ver la vista general del sitio.
- Haz clic en la pestaña Despliegues.
- Haz clic en el botón «Conectar». Si ves los repositorios en la lista, ya has conectado tu cuenta de GitHub. Continuar con el paso 11.
- Haz clic en el botón «Instalar la aplicaciónde WordPress.com».
- Se abrirá una nueva ventana y se te pedirá que inicies sesión en tu cuenta de GitHub si aún no lo has hecho. A continuación verás esta pantalla:
- Haz clic en el botón «Autorizar WordPress.com para desarrolladores».
- Selecciona la organización o cuenta de GitHub en la que se encuentra tu repositorio.
- Selecciona qué repositorio/repositorios te gustaría conectar:
- Todos los repositorios: Si seleccionas esta opción, WordPress.com tendrá acceso a todos los repositorios actuales y futuros que sean propiedad de la cuenta de GitHub seleccionada. Esto incluye los repositorios públicos que son de solo lectura.
- Solo seleccionar repositorios: Al seleccionar esta opción podrás elegir a qué repositorios puede acceder WordPress.com en la cuenta de GitHub seleccionada.
- Cuando hayas elegido una opción, haz clic en el botón Instalar.
- La nueva ventana se cerrará y volverás a WordPress.com. El repositorio o los repositorios que hayas elegido se mostrarán junto con la cuenta de GitHub asociada a ese repositorio:
- Haz clic en Seleccionar junto al repositorio que quieras conectar.
En este punto, deberías ver WordPress.com para desarrolladores en tus aplicaciones de GitHub autorizadas y en las aplicaciones de GitHub instaladas.
Una vez que selecciones un repositorio, tendrás que ajustar los ajustes de despliegue:
- Rama de despliegue: Por defecto es la rama por defecto del repositorio (normalmente
principal) pero se puede cambiar a la rama que quieras usar. - Directorio de destino: la carpeta del servidor donde quieres desplegar los archivos. Para los plugins, será
/wp-content/plugins/my-plugin-name. Para los temas, será/wp-content/themes/my-theme-name. Para un despliegue parcial del sitio (es decir, varios plugins o temas), puedes usar/wp-content. El contenido de un repositorio se fusionará con el contenido existente del sitio de WordPress en el directorio especificado. - Despliegues automáticos: puedes desplegar en WordPress.com de dos formas:
- Automático: Una vez que se haya confirmado el código, se desplegará en tu sitio de WordPress.com. Se recomiendan despliegues automáticos para los sitios de pruebas.
- Manual: El código se desplegará cuando solicites un despliegue. Se recomiendan despliegues manuales para los sitios de producción.
- Modo de despliegue: Hay dos tipos de despliegues:
- Simple: este modo copiará todos los archivos de una rama del repositorio al sitio y los desplegará sin post-procesamiento.
- Avanzado: Con este modo, puedes usar un script de workflow, activando los pasos de compilación personalizados, como la instalación de dependencias de Composer, la realización de pruebas de código previas al despliegue y el control del despliegue de archivos. Ideal para repositorios que necesitan software Composer o Node. Para obtener más información, consulta Despliegue avanzado a continuación.
Una vez configurados todos los ajustes, haz clic en el botón Conectar. Se añadirá tu repositorio:
Ten en cuenta que debes activar el primer despliegue, ya sea de forma automática o manual.Puedes conectar otro repositorio en cualquier momento haciendo clic en el botón «Conectar repositorio».
Con el despliegue avanzado, puedes proporcionar un script de flujo de trabajo para procesar los archivos de tu repositorio antes del despliegue. Esto abre muchas posibilidades, como la comprobación de tu código para garantizar que cumple con los estándares de codificación de tu equipo, la ejecución de pruebas unitarias, la exclusión de archivos del despliegue, la instalación de dependencias y mucho más. Para empezar, echa un vistazo a nuestras recetasde workflow.
Para configurar el despliegue avanzado:
- Aparecerá un formulario donde puedes configurar el despliegue.
- Haz clic en el nombre del repositorio para gestionar la conexión.
- En el lado derecho, en «Elige el modode despliegue», elige Avanzado.
- Si el repositorio ya contiene un archivo de workflow, puedes seleccionarlo aquí. El sistema comprobará si hay algún error en el archivo. Si no se encuentran errores, vaya al paso 7.
- También puedes seleccionar la opción «Crear nuevo flujode trabajo» para añadir un archivo de flujo de trabajo preconfigurado. Si eliges esta opción, se sobrescribirá el archivo del flujo de trabajo
wpcom.ymlsi ya existe en tu repositorio. - Haz clic en el botón «Instalar flujo de trabajo para mí» para enviar el archivo de flujo de trabajo al repositorio.
- Cuando se haya añadido y verificado un flujo de trabajo, haz clic en Actualizar. Tu repositorio ahora utilizará el despliegue avanzado.
Después de conectar tu repositorio de GitHub a un sitio, el siguiente paso es realmente desplegar tu código. Hay dos métodos de despliegue disponibles: automático y manual.
No se recomiendan despliegues automáticos para los sitios de producción en vivo, ya que cualquier cambio de código en el repositorio se despliega automáticamente desde GitHub al sitio en vivo. En su lugar, plantéate configurar el despliegue automático en un sitio de pruebas y sincronizarlo con el de producción cuando estés listo.
Los despliegues manuales te dan más control sobre cuándo se publican los cambios de código, ya que tendrás que activar manualmente cada despliegue. Recomendamos los despliegues manuales si no quieres utilizar un sitio de pruebas.
Para activar manualmente un despliegue:
- Visita tu página Sitios: https://wordpress.com/sites/
- Haz clic en el nombre de tu sitio para ver la vista general del sitio.
- Haz clic en la pestaña Despliegues.
- Haz clic en el menú de puntos suspensivos (⋮) del repositorio que quieras desplegar.
- Selecciona «Activar despliegue manual». Deberías ver una notificación de banner que diga «Se ha creado la ejecución de despliegue» y el estado de despliegue cambiará a «En cola».
- Espera a que se complete el despliegue (el estado cambiará a «Desplegado»).
- Vuelve a hacer clic en el menú de puntos suspensivos (⋮) y elige «Ver ejecucionesde despliegue».
- El registro de ejecución de despliegue muestra el autor y el commit desplegado. Si haces clic en la entrada de ejecución de despliegue, puedes ver más información.
Para gestionar las conexiones de tu repositorio de GitHub existente:
- Visita tu página Sitios: https://wordpress.com/sites/
- Haz clic en el nombre de tu sitio para ver la vista general del sitio.
- Haz clic en la pestaña Despliegues.
- Deberías ver la lista de conexiones.
La lista de conexiones se muestra si hay al menos una conexión entre un repositorio de GitHub y tu sitio. La lista incluye información relevante para cada conexión, como el nombre del repositorio y la rama, la última confirmación que se implementó en un sitio, cuándo ocurrió, dónde se colocó el código, cuánto tiempo duró la ejecución del despliegue y su estado.
Hay acciones adicionales disponibles después de hacer clic en el menú de puntos suspensivos (⋮):
- Activar despliegue manual: inicia una ejecución de despliegue en la última confirmación de la rama configurada.
- Ver ejecuciones de despliegue: Abre la vista de registros de ejecuciones de despliegue para el repositorio conectado.
- Configurar la conexión: abre la vista de gestionar la conexión del repositorio.
- Desconectar repositorio: elimina la conexión entre el repositorio y el sitio.
Los registros de ejecuciones de despliegues proporcionan un registro detallado paso a paso de cada despliegue, ya sea que se active de forma automática o manual. Estos registros te ayudan a hacer un seguimiento de los cambios, supervisar el estado del despliegue y solucionar los problemas que puedan surgir. Con acceso a los registros de las últimas 10 ejecuciones en un plazo de 30 días, puedes revisar fácilmente lo que ha ocurrido durante cada despliegue y asegurarte de que todo funciona sin problemas.
Para comprobar los registros de un despliegue:
- Visita tu página Sitios: https://wordpress.com/sites/
- Haz clic en el nombre de tu sitio para ver la vista general del sitio.
- Haz clic en la pestaña Despliegues.
- Haz clic en el menú de puntos suspensivos (⋮) situado junto al repositorio para el que quieres ver los registros.
- Selecciona «Ver ejecucionesde despliegue».
- La vista de lista Ejecuciones de despliegue muestra las confirmaciones que se han desplegado en el sitio, el estado del despliegue, la fecha y la duración.
- Haz clic en cualquier lugar de una ejecución para ampliar y ver más información sobre el despliegue.
Los registros proporcionan un registro de todos los comandos ejecutados, desde obtener código de GitHub hasta colocarlo en el directorio de destino. Puedes ampliar las líneas de registro para ver más información haciendo clic en «mostrar más».
Cuando desconectas un repositorio de GitHub de tu sitio, cualquier cambio futuro en el repositorio ya no afectará a tu sitio. Por defecto, los archivos desplegados permanecen en tu sitio, pero tienes la opción de eliminarlos durante el proceso de desconexión.
Para eliminar un repositorio:
- Visita tu página Sitios: https://wordpress.com/sites/
- Haz clic en el nombre de tu sitio para ver la vista general del sitio.
- Haz clic en la pestaña Despliegues.
- Haga clic en el menú de puntos suspensivos (⋮) del repositorio.
- Selecciona «Desconectar repositorio».
- Aparecerá una ventana de diálogo. Haz clic en el botón para eliminar los archivos asociados del sitio.
- Haz clic en «Desconectar repositorio» para cerrar el diálogo y desconectar el repositorio.
Ten en cuenta que WordPress.com para desarrolladores seguirá apareciendo en tus aplicaciones de GitHub instaladas y en tus aplicaciones de GitHub autorizadas. Esto se debe a que WordPress.com todavía tiene acceso al repositorio, pero la conexión se ha eliminado.
También puedes revocar el acceso de WordPress.com a tu cuenta de GitHub. Puedes hacerlo en cualquier momento visitando la configuración de Aplicaciones en GitHub.
Para revocar el acceso autorizado a la aplicación a tu cuenta de GitHub:
- Ve a las aplicaciones autorizadas de GitHub.
- Haz clic en Revocar junto a WordPress.com para desarrolladores.
- Haz clic en el botón «Entiendo, revocar acceso».
Incluso si revocas el acceso autorizado a la aplicación, se puede seguir implementando código porque la aplicación WordPress.com para desarrolladores sigue instalada en las cuentas seleccionadas.
Para revocar el acceso a la instalación de WordPress.com y desactivar la posibilidad de desplegar código en tu sitio de WordPress.com:
- Ve a las aplicaciones de GitHub instaladas.
- Haz clic en Configurar junto a WordPress.com para desarrolladores.
- En el área Zona de peligro, haz clic en Desinstalary, cuando se te pida, haz clic en Aceptar .
Eliminar WordPress.com de la lista de aplicaciones autorizadas no significa que los repositorios se eliminarán o dejarán de funcionar; tus repositorios seguirán existiendo en GitHub después de que revoques el acceso a WordPress.com, pero WordPress.com ya no podrá desplegar código.
