Generated with sparks and insights from 33 sources
Introduction
-
Overview: Enabling the WebIDE Marketplace on GitLab allows users to install and manage extensions within the WebIDE environment.
-
Step 1: Navigate to your project in GitLab.
-
Step 2: Go to the merge request section and select 'Code' > 'Open in Web IDE'.
-
Step 3: Enable the feature flag for the WebIDE Extension Marketplace by running the command
Feature.enable(:allow_extensions_marketplace_in_workspace, Group.find(<group_id>))
in the Rails console. -
Step 4: Configure the extension marketplace URL by selecting either 'Open VSX marketplace' or 'Custom marketplace' and providing the necessary URL if custom.
-
Step 5: Verify the configuration by opening a terminal in the workspace and checking the value of
echo ${GL_EDITOR_ENABLE_MARKETPLACE}
. -
Step 6: Ensure the extensions gallery is properly set up by inspecting the
extensionsGallery
key in theproduct.json
file. -
Step 7: Test the setup by searching for and installing extensions within the WebIDE.
Introduction [1]
-
Purpose: The WebIDE Marketplace in GitLab allows users to enhance their development environment by installing various extensions.
-
Benefits: Provides flexibility and customization for developers, improving productivity and workflow.
-
Availability: This feature is available for both GitLab.com and self-managed instances, though it may require enabling specific feature flags.
-
Requirements: Ensure you have the necessary permissions to configure the WebIDE and access the Rails console for enabling feature flags.
Configuration Steps [2]
-
Step 1: Navigate to your project in GitLab and open the WebIDE.
-
Step 2: Go to the merge request section and select 'Code' > 'Open in Web IDE'.
-
Step 3: Enable the feature flag for the WebIDE Extension Marketplace by running the command
Feature.enable(:allow_extensions_marketplace_in_workspace, Group.find(<group_id>))
in the Rails console. -
Step 4: Configure the extension marketplace URL by selecting either 'Open VSX marketplace' or 'Custom marketplace' and providing the necessary URL if custom.
-
Step 5: Verify the configuration by opening a terminal in the workspace and checking the value of
echo ${GL_EDITOR_ENABLE_MARKETPLACE}
.
Feature Flag [3]
-
Purpose: The feature flag allows controlled rollout and testing of the WebIDE Extension Marketplace.
-
Command: Use
Feature.enable(:allow_extensions_marketplace_in_workspace, Group.find(<group_id>))
to enable the feature flag. -
Verification: Check the value of
echo ${GL_EDITOR_ENABLE_MARKETPLACE}
in the terminal to ensure the feature flag is enabled. -
Scope: This can be configured at the group level for SaaS or instance level for self-managed instances.
Custom Marketplace [1]
-
Option: Users can configure a custom marketplace URL for their extensions.
-
Configuration: Select 'Custom marketplace' and provide the necessary URL.
-
Use Case: Ideal for organizations that want to host custom, internal extensions or limit access to a subset of extensions.
-
Flexibility: Supports both public and self-hosted marketplaces, such as Open VSX.
Verification [2]
-
Terminal Check: Open a terminal in the workspace and run
echo ${GL_EDITOR_ENABLE_MARKETPLACE}
to verify the feature flag status. -
File Inspection: Check the
product.json
file for theextensionsGallery
key to ensure the marketplace is configured. -
Extension Search: Use the 'Extensions' tab in the WebIDE to search for and install extensions to confirm the setup.
Testing [2]
-
Workspace Creation: Create a new workspace and enable the feature flag.
-
Extension Installation: Search for and install extensions within the WebIDE to test the marketplace functionality.
-
Recommended Extensions: If your repository has a
.vscode/extensions.json
file, the WebIDE will prompt to install recommended extensions.
Troubleshooting [1]
-
Common Issues: Ensure the feature flag is correctly enabled and the marketplace URL is properly configured.
-
Logs: Check the WebIDE logs for any errors related to the extension marketplace.
-
Support: Refer to GitLab documentation or contact GitLab support for further assistance.
Related Videos
<br><br>
<div class="-md-ext-youtube-widget"> { "title": "GitLab Web IDE", "link": "https://www.youtube.com/watch?v=NpD54sVdt_0", "channel": { "name": ""}, "published_date": "Dec 16, 2021", "length": "" }</div>
<div class="-md-ext-youtube-widget"> { "title": "Web IDE Terminal - Setup using GDK", "link": "https://www.youtube.com/watch?v=MhwmqqaREw0", "channel": { "name": ""}, "published_date": "Apr 8, 2020", "length": "" }</div>
<div class="-md-ext-youtube-widget"> { "title": "GitLab Web IDE now open source", "link": "https://www.youtube.com/watch?v=Y2SsnCHJd2w", "channel": { "name": ""}, "published_date": "Apr 20, 2018", "length": "" }</div>