Beitragen zu Azure Linux-Code

Azure Linux-Quellrepositorys sind öffentlich und folgen standardmäßigen Open-Source-Pull-Anforderungsworkflows (PR). In diesem Artikel wird erläutert, wie Sie zu Azure Linux-Code beitragen, z. B. wie PRs übermittelt, Fehler behoben und neue Features für Azure Linux in Azure Szenarien hinzugefügt werden.

Important

Codebeiträge sollten auf Azure-unterstützte Szenarien abzielen. Microsoft Support- und Lebenszyklusverpflichtungen gelten nur für:

  • Azure Linux Virtual Machines (VM) / Virtual Machine Scale Sets (VMSS), AKS-Containerhost und Containerimages.
  • Anpassungen, die auf einem vorgefertigten Azure Linux-Image basieren (z. B. mit Image Customizer).

Änderungen, die speziell Bare Metal, On-Premises-Umgebungen, andere Clouds oder von Grund auf aus den Azure-Linux-Quellen auf GitHub erstellte Images betreffen, gehören ins Upstream-Projekt. Erwägen Sie stattdessen, zum Upstream-Projekt oder zum Fedora Linux Project beizutragen. Weitere Informationen finden Sie im How to contribute to Azure Linux.

Note

Azure Linux 4.0 befindet sich jetzt in preview und ist streng auf Auswertungs- und Testzwecke beschränkt. Es ist nicht für den Produktionseinsatz geeignet.

Bevor Sie anfangen

Für alle Codebeiträge ist zuerst ein Problem erforderlich. Öffnen Sie keine PR ohne ein verknüpftes, von einem Verwalter genehmigtes Problem. PRs, die ohne vorherige Genehmigung eines Problems eingereicht werden, können ohne Prüfung geschlossen werden.

Bewährte Methoden für Beiträge

Wenn Sie Code zu Azure Linux beitragen, befolgen Sie die folgenden bewährten Methoden, um sicherzustellen, dass Ihre PR effizient überprüft und erfolgreich zusammengeführt werden kann:

  • Folgen Sie dem Upstream-First-Modell. Überprüfen Sie, ob eine Änderung upstream gehört, bevor Sie eine PR auf Azure Linux öffnen.
  • Öffnen Sie ein Problem, bevor Sie nicht triviale Arbeit starten, damit das Team die Richtung und den Umfang bestätigen kann.
  • Halten Sie PRs klein und fokussiert. Eine logische Änderung pro PR.
    • Wenn Sie größere Änderungen einreichen müssen, beginnen Sie mit der Einreichung eines Problems, um den Umfang und den Ansatz zu besprechen, bevor Sie versuchen, die vollständige Änderung zu implementieren.
  • Schließen Sie Tests oder Überprüfungsnachweise ein, wenn Sie neues Verhalten hinzufügen oder Fehler beheben.
  • Verweisen Sie auf verwandte Probleme und alle upstream-Einreichungen in Ihrer PR-Beschreibung.
  • Senden Sie PRs, die nur funktionale Änderungen vornehmen. Vermeiden Sie das Einreichen von PRs, die Code nur umgestalten oder neu formatieren, ohne das Verhalten zu ändern.

So tragen Sie Code zu Azure Linux bei:

  1. Erstellen oder suchen Sie ein Problem für die Arbeit, die Sie ausführen möchten. Warten Sie, bis ein Verwalter das Problem genehmigt, bevor Sie mit der Arbeit beginnen. Wenn ein vorhandenes Problem Ihr Szenario abdeckt, kommentieren Sie, um anzugeben, dass Sie daran arbeiten möchten.
  2. Forken Sie das Repository auf GitHub.
  3. Erstellen Sie einen Branch ausgehend von main mit einem aussagekräftigen Namen (z. B. feature/tool-logging).
  4. Nehmen Sie Ihre Änderungen vor und committen Sie sie. Schreiben Sie klare, präzise Commit-Nachrichten.
  5. Testen Sie Ihre Änderungen , und stellen Sie sicher, dass Builds sauber sind.
  6. Öffnen Sie eine PR für die main Verzweigung. Füllen Sie die PR-Vorlage vollständig aus, verknüpfen Sie verwandte Probleme, und beschreiben Sie, was sich geändert hat und warum.
  7. Antworten Sie auf feedback. Maintainer können Änderungen anfordern, und mehrere Überarbeitungsrunden sind üblich.
  8. Warten Sie auf Genehmigung. Nach der Genehmigung wird Ihre PR zusammengeführt. Für diesen Schritt gibt es keinen garantierten Zeitrahmen.

Lizenzvertrag für Mitwirkende (Contributor License Agreement, CLA)

Für die meisten Beiträge ist die Zustimmung zu einer Lizenzvereinbarung für Mitwirkende (Contributor License Agreement, CLA) erforderlich, in der Sie erklären, dass Sie dazu berechtigt sind, uns die Rechte für die Nutzung Ihres Beitrags zu erteilen, und dies auch tun.

Wenn Sie eine PR übermitteln, bestimmt ein CLA-Bot automatisch, ob Sie eine CLA bereitstellen und die PR entsprechend aktualisieren müssen (z. B. durch Hinzufügen einer Statusüberprüfung oder eines Kommentars). Wenn der Bot angibt, dass eine CLA erforderlich ist, folgen Sie den Anweisungen, die er bereitstellt, um den CLA-Prozess abzuschließen, bevor Ihre PR zusammengeführt werden kann. Sie müssen dies nur einmal über alle Repositorys hinweg tun, indem Sie die Microsoft CLA verwenden.

Was sie während der Überprüfung erwarten sollten

  • Bewertungen erfolgen nach bestem Bemühen. Maintainer prüfen Beiträge je nach verfügbarer Kapazität. Zeitrahmen können variieren.
  • Die Akzeptanz wird nicht garantiert. Nicht jede PR wird zusammengeführt. Wir schlagen Ihnen möglicherweise einen anderen Ansatz vor, bitten Sie, zunächst upstream einzureichen, oder stellen fest, dass eine Änderung außerhalb des Umfangs liegt.
  • Wir können umleiten. Wenn Ihre Änderung besser für ein Upstream-Projekt oder Fedora geeignet ist, informieren wir Sie und helfen Ihnen, den richtigen Ort zu finden.
  • Kleine PRs kommen schneller voran. Fokussierte Änderungen mit klaren Problemaussagen und reproduzierbarer Validierung sind die einfachste Überprüfung.
  • Veraltete PRs werden geschlossen. PRs ohne Aktivität für 30 Tage werden möglicherweise automatisch geschlossen. Sie können erneut öffnen, wenn Sie die Arbeit an der PR fortsetzen möchten.

Verwandte Inhalte

Weitere Informationen zum Beitragen zu Azure Linux finden Sie unter How to contribute to Azure Linux.

  • Last updated on