Description

Describe the purpose of this pull request.

Prevent deployment of client images with runtime versions newer than the target deployment's runtime version to ensure compatibility.

Changes:

• Add --deployment-id flag to 'astro remote deploy' command for validation
• Implement validateClientImageRuntimeVersion() function that:
  • Fetches deployment runtime version from platform API
  • Parses Dockerfile.client to extract client image runtime version
  • Rejects deployment if client version > deployment version
• Enhance ParseImageTag() function to extract runtime versions from image tags like '3.1-1-python-3.12-astro-agent-1.1.0'
• Add comprehensive test coverage for all validation scenarios
• Update docker parsing to support Dockerfile.client files

This ensures client images are compatible with the deployment environment and prevents runtime incompatibility issues.

🎟 Issue(s)

closes: #1957

🧪 Functional Testing

List the functional testing steps to confirm this feature or fix.

📸 Screenshots

❯ ../astro remote deploy --deployment-id cmieixby600r601mx9snv8pf1
Error: client image runtime version validation failed:

The client image is based on Astro Runtime version 3.1-5, which is newer than the deployment's runtime version 3.1-4.

To fix this issue, you can either:
1. Downgrade the client image version by updating the base image in Dockerfile.client to use runtime version 3.1-4 or earlier
2. Upgrade the deployment's runtime version to 3.1-5 or later

This validation ensures compatibility between your client image and the deployment environment.

Add screenshots to illustrate the validity of these changes.

📋 Checklist

• Rebased from the main (or release if patching) branch (before testing)
• Ran make test before taking out of draft
• Ran make lint before taking out of draft
• Added/updated applicable tests
• Tested against Astro-API (if necessary).
• Tested against Houston-API and Astronomer (if necessary).
• Communicated to/tagged owners of respective clients potentially impacted by these changes.
• Updated any related documentation