68 lines
3.1 KiB
Markdown
68 lines
3.1 KiB
Markdown
---
|
|
stage: Create
|
|
group: IDE
|
|
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments"
|
|
---
|
|
|
|
# Gitpod **(FREE ALL)**
|
|
|
|
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/228893) in GitLab 13.4.
|
|
> - [Feature flag removed](https://gitlab.com/gitlab-org/gitlab/-/258206) in GitLab 13.8
|
|
|
|
With [Gitpod](https://www.gitpod.io/), you can describe your development environment as code to get fully
|
|
set up, compiled, and tested development environments for any GitLab project. The development
|
|
environments are not only automated but also prebuilt which means that Gitpod continuously builds
|
|
your Git branches like a CI/CD server.
|
|
|
|
This means you don't have to wait for dependencies to be downloaded and builds to finish, you can start
|
|
coding immediately. With Gitpod you can start coding instantly on any project, branch, and merge
|
|
request from your browser.
|
|
|
|
To use the GitLab Gitpod integration, it must be enabled for your GitLab instance. Users of:
|
|
|
|
- GitLab.com can use it immediately after it's [enabled in their user settings](#enable-gitpod-in-your-user-settings).
|
|
- GitLab self-managed instances can use it after:
|
|
1. It's [enabled and configured by a GitLab administrator](#configure-a-self-managed-instance).
|
|
1. It's [enabled in their user settings](#enable-gitpod-in-your-user-settings).
|
|
|
|
For more information about Gitpod, see the Gitpod [features](https://www.gitpod.io/) and
|
|
[documentation](https://www.gitpod.io/docs/).
|
|
|
|
## Enable Gitpod in your user settings
|
|
|
|
With the Gitpod integration enabled for your GitLab instance, to enable it for yourself:
|
|
|
|
1. On the left sidebar, select your avatar.
|
|
1. Select **Preferences**.
|
|
1. Under **Preferences**, locate the **Integrations** section.
|
|
1. Select the **Enable Gitpod integration** checkbox and select **Save changes**.
|
|
|
|
## Configure a self-managed instance **(FREE SELF)**
|
|
|
|
For self-managed GitLab instances, a GitLab administrator must:
|
|
|
|
1. Enable the Gitpod integration in GitLab:
|
|
1. On the left sidebar, at the bottom, select **Admin Area**.
|
|
1. On the left sidebar, select **Settings > General**.
|
|
1. Expand the **Gitpod** configuration section.
|
|
1. Select the **Enable Gitpod integration** checkbox.
|
|
1. Enter the Gitpod instance URL (for example, `https://gitpod.example.com` or `https://gitpod.io`).
|
|
1. Select **Save changes**.
|
|
1. Register the self-managed GitLab instance in Gitpod. For more information, see the [Gitpod documentation](https://www.gitpod.io/docs/configure/authentication/gitlab#registering-a-self-hosted-gitlab-installation).
|
|
|
|
GitLab users can then [enable the Gitpod integration for themselves](#enable-gitpod-in-your-user-settings).
|
|
|
|
## Launch Gitpod in GitLab
|
|
|
|
You can launch Gitpod directly from GitLab in one of these ways:
|
|
|
|
- **From a project repository:**
|
|
1. On the left sidebar, select **Search or go to** and find your project.
|
|
1. In the upper right, select **Edit > Gitpod**.
|
|
|
|
- **From a merge request:**
|
|
1. Go to your merge request.
|
|
1. In the upper-right corner, select **Code > Open in Gitpod**.
|
|
|
|
Gitpod builds your development environment for your branch.
|