Acerca de las notas de lanzamiento generadas automáticamente
Las notas de lanzamiento generadas automáticamente proporcionan una alternativa de automatización para escribir notas de lanzamiento manualmente para tus lanzamientos de GitHub. Con las notas de lanzamiento generadas automáticamente, puedes generar rápidamente un resumen del contenido de un lanzamiento. Las notas de lanzamiento generadas automáticamente incluyen una lista de solicitudes de cambio fusionadas, una lista de contribuyentes al lanzamiento y un enlace a una bitácora de cambios completa.
También puedes personalizar tus notas de lanzamiento automatizadas, utilizando etiquetas para crear categorías personalizadas para organizar las solicitudes de cambio que quieras incluir y excluyendo ciertas etiquetas y usuarios para que no aparezcan en la salida.
Crear notas de lanzamiento generadas automáticamente para un lanzamiento nuevo
-
En tu instancia de GitHub Enterprise Server, visita la página principal del repositorio.
-
A la derecha de la lista de archivos, haz clic en Lanzamientos.
-
Haz clic en Borrador de un nuevo lanzamiento.
-
Teclea un número de versión para tu lanzamiento. Como alternativa, selecciona una etiqueta existente.
-
Si creaste una etiqueta nueva, utiliza el menú desplegable para seleccionar la rama que contiene el proyecto que quieres lanzar.
-
En la esquina derecha de la caja de texto de descripción, haz clic en Auto generar notas de lanzamiento.
-
Verifica las notas generadas para garantizar que incluyan toda (y únicamente) la información que quieras incluir.
-
Opcionalmente, para incluir los archivos binarios tales como programas compilados en tu lanzamiento, arrastra y suelta o selecciona manualmente los archivos en la caja de binarios.
-
Para notificar a los usuarios que el lanzamiento no está listo para producción y puede ser inestable, selecciona Esto es un pre-lanzamiento.
-
Si estás listo para publicitar tu lanzamiento, haz clic en Publicar lanzamiento. Para seguir trabajando luego en el lanzamiento, haz clic en Guardar borrador.
Configurar las notas de lanzamiento generadas automáticamente
- En tu instancia de GitHub Enterprise Server, visita la página principal del repositorio.
- En la parte superior de la lista de archivos, utilizando el menú desplegable de Agregar archivo, da clic en Crear archivo nuevo.
- En el campo de nombre de archivo, teclea
.github/release.yml
para crear el archivorelease.yml
en el directorio.github
. - En el archivo, el utilizar las opciones de configuración siguientes, especificarán en YAML las etiquetas de solicitudes de cambio y los autores que quieras excluir de este lanzamiento. También puedes crear categorías nuevas y listar las etiquetas de la solicitud de cambios que se deben incluir en cada una de ellas.
Opciones de configuración
Parámetro | Descripción |
---|---|
changelog.exclude.labels | Una lista de etiquetas que excluyen una solicitud de cambios para que no aparezca en las notas de lanzamiento. |
changelog.exclude.authors | Una lista de manejos de inicio de sesión de usuarios o bots cuyas solicitudes de cambio deben excluirse de las notas de lanzamiento. |
changelog.categories[*].title | Requerido. El título de una categoría de cambios en las notas de lanzamiento. |
changelog.categories[*].labels | Requerido. Las etiquetas que califican a una solicitud de cambios para esta categoría. Utiliza * como un comodín para solicitudes de cambio que no empataron con ninguna de las categorías anteriores. |
changelog.categories[*].exclude.labels | Una lista de etiquetas que excluye una solicitud de cambio para que no aparezca en esta categoría. |
changelog.categories[*].exclude.authors | Una lista de manejos de inicio de sesión de usuarios o bots cuyas solicitudes de cambio deben excluirse de esta categoría. |
Ejemplo de configuración
# .github/release.yml
changelog:
exclude:
labels:
- ignore-for-release
authors:
- octocat
categories:
- title: Breaking Changes 🛠
labels:
- Semver-Major
- breaking-change
- title: Exciting New Features 🎉
labels:
- Semver-Minor
- enhancement
- title: Other Changes
labels:
- "*"