fernandrone.ansible_role_visual_studio_code

Rola Ansible: Visual Studio Code

Rola do instalacji IDE / edytora tekstu Visual Studio Code.

Wymagania

Ansible >= 2.8
Dystrybucja Linuxa
- Rodzina Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Rodzina RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 34
- Rodzina SUSE
  - openSUSE
    - 15.3
- Uwaga: inne wersje prawdopodobnie będą działać, ale nie były testowane.

Zmienne Roli

Poniższe zmienne zmieniają zachowanie tej roli (domyślne wartości pokazano poniżej):

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

# Wydanie (albo 'stable', albo 'insiders') https://code.visualstudio.com/insiders/
# Tylko Ubuntu (code-insiders nie jest w repozytorium RPM Microsoftu)
visual_studio_code_build: stable

# Serwer lustrzany do pobierania publicznych kluczy 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'

# Użytkownicy, dla których będą instalowane rozszerzenia i/lub 
# pisany jest 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: # Nadpisuje plik ustawień, jeśli istnieje. Opcje: boolean "yes" lub "no" (domyślnie "no").
    visual_studio_code_settings: # Obiekt JSON

Przykład Playbooków

Minimalny playbook:

- hosts: servers
  roles:
    - role: fernandrone.ansible_role_visual_studio_code

Playbook z instalowanymi rozszerzeniami, który nadpisuje ustawienia:

- hosts: servers
  roles:
    - role: fernandrone.ansible_role_visual_studio_code
      users:
        - username: vagrant
          visual_studio_code_extensions:
            - streetsidesoftware.code-spell-checker
            - wholroyd.jinja
            - ms-python.python
          visual_studio_code_overwrite: yes
          visual_studio_code_settings_overwrite: yes
          visual_studio_code_settings: {
            "editor.rulers": [80, 100, 120],
            "editor.renderWhitespace": true,
            "files.associations": {
              "Vagrantfile": "ruby"
            }
          }

Więcej Ról od GantSign

Więcej ról od GantSign można znaleźć na Ansible Galaxy.

Rozwój i Testowanie

Ten projekt wykorzystuje Molecule do ułatwienia rozwoju i testowania; rola jest testowana jednostkowo przy pomocy Testinfra i pytest.

Aby rozwijać lub testować, należy zainstalować następujące:

Linux (np. Ubuntu)
Docker
Python (w tym python-pip)
Ansible
Molecule

Ponieważ powyższe może być trudne do zainstalowania, projekt ten zawiera Molecule Wrapper. Molecule Wrapper to skrypt powłoki, który instaluje Molecule i jego zależności (oprócz Linuxa), a następnie wykonuje Molecule z podaną komendą.

Aby przetestować tę rolę usando Molecule Wrapper, uruchom następującą komendę z głównego katalogu projektu: