debian-mirror-gitlab/doc/api/templates/gitlab_ci_ymls.md

150 lines
4.2 KiB
Markdown
Raw Normal View History

2019-12-04 20:38:33 +05:30
---
type: reference
---
2017-09-10 17:25:29 +05:30
# GitLab CI YMLs API
2016-11-03 12:29:30 +05:30
2019-12-04 20:38:33 +05:30
In GitLab, there is an API endpoint available to work with CI YMLs. For more
information on CI/CD pipeline configuration in GitLab, see the
[configuration reference documentation](../../ci/yaml/README.md).
2016-11-03 12:29:30 +05:30
## List GitLab CI YML templates
Get all GitLab CI YML templates.
2019-12-21 20:55:43 +05:30
```plaintext
2016-11-03 12:29:30 +05:30
GET /templates/gitlab_ci_ymls
```
2019-12-21 20:55:43 +05:30
Example request:
2016-11-03 12:29:30 +05:30
```bash
2017-08-17 22:00:37 +05:30
curl https://gitlab.example.com/api/v4/templates/gitlab_ci_ymls
2016-11-03 12:29:30 +05:30
```
Example response:
```json
[
{
2018-12-05 23:21:45 +05:30
"key": "Android",
"name": "Android"
2016-11-03 12:29:30 +05:30
},
2019-12-21 20:55:43 +05:30
{
"key": "Android-Fastlane",
"name": "Android-Fastlane"
},
2016-11-03 12:29:30 +05:30
{
2018-12-05 23:21:45 +05:30
"key": "Auto-DevOps",
"name": "Auto-DevOps"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Bash",
"name": "Bash"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "C++",
"name": "C++"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Chef",
"name": "Chef"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Clojure",
"name": "Clojure"
2016-11-03 12:29:30 +05:30
},
2019-12-21 20:55:43 +05:30
{
"key": "Code-Quality",
"name": "Code-Quality"
},
2016-11-03 12:29:30 +05:30
{
2018-12-05 23:21:45 +05:30
"key": "Crystal",
"name": "Crystal"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Django",
"name": "Django"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Docker",
"name": "Docker"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Elixir",
"name": "Elixir"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Go",
"name": "Go"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Gradle",
"name": "Gradle"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Grails",
"name": "Grails"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Julia",
"name": "Julia"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "LaTeX",
"name": "LaTeX"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Laravel",
"name": "Laravel"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Maven",
"name": "Maven"
2016-11-03 12:29:30 +05:30
},
{
2018-12-05 23:21:45 +05:30
"key": "Mono",
"name": "Mono"
2016-11-03 12:29:30 +05:30
}
]
```
## Single GitLab CI YML template
Get a single GitLab CI YML template.
2019-12-21 20:55:43 +05:30
```plaintext
2016-11-03 12:29:30 +05:30
GET /templates/gitlab_ci_ymls/:key
```
2019-12-21 20:55:43 +05:30
| Attribute | Type | Required | Description |
| ---------- | ------ | -------- | ------------------------------------- |
2016-11-03 12:29:30 +05:30
| `key` | string | yes | The key of the GitLab CI YML template |
2019-12-21 20:55:43 +05:30
Example request:
2016-11-03 12:29:30 +05:30
```bash
2017-08-17 22:00:37 +05:30
curl https://gitlab.example.com/api/v4/templates/gitlab_ci_ymls/Ruby
2016-11-03 12:29:30 +05:30
```
Example response:
```json
{
"name": "Ruby",
2019-12-21 20:55:43 +05:30
"content": "# This file is a template, and might need editing before it works on your project.\n# Official language image. Look for the different tagged releases at:\n# https://hub.docker.com/r/library/ruby/tags/\nimage: \"ruby:2.5\"\n\n# Pick zero or more services to be used on all builds.\n# Only needed when using a docker container to run your tests in.\n# Check out: http://docs.gitlab.com/ce/ci/docker/using_docker_images.html#what-is-a-service\nservices:\n - mysql:latest\n - redis:latest\n - postgres:latest\n\nvariables:\n POSTGRES_DB: database_name\n\n# Cache gems in between builds\ncache:\n paths:\n - vendor/ruby\n\n# This is a basic example for a gem or script which doesn't use\n# services such as redis or postgres\nbefore_script:\n - ruby -v # Print out ruby version for debugging\n # Uncomment next line if your rails app needs a JS runtime:\n # - apt-get update -q && apt-get install nodejs -yqq\n - bundle install -j $(nproc) --path vendor # Install dependencies into ./vendor/ruby\n\n# Optional - Delete if not using `rubocop`\nrubocop:\n script:\n - rubocop\n\nrspec:\n script:\n - rspec spec\n\nrails:\n variables:\n DATABASE_URL: \"postgresql://postgres:postgres@postgres:5432/$POSTGRES_DB\"\n script:\n - rails db:migrate\n - rails db:seed\n - rails test\n\n# This deploy job uses a simple deploy flow to Heroku, other providers, e.g. AWS Elastic Beanstalk\n# are supported too: https://github.com/travis-ci/dpl\ndeploy:\n type: deploy\n environment: production\n script:\n - gem install dpl\n - dpl --provider=heroku --app=$HEROKU_APP_NAME --api-key=$HEROKU_PRODUCTION_KEY\n"
2016-11-03 12:29:30 +05:30
}
```
2019-12-04 20:38:33 +05:30
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
Each scenario can be a third-level heading, e.g. `### Getting error message X`.
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->