question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

Improve the Che 6 -> Che 7 migration doc

See original GitHub issue

Is your task related to a problem? Please describe.

I tried to migrate Che 6 workspace to Che 7 using this documentation: https://www.eclipse.org/che/docs/che-7/converting-a-che-6-workspace-to-a-che-7-devfile/ and I have a few issues.

The first problem is accessing a documentation. There is already issue for that https://github.com/eclipse/che/issues/14308

The procedure of migration Che 6 workspace to Che 7: 1. Open an old Che 6 configuration file. There are steps how to access configuration file, but those steps are placed at the end of a document. I think it would be more useful to have them right in this step. I didn’t expect those steps to be at the end so I found them when I was done.

2. Create a new workspace from the similar Che 7 devfile There are not all old stack types listed in a Table 1, e.g. vert.x is missing.

3. Add the required number of blank projects. I’m not sure if I was supposed to create a workspace first and then go to the Workspace configuration to the Projects window to add a blank project or add a blank project before I create a workspace. If the second option is correct, this step should be a part of a second step. Anyway, I was not able to find out how to add blank project trying both ways:

  • adding project to already created workspace Screenshot from 2019-08-22 16-55-20

  • adding project when creating a workspace Screenshot from 2019-08-22 16-58-49

4. Change the required devfile fields. I don’t understand what a screenshot at this section is trying to say me: Screenshot from 2019-08-22 17-00-11

There is no info where to find a devfile fields. I think it would be useful to have there some example on how to change a devfile or even a link to a devfile specification, so user can see what are the parameters he/she can set up.

Describe the solution you’d like

Update obsolete information - user is not able to create blank project anymore. Replace that with the guide how can then import a project, which is used in Che 6 workspace (e.g. change a devfile, import project when creating Che 7 worksapce, import project from Theia UI). Make the documentation clearer even for users who are not much familiar with devfile or does not have much experiences with a Dashboard e.g. by including some screenshots or more precise steps.

Issue Analytics

  • State:closed
  • Created 4 years ago
  • Reactions:5
  • Comments:9 (8 by maintainers)

github_iconTop GitHub Comments

1reaction
Katka92commented, Aug 23, 2019

@ibuziuk I can try 😄 I’m not good at writing docs, so I will write some “draft” and ask you for a review then 😃

0reactions
Katka92commented, Aug 30, 2019

The PR with changes in migration docs was merged and documentation is currently up-to-date. I’ll close this issue. @olexii4 If you find some areas that are not described enough or you want to enhance the docs, please feel free to create another PR to https://github.com/eclipse/che-docs. Thank you!

Read more comments on GitHub >

github_iconTop Results From Across the Web

Migration Toolkit for Applications 5.1 Release Notes - Red Hat ...
This document describes new features, known issues, and resolved issues for the Migration Toolkit for Applications, version 5.1.4.
Read more >
| Page 319 | projects.eclipse.org
I would like to promote Pavol Baran to Eclipse Che committers. He made valuable contributions to Che server. https://github.com/eclipse/che/pulls?q=is%3Apr+ ...
Read more >
Che Goijaerts on LinkedIn: French Regulators Urge Financials to ...
French Regulators Urge Financials to Improve Transparency, Consistency on Fossil Fuel Exposure & Policies - ESG Today...
Read more >
Exclusive - Central America seeks $20 billion to ... - Reuters
The spending plan aims to revitalise one of the poorest and most dangerous regions in the world, and it seeks to raise growth...
Read more >
Samsung Magician & SSD Tools & Software Update
Download Samsung Magician, tools & software for Samsung SSDs, Data Migration Software, Firmware, Driver, Data Center Toolkit, Activation Software.
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found