Configuration de l'édition sur site d'Axe DevTools Linter

L'édition sur site d'Axe DevTools Linter est un binaire Linux x86 64 bits qui permet à votre organisation d'utiliser Axe DevTools Linter localement. Ce guide montre comment configurer ce logiciel.

Pour installer l'Axe DevTools Linter sur site, vous aurez besoin du binaire, qui est disponible pour Linux x86 64 bits. Vous aurez également besoin de NGINX si vous souhaitez configurer une instance de proxy inverse (pour utiliser des requêtes chiffrées car Axe DevTools Linter ne reconnaît pas les connexions chiffrées). Consultez Utiliser Axe DevTools Linter avec un proxy inverse pour plus d'informations.

Vous aurez également besoin d'une clé de licence pour utiliser l'édition sur site d'Axe DevTools Linter. Contactez le service d'assistance de Deque pour obtenir votre clé de licence.

Installation

Vous pouvez extraire les fichiers d'installation en tapant ce qui suit :

tar xvfz installer.tar.gz

Les fichiers seront extraits dans le répertoire courant.

Vous pouvez maintenant exécuter le programme d'installation. Vous devez le lancer en tant que root en tapant ce qui suit :

sudo ./installer --license-key your-license-key

Le programme d'installation créera un nouvel utilisateur axe s'il n'existe pas déjà (mais ne créera pas de répertoire personnel). Il créera également le répertoire /opt/deque s'il n'existe pas.

Pour plus d'informations sur les options de ligne de commande acceptées par le programme d'installation, consultez Options du programme d'installation ci-dessous.

Configurer le service pour qu'il s'exécute automatiquement

La première étape pour exécuter Axe DevTools Linter au démarrage est de modifier la configuration du service en tant que root :

sudo nano /etc/systemd/system/axe-linter.service

Ajoutez les lignes suivantes en bas du fichier si elles ne s'y trouvent pas déjà :

[Install]
WantedBy=multi-user.target

(Il est peu probable que vous ayez besoin d'ajouter cela.)

Vous devez maintenant activer le service en tapant :

sudo systemctl enable axe-linter

Vous devriez maintenant redémarrer la machine pour vérifier si le service Axe DevTools Linter démarre automatiquement. La section suivante montre comment obtenir le statut du service.

Obtenir le statut du service

Vous pouvez utiliser la commande systemctl pour vérifier le statut du service en cours d'exécution comme indiqué ci-dessous :

systemctl status axe-linter

Voici un exemple de sortie du service en cours d'exécution :

● axe-linter.service - Axe Linter Service
   Loaded: loaded (/opt/deque/service/axe-linter.service; linked; vendor preset: enabled)
   Active: active (running) since Wed 2021-11-24 12:34:11 PST; 6 days ago
     Docs: https://deque.com/axe
 Main PID: 4401 (axe-linter-serv)
    Tasks: 10 (limit: 2108)
   CGroup: /system.slice/axe-linter.service
           └─4401 /opt/deque/axe-linter-service

Nov 24 12:34:11 galliumos systemd[1]: Started Axe Linter Service.

Si le service ne fonctionne pas, vous verrez une sortie similaire à la suivante :

● axe-linter.service - Axe Linter Service
   Loaded: loaded (/opt/deque/service/axe-linter.service; linked; vendor preset: enabled)
   Active: inactive (dead)
     Docs: https://deque.com/axe

Options du programme d'installation

Le programme d'installation sur site reconnaît plusieurs options de ligne de commande :

• --axe-user nom d'utilisateur

  Le nom d'utilisateur qui possédera le service Axe Linter en cours d'exécution. Si cet utilisateur n'existe pas, il sera créé. La valeur par défaut est axe.

• --license-key votre-clé-de-licence

  La clé de licence utilisée par le service Axe Linter. Ce paramètre est requis. Contactez le service d'assistance de Deque pour plus d'informations sur votre clé de licence.

• --log-level niveau de journalisation sélectionné

  Le niveau de journalisation qui sera utilisé par le service Axe DevTools Linter installé. La valeur par défaut est error. Les valeurs sont : error, warn, info, verbose et debug.

• --port votre-port

  Le port sur lequel le service Axe Linter écoute les requêtes. La valeur par défaut est le port 3000.