Χρησιμοποιώντας το CVS για πρόσβαση και αναβάθμιση του source κώδικα του Moodle

Τα αρχικά CVS σημαίνουν Concurrent Versioning System (ΠΑράλληλο Σύστημα Εκδόσεων). Είναι ένας κοινά χρησιμοποιούμενος τρόπος για αποθήκευση του source κώδικα επειδή κρατάει εκδόσεις απο όλα τα αρχεία έτσι ώστε να μην χάνεται ποτέ τίποτα, και είναι δυνατή η χρήση απο πολλούς χρήστες ταυτόχρονα. Παρέχει επίσης τρόπους για να ενώνει τον κώδικα αν δύο οι περισσότεροι χρήστες δουλεύουν στο ίδιο αρχείο. Όλος ο κώδικας και όλες οι εκδόσεις αποθηκεύονται σε ένα κεντρικό server (σε αυτή την περίπτωση, στον Sourceforge).

Για να χρησιμοποιεισετεί το αρχείο του CVS του Moodle (σαν ένας προγραμματιστής με δικαιώματα εγγραφής (write access)), πρέπει πρώτα να έχετε ένα λογαριασμό στο Sourceforge. Για τα παραδείγματα αυτής της σελιδας, ας υποθέσουμε οτι το Όνομα Χρήστη (username) είναι myusername και ο κωδικός πρόσβασης (password) είναι mypassword. Όταν θα έχετε ένα λογαριασμό στο Sourceforge, επικοινωνήστε μαζί μου (Martin Dougiamas) για να σας δώσω δικαιώματα εγγραφής σε συγκεκριμένα directories.

Για να αποφεύγεται να σας ζητάει κωδικό προσβασης mypassword κάθε φορά που τρέχετε μια εντολή του CVS, ακολουθήστε τις Sourceforge οδηγίες για χρήση εξουσιοδοτημένων κλειδιών. Αυτό το βήμα είναι προαιρετικό, αλλά μπορεί να κάνει την εμπειρία σας με το CVS πολύ καλύτερη.

Αν γίνει και αυτό, θα έχετε όλες τις άδειες που χρειάζεστε, έτσι χρειάζεστε μόνο να στήσετε το μηχάνημα σας και να κατεβάσετε τις τρέχουσες πηγές για να αρχίσετε να δουλεύετε σε αυτές. Παρακάτω είναι οδηγίες για συστήματα Unix και Windows.

1. Χρησιμοποιόντας το CVS στο Unix

Το Sourceforge CVS χρησιμοποιεί ssh σαν πρωτόλλο μεταφοράς για ασφάλεια, γιαυτό θα πρέπει να θέσετε την μεταβλητή περιβάλλοντος CVS_RSH στο Unix shell:

setenv CVS_RSH ssh (for csh, tcsh etc)
export CVS_RSH=ssh (for sh, bash etc)

Είναι καλύτερα να τοποθετήσετε αυτό στο αρχείο σας .bashrc ή .cshrc για να μην το πληκτρολογείτε κάθε φορά. Μετά ρίξτε μια ματιά στο Moodle χρησιμοποιόντας αυτό (όλο σε μια γραμμή): 

cvs -z3 -d:ext:myusername@cvs.sourceforge.net:/cvsroot/moodle co moodle

Μην δοκιμάσετε να τρέξετε αυτή την πρώτη CVS εντολή σε ένα υπάρχον directory του moodle - Ξεκινήστε απο την αρχή με ένα καινούργιο directory.

Σημειώστε οτι θα χρειαστεί να εισάγετε τον κωδικό πρόσβασης mypassword για κάθε εντολή εκτός και αν θέσετε τα εξουσιοδοτημένα κλειδία

Τώρα, θα πρέπει να έχετε ένα καινούργιο 'moodle' directory. Μπορείτε να του αλάξετε όνομα και να το μετακινήσετε αν θέλετε. Πηγαίνετε σε αυτό: 

cd moodle

Όλα τα τελευταία αρχεία του Moodle πρέπει να βρίσκονται εκεί. Μπορείτε τώρα να αλλάξετε τα αρχεία στο αντίγραφό σας. Για να συγκρίνετε με αυτά του πρωτεύοντος αντίγραφού του CVS στον server χρησιμοποιήστε cvs diff, eg: 

cvs diff -c config-dist.php
cvs diff -c lang

Για να πάρετε το τελευταίο update απο τον server χρησιμοποιήστε: 

cvs update -dP

Για να αντιγράψετε τα καινούργια αρχεία σας στον server θα πρέπει να κάνετε κάτι σαν: 

cd lang/ca 
cvs commit

Θα σας ζητηθεί να προσθέσετε μερικά σχόλεια (εξαρτάτε απο τον default κειμενογράφο) ... προσθέστε ένα σχόλειο που να βγάζει νόημα και κλείστε τον κειμενογράφο ... τα αρχεία θα σταλούν στο Sourceforge και θα αποθηκευτούν. Έτοιμοι!

Για οικονομία χρόνου μπορείτε να θέσετε default ορίσματα σε ένα αρχείο που λέγετε .cvsrc στο home directory σας. Για παράδειγμα, το δικό μου περιέχει: 

diff -c 
update -dP

Δοκιμάστε 'cvs help' για περισσότερες λεπτομέριες ...

 

2. Χρησιμοποιόντας το CVS στα Windows

Αυτές οι οδηγίες βασίζονται σε σημείωσεις του Mitsuhiro Yoshida <mits@mitstek.com>.

Πρώτα, κατεβάστε και εγκαταστήστε το WinCVS.

https://sourceforge.net/project/showfiles.php?group_id=10072

Μετά, κατεβάστε το sfsetup για SourceForge ssh πρόσβαση, εγκαταστήστετψ και επανεκκιννήστε τα Windows.

http://sourceforge.net/projects/sfsetup/

Επόμενο βήμα, παραμετροποιήστε το WinCVS. Βρείτε το, και διαλέψτε Admin -> Preferences. Μετά αλλάξτε τα όπως φαίνονται παρακάτω:

[General]
CVSROOT data:
Authentication: ssh
Path: /cvsroot/moodle
Host address: cvs.sourceforge.net
User name: myusername
CVSROOT: myusername@cvs.sourceforge.net:/cvsroot/moodle

[Globals]
Checkout read-only: uncheck
Supply control when adding files: check
Quiet mode: uncheck
TCP/IP compression: check and select 9
Dirty files support: check
Prune(remove) empty directories: check
Disable splash screen: uncheck

Συγχαρητήρια, το WinCVS είναι έτοιμο. Τώρα, θα πρέπει να δοκιμάσετε ένα ολοκληρωμένο αντίγραφο που να δουλεύει απο τον source κώδικα του Moodle:

  1. Επιλέξτε 'Create -> checkout'
  2. Για την επιλογή 'Module name and path on the server", πληκτρολογήστε "moodle", και μετά πατήστε ΟΚ.
  3. Πληκτρολογήστε mypassword και πατήστε Enter στο παράθυρο του DOS.

Μετά από αυτό τον πρώτο έλεγχο, μπορείτε να πάρετε ανανεώμενα αρχεία απο τον CVS server όπως αυτα:

  1. Επιλέξτε τα directories και τα αρχεία που θέλετε να κάνετε update
  2. Πατήστε το δεξί πλήκτρο του ποντικιού και επιλέξτε 'Update selection'
  3. Πατήστε ΟΚ
  4. Πληκτρολογήστε mypassword και πατήστε Enter στο παράθυρο του DOS.

Αφού αλάξετε τα αρχεία , μπορείτε να τα στείλετε πίσω στον CVS server με τον ακόλουθο τρόπο:

  1. Επιλέξτε τα αρχεία και τα directories που θέλετε να στείλετε στον server
  2. Πατήστε το δεξί κουμπί και επιλέξτε 'Commit selection'
  3. Πατήστε ΟΚ
  4. Πληκρολογήστε ένα σχόλειο που να έχει νόημα και πατήστε ΟΚ.
  5. Πληκτρολογήστε mypassword και πατήστε Enter στο παράθυρο του DOS.

 

Καλή Τύχη!

 

Τεκμηρίωση του Moodle

Version: $Id: features.html,v 1.2 2001/12/09 10:34:19 martin Exp $