Contribuir al código de Linux de Azure

Los repositorios de código fuente de Azure Linux son públicos y siguen los flujos de trabajo estándar de las pull requests de código abierto. En este artículo se explica cómo contribuir al código de Azure Linux, incluida la forma de enviar PR, corregir errores y agregar nuevas funcionalidades para Azure Linux en escenarios de Azure.

Importante

Las contribuciones de código deben estar dirigidas a escenarios compatibles con Azure. Los compromisos de soporte técnico y de ciclo de vida de Microsoft solo se aplican a:

  • Azure Linux Virtual Machines (VM) / Virtual Machine Scale Sets (VMSS), host de contenedor de AKS e imágenes de contenedor.
  • Personalizaciones basadas en una imagen de Linux precompilada Azure (por ejemplo, con Image Customizer).

Los cambios específicos en equipo sin sistema operativo, entornos locales, otras nubes o imágenes creadas desde cero a partir de Orígenes de Azure Linux en GitHub corresponden a niveles ascendentes. Considere contribuir al proyecto original o al Fedora Linux Project en su lugar. Para obtener más información, consulte la Cómo contribuir a Azure Linux.

Note

Azure Linux 4.0 está ahora en preview y está estrictamente limitado a fines de evaluación y pruebas. No es adecuado para su uso en producción.

Antes de empezar

Todas las contribuciones de código requieren primero un problema. No abra una PR sin una incidencia vinculada aprobada por el mantenedor. Las PR presentadas sin aprobación previa de la incidencia podrían cerrarse sin revisarse.

Procedimientos recomendados de contribución

Al contribuir con código a Azure Linux, sigue estas prácticas recomendadas para garantizar que tu PR pueda revisarse de forma eficaz e integrarse correctamente:

  • Siga el modelo ascendente primero. Compruebe si un cambio corresponde a niveles ascendentes antes de abrir una PR en Azure Linux.
  • Abra un problema antes de iniciar un trabajo no trivial para que el equipo pueda confirmar la dirección y el ámbito.
  • Mantenga los PR pequeños y enfocados. Un cambio lógico por PR.
    • Si tiene cambios más grandes para enviar, empiece por presentar un problema para analizar el ámbito y el enfoque antes de intentar implementar el cambio completo.
  • Incluya pruebas o pruebas de validación al agregar un nuevo comportamiento o corregir errores.
  • Mencione incidencias relacionadas y cualquier envío ascendente en la descripción de la PR.
  • Envíe PR que solo introduzcan cambios funcionales. Evite enviar PR que solo cambien el estilo o reformateen el código sin modificar su comportamiento.

Para contribuir al código a Azure Linux:

  1. Cree o busque un problema para el trabajo que desea realizar. Espere a que un mantenedor apruebe el problema antes de iniciar el trabajo. Si un problema existente abarca su escenario, comente para indicar que le gustaría trabajar en él.
  2. Haz un fork del repositorio en GitHub.
  3. Cree una rama de main con un nombre descriptivo (por ejemplo, feature/tool-logging).
  4. Realice y confirme los cambios. Escribir mensajes de confirmación claros y concisos.
  5. Pruebe los cambios y asegúrese de que las compilaciones están limpias.
  6. Abre una PR para la rama de main. Rellene por completo la plantilla de la PR, vincule las incidencias relacionadas y describa qué ha cambiado y por qué.
  7. Responda a los comentarios. Los mantenedores pueden solicitar cambios y varias rondas de revisión son comunes.
  8. Espere a la aprobación. Una vez aprobada, tu PR se fusionará. No hay ninguna escala de tiempo garantizada para este paso.

Contrato de licencia de colaborador (CLA)

La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución.

Cuando envías una PR, un bot de CLA determina automáticamente si necesitas presentar un CLA y actualiza la PR en consecuencia (por ejemplo, añadiendo una comprobación de estado o un comentario). Si el bot indica que se requiere un CLA, sigue las instrucciones que proporciona para completar el proceso del CLA antes de que se pueda fusionar tu PR. Solo tiene que hacerlo una vez para todos los repositorios que usan el CLA de Microsoft.

Qué esperar durante la revisión

  • Las revisiones se realizan de la mejor manera posible. Los mantenedores revisan las contribuciones en función de su disponibilidad. Las escalas de tiempo pueden variar.
  • No se garantiza la aceptación. No todas las PR se fusionarán. Podríamos sugerir un enfoque diferente, pedirle que envíe primero al nivel ascendente o determinar que un cambio está fuera del ámbito.
  • Es posible que redirijamos. Si su cambio es más adecuado para un proyecto ascendente o Fedora, le informaremos y le ayudaremos a encontrar el lugar adecuado.
  • Los PR pequeños avanzan más rápido. Los cambios centrados con instrucciones de problemas claras y validación reproducible son los más fáciles de revisar.
  • Se cerrarán las PR inactivas. Es posible que los PR sin actividad durante 30 días se cierren automáticamente. Puede volver a abrir la PR si desea seguir trabajando en ella.

Contenido relacionado

Para obtener más información sobre cómo contribuir a Azure Linux, consulte Cómo contribuir a Azure Linux.

  • Last updated on