[docs] Managing workspaces via kubectl

[ibuziuk]

List of the functionality that is expected to be documented as part of new section Managing workspaces via kubectl - https://www.eclipse.org/che/docs/stable/end-user-guide/integrating-with-kubernetes/

• Managing users' workspaces with OpenShift APIs* (and/or Kubernetes API server)

• Listing workspaces*

• Creating workspaces*

• Restarting workspaces*

• Stopping workspaces*

• Starting stopped workspaces*

• Removing workspaces

Downstream issue - https://issues.redhat.com/browse/CRW-2160

[max-cx]

I got as far as testing $ chectl/oc get devworkspace --all-namespaces (TIP: --watch), but the rest of the commands don't have a clearcut presence in the kubectl/oc docs, so I'd better rely on the assigned developer to come up with approaches and commands that customers/users can confidently use in production.

Advice for the assignee developer: please first read the downstream issue (linked above) and then add your content to eclipse-che/che-docs#2487. (I just need the technical info from you, and I'll take care of writing the final PR text with your engineering reviews.)

[tolusha]

Here is some examples
#20671 (comment)

I think we can ask either QE team @dmytro-ndp if they have those commands in some internal docs

[dmytro-ndp]

@tolusha : that was correct assumption.

There are test scripts developed by @artaleks9 :

• create and start workspace: https://gitlab.cee.redhat.com/codeready-workspaces/crw-jenkins/-/blob/master/vars/dsUtil.groovy#L98
• stop workspace: https://gitlab.cee.redhat.com/codeready-workspaces/crw-jenkins/-/blob/master/vars/dsUtil.groovy#L201
• delete workspace: https://gitlab.cee.redhat.com/codeready-workspaces/crw-jenkins/-/blob/master/vars/dsUtil.groovy#L214

An example of create, start, stop, delete commands for NodeJsExpressWebApplication sample workspace with VS Code Editor: https://main-jenkins-csb-crwqe.apps.ocp-c1.prod.psi.redhat.com/job/Testing/job/e2e/job/basic/job/api-tests/672/consoleFull

[themr0c]

Reference in Jira: https://issues.redhat.com/browse/RHDEVDOCS-3216

[dkwon17]

Hello @max-cx @tolusha @dmytro-ndp, if no one has done so already, I am interested in working on this issue (adding content to eclipse-che/che-docs#2487 based on examples from #21808 (comment) and #21808 (comment))

[tolusha]

@dkwon17
That would be nice!

[max-cx]

@dkwon17 , thank you. I'm very much looking forward to working with you on this. I've assigned this issue to you now (my handle was just a placeholder). FYI, there's also the downstream issue (I've made you the assignee there too just for clarity): https://issues.redhat.com/browse/CRW-2160.

[ibuziuk]

@max-cx PR has been opened and waiting for review - eclipse-che/che-docs#2510

[max-cx]

@ibuziuk, thank you for the reminder. I am well aware of eclipse-che/che-docs#2510. I currently have no bandwidth to work on it before the holidays. This will be my priority when I'm back in January. I'm very much looking forward to working on the content that David has drafted and doing my review, testing, and editing.

[ibuziuk]

thank you. Closing