Bien démarrer

Softwareforge relie vos dépôts Git, vos constructions Factory et vos images publiées. Le tableau de bord présente uniquement les projets que vous possédez ou auxquels vous avez accès.

Le parcours habituel est : accéder au projet, modifier les sources, envoyer un commit, suivre sa construction puis récupérer une version vérifiée. Une image publiée ne change plus : son digest identifie exactement son contenu.

1. Connectez-vous avec votre compte sigMAX et vérifiez que Softwareforge est activé dans Identity.
2. Ouvrez un projet existant ou utilisez Nouveau projet. Attendez que le dépôt soit Prêt.
3. Choisissez Voir le projet pour l’éditeur intégré, ou clonez le dépôt sur votre poste avec l’adresse SSH affichée.

Compte Identity et connexion commune

Identity centralise votre compte, votre avatar, votre langue, vos clés SSH et les applications autorisées. La connexion passe par Authentik. Un compte connecté à une application sigMAX retrouve sa session dans les autres applications auxquelles il a droit.

Déconnexion ferme la session commune : Softwareforge, l’éditeur et les autres applications sigMAX cessent d’accepter cette session. Une clé API personnelle créée séparément reste indépendante de la connexion navigateur ; révoquez-la dans Identity si nécessaire.

La connexion commune ne donne pas de nouveaux droits. Un compte peut avoir accès à Softwareforge sans avoir accès à Asset Manager ou à Inference. Le sélecteur de langue enregistre la préférence commune dans Identity.

Projets et droits d’accès

Nouveau projet crée un dépôt Git. Son état Préparation indique que sa mise en place continue ; Prêt signifie qu’il peut être utilisé. En cas d’Erreur, actualisez puis demandez à un administrateur de vérifier le projet. Un projet Archivé ne doit pas être utilisé pour une nouvelle construction.

Le propriétaire et les membres autorisés voient le projet. La lecture permet de consulter le dépôt et les versions. L’écriture permet notamment d’ouvrir l’éditeur et de demander une construction ; l’administration du projet gère ses membres. Ces droits sont vérifiés par le serveur.

Constructions activées ou Constructions désactivées s’applique à chaque projet. Un dépôt utilisable peut avoir ses constructions désactivées. Seul un administrateur peut modifier cette disponibilité ; elle ne bloque pas la consultation des versions déjà publiées.

Cloner et envoyer du code avec SSH

Sur votre poste, créez une clé SSH si vous n’en avez pas. Ajoutez uniquement sa partie publique dans Identity, via Gérer mes clés SSH. La clé privée reste sur votre poste et ne doit jamais être copiée dans un dépôt ou un ticket d’assistance.

Copiez la commande Cloner le dépôt affichée dans le projet : elle contient l’adresse et, lorsqu’une branche est imposée, les options adaptées. Après modification, vérifiez les fichiers avec git status, créez votre commit puis envoyez-le sur la branche voulue.

1. Vérifiez l’empreinte du serveur auprès de votre administrateur lors de la première connexion SSH.
2. En cas de refus SSH, vérifiez la clé publique enregistrée, la clé chargée dans votre agent et vos droits sur ce projet.

ssh-keygen -t ed25519
git status
git add content/page.md
git commit -m "Update page"
git push

Éditeur intégré et travail conservé

Dans DÉPÔT ET CONSTRUCTIONS, Voir le projet ouvre code-server directement dans Softwareforge. Le premier démarrage peut prendre du temps. L’éditeur démarre en thème clair ; vos préférences déjà enregistrées sont conservées lors des ouvertures suivantes.

L’espace de travail appartient à votre compte et à ce projet. Fermer l’éditeur ferme son affichage ; les fichiers enregistrés et les commits locaux restent conservés. À la réouverture, les sources ne sont pas remplacées automatiquement par la dernière branche distante.

Enregistrer un fichier, créer un commit et publier ce commit sont trois actions distinctes. La synchronisation Git exige votre propre accès SSH ; l’ouverture de l’éditeur ne fournit pas de clé technique partagée. Vérifiez la confirmation de l’envoi avant de considérer votre travail comme publié.

Frontmark : sources et prévisualisation

Le projet Frontmark présente uniquement sa branche qualification-dehydrated. Elle contient les sources déshydratées prévues pour l’édition. La réhydratation nécessaire à une construction est réalisée par Factory ; la vue du projet ne propose pas la variante hydratée.

Le plugin FrontMark est installé dans l’éditeur. Ouvrez une page Markdown ou FrontMark, puis utilisez sa commande de prévisualisation depuis la palette de commandes. Les vues FrontMark proposent aussi les réglages du site et les opérations de versionnement. Relisez les modifications avant de les appliquer ou de les publier.

Certaines opérations qui exécutent le projet nécessitent la confiance de l’espace de travail dans VS Code. N’accordez cette confiance qu’après avoir vérifié les sources. La connexion partagée et son panneau restent disponibles sans saisir de nouveaux identifiants.

Asset Manager et Inference dans FrontMark

Dans l’éditeur Softwareforge, FrontMark reprend automatiquement votre session : aucune seconde connexion Identity n’est nécessaire. Le panneau Asset Manager & Inference indique le compte hérité et permet la déconnexion de toutes les applications Sigmax. Hors de cet éditeur, VS Code conserve la connexion Identity avec confirmation dans le navigateur.

Asset Manager permet de parcourir les images et documents autorisés, de choisir un bucket de destination et d’insérer des liens dans vos pages. Le mode Auto suit le bucket par défaut du projet lorsqu’il est accessible. Un lien vers une ressource privée ne la rend pas publique.

Inference utilise les modèles et droits de votre compte pour proposer des modifications. Vérifiez le document ciblé, relisez la proposition et appliquez-la explicitement. Une proposition n’est pas automatiquement enregistrée ni publiée. Si un seul des deux services est autorisé, il reste utilisable indépendamment de l’autre.

Construire, suivre et reprendre

Pour un projet dont les constructions sont activées, les événements Git admissibles ou une demande API peuvent déclencher Factory. Une demande référence un commit précis. Les droits, la branche et la disponibilité du projet sont contrôlés ; envoyer du code ne garantit pas qu’une image sera publiée.

Les étapes principales sont En attente, Préparation, Construction, Image créée, Vérification et Prêt. L’image n’est publiée comme version utilisable qu’après vérification. Le tableau de bord s’actualise toutes les 15 secondes ; Actualiser permet de relire immédiatement l’état.

Ouvrez Journaux dans l’historique pour lire les sorties disponibles. Reprendre relance un build en Échec si les constructions du projet sont toujours autorisées ; cette action conserve sa version logique. Annuler interrompt un travail encore actif. Ces actions restent soumises à vos droits d’écriture.

La durée moyenne du tableau de bord porte sur les publications réussies des 30 derniers jours. Elle inclut l’attente et les reprises, depuis la demande jusqu’à la publication ; elle ne correspond pas uniquement au temps du compilateur.

Versions et images publiées dans Zot

Images de conteneurs présente les versions vérifiées auxquelles vous avez accès. Chaque carte relie le projet, sa version, son commit et la référence du registre. Copier la commande pull produit une référence par digest, adaptée à une récupération reproductible.

Les détails de publication donnent les références de la SBOM, de la signature et de l’attestation. La SBOM décrit les composants ; la signature et l’attestation fournissent les preuves de publication. Conservez ces références avec le digest lorsque vous transmettez une version.

Le registre privé demande une authentification autorisée. Les credentials de lecture obtenus via l’API du projet sont temporaires et limités au dépôt. Une commande pull copiée ne remplace pas cette authentification. Pour un déploiement durable, utilisez l’identité machine prévue par votre organisation.

Résoudre les problèmes courants

Page de connexion ou accès refusé : ouvrez Identity et vérifiez vos applications autorisées. Si votre session vient d’être fermée ailleurs, reconnectez-vous une fois. Une panne temporaire du fournisseur de connexion peut demander de réessayer ; elle ne justifie pas de changer votre mot de passe.

Projet absent ou éditeur refusé : vérifiez le compte affiché et demandez au propriétaire de contrôler vos droits. Un accès en lecture ne suffit pas pour l’éditeur. Si vos droits sont retirés pendant une session, les appels suivants sont refusés.

Éditeur long à démarrer : attendez le message de préparation puis utilisez Réessayer si proposé. Fermer et rouvrir l’affichage ne supprime pas vos fichiers enregistrés. Si le problème persiste, relevez le projet, l’heure et le message affiché.

Build désactivé, en attente ou en échec : contrôlez la disponibilité du projet et ses journaux. Une attente peut refléter la capacité disponible ; un échec doit être diagnostiqué avant une reprise. Ne créez pas plusieurs demandes identiques pour accélérer une construction.

Asset Manager ou Inference indisponible : distinguez une session déconnectée d’un droit manquant. Le panneau de connexion affiche la session héritée ; l’accès aux buckets ou aux modèles dépend encore de votre compte. Réessayez après une panne temporaire.

Documentation API et assistance

Swagger décrit les routes et leurs formats. Les appels de modification nécessitent un compte autorisé ; lire la documentation ne donne aucun accès supplémentaire. Les clés API personnelles et les identités machine ont leurs propres permissions et durées de validité.

Pour demander de l’aide, indiquez le nom ou l’identifiant du projet, la version ou le commit concerné, l’heure et le message exact. Joignez les journaux utiles après avoir retiré les secrets. Ne transmettez jamais mot de passe, cookie de session, jeton API ni clé SSH privée.