Skip to content

Latest commit

 

History

History
132 lines (113 loc) · 7.03 KB

CHANGELOG.md

File metadata and controls

132 lines (113 loc) · 7.03 KB
Raw

Changelog for openjdk-build scripts (DEPRECATED)

DEPRECATION NOTES

THIS DOCUMENT IS NO LONGER POPULATED. PLEASE SEE THE MASTER COMMIT HISTORY FOR A MORE UP TO DATE LOG

Version 1.0.0 (14th May 2018)

See Commit History up until May the 14th 2018.

Version 2.0.0 (26th Sep 2018)

A major overhaul to split out Docker and Native builds, fix a host of small issues and place build jobs into Groovy Pipeline scripts.

Core Build Changes

  1. configureBuild.sh added. The pre-build configuration logic now resides in this script.
  2. native-build.sh added. This script is invoked for building (Adopt) OpenJDK binaries natively.
  3. docker-build.sh added. This script is invoked for building (Adopt) OpenJDK binaries in a Docker container.
  4. sbin/prepareWorkspace.sh added
  5. sbin/colour-codes.sh removed to simplify code
  6. makejdk.sh removed - please use makejdk-any-platform.sh or (rarely) sbin/build.sh instead.
  7. sbin/common-functions.sh removed and its logic split
  8. sbin/common/common.sh added
  9. sbin/common/config_init.sh added
  10. sbin/common/constants.sh added
  11. sbin/build.template added for saving off the configure configuration.
  12. sbin/signalhandler.sh moved to signalhandler.sh
  13. sbin/build.sh enhanced, now requires a 'saved' build configuration to run. This 'saved' build configuration is created by makejdk-any-platform.sh but can be generated manually as well.
  14. sign.sh added for code signing functionality.

makejdk-any-platform.sh, build.sh, makejdk.sh usage changes

  1. More versions added, jdk8u | jdk9 | jdk10 | jfx | amber are now all supported
  2. -B is now used for specifying the build number (long form --build-number).
  3. -bv is removed, (long form --variant changes to --build-variant).
  4. -c (long form --clean-docker-build) added to build from a clean docker container.
  5. -ca changes to -C, (long form --configure-args stays the same).
  6. --clean-git-repos, added to clean out any 'bad' local git repository you already have.
  7. -D (long form --docker) added for building in a docker container.
  8. -dsgc is removed, (long form --disable-shallow-git-clone stays the same).
  9. -ftd changes to -f, (long form --freetype-dir stays the same).
  10. --freetype-build-param, specify any special freetype build parameters (required for some OS's).
  11. --freetype-version, specify the version of freetype you are building.
  12. -h (long form --help) added.
  13. -i (long form --ignore-container) added to ignore existing docker container.
  14. -j, --jtreg and -js, --jtreg-subsets are removed as tests should be run via the aqa-tests repository / project.
  15. -J (long form --jdk-boot-dir added to set JDK boot dir.
  16. -nc (long form --no-colour) is removed.
  17. -p (long form --processors) added to set number of processors in docker build.
  18. -sf changes to -F, (long form --skip-freetype stays the same).
  19. --sudo added to run the docker container as root.
  20. --tmp-space-build (set a temporary build space if regular workspace is unavailable).
  21. -T (long form --target-file-name added to specify the final name of the binary.
  22. -u (long form --update-version) added to specify the update version.
  23. --use-jep319-certs added to use certs defined in JEP319 for OpenJDK 8/9 builds.
  24. -V (long form --jvm-variant specify the JVM variant (server or client).

Please see makejdk-any-platform.1 man page for full details.

Test Changes

  1. sbin/jtreg.sh removed (superseded by the openjdk-tests project).
  2. sbin/jtreg_prep.sh removed (superseded by the openjdk-tests project).

Docker Support

  1. -D (long form --docker) has been added for building in a docker container.
  2. -c (long form --clean-docker-build) has been added to build from a clean docker container.
  3. -i (long form --ignore-container) has been added to ignore existing docker container.
  4. -p (long form --processors) added to set number of processors in docker build.
  5. --sudo added to run the docker container as root.
  6. docker-build.sh added. This script is invoked for building (Adopt) OpenJDK binaries in a Docker container.
  7. docker/jdk/x86_64/ubuntu/Dockerfile updated for various bugfixes.
  8. docker/jdk/x86_64/ubuntu/dockerConfiguration.sh files added. These contain Docker specific environment variables that the build scripts need (as opposed to falsely picking up the underlying native env).

Build Farm Support

  1. New build-farm/make-adopt-build-farm.sh added for the new AdoptOpenJDK Build Farm jenkins pipeline to build Adoptium OpenJDK binaries. Sets the default environment variables that are currently set in individual jobs. This allows us to now track and version these variables.
  2. New build-farm/set-platform-specific-configurations.sh added for the new AdoptOpenJDK Build Farm jenkins pipeline to build Adoptium OpenJDK binaries. Sets the default environment variables that are currently set in individual jobs. This allows us to now track and version these variables.
  3. New _build-farm/platform-specific-configurations/.sh added for the new AdoptOpenJDK Build Farm jenkins pipeline to build Adoptium OpenJDK binaries. Sets the default environment variables for specific platforms that are currently set in individual jobs. This allows us to now track and version these variables.
  4. New _build-farm/sign-releases.sh added for the new AdoptOpenJDK Build Farm jenkins pipeline to code sign Adoptium OpenJDK binaries (Mac and Windows for now).
  5. pipelines/build/common/build_base_file.groovy added. This co-ordinates the various pipeline builds. 1.pipelines/build/common/create_job_from_template.groovy added. This dynamically creates jenkins jobs for a particular pipeline run (e.g. All jdk8u jobs).
  6. pipelines/build/common/openjdk_build_pipeline.groovy added. This forms the base pipeline code for each build.
  7. pipelines/build/openjdk<version>_<variant>_<nightly|release>_pipeline.groovy files added. These will eventually replace the existing individual jobs with a Pipeline for each version and variant.
  8. pipelines/build/openjdk<version>_pipeline.groovy files added. These define the configurations for the pipelines/build/common/create_job_from_template.groovy to create jobs for a pipeline run.

Documentation and Misc

  1. README.md updated to reflect new scripts.
  2. docs/build.md added to describe how the build farm utilises the scripts.
  3. docs/generateBuildMatrix.sh added to build a table of build statuses.
  4. docs/generateTestMatrix.sh added to build a table of test statuses.
  5. docs/images/AdoptOpenJDK_Build_Script_Relationships.png added to show script relationship.
  6. docs/images/sequence.svg added to show pipeline workflow.
  7. .gitignore changed to reflect new workspace base directory, please check your local .gitignore for the diff.
  8. makejdk-any-platform.1 man page updated to reflect new script usage.