gantsign.visual-studio-code

Ansible-Rolle: Visual Studio Code

Rolle zur Installation der Visual Studio Code IDE / Texteditor.

Anforderungen

Ansible Core >= 2.12
Linux-Distribution
- Debian-Familie
  - Ubuntu
    - Focal (20.04)
    - Jammy (22.04)
- RedHat-Familie
  - Rocky Linux
    - 8
  - Fedora
    - 35
- SUSE-Familie
  - openSUSE
    - 15.3
- Hinweis: Andere Versionen funktionieren wahrscheinlich, wurden aber nicht getestet.

Rollen-Variablen

Die folgenden Variablen ändern das Verhalten dieser Rolle (Standardwerte sind unten gezeigt):

# Version von Visual Studio Code (standardmäßig die neueste Version)
visual_studio_code_version: ''

# Build (entweder 'stable' oder 'insiders') https://code.visualstudio.com/insiders/
# Nur für Ubuntu (code-insiders ist nicht im RPM-Repo von Microsoft enthalten)
visual_studio_code_build: stable

# Mirror-Server zum Abrufen der öffentlichen Schlüssel und des Installationspakets von Visual Studio Code.
# Die URL kann Verzeichnisse enthalten. Die URL darf nicht mit einem Slash enden.
visual_studio_code_mirror: 'https://packages.microsoft.com'

# Soll die gpg-Prüfung des Repos aktiviert sein?
# Wenn wahr
# - für apt-Repo wird die Option trusted=yes NICHT hinzugefügt
# - für dnf/yum wird die Option gpgcheck auf yes gesetzt
# - für zypper wird die Option gpgcheck auf 1 gesetzt
# wahr ist der Standard
# Wenn falsch
# - für apt-Repo wird die Option trusted=yes zur Repo-Definition hinzugefügt
# - für dnf/yum wird die Option gpgcheck auf no gesetzt
# - für zypper wird die Option gpgcheck auf 0 gesetzt
visual_studio_code_gpgcheck: true

# Aufgabe zum Hinzufügen des Repos für den Remote-Paketmanager überspringen
# Wenn auf wahr gesetzt, wird die Aufgabe 'installiere VS Code-Repo (apt/yum/dnf/zypper)' übersprungen
# Wenn auf falsch gesetzt, wird das Repo hinzugefügt, dies ist der Standard
visual_studio_code_skip_add_repo: false

# Benutzer, für die Erweiterungen installiert und/oder die settings.json geschrieben werden
users: []

Benutzer werden wie folgt konfiguriert:

users:
  - username: # Unix-Benutzername
    visual_studio_code_extensions:
      - # Erweiterung 1
      - # Erweiterung 2
    visual_studio_code_settings_overwrite: # Überschreibe die Einstellungsdatei, wenn sie existiert. Optionen: boolean "true" oder "false" (Standard ist "false").
    visual_studio_code_settings: # JSON-Objekt
    visual_studio_code_keybindings_overwrite: # Überschreibe die Tastenkombinationsdatei, wenn sie existiert. Optionen: boolean "true" oder "false" (Standard ist "false").
    visual_studio_code_keybindings: # JSON-Array

Beispiel-Playbooks

Minimales Playbook:

- hosts: servers
  roles:
    - role: gantsign.visual-studio-code

Playbook mit installierten Erweiterungen, das Einstellungen und Tastenkombinationen überschreibt:

- 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"
            }
          ]