SCM Config Option¶
SCM Config Option is used to represent codebase-related config option.
Config Options¶
| Option | Description | Note |
|---|---|---|
| owner | the owner of repo | This option can't be configured at the same time with org |
| org | the organization of repo | This option can't be configured at the same time with owner |
| scmType | the repo type | Support Gitlab/Github for now |
| name | the repo name | |
| baseURL | the gitlab url address | If you use Gitlab for SCM, you should set this field |
| url | the repo url address | If you configure this option, then org, owner, scmType, name field can be empty |
| token | the repo api token | |
| branch | the repo branch | If this option is empty, For Github, branch will be main, for Gitlab, branch will be master |
Notes:
You need to get the token of the repo first.
- For
GithubRepo, you can refer to this doc about how to getGithubtoken. - For gitlab.com (instead of a self-hosted GitLab), click here to create a token for DevStream (the scope contains API only).
- For self-hosted GitLab, refer to the official doc here for more info.
Example¶
Github SCM Config With URL¶
YAML
scm:
url: https://github.com/devstream-io/dtm-repo-scaffolding-python-flask.git
branch: main
token: TEST_TOKEN
Github SCM Config Without URL¶
YAML
scm:
name: dtm-repo-scaffolding-python-flask
scmType: github
org: devstream-io
branch: main
token: TEST_TOKEN
Gitlab SCM Config With URL¶
YAML
scm:
url: https://test.gitlab.com/testUser/dtm-repo-scaffolding-python-flask.git
branch: master
token: TEST_TOKEN