Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

need documentation which will describe how to install eclipse-che on virtual machines available in a LAN network #21332

Closed
Divine1 opened this issue Apr 13, 2022 · 9 comments
Labels
area/doc Issues related to documentation area/install Issues related to installation, including offline/air gap and initial setup kind/question Questions that haven't been identified as being feature requests or bugs. status/doc-impact This issue has an impact on documentation, it is required to provide a documentation update.

Comments

@Divine1
Copy link

Divine1 commented Apr 13, 2022

Summary

i have couple of virtual machines in my local area network (LAN). i have configured a kubernetes cluster in my LAN by linking couple of machines. i have decided to install eclipse-che in this environment.

In the documentation i'm not able to find the installation instructions of eclipse-che on LAN or an environment equivalent of LAN (like installing eclipse-che on a k8s cluster configured by connected multiple AWS EC2 instances).
Please help me understand what steps can i follow to accomplish this.

https://www.eclipse.org/che/docs/che-7/installation-guide/installing-che/
image

Thank you

Relevant information

No response

@Divine1 Divine1 added the kind/question Questions that haven't been identified as being feature requests or bugs. label Apr 13, 2022
@che-bot che-bot added the status/need-triage An issue that needs to be prioritized by the curator responsible for the triage. See https://github. label Apr 13, 2022
@Divine1 Divine1 changed the title need documentation which will describe how to install eclipse-che in a virtual machines created in a LAN network need documentation which will describe how to install eclipse-che on virtual machines available in a LAN network Apr 13, 2022
@nickboldt nickboldt added area/doc Issues related to documentation team/doc area/install Issues related to installation, including offline/air gap and initial setup status/doc-impact This issue has an impact on documentation, it is required to provide a documentation update. labels Apr 14, 2022
@themr0c
Copy link
Contributor

themr0c commented Apr 14, 2022

This is a good idea for a blog post on https://che.eclipseprojects.io/.

The screenshot displays the obsolete Installing Che page. The latest stable version for this page is at https://www.eclipse.org/che/docs/stable/administration-guide/installing-che/. As you can see, we have removed from the documentation most installation procedures designed for specific infrastructures such as AWS, Azure, GCP, Kubespray, Docker desktop, Minishift, Kind. We don't have sufficient resources to maintain these procedures. We chose to deprecate the content rather than keeping misleading procedures.

The blog https://che.eclipseprojects.io/ is a better place for these procedures, and a blog post documenting this user story, as well as updated procedures for installing on various platforms, will be very welcome.

@amisevsk amisevsk removed the status/need-triage An issue that needs to be prioritized by the curator responsible for the triage. See https://github. label May 2, 2022
@amisevsk
Copy link
Contributor

amisevsk commented May 2, 2022

In general, many steps in the install are shared, and platform-specific documentation comes down to friction with specific cluster configurations. @Divine1 if you're willing to try stuff out, a starting point would be to use the chectl utility to attempt to install Che in the cluster:

# from a machine connected to the cluster
chectl server:deploy --platform=kubernetes

One friction point from running on a LAN is that it may be required to set up a LAN hostname for the cluster. I've not done this for Kubernetes, so I can't be of much help, but it is possible to e.g. run crc on a separate machine in your LAN: https://crc.dev/crc/#setting-up-remote-server_gsg by setting up local DNS for the cluster via /etc/hosts on client machines or at the network level.

@themr0c themr0c removed the team/doc label Jun 7, 2022
@themr0c
Copy link
Contributor

themr0c commented Jun 7, 2022

@l0rd Should we have a "Installing Che on Kubernetes using CLI" procedure based on https://www.eclipse.org/che/docs/stable/administration-guide/installing-che-on-openshift-using-cli/, but with --platform=kubernetes. But how would we test it and list the prerequisites?

@Divine1
Copy link
Author

Divine1 commented Jun 7, 2022

@themr0c please do it

@l0rd
Copy link
Contributor

l0rd commented Jun 7, 2022

@themr0c we can document that but users will need to setup an OIDC provider anyway as a prerequisite (except on minikube where we automatically configure Dex and on openshift where it's pre-installed).

@Divine1
Copy link
Author

Divine1 commented Jun 7, 2022

@themr0c we can document that but users will need to setup an OIDC provider anyway as a prerequisite (except on minikube where we automatically configure Dex and on openshift where it's pre-installed).

if there is a documentation with details containing how to setup an OIDC provider (for example dex ) , it will be very helpful for me

@l0rd
Copy link
Contributor

l0rd commented Jun 7, 2022

@Divine1 the issue I have linked has a lot of references. The Kubernetes documentation is here.

@Divine1
Copy link
Author

Divine1 commented Jun 8, 2022

@l0rd i faced an issue while integrating dex and eclipse-che. i have detailed my issue in this link #21452

please help me to fix this issue

@Divine1 Divine1 closed this as completed Jun 8, 2022
@Divine1
Copy link
Author

Divine1 commented Jun 29, 2022

@l0rd i have installed eclipce-che with dex as OIDC in my LAN on k8s cluster created using kubeadm. the setup is working fine (as of today). Thank you for the help

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/doc Issues related to documentation area/install Issues related to installation, including offline/air gap and initial setup kind/question Questions that haven't been identified as being feature requests or bugs. status/doc-impact This issue has an impact on documentation, it is required to provide a documentation update.
Projects
None yet
Development

No branches or pull requests

6 participants