screwdriver-scm-gitlab
v4.1.0
Published
GitLab implementation for the scm-base class
Downloads
410
Readme
scm-gitlab
This scm plugin extends the scm-base, and provides methods to fetch and update data in Gitlab.
Usage
npm install screwdriver-scm-gitlab
Initialization
The class has a variety of knobs to tweak when interacting with GitLab.
| Parameter | Type | Description | | :------------- | :---- | :-------------| | config | Object | Configuration Object | | config.gitlabHost (gitlab.com) | String | GitLab hostname/port | | config.gitlabProtocol (https) | String | The protocol to use: http or https | | config.username (sd-buildbot) | String | GitLab username for checkout | | config.email ([email protected]) | String | GitLab user email for checkout | | config.https (false) | Boolean | Is the Screwdriver API running over HTTPS | | config.oauthClientId | String | OAuth Client ID provided by GitLab application | | config.oauthClientSecret | String | OAuth Client Secret provided by GitLab application | | config.readOnly ({}) | Object | Config with readOnly info: enabled, username, accessToken, cloneType | | config.fusebox ({}) | Object | [Circuit Breaker configuration][circuitbreaker] |
const scm = new GitlabScm({
oauthClientId: 'abcdef',
oauthClientSecret: 'hijklm',
gitlabHost: 'gitlab.com'
});
Methods
getScmContexts
No parameters are required.
Expected Outcome
A single element array of ScmContext (ex: ['gitlab:gitlab.com']
(default), ['gitlab:mygitlab.com']
), which will be a unique identifier for the scm.
For more information on the exposed methods please see the scm-base class.
Testing
npm test
License
Code licensed under the BSD 3-Clause license. See LICENSE file for terms.