diff --git a/02_gitlab_depot_distant/05_definitions.qmd b/02_gitlab_depot_distant/05_definitions.qmd index a2e5dc8208e8dc111f70e6c123f8c2ecf30eac73..c30a04be165f6619293e3b9a826103e5222f2cbb 100644 --- a/02_gitlab_depot_distant/05_definitions.qmd +++ b/02_gitlab_depot_distant/05_definitions.qmd @@ -1,5 +1,19 @@ # Définitions {.inverse} +## Forge + +::: callout-note +## Définition +Une forge est une plateforme web simplifiant la mise en oeuvre de bonnes pratiques et facilitant le développement de logiciels de meilleure qualité, ainsi que la constitution de communautés de contributeurs et d’utilisateurs. +::: + +Une forge intègre : + +* outils de développement collaboratif (suivi des modifications du code, gestion des demandes et des réponses d’utilisateurs - tickets -, gestion des contributions, gestion du projet), +* industrialisation du processus de création du logiciel à partir de son code source (compilation, tests automatiques, assurance qualité, diffusion des livrables), + +[hal-04098702](https://hal-lara.archives-ouvertes.fr/hal-04098702){target="_blank"} + ## GitLab {fig-align="center" width=50%} @@ -12,18 +26,59 @@ Forge majoritaire dans les installations au sein de l'ESR [hal-04098702](https:/ `hal-04098702` : *Forges de l’Enseignement supérieur et de la Recherche - Définition, usages, limitations rencontrées et analyse des besoins*. La définition de *forge* vient ensuite. ::: -## Forge +## D’autres forges -::: callout-note -## Définition -Une forge est une plateforme web simplifiant la mise en oeuvre de bonnes pratiques et facilitant le développement de logiciels de meilleure qualité, ainsi que la constitution de communautés de contributeurs et d’utilisateurs. +:::: {.columns} + +::: {.column width=30%} +{height=4em} + +{height=4em} ::: -Une forge intègre : +::: {.column width=30%} -* outils de développement collaboratif (suivi des modifications du code, gestion des demandes et des réponses d’utilisateurs - tickets -, gestion des contributions, gestion du projet), -* industrialisation du processus de création du logiciel à partir de son code source (compilation, tests automatiques, assurance qualité, diffusion des livrables), -* outils de communication comme [Mattermost](https://team.forgemia.inra.fr/){target="_blank"}. +{height=4em} -[hal-04098702](https://hal-lara.archives-ouvertes.fr/hal-04098702){target="_blank"} +{height=4em} + +::: + +::: {.column width=30%} + +{height=4em} + +{height=4em} + +::: + +:::: + + +::: notes + +Plein de logiciels de forges ont existé et continuent d’être créés. Certaines par des entreprises, d’autres par des groupes de développeurs. + + +github: la plus connue, souvent confondue avec le logiciel git, lancée en 2008, sous forme de service, propriétaire. + +gitea, forgejo: des logiciels de forges libres légers + +redmine: à priori moins utilisé aujourd’hui. Entre autre utilisé par IRSTEA + +phabricator: créé et utilisé en interne par facebook (simplification: la version libre n’est plus maintenu, c’est une variante qui est utilisée en interne) + +gitee : principale forge logicielle en chine, équivalent de github. + + +Tout ça pour dire qu’il y a plein de logiciels de forges qui existent, et ça risque de changer un jour, mais les principes se retrouvent souvent. +::: + + +## Forgemia + +[https://forgemia.inra.fr](https://forgemia.inra.fr) +* Maintenue par le département MIA +* Déploie aussi l’outil de communication [Mattermost](https://team.forgemia.inra.fr/){target="_blank"}. +* Va être basculée vers une forge institutionnelle inrae, sans doute https://forge.inrae.fr début 2025. diff --git a/02_gitlab_depot_distant/06_configuration_gitlab.qmd b/02_gitlab_depot_distant/06_configuration_gitlab.qmd index 6a7abfb90a1a409aa49fb3785d91c18fed5eb86a..23ba1bdd4475d1e5ec22e7e57304a2660e1169e8 100644 --- a/02_gitlab_depot_distant/06_configuration_gitlab.qmd +++ b/02_gitlab_depot_distant/06_configuration_gitlab.qmd @@ -69,3 +69,5 @@ TODO {width=70% fig-align="center"} + +lien direct: [forgemia.inra.fr/-/user_settings/ssh_keys](https://forgemia.inra.fr/-/user_settings/ssh_keys) diff --git a/02_gitlab_depot_distant/07_projet_gitlab.qmd b/02_gitlab_depot_distant/07_projet_gitlab.qmd index 9b293d6af69af90cbabad45bfce4fc7cc9d10448..e9616510e82a8526fa5ce2d7a0ab6191b90eab38 100644 --- a/02_gitlab_depot_distant/07_projet_gitlab.qmd +++ b/02_gitlab_depot_distant/07_projet_gitlab.qmd @@ -6,6 +6,10 @@ Aller sur la page d'accueil (cliquer sur le logo GitLab en haut à gauche) et cl {fig-align="center"} +Ou, depuis n’importe où dans gitlab, cliquer sur le `+` dans la barre puis sur « new project/repository » + +{fig-align="center"} + ---- Pour mettre sur GitLab un dépôt créé sur votre machine, cliquer sur "Create blank project". diff --git a/02_gitlab_depot_distant/08_commandes_initiales.qmd b/02_gitlab_depot_distant/08_commandes_initiales.qmd index f9d65e1ceea43471b6cf1e388eff4686ae476af3..2e815cc5879404502c4fbb88959f43d47708bd5c 100644 --- a/02_gitlab_depot_distant/08_commandes_initiales.qmd +++ b/02_gitlab_depot_distant/08_commandes_initiales.qmd @@ -23,6 +23,17 @@ Les commandes sont affichées sur la page d'accueil du projet, lors de la créat ::: +## Copier l’URL du dépot + +Le bouton “Code†permet de récupérer l’URL qui sert à cloner ou envoyer le dépôt. + + + +::: callout-tip +on va utiliser SSH avec les clés qu’on a généré plus tôt, mais c’est aussi possible d’utiliser HTTPS avec [des tokens d’accès](https://forgemia.inra.fr/-/user_settings/personal_access_tokens). +::: + + ## Récupérer un dépôt distant en local ::: {.panel-tabset} diff --git a/02_gitlab_depot_distant/11_issues.qmd b/02_gitlab_depot_distant/11_issues.qmd index 202237fbc7d11075f156f655b29e66d49e1b6347..d455e367033dad58019684c93f37bf0d9450c750 100644 --- a/02_gitlab_depot_distant/11_issues.qmd +++ b/02_gitlab_depot_distant/11_issues.qmd @@ -2,7 +2,7 @@ ## Définition -Une *issue* est comme un ticket et permet : +Une *issue* est un ticket. Elle permet : - de prendre des notes - d'échanger sur une idée @@ -138,4 +138,4 @@ git commit -m "Correction orthographique. fixes #12" ::: notes Fermer un ticket depuis le message de commit n'est possible que depuis la branche *main*. -::: \ No newline at end of file +::: diff --git a/02_gitlab_depot_distant/images/05_04_gitlab_nouveau_projet_plus.png b/02_gitlab_depot_distant/images/05_04_gitlab_nouveau_projet_plus.png new file mode 100644 index 0000000000000000000000000000000000000000..47f12e8b4a1a2121466c5daffb46be560c6be8be Binary files /dev/null and b/02_gitlab_depot_distant/images/05_04_gitlab_nouveau_projet_plus.png differ diff --git a/02_gitlab_depot_distant/images/08_recuperation_url_depot.png b/02_gitlab_depot_distant/images/08_recuperation_url_depot.png new file mode 100644 index 0000000000000000000000000000000000000000..f2558ab8cbd0feba7e8a8d929016937ae1c5431c Binary files /dev/null and b/02_gitlab_depot_distant/images/08_recuperation_url_depot.png differ diff --git a/02_gitlab_depot_distant/images/240px-Logo_gitee_g_red.svg.png b/02_gitlab_depot_distant/images/240px-Logo_gitee_g_red.svg.png new file mode 100644 index 0000000000000000000000000000000000000000..89b27c16ab3f1e745dc388729b3712fc09585b26 Binary files /dev/null and b/02_gitlab_depot_distant/images/240px-Logo_gitee_g_red.svg.png differ diff --git a/02_gitlab_depot_distant/images/240px-Phacility_phabricator_logo.svg.png b/02_gitlab_depot_distant/images/240px-Phacility_phabricator_logo.svg.png new file mode 100644 index 0000000000000000000000000000000000000000..e792eef3a6ae4e30ca4420771bdc061c1e5c40ef Binary files /dev/null and b/02_gitlab_depot_distant/images/240px-Phacility_phabricator_logo.svg.png differ diff --git a/02_gitlab_depot_distant/images/300px-GitHub_Invertocat_Logo.svg.png b/02_gitlab_depot_distant/images/300px-GitHub_Invertocat_Logo.svg.png new file mode 100644 index 0000000000000000000000000000000000000000..9adf0530139ba8db12f78526e1445e57bf2f3c4e Binary files /dev/null and b/02_gitlab_depot_distant/images/300px-GitHub_Invertocat_Logo.svg.png differ diff --git a/02_gitlab_depot_distant/images/512px-Forgejo_logo.svg.png b/02_gitlab_depot_distant/images/512px-Forgejo_logo.svg.png new file mode 100644 index 0000000000000000000000000000000000000000..d8d618d44b3395dfe1fb81478035984c58e02884 Binary files /dev/null and b/02_gitlab_depot_distant/images/512px-Forgejo_logo.svg.png differ diff --git a/02_gitlab_depot_distant/images/512px-Gitea_Logo.svg.png b/02_gitlab_depot_distant/images/512px-Gitea_Logo.svg.png new file mode 100644 index 0000000000000000000000000000000000000000..ca162d0e60e81864bec3687c8c8236f86e983db7 Binary files /dev/null and b/02_gitlab_depot_distant/images/512px-Gitea_Logo.svg.png differ diff --git a/02_gitlab_depot_distant/images/Redmine_logo_v1.png b/02_gitlab_depot_distant/images/Redmine_logo_v1.png new file mode 100644 index 0000000000000000000000000000000000000000..bdfabb1ca8e51b7c914b198e19a99c12c67981af Binary files /dev/null and b/02_gitlab_depot_distant/images/Redmine_logo_v1.png differ diff --git a/flake.nix b/flake.nix index fe9d3f5d577b5db676eeb246147d50dfc08bfdda..6a838ca3518a666a0ba941b136b2897cac65f01f 100644 --- a/flake.nix +++ b/flake.nix @@ -62,6 +62,8 @@ pkgs.quarto pkgs.gnumake pkgs.python3 + pkgs.watchexec + pkgs.miniserve ]; enterShell = ''