Premiers pas avec votre forge Gitsi

À la livraison, la forge vous envoie un mail « Récupérer votre compte » depuis gitsi@aleop.eu. Le lien qu'il contient sert une seule fois. Il vous fait choisir votre mot de passe. Personne chez Aleop ne le connaît.

Votre identifiant est la partie de votre adresse avant le @. Pour it@societe.fr, c'est it.

Si le lien a expiré, ouvrez la forge, cliquez sur Mot de passe oublié ? et demandez-en un nouveau.

Personne ne peut s'inscrire seul sur votre forge. C'est vous qui créez les comptes, en tant qu'administrateur du site.

Ouvrez Administration du site, puis Identité et accès, Comptes utilisateurs et Créer un compte. Saisissez le nom d'utilisateur et le courriel du collègue.

Le formulaire demande un mot de passe. Tapez-en un long, au hasard, que vous ne gardez pas. Laissez cochée Demande à l'utilisateur de changer son mot de passe et cochez Envoyer une notification d'inscription. Votre collègue reçoit un mail « Votre compte sur » suivi du nom de la forge, avec un bouton Choisir mon mot de passe.

Pour partager les dépôts, créez ensuite une organisation (Nouvelle organisation) et des Équipes : Lecture, Écriture ou Accès Administrateur sur leurs dépôts. Ajoutez-y les comptes créés.

La forge ne parle Git qu'en HTTPS. Pour cloner et pousser depuis un poste, créez un jeton plutôt que d'utiliser votre mot de passe.

Dans vos Paramètres, ouvrez Applications, rubrique Gérer les jetons d'accès. Donnez un Nom du jeton, réglez repository sur Lecture et écriture, puis Générer un jeton.

Au premier git clone, Git demande un nom d'utilisateur et un mot de passe : donnez votre identifiant, puis le jeton à la place du mot de passe.

Préparez d'abord un jeton d'accès personnel sur GitHub ou GitLab, avec la lecture des dépôts à reprendre. Sans lui, seul le code Git passe.

Dans la forge, ouvrez le menu + en haut à droite, puis Nouvelle migration. Choisissez GitHub ou GitLab. Collez l'adresse du dépôt dans Migrer depuis une URL et le jeton dans le champ prévu.

Cochez les Éléments à migrer : tickets, demandes de fusion, labels, jalons, publications ou wiki, selon ce que vous voulez garder. Choisissez le Propriétaire, vous ou une organisation, puis Migrer le dépôt. Recommencez pour chaque dépôt.

Les secrets de vos pipelines ne suivent pas la migration. Recréez-les dans les paramètres du dépôt, rubrique Actions, Secrets.

Gitsi lit les workflows au format GitHub Actions. Déposez un fichier YAML dans .gitea/workflows/. À défaut, la forge lit .github/workflows/ : un dépôt importé de GitHub repart donc avec ses pipelines, qui se lancent au premier push.

Pour un essai, poussez ce fichier dans .gitea/workflows/essai.yaml :

Ouvrez l'onglet Actions du dépôt. Le job passe par En attente et En cours d'exécution, puis affiche Succès. Chaque étape a son journal.

Les actions écrites uses: actions/checkout@v4 sont prises sur github.com, comme chez GitHub. Une action qui appelle un service propre à GitHub demande une adaptation : c'est ce premier essai qui vous le montre.

Si l'onglet Actions n'apparaît pas, cochez Activer les actions du dépôt dans les paramètres du dépôt.

La forge a un registre de paquets. Il accepte les images de conteneur et les fichiers génériques, entre autres formats. Créez pour cela un jeton (étape 3) avec package réglé sur Lecture et écriture.

Pour une image, connectez Docker à la forge avec votre identifiant et ce jeton, puis nommez l'image d'après son propriétaire, vous ou une organisation. Le runner fourni n'a pas Docker : construisez l'image sur un poste.

Une archive, un binaire ou un installeur se dépose avec curl. Utilisez bien --upload-file : un envoi par --data-binary est refusé. Nous l'avons essayé jusqu'à 200 Mo.

Les paquets publiés apparaissent dans l'onglet Paquets de leur propriétaire. Depuis la fiche d'un paquet, Lier ce paquet à un dépôt l'affiche aussi dans le dépôt.