79 lines
4.1 KiB
Markdown
79 lines
4.1 KiB
Markdown
# Concourse CI YAML Editor for Atom
|
|
[](https://travis-ci.org/spring-projects/atom-concourse) [](https://ci.appveyor.com/project/spring-projects/atom-concourse/branch/master) [](https://david-dm.org/spring-projects/atom-concourse)
|
|
|
|
This extension provides basic validation, content assist and hover infos
|
|
for editing Concourse [Pipeline](https://concourse-ci.org/pipelines.html) and [Task Configuration](https://concourse-ci.org/running-tasks.html) Files.
|
|
|
|
It is recommended to use this extension package when `atom-ide-ui` atom extension package is installed. Thus, reconciling (error/warning markers) and hover support is fully functional.
|
|
|
|
## Usage
|
|
|
|
The Concourse editor automatically activates when the name of the file you are editing is `pipeline.yml` or `task.yml`. Alternately, you can select the grammar for your file by doing these steps:
|
|
|
|
- Open the file, and it will most likely open with the default Atom YAML editor.
|
|
- In the bottom-right of the editor, click on YAML.
|
|
- This opens the Grammar Selection dialogue. Search and select `Concourse-Pipeline-YAML` for pipeline files, or `Concourse-Task-YAML` for task files.
|
|
|
|
If you find an issue please raise it here: https://github.com/spring-projects/sts4/issues
|
|
|
|
## Functionality
|
|
|
|
### Validation
|
|
|
|
(Requires `atom-ide-ui` package) As you type the file is parsed and checked for basic syntactic and structural correctness. Hover over an error marker to see an explanation.
|
|
|
|
![Linting Screenshot][linting]
|
|
|
|
### Content Assist
|
|
|
|
Having trouble remembering all the names of the attributes, and their spelling? Or can't remember
|
|
which resource properties to set in the `get` task params versus its `source` attributes? Or
|
|
don't remember what 'special' values are acceptable for a certain property? Content assist
|
|
to the rescue:
|
|
|
|
![Content Assist Screenshot][ca1]
|
|
|
|
![Content Assist Screenshot][ca2]
|
|
|
|
### Documentation Hovers
|
|
|
|
(Requires `atom-ide-ui` package) Having trouble remembering exactly what the meaning of each attribute is? Hover over any attribute and
|
|
read its detailed documentation.
|
|
|
|
![Hover Docs Screenshot][hovers]
|
|
|
|
### Navigate to Symbol in File
|
|
|
|
Is your Pipeline yaml file getting larger and it is becoming harder to find a particular Job, Resource or
|
|
Resource Type declaration? The Atom Outline View (View -> Toggle Outline View) helps you quickly jump to a specific definition.
|
|
|
|
![Outline View][outline_view]
|
|
|
|
# Releases:
|
|
|
|
Released versions of this package can be installed directly from the Atom package installer.
|
|
|
|
There are also development snapshots available with the latest fixes and improvements from release git repository: https://github.com/spring-projects/atom-concourse
|
|
1. Clone the release repository for Atom package if not already cloned and navigate to `atom-concourse` folder
|
|
2. Run `git clean -fxd` - necessary to delete out of date LS JAR file and dependency packages
|
|
3. Run `git pull` - get the latest changes
|
|
3. Run `npm install` - Install latest dependecnies and download proper LS JAR
|
|
4. Run `apm link .` - Link the package to Atom
|
|
5. Either start Atom or Reload Window in Atom
|
|
|
|
[linting]:
|
|
https://raw.githubusercontent.com/spring-projects/sts4/af715bad53bd6cf30a10a2dc6d34bfcc17968382/atom-extensions/atom-concourse/readme-imgs/linting.png
|
|
|
|
[ca1]:
|
|
https://raw.githubusercontent.com/spring-projects/sts4/af715bad53bd6cf30a10a2dc6d34bfcc17968382/atom-extensions/atom-concourse/readme-imgs/ca1.png
|
|
|
|
[ca2]:
|
|
https://raw.githubusercontent.com/spring-projects/sts4/af715bad53bd6cf30a10a2dc6d34bfcc17968382/atom-extensions/atom-concourse/readme-imgs/ca2.png
|
|
|
|
[hovers]:
|
|
https://raw.githubusercontent.com/spring-projects/sts4/af715bad53bd6cf30a10a2dc6d34bfcc17968382/atom-extensions/atom-concourse/readme-imgs/hovers.png
|
|
|
|
[outline_view]:
|
|
https://raw.githubusercontent.com/spring-projects/sts4/af715bad53bd6cf30a10a2dc6d34bfcc17968382/atom-extensions/atom-concourse/readme-imgs/outline_view.png
|
|
|