Commit dcb9f8d6 authored by Marcel Amirault's avatar Marcel Amirault

Merge branch 'selhorn-nav-updates-2' into 'master'

Updated ordered list for latest standard

See merge request gitlab-org/gitlab!67697
parents e7bf6f62 18a79593
...@@ -14,15 +14,16 @@ GitLab CI/CD can be used with Bitbucket Cloud by: ...@@ -14,15 +14,16 @@ GitLab CI/CD can be used with Bitbucket Cloud by:
To use GitLab CI/CD with a Bitbucket Cloud repository: To use GitLab CI/CD with a Bitbucket Cloud repository:
1. <!-- vale gitlab.Spelling = NO --> In GitLab create a **CI/CD for external repository**, select 1. In GitLab, create a project:
**Repo by URL** and create the project. 1. On the top menu, select **Projects > Create new project**.
<!-- vale gitlab.Spelling = YES --> 1. Select **Run CI/CD for external repository**.
1. Select **Repo by URL**.
![Create project](img/external_repository.png) ![Create project](img/external_repository.png)
GitLab imports the repository and enables [Pull Mirroring](../../user/project/repository/repository_mirroring.md#pull-from-a-remote-repository). GitLab imports the repository and enables [Pull Mirroring](../../user/project/repository/repository_mirroring.md#pull-from-a-remote-repository).
1. In GitLab create a 1. In GitLab, create a
[Personal Access Token](../../user/profile/personal_access_tokens.md) [Personal Access Token](../../user/profile/personal_access_tokens.md)
with `api` scope. This is used to authenticate requests from the web with `api` scope. This is used to authenticate requests from the web
hook that is created in Bitbucket to notify GitLab of new commits. hook that is created in Bitbucket to notify GitLab of new commits.
...@@ -120,7 +121,7 @@ To use GitLab CI/CD with a Bitbucket Cloud repository: ...@@ -120,7 +121,7 @@ To use GitLab CI/CD with a Bitbucket Cloud repository:
\"$BITBUCKET_DESCRIPTION\",\"url\": \"$CI_PROJECT_URL/-/jobs/$CI_JOB_ID\" }" \"$BITBUCKET_DESCRIPTION\",\"url\": \"$CI_PROJECT_URL/-/jobs/$CI_JOB_ID\" }"
``` ```
1. Still in Bitbucket, create a `.gitlab-ci.yml` file to use the script to push 1. In Bitbucket, create a `.gitlab-ci.yml` file to use the script to push
pipeline success and failures to Bitbucket. pipeline success and failures to Bitbucket.
```yaml ```yaml
......
...@@ -27,27 +27,26 @@ repositories to GitLab, and the GitHub user must have the [owner role](https://d ...@@ -27,27 +27,26 @@ repositories to GitLab, and the GitHub user must have the [owner role](https://d
To perform a one-off authorization with GitHub to grant GitLab access your To perform a one-off authorization with GitHub to grant GitLab access your
repositories: repositories:
1. Open <https://github.com/settings/tokens/new> to create a **Personal Access 1. In GitHub, create a token:
Token**. This token is used to access your repository and push commit 1. Open <https://github.com/settings/tokens/new>.
statuses to GitHub. 1. Create a **Personal Access Token**.
1. Enter a **Token description** and update the scope to allow
The `repo` and `admin:repo_hook` should be enable to allow GitLab access to `repo` and `admin:repo_hook` so that GitLab can access your project,
your project, update commit statuses, and create a web hook to notify update commit statuses, and create a web hook to notify GitLab of new commits.
GitLab of new commits. 1. In GitLab, create a project:
1. On the top menu, select **Projects > Create new project**.
1. In GitLab, go to the [new project page](../../user/project/working_with_projects.md#create-a-project), select the **CI/CD for external repository** tab, and then click 1. Select **Run CI/CD for external repository**.
**GitHub**. 1. Select **GitHub**.
1. For **Personal access token**, paste the token.
1. Paste the token into the **Personal access token** field and click **List 1. Select **List Repositories**.
Repositories**. Click **Connect** to select the repository. 1. Select **Connect** to select the repository.
1. In GitHub, add a `.gitlab-ci.yml` to [configure GitLab CI/CD](../quick_start/index.md). 1. In GitHub, add a `.gitlab-ci.yml` to [configure GitLab CI/CD](../quick_start/index.md).
GitLab: GitLab:
1. Imports the project. 1. Imports the project.
1. Enables [Pull Mirroring](../../user/project/repository/repository_mirroring.md#pull-from-a-remote-repository) 1. Enables [Pull Mirroring](../../user/project/repository/repository_mirroring.md#pull-from-a-remote-repository).
1. Enables [GitHub project integration](../../user/project/integrations/github.md) 1. Enables [GitHub project integration](../../user/project/integrations/github.md).
1. Creates a web hook on GitHub to notify GitLab of new commits. 1. Creates a web hook on GitHub to notify GitLab of new commits.
## Connect manually ## Connect manually
...@@ -56,30 +55,25 @@ To use **GitHub Enterprise** with **GitLab.com**, use this method. ...@@ -56,30 +55,25 @@ To use **GitHub Enterprise** with **GitLab.com**, use this method.
To manually enable GitLab CI/CD for your repository: To manually enable GitLab CI/CD for your repository:
1. In GitHub open <https://github.com/settings/tokens/new> create a **Personal 1. In GitHub, create a token:
Access Token.** GitLab uses this token to access your repository and 1. Open <https://github.com/settings/tokens/new>.
push commit statuses. 1. Create a **Personal Access Token**.
1. Enter a **Token description** and update the scope to allow
Enter a **Token description** and update the scope to allow: `repo` so that GitLab can access your project and update commit statuses.
1. In GitLab, create a project:
`repo` so that GitLab can access your project and update commit statuses 1. On the top menu, select **Projects > Create new project**.
1. Select **Run CI/CD for external repository** and **Repo by URL**.
1. In GitLab create a **CI/CD project** using the Git URL option and the HTTPS 1. In the **Git repository URL** field, enter the HTTPS URL for your GitHub repository.
URL for your GitHub repository. If your project is private, use the personal If your project is private, use the personal access token you just created for authentication.
access token you just created for authentication. 1. Fill in all the other fields and select **Create project**.
GitLab automatically configures polling-based pull mirroring.
GitLab automatically configures polling-based pull mirroring. 1. In GitLab, enable [GitHub project integration](../../user/project/integrations/github.md):
1. On the left sidebar, select **Settings > Integrations**.
1. Still in GitLab, enable the [GitHub project integration](../../user/project/integrations/github.md) 1. Select the **Active** checkbox.
from **Settings > Integrations.** 1. Paste your personal access token and HTTPS repository URL into the form and select **Save**.
1. In GitLab, create a **Personal Access Token** with `API` scope to
Check the **Active** checkbox to enable the integration, paste your
personal access token and HTTPS repository URL into the form, and **Save.**
1. Still in GitLab create a **Personal Access Token** with `API` scope to
authenticate the GitHub web hook notifying GitLab of new commits. authenticate the GitHub web hook notifying GitLab of new commits.
1. In GitHub, from **Settings > Webhooks**, create a web hook to notify GitLab of
1. In GitHub from **Settings > Webhooks** create a web hook to notify GitLab of
new commits. new commits.
The web hook URL should be set to the GitLab API to The web hook URL should be set to the GitLab API to
...@@ -92,7 +86,7 @@ To manually enable GitLab CI/CD for your repository: ...@@ -92,7 +86,7 @@ To manually enable GitLab CI/CD for your repository:
Select the **Let me select individual events** option, then check the **Pull requests** and **Pushes** checkboxes. These settings are needed for [pipelines for external pull requests](index.md#pipelines-for-external-pull-requests). Select the **Let me select individual events** option, then check the **Pull requests** and **Pushes** checkboxes. These settings are needed for [pipelines for external pull requests](index.md#pipelines-for-external-pull-requests).
1. In GitHub add a `.gitlab-ci.yml` to configure GitLab CI/CD. 1. In GitHub, add a `.gitlab-ci.yml` to configure GitLab CI/CD.
<!-- ## Troubleshooting <!-- ## Troubleshooting
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment