Adoptium® への貢献

このプロジェクトへのご興味をありがとうございます。

プロジェクト概要

Adoptium は、Java Development Kit (JDK) および関連技術の高品質で本番対応のディストリビューションを提供することに焦点を当てたオープンソースプロジェクトです。プロジェクトの主な目標は、Java Platform Standard Edition (Java SE) のオープンソース実装である OpenJDK の、ベンダー中立でコミュニティ主導のディストリビューションを作成することです。

Adoptium は、Windows、macOS、Linux などのさまざまなプラットフォームで、信頼性の高いテスト済みの OpenJDK ビルドをユーザーに提供することを目指しています。本プロジェクトは OpenJDK コミュニティと緊密に連携し、開発者、組織、Java 愛好者など多様な貢献者の専門知識を活かしています。

Adoptium の主要な目的の一つは、開発者と組織が OpenJDK ビルドに簡単にアクセスして利用できるようにすることです。安定性と互換性を確保するために徹底的にテストされたビルド済みバイナリを提供しています。これらのバイナリは無料で入手でき、ライセンスの制限なく開発者がプロジェクトで OpenJDK を採用・使用することを容易にしています。

Adoptium は長期サポート (LTS) ビルドも提供しており、これは安定した信頼性の高い Java ランタイム環境を必要とするエンタープライズや組織向けに特別に設計されています。LTS ビルドは定期的なアップデートとセキュリティパッチを受け取り、Java プラットフォームの長期的な維持・保守を保証します。

全体として、Adoptium は OpenJDK の信頼性が高く利用しやすいディストリビューションを提供し、Java エコシステム内での透明性・協調・コミュニティ主導のイノベーションを促進することを目指しています。

Eclipse コントリビューター契約

プロジェクトチームが貢献を受け入れる前に、コントリビューターは Eclipse コントリビューター契約 (ECA) に電子署名する必要があります。

コミッター以外が提供するコミットは、貢献がプロジェクトに提供される条件を作者が理解していることを示す Signed-off-by フィールドをフッターに含める必要があります。コミッター以外の者は、Eclipse Foundation のアカウントを持ち、https://adoptium.net/docs/eca-sign-off[Eclipse コントリビューター契約] (ECA) に署名済みである必要があります。

詳細については、https://www.eclipse.org/projects/handbook/#resources-commit[Eclipse コミッターハンドブック]および Adoptium ドキュメントをご覧ください。

Adoptium への貢献の提出

ECA に署名した後、GitHub のプルリクエスト (PR) を通じて貢献を提案できます。

注記: ここでは aqa-tests リポジトリへの貢献を例として説明します。

プロジェクトへの初めての貢献の場合、git リポジトリページの右上にある Fork ボタンをクリックしてリポジトリをフォークしてください。これにより、あなたの GitHub アカウント下にリポジトリのコピーが作成されます: https://github.com/<YourGitUserName>/aqa-tests.git

リポジトリをクローンします:

git clone https://github.com/<YourGitUserName>/aqa-tests.git

作業用の新しいブランチを作成します:

cd aqa-tests
git checkout -b my_new_branch
git remote add upstream https://github.com/adoptium/aqa-tests.git

作業を始める前に、ローカルブランチが最新であることを確認してください:

git fetch upstream
git rebase upstream/master

作業が完了したら、変更をトラックしてコミットします。

git add .
git commit -s -m "message about this PR"
  • コミットメッセージの例:

Update jtreg in openjdk test
This patch updates jtreg version from 5.1 to 6.1.
Fixes: #1234
Signed-off-by: Full Name <email>
  • 最初の行は PR タイトルです。変更内容を簡潔に記述してください。

  • 本文には PR に関する詳細情報を含めます。設計・根拠・変更内容の簡潔な説明を含めることをお勧めします。

  • コミットに関連する Issue がある場合は、Git キーワードを使用して自動的にクローズまたは関連付けてください。 https://help.github.com/articles/closing-issues-using-keywords/

  • フッターでコミットに署名してください。git commit-s を渡すことで自動的に追加できます(上記の例を参照)。

変更を Git リポジトリにプッシュします:

git push origin my_new_branch
  • git の履歴を上書きする必要がある場合は git push-f を使用できます。このフラグは慎重に使用してください。

PR を早めにオープンし、Create draft pull request オプションを使用することをお勧めします。これにより、他のメンバーが PR を確認し、早期フィードバックを得られ、より良い成果物の作成に役立ちます。

Jenkins サーバーでテストジョブを実行するアクセス権がある場合は、https://ci.adoptium.net/job/Grinder/[Grinder] を実行して PR を検証してください。アクセス権がない場合、PR のレビュアーがテストを実行します。レビュアーは変更内容に応じて追加のテスト実行を求める場合があります。

関連するすべての Grinder ジョブが通過していることを確認し、PR のコメントに Grinder のリンクを記載してください。変更は PR に適用される自動 PR ビルドも通過する必要があります。

PR の準備ができたら Ready for review に変換してください。

edit icon

このドキュメントの改善にご協力ください!

すべてのAdoptiumドキュメントはオープンソースです。誤りや不明な点がありましたらお知らせください。

ドキュメント著者
Ndacyayisenga-droidgdamstellison
Join our Slack channel to discuss and reach out to maintainers.Join Slack