Mirroring GitLab organizations and repos in Snyk

You can use four commands in the available utils to import the entirety of GitLab repos into Snyk. You must configure both the GitLab token and Snyk token as environment variables to proceed.

General steps to import GitLab repos

Refer to individual documentation pages for detailed information. The general steps are as follows:

1. export GITLAB_TOKEN=*** and export SNYK_TOKEN=***

2. Generate organization data, for example, snyk-api-import orgs:data --source=gitlab --groupId=<snyk_group_id> Full instructions: Creating organizations in Snyk

3. Create organizations in Snyk: snyk-api-import orgs:create --file=orgs.json By following the full instructions on Creating organizations in Snyk you will create a snyk-created-orgs.json file with Snyk organization ids and integration ids that are needed for import.

4. Generate import data: snyk-api-import import:data --orgsData=snyk-created-orgs.json --source=gitlab --integrationType=gitlab Full instructions: Creating import targets data for import

5. Run import :DEBUG=*snyk* snyk-api-import importFull instructions: Kicking off an import

Re-importing new repos and Orgs only while mirroring

Once initial import is complete you can periodically check for new repos and make sure they are added into Snyk by following these steps, which are similar to the preceding steps to import repos.

1. export GITLAB_TOKEN=*** and export SNYK_TOKEN=***

2. Generate organization data in Snyk and skip any that do not have any repos by using --skipEmptyOrg snyk-api-import orgs:data --source=gitlab --groupId=<snyk_group_id> --skipEmptyOrg Full instructions: Creating organizations in Snyk

3. Create organizations in Snyk and this time skip any that have been created already with --noDuplicateNames parameter snyk-api-import orgs:create --file=orgs.json --noDuplicateNames By following the full instructions on Creating organizations in Snyk you will create a snyk-created-orgs.json file with Snyk organization ids and integration ids that are needed for import.

4. Generate import data: snyk-api-import import:data --orgsData=snyk-created-orgs.json --source=gitlab --integrationType=gitlab Full instructions: Creating import targets data for import

5. Optional - Generate the previously imported log to skip all previously imported repos in a Group: snyk-api-import-macos list:imported --integrationType=gitlab --groupId=<snyk_group_id> Full instructions: Kicking off an import

6. Run import: DEBUG=*snyk* snyk-api-import importFull instructions: Kicking off an import