gantsign.visual-studio-code

Descripción general Versiones Perspectivas

Rol de Ansible: Visual Studio Code

Rol para instalar el editor de texto / IDE Visual Studio Code.

Requisitos

Ansible Core >= 2.12
Distribución de Linux
- Familia Debian
  - Ubuntu
    - Focal (20.04)
    - Jammy (22.04)
- Familia RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Familia SUSE
  - openSUSE
    - 15.3
- Nota: otras versiones probablemente funcionen, pero no se han probado.

Variables de la Rol

Las siguientes variables cambiarán el comportamiento de esta rol (los valores predeterminados se muestran a continuación):

# Número de versión de Visual Studio Code (de forma predeterminada, la última versión)
visual_studio_code_version: ''

# Build (ya sea 'stable' o 'insiders') https://code.visualstudio.com/insiders/
# Solo para Ubuntu (code-insiders no está en el repositorio RPM de Microsoft)
visual_studio_code_build: stable

# Servidor espejo para obtener las claves públicas y el paquete de instalación de Visual Studio Code.
# La URL puede incluir directorios. La URL no debe terminar con una barra diagonal.
visual_studio_code_mirror: 'https://packages.microsoft.com'

# ¿Debería habilitarse la verificación gpg del repositorio?
# si es verdadero
# - para el repository apt, no se agrega la opción trusted=yes
# - para dnf/yum, la opción gpgcheck se establece en yes
# - para zypper, la opción gpgcheck se establece en 1
# verdadero es lo predeterminado
# si es falso
# - para el repository apt, se agrega la opción trusted=yes a la definición del repositorio
# - para dnf/yum, la opción gpgcheck se establece en no
# - para zypper, la opción gpgcheck se establece en 0
visual_studio_code_gpgcheck: true

# Omite la tarea para agregar el repositorio para el gestor de paquetes remoto
# si se establece en verdadero, se omitirá la tarea 'instalar el repositorio VS Code (apt/yum/dnf/zypper)'
# si se establece en falso, se añadirá el repositorio, este es el valor predeterminado
visual_studio_code_skip_add_repo: false

# Usuarios para instalar extensiones y/o escribir settings.json
users: []

Los usuarios se configuran de la siguiente manera:

users:
  - username: # Nombre de usuario de Unix
    visual_studio_code_extensions:
      - # extensión 1
      - # extensión 2
    visual_studio_code_settings_overwrite: # Sobrescribir el archivo de configuración si existe. Opciones: boolean "true" o "false" (predeterminado es "false").
    visual_studio_code_settings: # Objeto JSON
    visual_studio_code_keybindings_overwrite: # Sobrescribir el archivo de atajos de teclado si existe. Opciones: boolean "true" o "false" (predeterminado es "false").
    visual_studio_code_keybindings: # Arreglo JSON

Ejemplos de Playbooks

Playbook mínimo:

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

Playbook con extensiones instaladas que sobrescribe configuraciones y atajos de teclado:

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