Ptdradmin at 11:10, 4 February 2026

2026-02-04T11:10:07Z

← Older revision		Revision as of 11:10, 4 February 2026
Line 109:		Line 109:
	- ptdradmin		- ptdradmin
	</syntaxhighlight>		</syntaxhighlight>
			<syntaxhighlight lang="yaml">
			nasqueron-dev-docker:
			Members:
			- ptdradmin
			</syntaxhighlight>
			<syntaxhighlight lang="yaml">
			nasquenautes:
			Members:
			- ptdradmin
			</syntaxhighlight>
	----		----

Line 131:		Line 140:

	<syntaxhighlight lang="bash">		<syntaxhighlight lang="bash">
	git commit -m "~~Ajout de~~ Doba Gui ~~comme user et dans le groupe core~~"		git commit -m "Create new account for Doba Gui"
	</syntaxhighlight>		</syntaxhighlight>

Ptdradmin at 14:50, 26 November 2025

2025-11-26T14:50:45Z

← Older revision		Revision as of 14:50, 26 November 2025
Line 102:		Line 102:
	</syntaxhighlight>		</syntaxhighlight>

	Ajoutez-vous dans le groupe <code>~~core~~</code> :		Ajoutez-vous dans le groupe <code>nasqueron</code> :

	<syntaxhighlight lang="yaml">		<syntaxhighlight lang="yaml">
	~~core~~:		shellgroups:
	Members:		Members:
	- ptdradmin		- ptdradmin

Dereckson: Update categories

2025-11-24T14:20:00Z

Update categories

← Older revision		Revision as of 14:20, 24 November 2025
Line 473:		Line 473:
	* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''		* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''

			[[Category:Contributor guide]]
	~~Catégorie~~:~~Documentation~~		[[Category:Reference]]
	~~Catégorie~~:~~Guide de contribution~~		[[Category:Internship guide]]
	~~Catégorie~~:~~Développement~~

Ptdradmin: Created page with "= Guide complet : Configuration de l'accès devserver avec Git et Arcanist = Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations. == 1. Création du dossier de travail == Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet : C:\STAGE 2025 C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations...."

2025-11-19T14:35:39Z

Created page with "= Guide complet : Configuration de l'accès devserver avec Git et Arcanist = Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations. == 1. Création du dossier de travail == Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet : <syntaxhighlight lang="powershell"> C:\STAGE 2025 </syntaxhighlight> C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations...."

New page

= Guide complet : Configuration de l'accès devserver avec Git et Arcanist =

Ce guide explique comment configurer votre environnement de développement pour contribuer au projet Operations.

== 1. Création du dossier de travail ==

Créez un dossier sur votre PC Windows pour organiser tous les fichiers du projet :

<syntaxhighlight lang="powershell">
C:\STAGE 2025
</syntaxhighlight>

C'est dans ce dossier que vous allez ranger tout ce qui concerne le projet Operations.

----

== 2. Récupération et clonage du dépôt Operations ==

=== 2.1 Récupération de l'URL du dépôt ===

Rendez-vous sur la page du dépôt :
* https://devcentral.nasqueron.org/source/operations/

Copiez l'URL Git pour pouvoir cloner le projet.

=== 2.2 Clonage du dépôt ===

Ouvrez PowerShell et placez-vous dans votre dossier :

<syntaxhighlight lang="powershell">
cd "C:\STAGE 2025"
git clone https://devcentral.nasqueron.org/source/operations.git
</syntaxhighlight>

Git crée un dossier <code>operations</code> avec tous les fichiers du projet.

----

== 3. Gestion de Git et création de branche dans WSL ==

=== 3.1 Se placer dans le dossier du projet ===

Depuis WSL (Ubuntu), placez-vous dans le dossier du projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
</syntaxhighlight>

=== 3.2 Création d'une nouvelle branche ===

Créez une nouvelle branche pour vos modifications :

<syntaxhighlight lang="bash">
git switch -c feature/add-gui-user
</syntaxhighlight>

Avertissement|Si la branche existe déjà, Git affichera :
<code>fatal: a branch named 'feature/add-gui-user' already exists</code>

Dans ce cas, basculez simplement sur la branche existante :
<syntaxhighlight lang="bash">
git switch feature/add-gui-user
</syntaxhighlight>

----

== 4. Modifications dans les fichiers du dépôt ==

=== 4.1 Vérification de l'emplacement des fichiers ===

Vérifiez où se trouvent les vrais fichiers <code>users.sls</code> et <code>groups.sls</code> :

<syntaxhighlight lang="bash">
ls -la pillar/core/
</syntaxhighlight>

Important|Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.

=== 4.2 Ajout de votre utilisateur dans users.sls ===

Ouvrez le fichier avec VS Code :
<syntaxhighlight>
pillar/core/users.sls
</syntaxhighlight>

Ajoutez votre utilisateur dans la section <code>shellusers:</code> par ordre alphabétique :

<syntaxhighlight lang="yaml">
ptdradmin:
fullname: Doba Gui
ssh_keys:
- ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAFtlR4OeXNHfJXNrvrLeU9nGu7ufcxc38xUGqlwiY5L doba.guimartinien@gmail.com
uid: 1001
</syntaxhighlight>

=== 4.3 Ajout de votre compte dans groups.sls ===

Ouvrez également le fichier :
<syntaxhighlight>
pillar/core/groups.sls
</syntaxhighlight>

Ajoutez-vous dans le groupe <code>core</code> :

<syntaxhighlight lang="yaml">
core:
Members:
- ptdradmin
</syntaxhighlight>

----

== 5. Commit des modifications ==

=== 5.1 Suppression des fichiers créés par erreur ===

Si vous avez créé des fichiers vides dans <code>operations/</code> :

<syntaxhighlight lang="bash">
rm -rf operations/
</syntaxhighlight>

=== 5.2 Ajout des bons fichiers ===

<syntaxhighlight lang="bash">
git add pillar/core/users.sls pillar/core/groups.sls
</syntaxhighlight>

=== 5.3 Commit des changements ===

<syntaxhighlight lang="bash">
git commit -m "Ajout de Doba Gui comme user et dans le groupe core"
</syntaxhighlight>

=== 5.4 Vérification du commit ===

<syntaxhighlight lang="bash">
git show HEAD
</syntaxhighlight>

Vérifiez que vous voyez seulement les lignes que vous avez vraiment modifiées.

=== 5.5 Modification du dernier commit (si nécessaire) ===

Si vous avez corrigé des fichiers après le commit :

<syntaxhighlight lang="bash">
git commit --amend
</syntaxhighlight>

----

== 6. Premier essai de arc diff (échec - arc n'existe pas) ==

Essayez de lancer :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
arc: command not found
</syntaxhighlight>

Il faut installer Arcanist.

----

== 7. Installation d'Arcanist avec WSL ==

=== Pourquoi installer Arcanist ? ===

Arcanist (ou <code>arc</code>) est l'outil officiel de ligne de commande pour interagir avec Phabricator, le système de revue de code utilisé par le projet Operations.

* Il permet de créer, mettre à jour et soumettre des révisions (<code>arc diff</code>) directement depuis votre environnement local
* Il gère les linters et les tests automatiques configurés par le projet avant l'envoi de modifications
* Sans Arcanist, vous ne pouvez pas soumettre vos changements pour revue ni intégrer les vérifications automatiques du projet

=== 7.1 Mise à jour d'Ubuntu ===

Avant d'installer quoi que ce soit :

<syntaxhighlight lang="bash">
sudo apt update
sudo apt upgrade -y
</syntaxhighlight>

=== 7.2 Installation des dépendances ===

Arcanist a besoin de PHP et Git :

<syntaxhighlight lang="bash">
sudo apt install -y php-cli php-curl php-xml php-mbstring git curl unzip
</syntaxhighlight>

=== 7.3 Téléchargement d'Arcanist ===

Création d'un dossier pour Arcanist :

<syntaxhighlight lang="bash">
mkdir -p ~/phabricator
cd ~/phabricator
</syntaxhighlight>

Téléchargement des fichiers :

<syntaxhighlight lang="bash">
git clone https://github.com/phacility/arcanist.git
git clone https://github.com/phacility/libphutil.git
</syntaxhighlight>

=== 7.4 Rendre arc accessible partout ===

Pour ne pas devoir écrire tout le chemin :

<syntaxhighlight lang="bash">
sudo ln -s ~/phabricator/arcanist/bin/arc /usr/local/bin/arc
</syntaxhighlight>

Si le cache Bash ne reconnaît pas la commande :

<syntaxhighlight lang="bash">
hash -r
</syntaxhighlight>

=== 7.5 Vérification de l'installation ===

Test de la commande :

<syntaxhighlight lang="bash">
arc version
</syntaxhighlight>

Note|Une erreur sur shellcheck-linter peut apparaître, mais la version devrait s'afficher. Répondre "y" pour continuer.

----

== 8. Deuxième essai de arc diff (échec - authentification requise) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Erreur attendue :'''
<syntaxhighlight>
YOU NEED TO AUTHENTICATE TO CONTINUE
</syntaxhighlight>

Il faut installer le certificat.

----

== 9. Authentification Arcanist ==

=== Pourquoi exécuter arc install-certificate ? ===

Cette commande permet d'associer votre environnement local à votre compte Phabricator via un token sécurisé.

* Elle est nécessaire pour que Arcanist puisse créer, mettre à jour et soumettre vos révisions (<code>arc diff</code>) sur le serveur Phabricator
* Sans ce certificat, Arcanist ne peut pas authentifier vos commandes et toutes les opérations de soumission de code échoueront
* Le token est spécifique à votre compte et doit être généré depuis l'interface web de Phabricator

=== 9.1 Installation du certificat ===

<syntaxhighlight lang="bash">
arc install-certificate
</syntaxhighlight>

Suivez le lien fourni, récupérez le token API et collez-le dans le terminal. Arcanist est maintenant connecté à votre compte.

----

== 10. Troisième essai de arc diff (échec - shellcheck-linter manquant) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande de choisir la branche de référence, choisissez <code>origin/main</code>.

'''Nouvelle erreur :'''
<syntaxhighlight>
Failed to load library at location "shellcheck-linter"
</syntaxhighlight>

----

== 11. Installation de shellcheck-linter ==

<syntaxhighlight lang="bash">
cd ~/phabricator
git clone https://github.com/pinterest/arcanist-linters.git shellcheck-linter
</syntaxhighlight>

----

== 12. Quatrième essai de arc diff (échec - linter invalide) ==

Retournez dans le projet :

<syntaxhighlight lang="bash">
cd /mnt/c/STAGE\ 2025/operations
arc diff
</syntaxhighlight>

'''Nouvelle erreur :'''
<syntaxhighlight>
Linter 'shell' specifies invalid type 'shellcheck'
</syntaxhighlight>

Le type <code>shellcheck</code> n'est pas reconnu.

----

== 13. Correction du linter shellcheck ==

Ouvrez <code>.arclint</code> avec VS Code et modifiez :

'''Avant :'''
<syntaxhighlight lang="json">
"shell": {
"type": "shellcheck",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

'''Après :'''
<syntaxhighlight lang="json">
"shell": {
"type": "text",
"include": ["(\\.sh$)"]
}
</syntaxhighlight>

Avertissement|Ne pas commiter ce changement, c'est juste pour que ça fonctionne localement.

'''Alternative :''' Bypass des tests si nécessaire :

<syntaxhighlight lang="bash">
arc diff --nolint
</syntaxhighlight>

----

== 14. Cinquième essai de arc diff (échec - problème CRLF) ==

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc détecte 1,011 fichiers modifiés. C'est un problème de fins de ligne Windows/Linux.

=== 14.1 Correction des problèmes de fins de ligne ===

<syntaxhighlight lang="bash">
git config --global core.autocrlf input
git restore .
</syntaxhighlight>

Avertissement|Assurez-vous d'être bien dans <code>/mnt/c/STAGE\ 2025/operations</code> avant d'exécuter ces commandes.

----

== 15. Sixième essai de arc diff (succès !) ==

=== 15.1 Vérification de l'état de Git ===

Pour vous assurer qu'il n'y a pas de fichiers non suivis :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

'''Résultat attendu :''' Aucun fichier non commité ne doit apparaître.

=== 15.2 Lancement d'Arcanist ===

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Arc vous demande si vous voulez amend les changements dans <code>.arclint</code> :
<syntaxhighlight>
Do you want to amend these 1 change(s) to the current commit? [y/N] y
</syntaxhighlight>

Puis il vous demande si vous voulez utiliser le message sauvegardé :
<syntaxhighlight>
Do you want to use this message? [Y/n] Y
</syntaxhighlight>

=== 15.3 Remplissage des informations de révision ===

L'éditeur (nano) s'ouvre avec les informations à remplir :

<syntaxhighlight>
Summary: Ajout de Doba Gui comme user et dans le groupe core
Test Plan: Vérification de la syntaxe YAML et des informations utilisateur
Reviewers: dereckson
Subscribers:
</syntaxhighlight>

=== 15.4 Sauvegarde dans nano ===

# '''Sauvegarder le fichier :'''
#* Appuyez sur '''Ctrl + O''' (la lettre O, pas zéro)
#* Nano vous demandera le nom du fichier → appuyez sur '''Entrée''' pour garder le même
# '''Quitter nano :'''
#* Appuyez sur '''Ctrl + X'''

Après ça, vous retournez dans votre terminal et <code>arc diff</code> continuera le processus.

=== 15.5 Pour mettre à jour une révision existante ===

Si vous voulez mettre à jour une révision existante (ex. : D3888) :

<syntaxhighlight lang="bash">
arc diff --update D3888
</syntaxhighlight>

----

== 16. Vérification finale ==

Vérifiez que tout est propre :

<syntaxhighlight lang="bash">
git status
</syntaxhighlight>

Aucun fichier ne doit rester non commité.

Assurez-vous que votre révision contient bien vos modifications :

<syntaxhighlight lang="bash">
arc diff
</syntaxhighlight>

Succès|À ce stade, votre révision est prête à être relue par votre reviewer.

----

== Résumé des problèmes rencontrés ==

{| class="wikitable"
! Problème !! Solution
|-
| Fichiers vides dans operations/ || <code>rm -rf operations/</code> puis travailler dans <code>pillar/core/</code>
|-
| Cache Bash pour arc || <code>hash -r</code>
|-
| Authentification manquante || <code>arc install-certificate</code>
|-
| Bibliothèque shellcheck-linter manquante || Cloner dans <code>~/phabricator/</code>
|-
| Erreur linter shellcheck || Changer <code>"type": "shellcheck"</code> en <code>"type": "text"</code> dans <code>.arclint</code>
|-
| Problème CRLF/LF || <code>git config --global core.autocrlf input</code> puis <code>git restore .</code>
|}

----

== Points importants à retenir ==

Avertissement|
* '''Toutes les commandes Git et Arcanist doivent être exécutées dans <code>/mnt/c/STAGE\ 2025/operations</code>, et non dans <code>~/phabricator</code>.'''
* '''Ne pas commiter les modifications du fichier <code>.arclint</code> (changement de shellcheck en text).'''
* '''Les vrais fichiers sont dans <code>pillar/core/</code>, pas dans <code>operations/pillar/core/</code>.'''

Catégorie:Documentation
Catégorie:Guide de contribution
Catégorie:Développement

Dev zone/Create devserver access/fr - Revision history

Ptdradmin at 11:10, 4 February 2026

Ptdradmin at 14:50, 26 November 2025

Dereckson: Update categories