Documentation improvements for importing projects from GitLab.com
-
Update import documentation screenshots https://docs.gitlab.com/ee/workflow/importing/import_projects_from_gitlab_com.html -
Import documentation needs to include a section or a link for setting up OAuth integration. -
OAuth popup on instance should link to the updated docs - Current link: https://gitlab.com/help/integration/gitlab
-
OAuth documentation should open in a new tab, and not navigate the user away from their instance -
OAuth documentation needs to be updated https://gitlab.com/help/integration/gitlab -
Sign in to GitLab.com. Link to GitLab.com to help users easily access it
- Note that this step is for GitLab.com, not[bold] your own instance.
-
Navigate to your profile settings from the user dropdown in the upper right corner.
-
Select "Applications" from the menu.
-
Select "New application".This step doesn't exist -
Add a new application by providing the required details:
- Name: This can be anything. Consider something like
<Organization>'s GitLab
or<Your Name>'s GitLab
or something else descriptive. - Redirect URI:
http://your-gitlab.example.com/import/gitlab/callback http://your-gitlab.example.com/users/auth/gitlab/callback
The first link is required for the importer and second for the authorization.
- Name: This can be anything. Consider something like
-
Click
Submit"Save application" -
You should now see a Client ID and Client Secret near the top right of the page (see screenshot).
- Keep this page open as you continue configuration.
[Needs updated screenshot]
-
On your GitLab server, open the configuration file.For omnibus package:sudo editor /etc/gitlab/gitlab.rb
For installations from source:cd /home/git/gitlab sudo -u git -H editor config/gitlab.yml
-
See Initial OmniAuth Configuration for initial settings.I don't get why this is it's own step. -
Add the provider configuration:For omnibus package:gitlab_rails['omniauth_providers'] = [ { "name" => "gitlab", "app_id" => "YOUR_APP_ID", "app_secret" => "YOUR_APP_SECRET", "args" => { "scope" => "api" } } ]
For installations from source:- { name: 'gitlab', app_id: 'YOUR_APP_ID', app_secret: 'YOUR_APP_SECRET', args: { scope: 'api' } }
-
Change 'YOUR_APP_ID' to the Application ID from the GitLab.com application page. -
Change 'YOUR_APP_SECRET' to the secret from the GitLab.com application page. -
Save the configuration file.-
Remove steps 8-13 and replace with UI configuration -
[TAURIE TODO: Add mockup]
-
-
-
Reconfigure or restart GitLab for the changes to take effect if you installed GitLab via Omnibus or from source respectively.
-
Ability to restart via the UI? Refresh after hitting save somehow?
-
-