gantsign.intellij-plugins

Rôle Ansible : Plugins IntelliJ

Rôle pour télécharger et installer des plugins IntelliJ IDEA.

Avertissement : ce rôle utilise des API internes d'IntelliJ IDEA et doit être considéré comme expérimental pour le moment.

Conditions préalables

Ansible >= 2.9
Distribution Linux
- Famille Debian
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Famille RedHat
  - Rocky Linux
    - 8
- Remarque : d'autres versions peuvent fonctionner mais n'ont pas été testées.

Variables de rôle

Les variables suivantes modifieront le comportement de ce rôle (les valeurs par défaut sont indiquées ci-dessous) :

# Répertoire d'installation d'IntelliJ IDEA
intellij_plugins_intellij_home: '{{ ansible_local.intellij.general.home }}'

# Répertoire contenant les plugins IntelliJ IDEA (par rapport au répertoire utilisateur)
intellij_plugins_intellij_user_plugins_dir: '{{ ansible_local.intellij.general.user_plugins_dir }}'

# Répertoire pour stocker les fichiers téléchargés pour l'installation d'IntelliJ IDEA
intellij_plugins_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

# URL du service web du gestionnaire de plugins d'IntelliJ IDEA
intellij_plugins_manager_url: 'https://plugins.jetbrains.com/pluginManager/'

# Liste des utilisateurs à configurer pour IntelliJ IDEA
users: []

Les utilisateurs sont configurés comme suit :

users:
  - username: # Nom d'utilisateur Unix
    intellij_plugins:
      - # ID du plugin à installer

Exemples de Playbooks

Playbook minimal :

- hosts: servers
  roles:
    - role: gantsign.intellij-plugins
      users:
        - username: vagrant
          intellij_plugins:
            - CheckStyle-IDEA

Playbook avec le répertoire d'installation IntelliJ et le répertoire utilisateur spécifiés :

- hosts: servers
  roles:
    - role: gantsign.intellij-plugins
      intellij_plugins_intellij_home: '/opt/idea/idea-community-2016.2.5'
      intellij_plugins_intellij_user_dirname: '.IdeaIC2016.2'
      users:
        - username: vagrant
          intellij_plugins:
            - CheckStyle-IDEA

Plus de rôles de GantSign

Vous pouvez trouver d'autres rôles de GantSign sur Ansible Galaxy.

Développement et tests

Ce projet utilise Molecule pour aider au développement et aux tests ; le rôle est testé de manière unitaire avec Testinfra et pytest.

Pour développer ou tester, vous devez avoir installé les éléments suivants :

Linux (par exemple Ubuntu)
Docker
Python (y compris python-pip)
Ansible
Molecule

Comme l'installation de ce qui précède peut être délicate, ce projet inclut Molecule Wrapper. Molecule Wrapper est un script shell qui installe Molecule et ses dépendances (autre que Linux) et exécute ensuite Molecule avec la commande que vous lui passez.

Pour tester ce rôle en utilisant Molecule Wrapper, exécutez la commande suivante depuis le répertoire du projet :