Add parameter to change archive repository URL and check Jenkins version against archive repositories

[xT10r]

Description

This PR introduces the ability to set a custom URL for the Jenkins plugin archive repository and adds a flag --archive to check if the selected Jenkins version corresponds to archived repositories. If the version is found in the archive, the tool will use the update center from the archive repository; otherwise, it will use the default update center URL.

The functionality is implemented through:

1. A new command-line option --jenkins-archive-repo-mirror and the corresponding environment variable JENKINS_ARCHIVE_REPO_MIRROR to configure a custom archive repository mirror URL.
2. A new --archive flag to check whether the selected Jenkins version is available in the archived repositories. If the version is archived, the tool will fetch metadata from the archive repository.

This allows users to specify an alternative archive repository mirror, making it easier to work with repository mirrors, especially in environments with proxies like Sonatype Nexus Repository.

If no custom URL is provided, the default value https://archives.jenkins.io/ will be used, ensuring backward compatibility.

Changes

CliOptions.java:

• Added the --archive flag to specify if the tool should use archived update center metadata for plugin dependencies.
• Added the --jenkins-archive-repo-mirror CLI option to allow specifying a custom archive repository mirror URL.

Config.java:

• Added support for storing and retrieving the custom archive repository mirror URL.
• Added a method isUseArchiveAll() to check if the --archive flag is set and whether to use archived repository metadata.

Settings.java:

• Introduced a default URL constant for the archive repository mirror.

PluginManager.java:

• Updated to use the custom archive repository URL if specified, falling back to the default if not.
• Added logic to check if the Jenkins version exists in the archive repository based on the --archive flag. If the version is archived, the tool will use the update center URL from the archive repository.

PluginManagerUtils.java:

• Added the resolveArchiveUpdateCenterUrl() method to resolve the URL for the update center based on the Jenkins version and the provided archive mirror URL.
• Updated URL validation and construction logic to support the archive update center URLs.

Tests:

• Updated ConfigArchiveRepoTest.java to test the new --jenkins-archive-repo-mirror CLI option and the --archive flag.
• Added tests to verify that the tool correctly handles both default and custom archive repository URLs and the functionality of the --archive flag.

Testing done

Command-line option tests:

• Updated ConfigArchiveRepoTest.java to test the new --jenkins-archive-repo-mirror CLI option.

Archive version checks:

• Added tests to verify the functionality of the --archive flag, checking whether the Jenkins version exists in the archive repository and whether the correct update center URL is used.

Environment variable tests:

• Environment variable tests for JENKINS_ARCHIVE_REPO_MIRROR are not yet implemented but can be added if necessary.

Submitter checklist

• Make sure you are opening from a topic/feature/bugfix branch (right side) and not your main branch!
• Ensure that the pull request title represents the desired changelog entry
• Please describe what you did
• Link to relevant issues in GitHub or Jira
• Link to relevant pull requests, esp. upstream and downstream changes
• Ensure you have provided tests - that demonstrates feature works or fixes the issue