feat(factory): detect devcontainer.json when no devfile is present

[rohanKanojia]

What does this PR do?

⚠️ Currently WIP

Related to eclipse-che/che#23458

Adds devcontainer.json detection to the factory URL resolver. When a factory URL points to a repo with no devfile but has .devcontainer/devcontainer.json (or .devcontainer.json), che-server returns a generated devfile that merges devcontainer commands with the default devfile.

The generated devfile adds five commands:

• start-devcontainer (manual command, not postStart): builds the devcontainer image via rootless podman, starts the nested container, runs lifecycle hooks, and publishes terminal runtime for the che-code extension
• rebuild-devcontainer: force rebuild (removes existing container/image)
• rebuild-devcontainer-no-cache: rebuild without cache
• show-devcontainer-log: tail the build/run log
• clean-devcontainer-images: remove the nested container and its image

The detection runs in URLFactoryBuilder.createFactoryFromDevfile() after all devfile locations are exhausted. The fallback chain is:

devfile.yaml / .devfile.yaml → .devcontainer/devcontainer.json / .devcontainer.json → default empty devfile

Key script behaviors:

• Runs all devcontainer lifecycle hooks (initializeCommand, onCreateCommand, updateContentCommand, postCreateCommand, postStartCommand, postAttachCommand)

Screenshot/screencast of this PR

What issues does this PR fix or reference?

It's related to eclipse-che/che#23458

Prerequisites:

• OpenShift 4.20+ cluster with Eclipse Che installed
• Container run capabilities enabled

Steps:

Detailed test plan https://gist.github.com/rohanKanojia/5bfdcb4bbea318f5949dafc495960a05

1. Deploy Che Server to an OpenShift Cluster >= 4.20
2. Ensure Nested containers functionality is enabled:

oc patch checluster/eclipse-che -n eclipse-che \
  --type='merge' -p \
  '{"spec":{"devEnvironments":{"disableContainerRunCapabilities":false}}}'

3. Build and deploy the custom che-server image, or patch the CheCluster CR to use a pre-built image with this change

oc patch checluster eclipse-che -n eclipse-che --type=merge -p '{
  "spec": { "components": { "cheServer": { "deployment": { "containers": [{
    "name": "che",
    "image": "quay.io/rokumar/che-server:latest",
    "imagePullPolicy": "Always"
  }] } } } }
}'

4. Open a repo with a devcontainer.json but no devfile, e.g. : https://github.com/coder/envbuilder-starter-devcontainer

PR Checklist

As the author of this Pull Request I made sure that:

• The Eclipse Contributor Agreement is valid
• Code produced is complete
• Code builds without errors
• Tests are covering the bugfix
• The repository devfile is up to date and works
• Sections What issues does this PR fix or reference and How to test this PR completed
• Relevant user documentation updated
• Relevant contributing documentation updated
• CI/CD changes implemented, documented and communicated

Release Notes

Reviewers

Reviewers, please comment how you tested the PR when approving it.

[openshift-ci]

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

[openshift-ci]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: rohanKanojia

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}