che icon indicating copy to clipboard operation
che copied to clipboard

Documentation and Solution Needed for Using Parent ID Devfiles Without an Internal Devfile Registry

Open eye0fra opened this issue 1 year ago • 4 comments

Is your enhancement related to a problem? Please describe

With the upcoming deprecation of the internal devfile registry in Eclipse Che, users will need alternative methods for accessing and using parent ID devfiles, particularly when following a "getting started" approach. Currently, the process for obtaining and referencing a parent devfile ID is unclear without relying on the internal registry.

The following issues need to be addressed:

  1. How to Obtain the Parent Devfile ID:

    • What are the recommended methods for obtaining the ID of a parent devfile if the internal registry is no longer available?
    • Is parent ID with URI is the only way supported ?
    • Is there a way to use the Che dashboard URL to acquire the parent devfile ID?
    • Would the by Kubernetes resource works (declariteve approach)?
  2. Support for Git Repositories:

    • If a Git repository URI is used to reference a parent devfile, how can this be implemented effectively?
    • The solution should work seamlessly with both public and private Git repositories. If using private repositories, what specific steps are required to ensure secure and successful access?
  3. Documentation and Guides:

    • There is a need for clear, comprehensive documentation that outlines the steps to follow for users who are transitioning away from the internal devfile registry.
    • This documentation should include examples, best practices, and potential pitfalls to avoid.

Describe the solution you'd like

The goal of this issue is to ensure that users of OpenShift DevSpaces can continue to use parent ID devfiles effectively even after the deprecation of the internal devfile registry. A well-documented and secure process should be established, with clear guidance on how to reference parent devfiles using alternative methods, including support for private Git repositories and Kubernetes resources.

Describe alternatives you've considered

No response

Additional context

No response

eye0fra avatar Aug 27 '24 14:08 eye0fra

@eye0fra could you please take a look at the devfile.io samples / docs - https://devfile.io/docs/2.3.0/referring-to-a-parent-devfile smth. like this should work for example:

parent:
  id: udi
  registryUrl: https://registry.stage.devfile.io/
  version: 1.0.0

ibuziuk avatar Oct 08 '24 13:10 ibuziuk

@eye0fra hello, please, find more follow up on this issues with answers inlined:

What are the recommended methods for obtaining the ID of a parent devfile if the internal registry is no longer available?

From Eclipse Che perspective the recommended approach is to use URI reference e.g. :

https://gist.github.com/ibuziuk/ff5d5da5ae887dfd420b10eda17a9a2e

A very powerful feature is that when images in parent devfile are updated the CDE would be also updated accordingly after restart (without any changes in the child devfile)

Is there a way to use the Che dashboard URL to acquire the parent devfile ID?

not sure I get the question, but for existing workspaces you can preview devfile definition from the User Dashboard:

Screenshot 2025-01-09 at 16 06 00

ibuziuk avatar Jan 09 '25 14:01 ibuziuk

Yes, we are currently using the same mechanism.

eye0fra avatar Jan 21 '25 16:01 eye0fra

The only thing is missing you need to make the repo public, there is no way to provide authentication.

eye0fra avatar Jan 23 '25 15:01 eye0fra

Issues go stale after 180 days of inactivity. lifecycle/stale issues rot after an additional 7 days of inactivity and eventually close.

Mark the issue as fresh with /remove-lifecycle stale in a new comment.

If this issue is safe to close now please do so.

Moderators: Add lifecycle/frozen label to avoid stale mode.

che-bot avatar Nov 12 '25 16:11 che-bot