Développement

De Documentation LCS
Aller à : Navigation, rechercher

Sommaire

Actualités

Suivre et contribuer au développement du projet LCS

Un outil de suivi des tâches en cours et rapport de bugs est disponible en suivant ce lien...

Le dépôt de développement LCS (subversion)

Le projet LCS utilise subversion comme outil de système de gestion de versions concurrentes. Le fichier LCS/README.txt contenu dans le dépôt subversion détaille comment le dépôt est organisé et la manière dont les contributeurs doivent l'utiliser voir également Architecture et usages du dépôt de développement.

Les dépôts des paquets Debian

Le dépôt APT

Branche de développement

Branche de test

Lcs Stable

Il existe également un dépôt Etch pour les LCS en exploitation encore basés sur cette distribution deb http://lcs.crdp.ac-caen.fr/etch LcsXP main

Maintenir un paquet LCS

Pour contribuer à LCS nous utilisons les outils Debian dpkg et dput. Pour contribuer il vous faut une clé GPG et une clé SSH

  • Signature d'un paquet

Pour réaliser un paquet Debian pour LCS, vous devez signer votre paquet avec une clé GPG. Pour connaître la liste des clés présentes sur votre machine :

gpg --list-keys

Pour fabriquer une nouvelle clé :

gpg --gen-key

Il va vous créer un répertoire .gnupg dans votre Home. A la première question, répondre "1" (DSA and Elgamal (default)) Ensuite, vous pouvez modifier la taille de la clé mais la valeur par défaut convient déjà très bien. Laissez le choix par défaut pour la date d’expiration. Confirmez avec "Y" que tous les renseignements sont corrects. Il va à présent vous demander de renseigner votre nom et votre adresse e-mail (Cela sera utile pour vos correspondants, qui pourront ainsi savoir à qui appartient la clef). Vous pouvez aussi éventuellement attacher un commentaire. Vous devez maintenant confirmer que les renseignements précédents sont corrects en tapant "O". A présent, entrez une passphrase pour protéger votre clé.

Une fois votre clé générée, vous pouvez l'exporter :

gpg --armor --output MaClePub.asc --export "Nom_De_Lutilisateur"

La génération de la clé GPG n'est à effectuer qu'une seule fois, à la création du 1er paquet.

Vous pouvez à présent créer votre paquet Debian en suivant la structure des paquets LCS :

Avec dpkg-buildpackage
dpkg-buildpackage  -rfakeroot -e<email_associé_à_la_clé_utilisée_pour_signer>

Votre passphrase sera demandé 2 fois au cours de la création du paquet.

Avec svn_buildpackage
Création d'un paquet à partir du dépôt local
jlcf@LinuxBox:/DepotSVN/svnTICE/BacASable/LCS2.0ndg/sources/trunk/lcs-preinstall$
 svn-buildpackage -rfakeroot -ejean-luc.chretien@tice.ac-caen.fr --svn-lintian

Le paquet est disponible dans : ../build-area

Création d'un paquet à partir du dépôt local et création d'un tag
jlcf@LinuxBox:/DepotSVN/svnTICE/BacASable/LCS2.0ndg/sources/trunk/lcs-preinstall$
svn-buildpackage --svn-move-to=../../../packages/debian/devel \
                 --svn-lintian \
                 --svn-tag -rfakeroot \  
                 -ejean-luc.chretien@tice.ac-caen.fr

Le paquet est disponible dans le répertoire ../../../packages/debian/devel Une version tagée est dispo en : sources/tags/lcs-preinstall/2.0/ Si l'on souhaite refaire un paquet avec le même tag, il faut remplacer --svn-tag par --svn-retag

Préparation au Transfert d'un paquet :

Le transfert d'un paquet sur les dépôts LCS se fait à l'aide de SSH et de dput, vous devez nous avoir envoyé votre clé SSH publique. Pour se faire vous devez nous transmettre le fichier .asc généré avec la commande d'exportation de votre clef gpg.

gpg --armor --output MaClePub.asc --export "Nom_De_Lutilisateur"

Les clés ssh sont dans le répertoire .ssh/ de votre home.

ls ~/.ssh
id_rsa  id_rsa.pub id_dsa  id_dsa.pub  

Les clés peuvent être au format RSA ou DSA

Si vous n'avez pas de clé, il est possible d'en générer une :

 ssh-keygen -t rsa

La partie publique est le fichier id_rsa.pub que vous pouvez communiquer. Le fichier id_rsa est votre clé privée à NE JAMAIS COMMUNIQUER.

* Pour envoyer un paquet vous devez nous avoir envoyé votre clé GPG et votre clé SSH par e-mail.
* Configuration de dput :

L'upload du paquet se fait avec l'utilitaire dput :

apt-get install dput : 

Puis dans votre dossier home, écrivez le fichier .dput.cf comme suit :


[lcs]
fqdn = lcs.crdp.ac-caen.fr
method = scp
login = debian
incoming = /home/debian/incomings/lcs
allow_unsigned_uploads = 0

[lcs-testing]
fqdn = lcs.crdp.ac-caen.fr 
method = scp
login = debian
incoming = /home/debian/incomings/lcs-testing
allow_unsigned_uploads = 0

[lcs-xp]
fqdn = lcs.crdp.ac-caen.fr 
method = scp
login = debian
incoming = /home/debian/incomings/lcs-xp
allow_unsigned_uploads = 0



Ensuite pour envoyer votre paquet :

- pour un envoi dans la branche stable

dput lcs mon-paquet-lcs-xxxx.changes

- pour un envoi dans la branche de test

dput lcs-testing mon-paquet-lcs-xxxx.changes

- pour un envoi dans la branche de développement

dput lcs-xp mon-paquet-lcs-xxxx.changes

5 min plus tard, votre paquet sera accessible avec apt-get install

La structure des paquets LCS

On distingue dans le projet LCS, trois types de paquets LCS développés, maintenus par l'équipe de développement LCS ou des contributeurs : les paquets «système», les paquets modules et les paquets communs à plusieurs projets (SLIS SE3 LCS).

Liste des paquets LCS

Arborescence des paquets LCS

Arbre des dépendances des paquets lcs

Projet : Gestion des accès internet LcSe3


Projet : Debian Installer pour LCS

Introduction

Objectifs

Installation complète et automatique d'un LCS 2 Debian Lenny avec D-I

Etat du projet

1. Disponible : Une interface web permettant de générer les fichiers de configuration d'un LCS (preseed, lcs.conf...) pour Debian Lenny accès ici...

FAQ LCS 2.0

Réponses aux Questions Fréquemments Posées

Fichiers xml d'importation des utilisateurs type Sconet/STSweb de test

Vous trouverez à cette adresse un zip contenant des fichiers xml sconet et sts de test (année N et année N+1).


Ces fichiers peuvent servir à peupler les annuaires de serveurs de tests ou à faire des formations.

Toutes les dates de naissance élèves (donc les mots de passe initiaux) sont à 19871212.

Toutes les dates de naissance professeurs sont à 19631212.

Le détail des changements de classe entre l'année N et N+1 sont dans le fichier README.txt.

Mise place d'un environnement de développement/debuggage PHP/MySQL associé à un LCS (VM ou LCS de test)

Outils personnels
Espaces de noms

Variantes
Actions
Navigation
Boîte à outils