{"id":1919,"date":"2020-01-08T12:52:14","date_gmt":"2020-01-08T11:52:14","guid":{"rendered":"https:\/\/iww.inria.fr\/sed-sophia\/?p=1919"},"modified":"2020-01-10T17:36:35","modified_gmt":"2020-01-10T16:36:35","slug":"create-a-gitlab-page-for-a-given-project","status":"publish","type":"post","link":"https:\/\/iww.inria.fr\/sed-sophia\/create-a-gitlab-page-for-a-given-project\/","title":{"rendered":"Create a GitLab Page for a given project"},"content":{"rendered":"<p>C&#8217;est une petite note sur comment cr\u00e9er une page GitLab Pages pour un projet donn\u00e9.<\/p>\n<p>Cr\u00e9ez un fichier <strong>.gitlab-ci.yml<\/strong> comme indiqu\u00e9 ici : <a href=\"https:\/\/gitlab.inria.fr\/help\/user\/project\/pages\/getting_started\/new_or_existing_website.md\">https:\/\/gitlab.inria.fr\/help\/user\/project\/pages\/getting_started\/new_or_existing_website.md<\/a><br \/>\n(partez de HTML si vous n&#8217;avez pas \u00e0 compiler un framework, ou choisissez le framework que vous utilisez sinon, par exemple vous pouvez partir d&#8217;un fichier plus ou moins bien rempli pour Doxygen, Jekyll, etc.)<br \/>\nD\u00e9finissez dans quelles branches le runner doit se lancer (par d\u00e9faut il se lance uniquement s&#8217;il y a une action dans a branche master).<br \/>\nD\u00e9finissez un tag en haut du fichier avec :<\/p>\n<p>tags:<br \/>\n&#8211; mon-super-tag<\/p>\n<p>Pour exemple, dans le cas du projet <strong>precis (<a href=\"https:\/\/gitlab.inria.fr\/coffee\/precis\/\">https:\/\/gitlab.inria.fr\/coffee\/precis\/<\/a> )<\/strong>, le fichier <strong>.gitlab-ci.yml<\/strong> contient \u00e7a :<\/p>\n<pre># This file is a template, and might need editing before it works on your project.\r\n# Full project: https:\/\/gitlab.com\/pages\/doxygen\r\n\r\npages:\r\ntags:\r\n  - mon-super-tag\r\nscript:\r\n  - source ~\/conda_setup\r\n  - conda env update -f pkg\/env\/precis-doc.yaml\r\n  - conda activate precis-doc\r\n  - mkdir build\r\n  - cd build\r\n  - cmake ..\r\n  - make doc\r\n  - mv doxygen\/out\/html\/ ..\/public\/\r\nartifacts:\r\n  paths:\r\n    - public\r\nonly:\r\n  - master\r\n  - develop\r\n  - feature\/doxygen\r\n<\/pre>\n<p>Activez le pipeline dans Gitlab:<br \/>\n&#8211; dans la barre \u00e0 gauche, <strong>Settings -&gt; General -&gt; Visibility, project features, permissions<\/strong>, cochez Pipeline<br \/>\n&#8211; dans la barre \u00e0 gauche, <strong>Settings -&gt; CI\/CD -&gt; (expand) Runner<\/strong>, notez l&#8217;URL et surtout le token du repository.<\/p>\n<p>Cr\u00e9ez (ou utilisez) un slave Jenkins dans CI :<br \/>\n&#8211; cr\u00e9er un projet CI et un slave, ou un slave Jenkins dans un projet sur CI, ou utilisez un slave Jenkins d\u00e9j\u00e0 existant<br \/>\n&#8211; se connecter dessuss en SSH<br \/>\n&#8211; faire l&#8217;install de gitlab-runner puis faire le gitlab-runner register en suivant la proc\u00e9dure : <a href=\"https:\/\/gitlab.inria.fr\/siteadmin\/doc\/-\/wikis\/faq#enabling-ci-on-a-gitlab-project\">https:\/\/gitlab.inria.fr\/siteadmin\/doc\/-\/wikis\/faq#enabling-ci-on-a-gitlab-project<\/a><br \/>\nAu moment du tag, rentrez mon-super-tag<\/p>\n<p>Si tout s&#8217;est bien fait, votre runner doit apparaitre sur Gitlab sous <strong>Settings -&gt; CI\/CD -&gt; (expand) Runner<\/strong><br \/>\nEt dans la barre \u00e0 gauche, <strong>CI\/CD -&gt; Pipeline<\/strong> votre pipeline doit apparaitre tout seul d\u00e8s qu&#8217;une action se fait dans une branche mentionn\u00e9e dans le .gitlab-ci.yml.<br \/>\nSous <strong>Settings -&gt; Pages<\/strong> vous trouverez un lien vers votre GitLab Page.<br \/>\nSous <strong>Settings -&gt; General -&gt; Visibility, project features, permissions<\/strong>, passez la page en visibilit\u00e9 publique pour la rendre visible \u00e0 tout le monde (sans besoin de se connecter \u00e0 GitLab)<\/p>\n<div id=\"blinkextension_snap_links_box_mg_mouse_gestures\" style=\"background-color: rgba(250, 128, 0, 0.07); border: 3px dashed blue; box-sizing: border-box; position: absolute; z-index: 2147483647; display: none;\"><\/div>\n<div id=\"hit_a_link_blinkextension_container_mg_mouse_gestures\" style=\"display: none; position: absolute; left: 0px; top: 0px; width: 0px; height: 0px; z-index: 2147483647; background: rgba(0, 0, 0, 0) none repeat scroll 0% 0%;\"><\/div>\n<div id=\"blinkextension_snap_links_box_mg_mouse_gestures\" style=\"background-color: rgba(250, 128, 0, 0.07); border: 3px dashed blue; box-sizing: border-box; position: absolute; z-index: 2147483647; display: none;\"><\/div>\n<div id=\"hit_a_link_blinkextension_container_mg_mouse_gestures\" style=\"display: none; position: absolute; left: 0px; top: 0px; width: 0px; height: 0px; z-index: 2147483647; background: rgba(0, 0, 0, 0) none repeat scroll 0% 0%;\"><\/div>\n<p><\/p>","protected":false},"excerpt":{"rendered":"<p>C&#8217;est une petite note sur comment cr\u00e9er une page GitLab Pages pour un projet donn\u00e9. Cr\u00e9ez un fichier .gitlab-ci.yml comme indiqu\u00e9 ici : https:\/\/gitlab.inria.fr\/help\/user\/project\/pages\/getting_started\/new_or_existing_website.md (partez de HTML si vous n&#8217;avez pas \u00e0 compiler un framework, ou choisissez le framework que vous utilisez sinon, par exemple vous pouvez partir d&#8217;un fichier\u2026<\/p>\n<p> <a class=\"continue-reading-link\" href=\"https:\/\/iww.inria.fr\/sed-sophia\/create-a-gitlab-page-for-a-given-project\/\"><span>Continue reading<\/span><i class=\"crycon-right-dir\"><\/i><\/a> <\/p>\n","protected":false},"author":2430,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_members_access_role":[],"_members_access_error":""},"categories":[29,111],"tags":[],"class_list":["post-1919","post","type-post","status-publish","format-standard","hentry","category-development-in-the-inria-teams","category-tools"],"_links":{"self":[{"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/posts\/1919","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/users\/2430"}],"replies":[{"embeddable":true,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/comments?post=1919"}],"version-history":[{"count":10,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/posts\/1919\/revisions"}],"predecessor-version":[{"id":1975,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/posts\/1919\/revisions\/1975"}],"wp:attachment":[{"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/media?parent=1919"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/categories?post=1919"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/iww.inria.fr\/sed-sophia\/wp-json\/wp\/v2\/tags?post=1919"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}