Azure Linux 코드에 기여

Azure Linux 원본 리포지토리는 공용이며 표준 PR(오픈 소스 끌어오기 요청) 워크플로를 따릅니다. 이 문서에서는 PR을 제출하고, 버그를 수정하고, Azure 시나리오에서 Azure Linux에 대한 새 기능을 추가하는 방법을 포함하여 Azure Linux 코드에 기여하는 방법을 설명합니다.

Important

코드 기여는 Azure 지원되는 시나리오 대상으로 해야 합니다. Microsoft 지원 및 수명 주기 약정은 다음 경우에만 적용됩니다.

  • Azure Linux 가상 머신(VM) / 가상 머신 확장 집합(VMSS), AKS 컨테이너 호스트 및 컨테이너 이미지.
  • 미리 빌드된 Azure Linux 이미지(예: Image Customizer)를 기반으로 빌드된 사용자 지정입니다.

베어 메탈, 온-프레미스, 기타 클라우드 또는 GitHub의 Azure Linux 소스에서 처음부터 빌드한 이미지에만 해당하는 변경 사항은 업스트림에 해당합니다. 대신 업스트림 프로젝트 또는 Fedora Linux Project에 기여하는 것을 고려해 보세요. 자세한 내용은 Azure Linux에 기여하는 방법 참조하세요.

메모

Azure Linux 4.0은 현재 preview이며 평가 및 테스트 용도로 엄격하게 제한됩니다. 프로덕션 사용에 적합하지 않습니다.

시작하기 전 주의 사항:

모든 코드 기여에는 먼저 문제가 필요합니다. 연결되어 있고 관리자의 승인을 받은 이슈 없이 PR을 열지 마세요. 사전 문제 승인 없이 제출된 PR은 검토 없이 닫을 수 있습니다.

기여 모범 사례

Azure Linux에 코드를 제공하는 경우 다음 모범 사례를 따라 PR을 효율적으로 검토하고 성공적으로 병합할 수 있는지 확인합니다.

  • 업스트림 우선 모델을 따릅니다. Azure Linux에서 PR을 열기 전에 변경 내용이 업스트림에 속하는지 확인합니다.
  • 팀이 방향과 범위를 확인할 수 있도록 사소한 작업을 시작하기 전에 문제를 엽니다.
  • PR을 작고 집중하게 유지합니다. PR당 하나의 논리적 변경.
    • 제출할 더 큰 변경 내용이 있는 경우 먼저 문제를 제출하여 전체 변경 내용을 구현하기 전에 범위 및 접근 방식을 논의합니다.
  • 새 동작을 추가하거나 버그를 수정할 때 테스트 또는 유효성 검사 증거를 포함합니다.
  • PR 설명에 관련 이슈와 업스트림 제출 내역을 참조하세요.
  • 기능 변경만 하는 PR을 제출합니다. 동작을 변경하지 않고 코드를 다시 설정하거나 다시 포맷하는 PR을 제출하지 마세요.

Azure Linux에 코드를 기여하려면 다음을 수행합니다.

  1. 수행하려는 작업에 대한 문제를 만들거나 찾습니다. 작업을 시작하기 전에 유지 관리자가 문제를 승인할 때까지 기다립니다. 기존 이슈가 해당 상황을 다루고 있다면, 그 이슈에 작업하고 싶다는 뜻을 댓글로 남기세요.
  2. GitHub에서 리포지토리를 포크하세요.
  3. 을 기반으로 설명적인 이름을 가진 main(예, feature/tool-logging).
  4. 변경 내용을 만들고 커밋합니다. 명확하고 간결한 커밋 메시지를 작성합니다.
  5. 변경 내용을 테스트 하고 빌드가 깨끗한지 확인합니다.
  6. 분기에 대해 main. PR 템플릿을 완전히 입력하고, 관련 문제를 연결하고, 변경된 내용과 이유를 설명합니다.
  7. 피드백에 응답합니다. 유지 관리자가 변경 내용을 요청할 수 있으며 여러 차례의 수정 버전이 일반적입니다.
  8. 승인을 기다립니다. 승인되면 PR이 병합됩니다. 이 단계에 대한 보장된 타임라인은 없습니다.

CLA(기여자 사용권 계약)

대부분의 기여는 당신이 기여를 사용할 권리를 우리에게 부여할 권리가 있으며 실제로 그렇게 한다는 것을 선언하는 기여자 사용권 계약 (CLA)에 동의해야 합니다.

PR을 제출하면 CLA 봇은 CLA를 제공해야 하는지 여부를 자동으로 결정하고 그에 따라 PR을 업데이트합니다(예: 상태 확인 또는 주석 추가). 봇이 CLA가 필요하다고 표시하면 PR이 병합되기 전에 CLA 절차를 완료할 수 있도록 봇이 제공하는 지침을 따르세요. Microsoft CLA를 사용하여 모든 리포지토리에서 한 번만 이 작업을 수행해야 합니다.

검토 중에 예상되는 사항

  • 리뷰는 최선의 노력입니다. 유지 관리자는 용량이 허용하는 대로 기여도를 검토합니다. 타임라인은 다를 수 있습니다.
  • 수용은 보장되지 않습니다. 모든 PR이 병합되는 것은 아닙니다. 다른 방법을 제안하거나, 업스트림을 먼저 제출하도록 요청하거나, 변경 내용이 범위를 벗어났는지 확인할 수 있습니다.
  • 리디렉션할 수 있습니다. 업스트림 프로젝트 또는 Fedora에 대한 변경 내용이 더 적합한 경우 적절한 위치를 알려드리고 도움을 드리겠습니다.
  • 작은 PR은 더 빠르게 이동합니다. 명확한 문제 설명과 재현 가능한 유효성 검사를 통해 집중된 변경 내용을 검토하는 것이 가장 쉽습니다.
  • 오래된 PR은 닫힙니다. 30일 동안 활동이 없는 PR은 자동으로 닫혀 있을 수 있습니다. PR에서 작업을 계속하려면 다시 열 수 있습니다.

관련 콘텐츠

Azure Linux에 기여하는 방법에 대한 자세한 내용은 Azure Linux에 기여하는 방법 참조하세요.

  • Last updated on