Skip to content

Update gitlab-com.mdx #861

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions website/docs/cloud-docs/vcs/gitlab-com.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The rest of this page explains the GitLab.com versions of these steps.

-> **Note:** Alternately, you can skip the OAuth configuration process and authenticate with a personal access token. This requires using HCP Terraform's API. For details, see [the OAuth Clients API page](/terraform/cloud-docs/api-docs/oauth-clients).

## Step 1: On HCP Terraform, Begin Adding a New VCS Provider
## Step 1: On HCP Terraform, begin adding a new VCS provider

1. Go to your organization's settings and then click **Providers**. The **VCS Providers** page appears.

Expand All @@ -37,7 +37,7 @@ The rest of this page explains the GitLab.com versions of these steps.

Leave the page open in a browser tab. In the next step you will copy values from this page, and in later steps you will continue configuring HCP Terraform.

## Step 2: On GitLab, Create a New Application
## Step 2: On GitLab, create a new application

1. In a new browser tab, open [gitlab.com](https://gitlab.com) and log in as whichever account you want HCP Terraform to act as. For most organizations this should be a dedicated service user, but a personal account will also work.

Expand Down Expand Up @@ -68,33 +68,33 @@ Leave the page open in a browser tab. In the next step you will copy values from

1. Leave this page open in a browser tab. In the next step, you will copy and paste the unique **Application ID** and **Secret.**

## Step 3: On HCP Terraform, Set up Your Provider
## Step 3: On HCP Terraform, set up your provider

1. Enter the **Application ID** and **Secret** from the previous step, as well as an option **Name** for this VCS connection.

1. Click **Connect and continue.** This takes you to a page on GitLab.com, which asks if you want to authorize the app.

1. Click the green **Authorize** button at the bottom of the authorization page.

## Step 4: On HCP Terraform, Configure Advanced Settings (Optional)
## Step 4: On HCP Terraform, configure advanced settings (optional)

The settings in this section are optional. The Advanced Settings you can configure are:
- **Scope of VCS Provider** - You can configure which workspaces can use repositories from this VCS provider. By default the **All Projects** option is selected, meaning this VCS provider is available to be used by all workspaces in the organization.
- **Set up SSH Keypair** - Most organizations will not need to add an SSH key. However, if the organization repositories include Git submodules that can only be accessed via SSH, an SSH key can be added along with the OAuth credentials. You can add or update the SSH key at a later time.

### If You Don't Need to Configure Advanced Settings:
### If you do not need to configure advanced settings:

1. Click the **Skip and Finish** button. This returns you to HCP Terraform's VCS Provider page, which now includes your new GitLab client.

### If You Need to Limit the Scope of this VCS Provider:
### If you need to limit the scope of this VCS provider:

1. Select the **Selected Projects** option and use the text field that appears to search for and select projects to enable. All current and future workspaces for any selected projects can use repositories from this VCS Provider.

1. Click the **Update VCS Provider** button to save your selections.

### If You Do Need an SSH Keypair:
### If uou do need an SSH keypair:

#### Important Notes
#### Important notes

- SSH will only be used to clone Git submodules. All other Git operations will still use HTTPS.
- Do not use your personal SSH key to connect HCP Terraform and GitLab; generate a new one or use an existing key reserved for service access.
Expand Down