6e881389eb
* Squashed Commits * Incremented minor version |
||
---|---|---|
.azure-pipelines | ||
.github | ||
.vscode | ||
assets | ||
examples | ||
src | ||
syntaxes | ||
tools/extract-yaml-testcases | ||
.eslintignore | ||
.eslintrc.js | ||
.gitattributes | ||
.gitignore | ||
.npmrc | ||
.vscode-test.mjs | ||
.vscodeignore | ||
CHANGELOG.md | ||
CONTRIBUTING.md | ||
LICENSE | ||
README.md | ||
RELEASE.md | ||
SECURITY.md | ||
language-configuration.json | ||
package-lock.json | ||
package.json | ||
service-schema.json | ||
tsconfig.json | ||
tsconfig.test.json | ||
webpack.config.js |
README.md
Azure Pipelines for VS Code
Get it on the VS Code Marketplace!
This VS Code extension adds syntax highlighting and autocompletion for Azure Pipelines YAML to VS Code. It also helps you set up continuous build and deployment for Azure WebApps without leaving VS Code.
Validation
Basic YAML validation is built in to VS Code, but now you can have syntax highlighting that's aware of the Pipelines YAML schema. This means that you get red squigglies if you say tasks:
where you meant task:
. IntelliSense is also schema-aware. Wherever you are in the file, press Ctrl-Space to see what options you have at that point.
By default, the extension will highlight known Azure Pipelines files in the root of your workspace. You can change the language mode at the lower right to work with one file at a time. Click the language picker, then choose "Azure Pipelines". If you have files which should always use this extension, set your user or workspace settings to match those file paths with this extension. For example:
{
"files.associations": {
"**/ci/*.yml": "azure-pipelines"
}
}
Schema auto-detection
Out of the box, the extension has a generic schema file that includes only in-box tasks. You probably have custom tasks installed in your organization.
To provide the most relevant IntelliSense, the extension will automatically detect and use your organization's schema! All you need to do is follow the instructions when prompted.
If automatic fetching of the organization schema doesn't work, try signing out and signing back in using the
Azure: Sign Out
andAzure: Sign In
commands from the VS Code command palette (Ctrl/Cmd + Shift + P).
Specific schema
If you need to use a specific schema, that is also possible.
- Visit
https://dev.azure.com/YOUR-ORG-HERE/_apis/distributedtask/yamlschema
and save the output asmy-schema.json
. - Edit your workspace's
settings.json
to include this:
{
"azure-pipelines.customSchemaFile": "./path/to/my-schema.json"
}
Document formatting
Since this extension defines a new file type ("azure-pipelines
"), any YAML formatter you've installed no longer applies to pipelines documents.
Hat tip to @mgexm and @dotnetcanuck for sharing how they restored this functionality.
We'll demonstrate with the Prettier VS Code extension:
Add this to your settings.json
:
"[azure-pipelines]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
Both format on save and the Format document
command should now work!
Telemetry
VS Code collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more. If you don’t wish to send usage data to Microsoft, you can set the telemetry.enableTelemetry
setting to false
. Learn more in our FAQ.
Extension Development
If you are only working on the extension (i.e. syntax highlighting, configure pipeline, and the language client):
- Run
npm install
to install all necessary dependencies - Run
npm run watch
to automatically rebuild the extension whenever you make changes - Run the "Extension" debug configuration to launch a VS Code window using your modified version of the extension
If you are also working on the language server:
- Follow the first two steps above
- Clone the azure-pipelines-language-server repository alongside this repository
- Run
npm link ../azure-pipelines-language-server/language-server
- Follow the instructions in the language server README to link the language service to the language server
- Add the
azure-pipelines-language-server
folder to your VS Code workspace - Run the "Launch Extension & Attach to Server" debug configuration
- Note: In order to attach to the server, the extension must be activated (in other words, make sure you are editing an Azure Pipelines file)
- In case the attach request timeouts before the server can start, wait for it to start and then run the "Attach to Server" debug configuration
Contributing
See CONTRIBUTING.md if you want to jump in!