Procédure pour soumettre un paquet sur AUR-git
Publié : 19 aou 2015, 10:49
Bonjour à tous
Pour les utilisateurs qui voudraient œuvrer pour la communauté par l'intermédiaire de soumission de paquets, cette procédure détaillée est basée sur du vécu ; je remercie vivement lemust83 pour le coup de main qu'il m'a apporté pour arriver à mes fins. papajoke m'a donné un coup de main appréciable en relisant/contrôlant ce sujet. Merci à eux deux
Tout d'abord, un peu de doc, ce sujet archlinux (in british)
Une autre doc, cette page du wiki francophone
Autre doc rendant bien service. Cette dernière est obsolète, mais il est utile de la lire car c'est un excellent point de départ.
1) En tout premier il faut installer 3 paquets :
Edit:
A partir d'ici nous n'interviendrons uniquement qu'en tant qu'utilisateur normal.
2) Vous pouvez aussi dès à présent songer à concocter une passphrase suffisamment complexe, facile à se rappeler et différente du MP qui vous sera demandé lors de votre inscription sur AUR...
3) Ensuite on va créer une clé ssh reconnue dans AUR en passant la commande suivante (en simple utilisateur) :
Un répertoire ~/.ssh/id_rsa-aur.pub s'est créé contenant la clé publique.
4) S'enregistrer sur Aur (si ce n'est déjà le cas)
Renseigner son pseudo, son adresse email.
PGP Key Fingerprint > laisser vide
Dans la fenêtre SSH Public Key, copier-coller le contenu de ~/.ssh/id_rsa-aur.pub. Si cette dernière action n'est pas indispensable, ne le faites pas maintenant, vous le ferez au point 5).
5) Se connecter sur AUR > Mon compte (à droite on peut passer de l'english au français).
Copier-coller la clé contenue dans ~/.ssh/id_rsa-aur.pub dans le carré Clé SSH publique.
Même si c'est déjà fait par défaut, le refaire puis Mise à jour.
6) On modifie le fichier ~/.ssh/config en y mettant ceci (si le fichier n'existe pas, le créer) :
*=*=*=*=*=*=*
CRÉATION D'UN PAQUET GIT
7) Assurez-vous que votre PKGBUILD est bien fonctionnel, vérifiez-le plutôt deux fois qu'une, qu'il ne manque aucunes dépendances. Vous pouvez vous aider de namcap (à installer par pacman).
Voir ce sujet :
https://wiki.archlinux.org/title/PKGBUI ... %C3%A7ais)
Assurez-vous aussi que le paquet que vous projetez de publier ne l'est pas déjà. Inutile d'encombrer AUR.
8) Passer la commande suivante, en utilisateur simple :
Vous allez obtenir ce retour :
Un répertoire portant le nom de votre paquet s'est créé dans votre home (dossier personnel).
Y mettre au minimum le PKGBUILD et .SRCINFO plus, éventuellement, un fichier d'installation xxxxx.install mais jamais les sources du paquets.
Pour obtenir le .SRCINFO, ouvrir un terminal dans le répertoire contenant le PKGBUILD et taper la commande suivante :
ou si pkgbuild-introspection n'est pas installé
9) Créer dans votre dossier personnel (home), s'il n'existe déjà, le fichier .gitconfig et mettre dedans :
10) Vous placer dans le répertoire contenant le PKGBUILD et .SRCINFO, et passer les commandes suivantes :
Lors du "push", aur va automatiquement vérifier la syntaxe de ces 2 fichiers et peut vous retourner des messages d'erreurs.
Lors de ces procédures, quand il vous est demandé 'Enter passphrase', veuillez entrer ce qui a été vu au point 2).
Vous pouvez ensuite aller vérifier, votre paquet doit être sur AUR.
*=*=*=*=*=*=*
MODIFICATION D'UN PAQUET GIT
11) On modifie le pkgbuild puis on entre les commandes suivantes :
Note : par sécurité, on peut souhaiter ne pas réutiliser un dépôt local mais préférer télécharger la dernière version sur aur et retravailler à partir d'elle.
Commande possible avec uniquement ces propres paquets !
Pour les utilisateurs qui voudraient œuvrer pour la communauté par l'intermédiaire de soumission de paquets, cette procédure détaillée est basée sur du vécu ; je remercie vivement lemust83 pour le coup de main qu'il m'a apporté pour arriver à mes fins. papajoke m'a donné un coup de main appréciable en relisant/contrôlant ce sujet. Merci à eux deux
Tout d'abord, un peu de doc, ce sujet archlinux (in british)
Une autre doc, cette page du wiki francophone
Autre doc rendant bien service. Cette dernière est obsolète, mais il est utile de la lire car c'est un excellent point de départ.
1) En tout premier il faut installer 3 paquets :
sudo pacman -S openssh git pkgbuild-introspection
pkgbuild-introspection
n'est plus dans les dépôts officiels. Il faut passer par Aur pour l'installer. Ce paquet permet de générer le fichier .SRCINFO (tarball). mais la commande makepkg --printsrcinfo > .SRCINFO
permet de s'en passerA partir d'ici nous n'interviendrons uniquement qu'en tant qu'utilisateur normal.
2) Vous pouvez aussi dès à présent songer à concocter une passphrase suffisamment complexe, facile à se rappeler et différente du MP qui vous sera demandé lors de votre inscription sur AUR...
3) Ensuite on va créer une clé ssh reconnue dans AUR en passant la commande suivante (en simple utilisateur) :
ssh-keygen -f ~/.ssh/id_rsa-aur
4) S'enregistrer sur Aur (si ce n'est déjà le cas)
Renseigner son pseudo, son adresse email.
PGP Key Fingerprint > laisser vide
Dans la fenêtre SSH Public Key, copier-coller le contenu de ~/.ssh/id_rsa-aur.pub. Si cette dernière action n'est pas indispensable, ne le faites pas maintenant, vous le ferez au point 5).
5) Se connecter sur AUR > Mon compte (à droite on peut passer de l'english au français).
Copier-coller la clé contenue dans ~/.ssh/id_rsa-aur.pub dans le carré Clé SSH publique.
Même si c'est déjà fait par défaut, le refaire puis Mise à jour.
6) On modifie le fichier ~/.ssh/config en y mettant ceci (si le fichier n'existe pas, le créer) :
Host aur.archlinux.org
IdentityFile ~/.ssh/id_rsa-aur
User aur
Port 22
CRÉATION D'UN PAQUET GIT
7) Assurez-vous que votre PKGBUILD est bien fonctionnel, vérifiez-le plutôt deux fois qu'une, qu'il ne manque aucunes dépendances. Vous pouvez vous aider de namcap (à installer par pacman).
Voir ce sujet :
https://wiki.archlinux.org/title/PKGBUI ... %C3%A7ais)
Assurez-vous aussi que le paquet que vous projetez de publier ne l'est pas déjà. Inutile d'encombrer AUR.
8) Passer la commande suivante, en utilisateur simple :
git clone git+ssh://aur@aur.archlinux.org/nom_du_paquet.git
Clonage dans 'nom_du_paquet'...
Enter passphrase for key '/home/votre_user/.ssh/id_rsa-aur':
warning: Vous semblez avoir cloné un dépôt vide.
Vérification de la connectivité... fait.
Y mettre au minimum le PKGBUILD et .SRCINFO plus, éventuellement, un fichier d'installation xxxxx.install mais jamais les sources du paquets.
Pour obtenir le .SRCINFO, ouvrir un terminal dans le répertoire contenant le PKGBUILD et taper la commande suivante :
mksrcinfo
makepkg --printsrcinfo > .SRCINFO
9) Créer dans votre dossier personnel (home), s'il n'existe déjà, le fichier .gitconfig et mettre dedans :
[user]
email = votre_email_renseignée_lors_de_votre_inscription_chez_AUR
name = votre_pseudo
[push]
default = simple
10) Vous placer dans le répertoire contenant le PKGBUILD et .SRCINFO, et passer les commandes suivantes :
git add PKGBUILD .SRCINFO
git commit -m 'Initial import'
git push origin master
Lors de ces procédures, quand il vous est demandé 'Enter passphrase', veuillez entrer ce qui a été vu au point 2).
Vous pouvez ensuite aller vérifier, votre paquet doit être sur AUR.
*=*=*=*=*=*=*
MODIFICATION D'UN PAQUET GIT
11) On modifie le pkgbuild puis on entre les commandes suivantes :
makepkg --printsrcinfo > .SRCINFO
git commit -am 'Modif....'
git push origin master
git clone git+ssh://aur@aur.archlinux.org/nom_du_paquet.git