Les alias sont des noms courts qui identifient de manière unique les éléments dans le contrôle des sources. Les alias sont des numéros de quatre chiffres (entre parenthèses) affichés à gauche de l'élément auquel ils font référence. Par exemple :
$ scm status
Workspace: (6377) "My Workspace" <-> (7487) "Stream"
Component: (6429) "Flux Capacitor"
Baseline: (8471) 6815 "v20091102"
Sortantes :
Ensembles d'artefacts modifiés :
(8459) --@ 98314 "Degauss Flux Capacitor" - <No comment>
Dans l'exemple ci-dessus, chaque nombre entre parenthèses (6377, 7487, 6429, 8471, 8459) est un alias.
Chaque sous-commande a un groupe de codes retour. 0 est retourné lorsque la sous-commande aboutit. Une valeur différente de zéro est retournée en cas d'erreur ou d'incident, tel qu'un conflit ou la désynchronisation du bac à sable local avec l'espace de travail distant.
Les exemples suivants supposent que vous vous êtes connecté à un référentiel avec lscm login. Par conséquent, il suffit de fournir -r repositoryNickName avec chaque sous-commande. Par exemple :
$ lscm login -r https://your.repository.com:9443/jazz -n nickname -u echughes -c Password (echughes @ https://your.repository.com:9443/jazz): Logged in to https://your.repository.com:9443/jazz
Vous pouvez également faire référence au référentiel https://your.repository.com:9443/jazz avec un pseudonyme. Par exemple, envoyez -r nickname à la sous-commande au lieu de l'URL, du nom d'utilisateur et du mot de passe.
Avant de commencer un projet, vous devez avoir un nom d'utilisateur, un mot de passe et l'URL de votre référentiel. Vous devez être également membre d'une zone d'équipe.
Si vous ne connaissez pas le nom du flux avec lequel vous collaborez, vous pouvez utiliser lscm list streams -r nickname pour lister les flux auxquels vous avez accès. Par exemple :
$ lscm -a y list streams -r l DeLorian Upgrades Home Energy Converter Doc Brown's playpen
Lorsque vous avez déterminé le flux avec lequel vous collaborez, vous pouvez créer un espace de travail distant pour y placer vos modifications. Par exemple :
$ lscm create workspace -r l myNewWorkspace -s "DeLorian Upgrades" Workspace (8551) "myNewWorkspace" successfully created
L'ajout du paramètre -s indique le flux avec lequel l'espace de travail doit collaborer. Le nouvel espace de travail utilise ce flux comme cible de flux par défaut et a l'état du flux comme état initial.
Pour charger l'espace de travail distant :
$ lscm load myNewWorkspace -r l Downloading /flux.capacitor/requirements.txt (0 B) Downloading /flux.capacitor/diagrams/design.cad (0 B)
Dans l'interface CLI du contrôle des sources, vous pouvez suivre un flux de travaux type, tel que modifier des fichiers, restituer des fichiers, accepter les nouvelles modifications et distribuer les modifications.
Les actions de restitution et de distribution de l'interface CLI sont identiques dans le client Eclipse. La restitution envoie les modifications de votre disque local vers un espace de travail distant et la distribution envoie les modifications depuis un espace de travail distant vers un flux.
Dans l'exemple d'interface CLI suivant, vous modifiez des fichiers et déterminez ce qui a été modifié en exécutant status :
$ lscm status
Workspace: (8551) "myNewWorkspace" <-> (8552) "DeLorian Upgrades"
Component: (8553) "Flux Capacitor"
Baseline: (8554) 1 "Initial Baseline"
Unresolved:
-c /flux.capacitor/requirements.txt
Sortantes :
Ensembles d'artefacts modifiés :
(8555) --$ "Initial CAD"
La commande status balaye les répertoires partagés pour rechercher les modifications, ce qui peut prendre beaucoup de temps. Si vous voulez comparer uniquement l'espace de travail distant et le flux, vous pouvez exécuter lscm status –n qui permet d'ignorer l'analyse du disque dur local.
Pour valider les modifications utilisez lscm checkin :
$ lscm checkin flux.capacitor/
Validation...
Workspace: (8551) "myNewWorkspace" <-> (8552) "DeLorian Upgrades"
Component: (8553) "Flux Capacitor"
Sortantes :
Ensembles d'artefacts modifiés :
(8556) --@ <No comment>
Cet exemple crée implicitement un nouvel ensemble d'artefacts modifiés. Les ensembles d'artefacts modifiés qui ont reçu des fichiers et des dossiers au cours de la validation figurent dans la sortie.
Une fois l'ensemble d'artefacts modifiés créé, vous pouvez l'associer à un élément de travail et ajouter un commentaire. Pour affecter un élément de travail, utilisez lscm changeset associate. Pour définir le commentaire, utilisez lscm changeset comment.
Vous pouvez afficher périodiquement l'état dans un flux en exécutant lscm status :
$ lscm status -C
Workspace: (8551) "myNewWorkspace" <-> (8552) "stream19_test_max_results_1256765247692134"
Component: (8553) "Flux Capacitor"
Baseline: (8554) 1 "Initial Baseline"
Sortantes :
Ensembles d'artefacts modifiés :
(8556) --@
Modifications :
---c /flux.capacitor/requirements.txt
Entrantes :
Ensembles d'artefacts modifiés :
(8615) --$ "Initial layout"
Modifications :
---c /flux.capacitor/diagrams/design.cad
L'option -C affiche le contenu des ensembles d'artefacts.
Dans l'exemple ci-dessus, il existe une seule modification entrante dans design.cad. Vous pouvez accepter cette modification, car elle ne modifie aucun des fichiers dans les ensembles d'artefacts.
Exécutez lscm accept :
$ lscm accept -v
Repository: https://localhost:9443/jazz/
Workspace: (8551) "myNewWorkspace"
Component: (8553) "Flux Capacitor"
Ensembles d'artefacts modifiés :
(8615) ADMIN --$ "Initial layout"
Modifications :
--c /flux.capacitor/diagrams/design.cad
Il arrive que les modifications entrantes modifient des fichiers que vous avez déjà modifiés.
Dans l'exemple ci-dessous, vous modifiez flux.capacitor/requirements.txt pour inclure une note d'une réunion de planification, restituez le fichier et exécutez status :
$ lscm status -C
Workspace: (8551) "myNewWorkspace" <-> (8552) "stream19_test_max_results_1256765247692134"
Component: (8553) "Flux Capacitor"
Baseline: (8554) 1 "Initial Baseline"
Sortantes :
Ensembles d'artefacts modifiés :
(8617) -#@ "Update from November planning meeting"
Modifications :
-#-c /flux.capacitor/requirements.txt
Entrantes :
Ensembles d'artefacts modifiés :
(8616) -#$ "Results of initial trials"
Modifications :
-#-c /flux.capacitor/requirements.txt
Une collision a eu lieu. Les fichiers que vous avez modifiés ont été également modifiés par un autre utilisateur qui a distribué des modifications au flux. La collision est signalée par # devant les fichiers participants et les ensemble d'artefacts modifiés participants. Lorsque vous modifiez l'ensemble d'artefacts modifiés avec l'alias 8616, vous générez un conflit.
$ lscm accept 8616 -v -i
Repository: https://localhost:9443/jazz/
Workspace: (8551) "myNewWorkspace"
Component: (8553) "Flux Capacitor"
Ensembles d'artefacts modifiés :
(8616) ADMIN -#$ "Results of initial trials"
Modifications :
!-c /flux.capacitor/requirements.txt
Les espaces de travail suivants ont toujours des conflits après accept :
myNewWorkspace
Exécutez 'scm resolve', 'scm conflicts' ou 'scm status' pour vous aider à résoudre les conflits.
L'option -i insère des marqueurs de conflit dans les fichiers. Ces marqueurs sont similaires à ceux utilisés par les autres systèmes de contrôle des sources.
Le point d'exclamation (!) dans la liste des modifications indique que le fichier a un conflit.
Vous pouvez obtenir la liste des conflits dans les composants chargés en exécutant scm conflicts.
Le fichier contient des marqueurs de conflit indiquant l'incident :
- Must not need any more than 1.5 gigawatts of power - Determine minimum necessary speed <<<<<<< mine - Twin Pines parking lot? ======= - Initial trials suggest 60kmh >>>>>>> proposed
La ligne entre <<<<<<< mine et le signe égal provient de l'ensemble d'artefacts modifiés dans votre espace de travail. La ligne entre les signes égal et >>>>>>> proposed provient de l'ensemble d'artefacts modifiés entrants. Vous pouvez obtenir le fichier d'origine en exécutant lscm conflicts -m flux.capacitor/requirements.txt. Si vous voulez obtenir la version entrante, vous pouvez exécuter lscm conflicts -p flux.capacitor/requirements.txt. L'option -m est l'abréviation de mine et l'option -p, l'abréviation de proposed.
Résolvez la modification avec la proposition. Supprimez les marqueurs de conflit du fichier :
- Must not need any more than 1.5 gigawatts of power - Determine minimum necessary speed Initial trials suggest 60kmh
Validez la modification et indiquez au référentiel que le conflit a été éliminé avec la version restituée en exécutant lscm resolve :
lscm resolve -c flux.capacitor/requirements.txt
Aucune sortie n'indique que le conflit a été résolu.
-c indique que le conflit doit être résolu avec la version restituée. Vous pouvez également utiliser -p pour résoudre le conflit avec la version proposée.
Maintenant, vous pouvez effectuer d'autres modifications ou distribuer l'ensemble d'artefacts modifiés avec lscm deliver :
$ lscm deliver Distribution des modifications de "myNewWorkspace" vers "DeLorian Updates" Aucune version de référence à transmettre.
Pour savoir qui a modifié des lignes d'un fichier, exécutez lscm annotate :
$ lscm annotate flux.capacitor/requirements.txt 1 Marty (8556) 2009-11-04 - Must not need any more than 1.5 gigawatts of power 2 Marty (8556) 2009-11-04 - Determine minimum necessary speed 3 Doc (8616) 2009-11-04 Results of initial t - Initial trials suggest 60kmh
La sortie de la commande annotate contient six colonnes :
Pour comparer deux versions différentes d'un fichier, utilisez scm diff qui génère un chemin standard.
Pour supprimer les modifications non validées, utilisez scm undo.
Cette section décrit les commandes avancées utilisées principalement par les administrateurs qui configurent le contrôle des sources Rational Team Concert pour d'autres utilisateurs. La plupart des utilisateurs créent et chargent les espaces de travail depuis des flux existants.
Un composant est un regroupement d'arborescences source qui rassemble les groupes logiques de code source.
Lorsqu'un projet s'étend, vous pouvez être amené à ajouter des arborescences source. Si un composant existant n'a pas besoin des modifications, vous devez ajouter un nouveau composant :
$ lscm create component "Flux Capacitor" "DeLorian Upgrades" -r l Component (8553) "Flux Capacitor" successfully created.
Dans l'exemple ci-dessus, vous avez créé un nouveau composant dans le flux DeLorian Upgrades. Les utilisateurs qui ont des espaces de travail qui collaborent avec ce flux, voient l'ajout du composant comme une modification entrante. Lorsqu'ils acceptent les modifications entrantes, les utilisateurs reçoivent le contenu dans le composant.
Si un utilisateur veut ajouter de nouveaux fichiers au composant créé à cet effet, l'utilisateur peut effectuer cette tâche avec la sous-commande share. Le contrôle des sources Rational Team Concert permet uniquement de partager des répertoires et des dossiers dans un espace de travail. L'utilisateur doit ajouter le nouveau composant dans un espace de travail distant :
$ lscm workspace add-component -r l myNewWorkspace 8553 Component (8553) "Flux Capacitor" successfully added.
Dans l'exemple ci-dessus, l'alias 8553 fait référence au composant nouvellement créé à partir de l'exemple précédent.
Le nouveau composant se trouve maintenant dans l'espace de travail et l'utilisateur doit partager l'arborescence source dans l'espace de travail :
$ lscm share -r l myNewWorkspace 8553 flux.capacitor Téléchargement en amont des fichiers... Partage réussi
Dans l'exemple ci dessus, l'action envoie le contenu du répertoire flux.capacitor à l'espace de travail mon nouvel espace de travail et l'ajoute au composant défini par 8553 qui est le Flux Capacitor de l'étape précédente.
Etes-vous satisfait ? Vous pouvez faire part de vos commentaires à l'adresse Jazz.net (enregistrement requis) : Commentaire dans les forums ou soumettre un bogue