/vscode-github-actions

GitHub Actions extension for VS Code

Primary LanguageTypeScriptMIT LicenseMIT

GitHub Actions for VS Code

The GitHub Actions extension lets you manage your workflows, view the workflow run history, and helps with authoring workflows.

Features

Manage workflows and runs

  • Manage your workflows and runs without leaving your editor.
  • Keep track of your CI builds and deployments.
  • Investigate failures and view logs.

View workflow runs and logs

Workflow authoring

Be more confident when authoring and modifying workflows. Find errors before committing workflows with:

Syntax highlighting for workflows and GitHub Actions Expressions makes it clear where values are inserted at execution time:

Syntax highlighting

Integrated documentation for the workflow schema, expression functions, and even event payloads:

Tooltip showing description for a pull_request payload

Validation and code completion for the YAML schema and GitHub Actions Expressions. Get instant validation and code completion for the workflow schema, expression functions, event payloads, and job or step outputs:

Validation for YAML keys and expressions

Smart validation and code completion for actions and reusable workflows: the extension automatically parses parameters, inputs, and outputs for referenced actions and called reusable workflows for code-completion and validation.

Video showing workflow validation and auto-completion

Getting started

  1. Install the extension from the Marketplace.
  2. Sign in with your GitHub account and when prompted allow GitHub Actions access to your GitHub account.
  3. Open a GitHub repository.
  4. You will be able to utilize the syntax features in Workflow files, and you can find the GitHub Actions icon on the left navigation to manage your Workflows.

Supported Features

  • Manage your workflows and runs
  • Edit workflows (syntax highlighting, auto-completion, hovering, and validation)
  • Keep track of your CI builds and deployments
  • Investigate failures and view logs
  • Modify settings like Environments, Secrets, and Variables

Unfortunately, at this time we are not able to support the extension with remote repositories (including github.dev and vscode.dev), so please use the extension with locally downloaded GitHub repositories for the best experience. Please check back here for updates in the future!

We have enabled experimental functionality to support GitHub Enterprise Server, but this feature is an experimental beta and currently unsupported. To try this out, enable the use-enterprise setting to authenticate with your GitHub Enterprise Server Authentication Provider settings Use-enterprise setting checkbox

Contributing

See CONTRIBUTING.md. A description of the architecture of the extension can be found here.

License

This project is licensed under the terms of the MIT open source license. Please refer to MIT for the full terms.