From b1e1c2ea776db5e4f443b1dfd0a20e3ac7514f2c Mon Sep 17 00:00:00 2001 From: Mahfood Balfaqeeh Date: Tue, 23 Sep 2025 14:42:55 -0400 Subject: [PATCH 1/2] added more details on how to access the proxy server --- docs/Lab Tools/cloud-ide-kubernetes.md | 10 +++++++++- docs/Lab Tools/cloud-ide.md | 17 ++++++++++++++--- 2 files changed, 23 insertions(+), 4 deletions(-) diff --git a/docs/Lab Tools/cloud-ide-kubernetes.md b/docs/Lab Tools/cloud-ide-kubernetes.md index fdc2176..9759498 100644 --- a/docs/Lab Tools/cloud-ide-kubernetes.md +++ b/docs/Lab Tools/cloud-ide-kubernetes.md @@ -51,4 +51,12 @@ Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the - Noun-phrases - Relations (Transformer) - Syntax -- Launch Application - This is how you view the application you run within Cloud IDE. This will open a tab either within Cloud IDE or your browser +- Launch Application - This is how you view the application you run within Cloud IDE. Launch Application starts a proxy server that makes your local app accessible through the cloud IDE. You can run it with a built-in live server or with a framework-specific server (e.g., Flask, Express via npm) + + - How to use: + + - Start your server. (Note: If you used the built-in live server a notification with the port opened will appear) + + - Go to Skills Network Toolbox, and input the port. + + - Press "your application" to access the server within the cloud IDE, or open a new tab to access it from you browser diff --git a/docs/Lab Tools/cloud-ide.md b/docs/Lab Tools/cloud-ide.md index 6c8c03c..01caeb0 100644 --- a/docs/Lab Tools/cloud-ide.md +++ b/docs/Lab Tools/cloud-ide.md @@ -16,13 +16,13 @@ This area is divided into two sections: - Tai's Chat Interface: This interface facilitates communication between the learner and Tai, featuring chat history, and learners' message input field. - Lab instructions: These instructions guide learners through the learning activities and exercises. -### Cloud IDE Features +## Cloud IDE Features Cloud IDE empowers learners with a comprehensive IDE experience, including: - File/folder management: Organize and manage files and folders efficiently. - Terminal: Execute commands and interact with the underlying operating system. -#### Skills Network Toolbox: +### Skills Network Toolbox: Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the Skills Network Toolbox Icon button located on the left-hand side of the Cloud IDE menu bar. This toolbox offers a variety of tools to enhance the learning experience and facilitate completion of labs: @@ -50,4 +50,15 @@ Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the - Noun-phrases - Relations (Transformer) - Syntax -- Launch Application - This is how you view the application you run within Cloud IDE. This will open a tab either within Cloud IDE or your browser +- Launch Application - This is how you view the application you run within Cloud IDE. The **Launch Application** feature lets you view applications running inside the Cloud IDE. It starts a proxy server that makes your local app accessible through the IDE. You can use either the built-in live server or a framework-specific server (e.g., Flask for Python, Express for Node.js). + + - How to use: + + - **Start your server** + - If you use the built-in live server, a notification will display the port that was opened. + + - Go to **Skills Network Toolbox**, access **Launch Application** and input the port. + + - **Access your application:** + - Click **Your Application** to open the server inside the Cloud IDE, or + - Open it in a new browser tab. From 1d701d0ebd107864e076ef4fe6320b569c5ce870 Mon Sep 17 00:00:00 2001 From: Mahfood Balfaqeeh Date: Tue, 23 Sep 2025 15:14:37 -0400 Subject: [PATCH 2/2] improved clarity --- docs/Lab Tools/cloud-ide-kubernetes.md | 11 +++++++---- docs/Lab Tools/cloud-ide-openshift.md | 13 ++++++++++++- docs/Lab Tools/cloud-ide.md | 2 +- docs/troubleshooting.md | 10 +++++++++- 4 files changed, 29 insertions(+), 7 deletions(-) diff --git a/docs/Lab Tools/cloud-ide-kubernetes.md b/docs/Lab Tools/cloud-ide-kubernetes.md index 9759498..79a615c 100644 --- a/docs/Lab Tools/cloud-ide-kubernetes.md +++ b/docs/Lab Tools/cloud-ide-kubernetes.md @@ -51,12 +51,15 @@ Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the - Noun-phrases - Relations (Transformer) - Syntax -- Launch Application - This is how you view the application you run within Cloud IDE. Launch Application starts a proxy server that makes your local app accessible through the cloud IDE. You can run it with a built-in live server or with a framework-specific server (e.g., Flask, Express via npm) +- Launch Application - This is how you view the application you run within Cloud IDE. The **Launch Application** button lets you view applications running inside the Cloud IDE. It starts a proxy server that makes your local app accessible through the IDE. You can use either the built-in live server or a framework-specific server (e.g., Flask for Python, Express for Node.js). - How to use: - - Start your server. (Note: If you used the built-in live server a notification with the port opened will appear) + - **Start your server** + - If you use the built-in live server, a notification will display the port that was opened. - - Go to Skills Network Toolbox, and input the port. + - Go to **Skills Network Toolbox**, access **Launch Application** and input the port. - - Press "your application" to access the server within the cloud IDE, or open a new tab to access it from you browser + - **Access your application:** + - Click **Your Application** to open the server inside the Cloud IDE, or + - Open it in a new browser tab. \ No newline at end of file diff --git a/docs/Lab Tools/cloud-ide-openshift.md b/docs/Lab Tools/cloud-ide-openshift.md index 9ff4016..89d8e40 100644 --- a/docs/Lab Tools/cloud-ide-openshift.md +++ b/docs/Lab Tools/cloud-ide-openshift.md @@ -51,4 +51,15 @@ Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the - Noun-phrases - Relations (Transformer) - Syntax -- Launch Application - This is how you view the application you run within Cloud IDE. This will open a tab either within Cloud IDE or your browser +- Launch Application - This is how you view the application you run within Cloud IDE. The **Launch Application** button lets you view applications running inside the Cloud IDE. It starts a proxy server that makes your local app accessible through the IDE. You can use either the built-in live server or a framework-specific server (e.g., Flask for Python, Express for Node.js). + + - How to use: + + - **Start your server** + - If you use the built-in live server, a notification will display the port that was opened. + + - Go to **Skills Network Toolbox**, access **Launch Application** and input the port. + + - **Access your application:** + - Click **Your Application** to open the server inside the Cloud IDE, or + - Open it in a new browser tab. diff --git a/docs/Lab Tools/cloud-ide.md b/docs/Lab Tools/cloud-ide.md index 01caeb0..b07590d 100644 --- a/docs/Lab Tools/cloud-ide.md +++ b/docs/Lab Tools/cloud-ide.md @@ -50,7 +50,7 @@ Within Cloud IDE, learners can access the Skills Network Toolbox by clicking the - Noun-phrases - Relations (Transformer) - Syntax -- Launch Application - This is how you view the application you run within Cloud IDE. The **Launch Application** feature lets you view applications running inside the Cloud IDE. It starts a proxy server that makes your local app accessible through the IDE. You can use either the built-in live server or a framework-specific server (e.g., Flask for Python, Express for Node.js). +- Launch Application - This is how you view the application you run within Cloud IDE. The **Launch Application** button lets you view applications running inside the Cloud IDE. It starts a proxy server that makes your local app accessible through the IDE. You can use either the built-in live server or a framework-specific server (e.g., Flask for Python, Express for Node.js). - How to use: diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md index f7d74f3..013404b 100644 --- a/docs/troubleshooting.md +++ b/docs/troubleshooting.md @@ -173,4 +173,12 @@ If your application fails to load or displays errors: - Check the terminal for any error messages - Ensure all required dependencies are installed - Restart your application and try again -- Otherwise, ask to open a support ticket \ No newline at end of file +- Otherwise, ask to open a support ticket + +### Problem with user session + +If you encounter an issue with your session, try resetting the lab: + +1. Click the **Reset Lab** button at the bottom of the left menu bar. +2. **Log out** to complete the reset. +3. After logging out, reopen the lab from your original tab.