gantsign.visual-studio-code

Rola Ansible: Visual Studio Code

Rola do instalacji IDE / edytora tekstu Visual Studio Code.

Wymagania

Ansible Core >= 2.12
Dystrybucja Linux
- Rodzina Debian
  - Ubuntu
    - Focal (20.04)
    - Jammy (22.04)
- Rodzina RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Rodzina SUSE
  - openSUSE
    - 15.3
- Uwaga: inne wersje mogą działać, ale nie były testowane.

Zmienne roli

Poniższe zmienne zmieniają działanie tej roli (domyślne wartości są pokazane poniżej):

# Numer wersji Visual Studio Code (domyślnie najnowsza wersja)
visual_studio_code_version: ''

# Wersja (czy 'stable' czy 'insiders') https://code.visualstudio.com/insiders/
# Tylko Ubuntu (code-insiders nie znajduje się w repozytorium RPM Microsoftu)
visual_studio_code_build: stable

# Serwer lustrzany do pobierania kluczy publicznych i
# pakietu instalacyjnego Visual Studio Code. URL może zawierać katalogi. URL nie może kończyć
# się ukośnikiem.
visual_studio_code_mirror: 'https://packages.microsoft.com'

# czy gpgcheck repozytorium ma być włączony?
# jeśli true
# - dla repozytorium apt opcja trusted=yes NIE jest dodawana
# - dla dnf/yum opcja gpgcheck jest ustawiona na yes
# - dla zypper opcja gpgcheck jest ustawiona na 1
# true jest domyślne
# jeśli false
# - dla repozytorium apt opcja trusted=yes jest dodawana do definicji repozytorium
# - dla dnf/yum opcja gpgcheck jest ustawiona na no
# - dla zypper opcja gpgcheck jest ustawiona na 0
visual_studio_code_gpgcheck: true

# pomiń zadanie dodania repozytorium dla zdalnego menedżera pakietów
# jeśli ustawione na true, zadanie 'install VS Code repo (apt/yum/dnf/zypper)' zostanie pominięte
# jeśli ustawione na false, repozytorium zostanie dodane, to jest domyślne
visual_studio_code_skip_add_repo: false

# Użytkownicy, dla których będą instalowane rozszerzenia i/lub pisane settings.json
users: []

Użytkownicy są konfigurowani w następujący sposób:

users:
  - username: # nazwa użytkownika Unix
    visual_studio_code_extensions:
      - # rozszerzenie 1
      - # rozszerzenie 2
    visual_studio_code_settings_overwrite: # Nadpisz plik ustawień, jeśli istnieje. Opcje: boolean "true" lub "false" (domyślnie "false").
    visual_studio_code_settings: # obiekt JSON
    visual_studio_code_keybindings_overwrite: # Nadpisz plik skrótów klawiszowych, jeśli istnieje. Opcje: boolean "true" lub "false" (domyślnie "false").
    visual_studio_code_keybindings: # tablica JSON

Przykładowe pliki playbook

Minimalny playbook:

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

Playbook z zainstalowanymi rozszerzeniami, który nadpisuje ustawienia i skróty klawiszowe:

- hosts: serwery
  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"
            }
          ]