[{"_1":2,"_169":-5,"_170":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_144":145},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_135":-5,"_136":11,"_137":17,"_138":11,"_139":-5,"_140":11,"_141":-5,"_142":143},"canonicalUrl","https://hub.docker.com/r/amatas/push-ref-gitlab/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","amatas","reponame","push-ref-gitlab","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":17,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2017-08-14T11:16:58.764533Z","description","GitHub and GitLab CI integration","is_private","last_updated","2017-08-14T12:08:07.126863Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",374,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# About\n\nThis repository is the result of exploratory work that was carried out to test GitHub and GitLab CI integration. The original inspiration was [a post on the sealedabstract website](http://faq.sealedabstract.com/gitlab_mirror/) and some of its configuration files and scripts have been adapted for this work.\n\nThe contents have been used to create [a Docker container](https://hub.docker.com/r/avtar/push-ref-gitlab/) that will:\n\n1. Use [webhook](https://github.com/adnanh/webhook/) to listen to GitHub [push](https://developer.github.com/v3/activity/events/types/#pushevent) or [pull request](https://developer.github.com/v3/activity/events/types/#pullrequestevent) events when changes are either merged in branches or when pull requests are sent via trusted contributors\n1. Pass the webhook payload as an argument (please refer to the environment variables below) a [Node.js script](ansible/files/sync-gitlab-mirror.js)\n\nThe script will then:\n\n1. Create a matching GitLab project if one does not already exist\n1. Enable up a [GitLab CI runner](https://docs.gitlab.com/ee/ci/runners/README.html) for the project in question\n1. Enable a [build events webhook](https://gitlab.com/gitlab-org/gitlab-ce/issues/4278) that will inform [webhook](https://github.com/adnanh/webhook/) of CI job progress\n1. Clone the GitHub repository and set up GitLab as a remote\n1. Finally the ref with changes from the original payload will be pushed to the GitLab repository\n\nGitLab CI jobs will be triggered if the GitHub repository contains a [valid](https://gitlab.com/ci/lint) [.gitlab-ci.yml file](https://issues.gpii.net/browse/GPII-2123?focusedCommentId=22422&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-22422). The progress of CI jobs will be communicated using the [GitHub Status API](https://developer.github.com/v3/repos/statuses/) and also be viewable using the [GitLab Pipelines UI](https://docs.gitlab.com/ee/ci/pipelines.html).\n\n### Environment Variables\n\nIn order to use the supplied container the following environment variables will need to be provided:\n\n* ``BUILD_EVENTS_WEBHOOK_URL`` - This is a URL pointing to where the container is running, for example ``http://:9000/hooks/update-github-status``\n* ``GITHUB_USER`` - The GitHub account associated with the repositories that will be generating the push events\n* ``GITHUB_TOKEN`` - A GitHub Personal Access Token with the ``repo:status`` scope\n* ``GITLAB_USER`` - The GitLab account where GitHub repositories will be mirrored\n* ``GITLAB_TOKEN`` - A GitLab Personal Access Token\n* ``GITLAB_RUNNER_ID`` - A GitLab CI Runner ID (please refer to notes further below)\n* ``GITLAB_HOST`` - ``https://gitlab.com`` should be a safe default unless a self-hosted GitLab instance is being used\n* ``CONTRIBUTORS_WHITELIST`` - A comma separated list (no spaces) of GitHub account names that are trusted to trigger CI jobs using their pull request changes\n* ``GITLAB_ENABLE_SHARED_RUNNERS`` - Boolean defaults to ``false``, ideally set to ``true`` if a self-hosted GitLab instance is being used\n\n### Start a Container\n\nA container can be started as long as the prerequisites listed below have been met.\n\n```\nsudo docker run \\\n-d -p 9000:9000 \\\n--name push-ref-gitlab \\\n-e BUILD_EVENTS_WEBHOOK_URL=http://:9000/hooks/update-github-status \\\n-e GITLAB_HOST=https://gitlab.com \\\n-e GITHUB_USER= \\\n-e GITHUB_TOKEN= \\\n-e GITLAB_USER= \\\n-e GITLAB_TOKEN= \\\n-e GITLAB_RUNNER_ID= \\\n-e CONTRIBUTORS_WHITELIST=github-account1,github-account2 \\\navtar/push-ref-gitlab\n```\n\n## Prerequisites\n\nBefore a container can be used some preparatory work is needed. The following tasks only need to be performed once unless the runner is moved to a different host or its details change in any other way. \n\nAfter these steps any merge activity in the configured GitHub repositories will trigger GitLab CI jobs.\n\n### Create a GitHub Personal Access Token\n\nVisit https://github.com/settings/tokens/ to create a new personal access token. Only the ``repo:status`` scope needs to be granted.\n\n### Create a GitLab Test Project\n\nVisit https://gitlab.com/projects/new to create a temporary test project.\n\nA project name such as ``test-project`` can be used. This project won't be used for any CI jobs, it is just need in order to obtain a CI runner token which unfortunately isn't offered by other means. If a self-hosted GitLab instance is being used then shared CI runners would be an option and these extra steps wouldn't be required.\n\n### Set Up a GitLab Runner\n\nA GitLab Runner can be hosted on your personal computer or in a data centre. Runners will have access to secrets depending on what your CI jobs entail.\n\n### Obtain a GitLab CI Runner Token\n\nVisit ``https://gitlab.com//test-project/runners`` and search for the ``Use the following registration token during setup: `` text. Make a note of this token.\n\n### Install a Runner\n* [macOS/OS X](https://docs.gitlab.com/runner/install/osx.html)\n* [Linux](https://docs.gitlab.com/runner/install/linux-repository.html)\n* [Windows](https://docs.gitlab.com/runner/install/windows.html)\n\n### Register a Runner \n\n```\ngitlab-runner register \\\n--non-interactive \\\n--registration-token \"\" \\\n--url \"https://gitlab.com/\" \\\n--name \"\" \\\n--executor \"shell\"\n```\n\n### Start a Runner Interactively\n\nThe following command will start the runner in the foreground and not as a service, allowing you to observe its activity:\n\n``gitlab-runner --debug run``\n\nTo stop the process you will need to type ``CTRL-C``.\n\n### Obtain the Runner's ID\n\nVisit ``https://gitlab.com///runners`` and copy the number prepended by the ``#`` character.\n\n### Set Up a GitHub Webhook\n\nVisit ``https://github.com///settings/hooks/new`` to create a new webhook. Each project that needs to make use of GitLab CI will need to have these hooks configured.\n\n* The only text field that needs to be populated is the ``Payload URL``. The URL will resemble the following example: ``http://:9000/hooks/sync-gitlab-mirror``\n\n* The ``Content type`` should be set to ``application/json``.\n\n* ``Send me everything`` should be selected.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",259183197,"orgData","recentTags",[87,125],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},"content_type","creator",175718,"full_size",214721217,"id",14047604,"images",[97],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},"architecture","amd64","digest","sha256:2faab20a9d8a7370f377dde9355e8e558a34ebbef14077fcbd41986560756c99","features","","last_pulled","2026-09-21T19:09:50.352899229Z","last_pushed","2017-08-14T12:08:07Z","os","linux","os_features","os_version","size","variant","2017-08-14T12:08:06.754277Z","last_updater","last_updater_username","media_type","latest","repository",1734143,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_88":40,"_89":90,"_91":126,"_93":127,"_95":128,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},214721220,14047564,[129],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},"sha256:da13cb792c0d17a0730c2acecd35e6b55e50405fa7aec330900abeb2a637eab6","2026-09-17T13:24:56.099593133Z","2017-08-14T12:05:28Z","2017-08-14T12:05:27.253968Z","GPII-2449","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":146,"_153":154,"_142":167,"_168":11},{"_36":147,"_38":148,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":149,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":150,"_75":17,"_76":152,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":151},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_155":156,"_157":-5,"_158":-5,"_159":160},"count",2,"next","previous","results",[161,164],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":162,"_46":114,"_115":90,"_116":29,"_117":52,"_53":118,"_119":120,"_121":105,"_122":114,"_123":62,"_124":17},[163],{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109,"_110":103,"_111":-5,"_112":92,"_59":62,"_113":-5},{"_88":40,"_89":90,"_91":126,"_93":127,"_95":165,"_46":133,"_115":90,"_116":29,"_117":52,"_53":134,"_119":120,"_121":131,"_122":133,"_123":62,"_124":17},[166],{"_98":99,"_100":130,"_102":103,"_104":131,"_106":132,"_108":109,"_110":103,"_111":-5,"_112":126,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

amatas/push-ref-gitlab

Tags for amatas/push-ref-gitlab