Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gantsign/ansible-role-visual-studio-code
Ansible role for installing the Visual Studio Code IDE
https://github.com/gantsign/ansible-role-visual-studio-code
ansible ansible-role visual-studio-code vscode
Last synced: about 1 month ago
JSON representation
Ansible role for installing the Visual Studio Code IDE
- Host: GitHub
- URL: https://github.com/gantsign/ansible-role-visual-studio-code
- Owner: gantsign
- License: mit
- Created: 2016-07-09T18:09:35.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-01-21T17:38:08.000Z (10 months ago)
- Last Synced: 2024-09-30T17:41:22.820Z (about 1 month ago)
- Topics: ansible, ansible-role, visual-studio-code, vscode
- Language: Python
- Homepage: https://galaxy.ansible.com/gantsign/visual-studio-code
- Size: 273 KB
- Stars: 103
- Watchers: 9
- Forks: 41
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ansible Role: Visual Studio Code
================================
[](https://github.com/gantsign/ansible-role-visual-studio-code/actions?query=workflow%3ATests)
[](https://galaxy.ansible.com/gantsign/visual-studio-code)
[](https://raw.githubusercontent.com/gantsign/ansible-role-visual-studio-code/master/LICENSE)
Role to install the [Visual Studio Code](https://code.visualstudio.com) IDE / text editor.
Requirements
------------
* Ansible Core >= 2.12
* Linux Distribution
* Debian Family
* Ubuntu
* Focal (20.04)
* Jammy (22.04)
* RedHat Family
* Rocky Linux
* 8
* Fedora
* 35
* SUSE Family
* openSUSE
* 15.3
* Note: other versions are likely to work but have not been tested.
Role Variables
--------------
The following variables will change the behavior of this role (default values
are shown below):
```yaml
# Visual Studio Code version number (defaults to the latest version)
visual_studio_code_version: ''
# Build (either 'stable' or 'insiders') https://code.visualstudio.com/insiders/
# Ubuntu only (code-insiders isn't in Microsoft's RPM repo)
visual_studio_code_build: stable
# Mirror server for fetching the public keys and the Visual Studio Code
# installation package. The URL may include directories. The URL must not end
# with a trailing slash.
visual_studio_code_mirror: 'https://packages.microsoft.com'
# should the gpgcheck of the repo enabled?
# if true
# - for apt repo the option trusted=yes is NOT added
# - for dnf/yum the option gpgcheck is set to yes
# - for zypper the option gpgcheck is set to 1
# true is the default
# if false
# - for apt repo the option trusted=yes is added to repo definition
# - for dnf/yum the option gpgcheck is set to no
# - for zypper the option gpgcheck is set to 0
visual_studio_code_gpgcheck: true
# skip task to add repo for remote package manager
# if set to true, the task 'install VS Code repo (apt/yum/dnf/zypper)' will be skipped
# if set to false, the repo will be added, this is the default
visual_studio_code_skip_add_repo: false
# Users to install extensions for and/or write settings.json
users: []
```
Users are configured as follows:
```yaml
users:
- username: # Unix user name
visual_studio_code_extensions:
- # extension 1
- # extension 2
visual_studio_code_settings_overwrite: # Overwrite the settings file if it exists. Options: boolean "true" or "false" (defaults to "false").
visual_studio_code_settings: # JSON object
visual_studio_code_keybindings_overwrite: # Overwrite the keybindings file if it exists. Options: boolean "true" or "false" (defaults to "false").
visual_studio_code_keybindings: # JSON array
```
Example Playbooks
-----------------
Minimal playbook:
```yaml
- hosts: servers
roles:
- role: gantsign.visual-studio-code
```
Playbook with extensions installed that overwrites settings and keybindings:
```yaml
- hosts: servers
roles:
- role: gantsign.visual-studio-code
users:
- username: vagrant
visual_studio_code_extensions:
- streetsidesoftware.code-spell-checker
- wholroyd.jinja
- ms-python.python
visual_studio_code_settings_overwrite: true
visual_studio_code_settings: {
"editor.rulers": [80, 100, 120],
"editor.renderWhitespace": true,
"files.associations": {
"Vagrantfile": "ruby"
}
}
visual_studio_code_keybindings_overwrite: true
visual_studio_code_keybindings: [
{
"key": "ctrl+'",
"command": "workbench.action.terminal.focus"
},
{
"key": "ctrl+'",
"command": "workbench.action.focusActiveEditorGroup",
"when": "terminalFocus"
}
]
```
More Roles From GantSign
------------------------
You can find more roles from GantSign on
[Ansible Galaxy](https://galaxy.ansible.com/gantsign).
Development & Testing
---------------------
This project uses the following tooling:
* [Molecule](http://molecule.readthedocs.io/) for orchestrating test scenarios
* [Testinfra](http://testinfra.readthedocs.io/) for testing the changes on the
remote
* [pytest](http://docs.pytest.org/) the testing framework
* [Tox](https://tox.wiki/en/latest/) manages Python virtual
environments for linting and testing
* [pip-tools](https://github.com/jazzband/pip-tools) for managing dependencies
A Visual Studio Code
[Dev Container](https://code.visualstudio.com/docs/devcontainers/containers) is
provided for developing and testing this role.
License
-------
MIT
Author Information
------------------
John Freeman
GantSign Ltd.
Company No. 06109112 (registered in England)