Commit ced7cf7b authored by Katarzyna Kobierska's avatar Katarzyna Kobierska

Improve documentation

parent 25ece82d
# Validate the .gitlab-ci.yml # Validate the .gitlab-ci.yml
> [Introduced][ce-5953] in GitLab 8.12.
Check whether your .gitlab-ci.yml file is valid. Check whether your .gitlab-ci.yml file is valid.
``` ```
...@@ -11,35 +13,74 @@ POST ci/lint ...@@ -11,35 +13,74 @@ POST ci/lint
| `content` | hash | yes | the .gitlab-ci.yaml content| | `content` | hash | yes | the .gitlab-ci.yaml content|
```bash ```bash
curl --request POST "https://gitlab.example.com/api/v3/ci/lint?content=YAML+Content" curl --request POST "https://gitlab.example.com/api/v3/ci/lint?content={
image: "ruby:2.1",
services: ["postgres"],
before_script: ["gem install bundler", "bundle install", "bundle exec rake db:create"],
variables: {"DB_NAME": "postgres"},
types: ["test", "deploy", "notify"],
rspec: {
script: "rake spec",
tags: ["ruby", "postgres"],
only: ["branches"]
},
spinach: {
script: "rake spinach",
allow_failure: true,
tags: ["ruby", "mysql"],
except: ["tags"]
},
staging: {
variables: {KEY1: "value1", KEY2: "value2"},
script: "cap deploy stating",
type: "deploy",
tags: ["ruby", "mysql"],
except: ["stable"]
},
production: {
variables: {DB_NAME: "mysql"},
type: "deploy",
script: ["cap deploy production", "cap notify"],
tags: ["ruby", "mysql"],
only: ["master", "/^deploy-.*$/"]
},
dockerhub: {
type: "notify",
script: "curl http://dockerhub/URL",
tags: ["ruby", "postgres"],
only: ["branches"]
}
}"
``` ```
Example response: Be sure to copy paste the exact contents of `.gitlab-ci.yml` as YAML is very picky with indentation and spaces.
Example responses:
* valid content * Valid content:
```json ```json
{ {
"status": "valid", "status": "valid",
"errors": [] "errors": []
} }
``` ```
* invalid content * Invalid content:
```json ```json
{ {
"status": "invalid", "status": "invalid",
"errors": [ "errors": [
"variables config should be a hash of key value pairs" "variables config should be a hash of key value pairs"
] ]
} }
``` ```
* without the content attribute * Without the content attribute:
```json ```json
{ {
"error": "content is missing" "error": "content is missing"
} }
``` ```
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment